rom/intuition/unlockpubscreen.c

   1 /*
   2     Copyright  1995-2007, The AROS Development Team. All rights reserved.
   3     Copyright  2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include "intuition_intern.h"
   8
   9 /*****************************************************************************
  10
  11     NAME */
  12 #include <proto/intuition.h>
  13
  14     AROS_LH2(void, UnlockPubScreen,
  15
  16 /*  SYNOPSIS */
  17          AROS_LHA(UBYTE         *, name, A0),
  18          AROS_LHA(struct Screen *, screen, A1),
  19
  20 /*  LOCATION */
  21          struct IntuitionBase *, IntuitionBase, 86, Intuition)
  22
  23 /*  FUNCTION
  24     Release a lock to a screen locked by LockPubScreen().
  25     Identify screen by the pointer returned from LockPubScreen()
  26     and pass NULL name in normal cases.
  27     Sometimes it might be useful to specify the name string. In
  28     this case the screen pointer will be ignored.
  29
  30     INPUTS
  31     name - Name of the public screen to unlock
  32     screen - Pointer to the screen to unlock
  33
  34     RESULT
  35
  36     NOTES
  37     The screen parameter will be ignored if name is non-NULL
  38
  39     EXAMPLE
  40
  41     BUGS
  42
  43     SEE ALSO
  44     LockPubScreen()
  45
  46     INTERNALS
  47
  48     HISTORY
  49     29-10-95    digulla automatically created from
  50                 intuition_lib.fd and clib/intuition_protos.h
  51
  52 *****************************************************************************/
  53 {
  54     AROS_LIBFUNC_INIT
  55
  56     struct List *publist;
  57
  58     DEBUG_UNLOCKPUBSCREEN(dprintf("UnlockPubScreen: name <%s> screen %p\n",
  59                                   name ? name : "NULL", screen));
  60     DEBUG_UNLOCKPUBSCREEN(dprintf("LockPubScreen: task %p <%s>\n",
  61                                   SysBase->ThisTask,
  62                                   SysBase->ThisTask->tc_Node.ln_Name ? SysBase->ThisTask->tc_Node.ln_Name : "NULL"));
  63
  64     publist = LockPubScreenList();
  65
  66     if (name != NULL)
  67     {
  68         struct PubScreenNode *psn;
  69
  70         /* Get screen by its name */
  71         if ((psn = (struct PubScreenNode *)FindName(publist, name)))
  72             screen = psn->psn_Screen;
  73         else
  74             screen = NULL;
  75
  76         DEBUG_UNLOCKPUBSCREEN(dprintf("UnlockPubScreen: found screen %p\n",
  77                                       screen));
  78     }
  79
  80     if (screen != NULL)
  81     {
  82         struct PubScreenNode *ps = GetPrivScreen(screen)->pubScrNode;
  83
  84         //ASSERT(GetPrivScreen(screen)->pubScrNode != NULL);
  85         //ASSERT(GetPrivScreen(screen)->pubScrNode->psn_VisitorCount > 0);
  86
  87         /* Unlock screen */
  88         ps->psn_VisitorCount--;
  89
  90         DEBUG_VISITOR(dprintf("UnlockPubScreen: count %d <%s>\n",
  91                               ps->psn_VisitorCount,
  92                               FindTask(NULL)->tc_Node.ln_Name));
  93
  94
  95         DEBUG_UNLOCKPUBSCREEN(dprintf("UnlockPubScreen: count %d\n",
  96                                       ps->psn_VisitorCount));
  97
  98         /* Notify screen owner if this is (was) the last window on the
  99            screen */
 100         if(ps->psn_VisitorCount == 0)
 101         {
 102             if(ps->psn_SigTask != NULL)
 103                 Signal(ps->psn_SigTask, 1 << ps->psn_SigBit);
 104         }
 105
 106     }
 107
 108     UnlockPubScreenList();
 109
 110     FireScreenNotifyMessage((IPTR) name, SNOTIFY_UNLOCKPUBSCREEN, IntuitionBase);
 111
 112     AROS_LIBFUNC_EXIT
 113 } /* UnlockPubScreen */