[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