GrBitmap()

Name

GrBitmap() -- Draw a monochrome bitmap

Synopsis

void GrBitmap ( GR_DRAW_ID id , GR_GC_ID gc , GR_COORD x , GR_COORD y , GR_SIZE width , GR_SIZE height , GR_BITMAP * imagebits );

Description

This function fills a rectangular area with a monochrome bitmap. Bits with a value of 1 are drawn in the current foreground color of the specified graphics context. Bits with a value of 0 are drawn in the background color of the graphics context if the usebackground flag is set in the GC, otherwise 0 bits have no effect on the drawable. The image data should be an array of aligned 16 bit words.

Parameters

TypeNameDescription
GR_DRAW_IDidThe ID of the drawable to draw the bitmap onto.
GR_GC_IDgcThe ID of the graphics context to use when drawing the bitmap.
GR_COORDxThe X coordinate to of the rectangular area that the bitmap will be drawn in, relative to the drawable.
GR_COORDyThe Y coordinate to of the rectangular area that the bitmap will be drawn in, relative to the drawable.
GR_SIZEwidthThe width of the rectangle that the bitmap will be drawn in.
GR_SIZEheightThe height of the rectangle that the bitmap will be drawn in.
GR_BITMAP*imagebitsAn array of 16 bit words that define the bitmap image.