NAME
EndUpdate -- remove damage list and restore state of layer to normal.
SYNOPSIS
EndUpdate( l, flag )
a0 d0
void EndUpdate( struct Layer *, UWORD);
FUNCTION
After the programmer has redrawn his picture he calls this
routine to restore the ClipRects to point to his standard
layer tiling. The layer is then unlocked for access by the
layer library.
Note: use flag = FALSE if you are only making a partial update.
You may use the other region functions (graphics functions such as
OrRectRegion, AndRectRegion, and XorRectRegion ) to clip adjust
the DamageList to reflect a partial update.
INPUTS
l - pointer to a layer
flag - use TRUE if update was completed. The damage list is cleared.
use FALSE if update not complete. The damage list is retained.
EXAMPLE
-- begin update for first part of two-part refresh --
BeginUpdate(my_layer);
-- do some refresh, but not all --
my_partial_refresh_routine(my_layer);
-- end update, false (not completely done refreshing yet) --
EndUpdate(my_layer, FALSE);
-- begin update for last part of refresh --
BeginUpdate(my_layer);
-- do rest of refresh --
my_complete_refresh_routine(my_layer);
-- end update, true (completely done refreshing now) --
EndUpdate(my_layer, TRUE);
BUGS
SEE ALSO
BeginUpdate, graphics/layers.h, graphics/clip.h