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

SuperBitMap windows are created by setting the WFLG_SUPER_BITMAP flag, or
by specifying the WA_SuperBitMap tag in the OpenWindowTagList() call.  A
pointer to an allocated and initialized BitMap structure must be provided.

A SuperBitMap window requires the application to allocate and initialize
its own bitmap.  This entails allocating a BitMap structure, initializing
the structure and allocating memory for the bit planes.

Allocate a BitMap structure with the Exec AllocMem() function.  Then use
the graphics function InitBitMap() to initialize the BitMap structure:

    void InitBitMap( struct BitMap *bitMap, long depth,
                     long width, long height );

InitBitMap() fills in fields in the BitMap structure describing how a
linear memory area is organized as a series of one or more rectangular
bit-planes.

Once you have allocated and initialized the BitMap structure, use the
graphics library function AllocRaster() to allocate the memory space for
all the bit planes.

    PLANEPTR AllocRaster( unsigned long width, unsigned long height );

The example listed in the next section shows how to allocate a BitMap
structure, initialize it with InitBitMap() and use AllocRaster() function
to set up memory for the bitplanes.

 Graphics and Layers Functions for SuperBitMap Windows 
 SuperBitMap Window Example