NAME                                                              (V36)
    InstallLayerHook -- safely install a new Layer->BackFill hook.

SYNOPSIS
    oldhook = InstallLayerHook( layer, hook )
    d0                          a0     a1

    struct hook *installlayerhook( struct layer *, struct hook *);

FUNCTION
    Installs a new Layer->Backfill hook, waiting until it is safe to do
    so. Locks the layer while substituting the new hook and removing the
    old one. If a new hook is not provided, will install the default layer
    BackFill hook.

INPUTS
    layer - pointer to the layer in which to install the Backfill hook.
    hook -  pointer to layer callback hook which will be called
            with object == (struct rastport *) result->rastport
            and message == [ (Layer *) layer, (struct Rectangle) bounds,
                           (WORD) offsetx, (WORD) offsety ]

            This hook should fill the rectangle in the rastport
            with the BackFill pattern appropriate for offset x/y.

            If this hook pointer is NULL, the function installs
            the "default" Layers BackFill hook into this layer.

RESULTS
    oldhook - pointer to the Layer->BackFill hook that was previously
              active.

BUGS

SEE ALSO
    graphics/clip.h utility/hooks.h