bmap_create(STRING* name)
bmap_createblack(var width, var height, var bits)

Creates a bmap at runtime. bmap_create loads the content from a file, bmap_createblack creates a black bmap with given dimensions that can later be filled with a color. Objects created this way are automatically deleted on closing the engine.

Parameters:

name - name (STRING* or char*) of an image file that defines width, height, format, and content of the bitmap.
width - width of the bitmap in pixels.
height - height of the bitmap in pixels.
bits - bits per pixel, either 16, 24, 32, or  A7  64 (16 bit floating point ABGR).

Returns:

Pointer to the bmap, or NULL if it could not be created.

Speed:

slow

Example:

bmap* dummy;

//...
dummy = bmap_create("test.pcx")

See also:

bmap, bmap_lock