rom/intuition/beginrefresh.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 <proto/layers.h>
   8 #include <proto/graphics.h>
   9 #include "intuition_intern.h"
  10 #include "inputhandler_actions.h"
  11 #include "inputhandler_support.h"
  12
  13 #ifdef SKINS
  14 #   include "renderwindowframe.h"
  15 #endif
  16
  17 /*****************************************************************************
  18
  19     NAME */
  20 #include <proto/intuition.h>
  21
  22     AROS_LH1(void, BeginRefresh,
  23
  24 /*  SYNOPSIS */
  25          AROS_LHA(struct Window *, window, A0),
  26
  27 /*  LOCATION */
  28          struct IntuitionBase *, IntuitionBase, 59, Intuition)
  29
  30 /*  FUNCTION
  31         Initializes optimized refreshing. It restricts redrawing to areas which
  32         need refreshing after a window has been moved or has changed size.
  33
  34     INPUTS
  35         window - window which needs refreshing
  36
  37     RESULT
  38
  39     NOTES
  40         Only simple graphics.library functions are allowed between
  41         BeginRefresh() and EndRefresh().
  42
  43         BeginRefresh()/EndRefresh() should always be called when an
  44         IDCMP_REFRESHWINDWOW message happens.
  45
  46     EXAMPLE
  47         somewhere in your window's event handling loop:
  48
  49         case IDCMP_REFRESHWINDWOW:
  50             BeginRefresh(mywindow);
  51             EndRefresh(mywindow, TRUE);
  52             break;
  53
  54     BUGS
  55
  56     SEE ALSO
  57         EndRefresh()
  58
  59     INTERNALS
  60
  61 *****************************************************************************/
  62 {
  63     AROS_LIBFUNC_INIT
  64
  65     ULONG mode = NO_DOUBLEBUFFER;
  66
  67 #ifdef BEGINUPDATEGADGETREFRESH
  68     BOOL gadgetrefresh = FALSE;
  69 #endif
  70
  71     DEBUG_REFRESH(dprintf("BeginRefresh: Window 0x%lx\n", window));
  72
  73     SANITY_CHECK(window)
  74
  75     //jDc: makes sure we've got 1 refresing window at a time
  76     LockLayerInfo(&window->WScreen->LayerInfo);
  77
  78     /* Find out whether it's a GimmeZeroZero window with an extra layer to lock */
  79     if (BLAYER(window))
  80         LockLayer(0, BLAYER(window));
  81
  82     /* jDc: in actual implementation border layer is created as the 1st one. this means it's added to
  83     ** screens layer semaphore list at the end (layers use AddTail), so here we also need to lock it
  84     ** as 1st one, otherwise we run into a deadlock with LockLayers() !!!
  85     */
  86
  87     LockLayer(0, WLAYER(window));
  88
  89     /* jDc: in current opaque implementation the damaged regions are added to
  90     ** window's internal damage list and matched against actual damage here
  91     */
  92
  93     if (IW(window)->specialflags & SPFLAG_WANTBUFFER) mode = DOUBLEBUFFER;
  94
  95     /* I don't think I ever have to update the BorderRPort's layer */
  96     if (!BeginUpdate(WLAYER(window)))
  97     {
  98         EndUpdate(WLAYER(window), FALSE);
  99
 100         //dprintf("%s :BeginUpdate returned FALSE!->Aborting BeginUpdate()\n",__FUNCTION__);
 101         return;
 102     }
 103
 104     /* jDc: because with opaque move window borders/gadgets are not refreshed to
 105     ** speed things up we do this here - this reduces cpu time spent in inputhandler
 106     */
 107
 108     /* let the user know that we're currently doing a refresh */
 109     AROS_ATOMIC_OR(window->Flags, WFLG_WINDOWREFRESH);
 110
 111     AROS_LIBFUNC_EXIT
 112 } /* BeginRefresh */