Home / Autodocs / layers.library
NAME
- EndUpdate
-
remove damage list and restore state of layer to normal.
SYNOPSIS
EndUpdate( l, flag )
void EndUpdate( struct Layer *, UWORD);
a0 d0
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.
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);
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
In V40 or below, EndUpdate() could have failed to re-install the user clip region in low-memory situations. This has been fixed for V45. V45 may leave the layer cliprects in sub- optimal, but valid stage if it runs low on memory.