NAME (V36)
CreateBehindHookLayer -- Create a new layer behind all existing layers,
using supplied callback BackFill hook.
SYNOPSIS
result = CreateBehindHookLayer(li,bm,x0,y0,x1,y1,flags,hook,[,bm2])
d0 a0 a1 d0 d1 d2 d3 d4 a3 [ a2 ]
struct layer *createbehindhooklayer(struct layer_info *, struct bitmap *,
long, long, long, long, long, struct hook *, ... );
FUNCTION
Create a new layer of position and size (x0,y0)->(x1,y1)
Make this layer of type found in flags.
Install Layer->BackFill callback hook.
If SuperBitMap, use bm2 as pointer to real SuperBitMap,
and copy contents of Superbitmap into display layer.
If this layer is a backdrop layer then place it behind all
other layers including other backdrop layers. If this is
not a backdrop layer then place it behind all nonbackdrop
layers.
Note: when using SUPERBITMAP, you should also set LAYERSMART flag.
INPUTS
li - pointer to LayerInfo structure
bm - pointer to common bitmap used by all layers
x0,y0 - upper left hand corner of layer
x1,y1 - lower right hand corner of layer
flags - various types of layers supported as bit sets.
(for bit definitions, see graphics/layers.h )
hook - Layer->BackFill callback hook (see installlayerhook())
If hook is LAYERS_BACKFILL, the default backfill is
used for the layer. (Same as pre-2.0)
As of V39:
If hook is LAYERS_NOBACKFILL, the layer will not be
backfilled (NO-OP).
bm2 - pointer to optional Super bitmap
RESULTS
result - pointer to layer structure if successful
NULL if not successful
BUGS
SEE ALSO
installlayerhook(), deletelayer(), graphics/layers.h, graphics/clip.h,
graphics/gfx.h, utility/hooks.h