fg_getdcb()

Win32 DirectX Fastgraph/Light

Prototype

void fg_getdcb (void *bitmap, int width, int height);

Sub fg_getdcb (bitmap() As Any, ByVal width As Long, ByVal height As Long)

procedure fg_getdcb (var bitmap; width, height : integer);

Description

The fg_getdcb() function retrieves a direct color bitmap. The graphics cursor defines the bitmap's lower left corner.

For high color virtual buffers, each pixel in the bitmap will be a 16-bit (two byte) encoded RGB value. For true color virtual buffers, each pixel will be a 24-bit (three byte) RGB value, stored blue byte first, then green byte, then red byte.

Parameters

bitmap is the name of the array that will receive the bitmap.

width is the bitmap width in pixels.

height is the bitmap height in pixels.

Return value

none

Restrictions

This function is meaningful only with direct color virtual buffers.

See also

fg_clipdcb(), fg_drawdcb(), fg_flipdcb(), fg_getimage(), fg_getmap(), fg_invdcb(), fg_putdcb(), fg_revdcb()

Examples

Blend, TMcube, TMcubeX