[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


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