fg_getdacs()

Win32 DirectX Fastgraph/Light

Prototype

void fg_getdacs (int start, int count, void *values);

Sub fg_getdacs (ByVal start As Long, ByVal count As Long, values() As Any)

procedure fg_getdacs (start, count : integer; var values);

Description

The fg_getdacs() function retrieves the red, green, and blue color components of a consecutive group of colors in the active logical palette or virtual palette. Retrieving many colors with fg_getdacs() is faster than doing so individually with fg_getrgb().

Parameters

start is the starting color number, between 0 and 255.

count is the number of consecutive colors to retrieve, between 1 and 256. The sum of start and count cannot exceed 256.

values is the name of the array that will receive the color components. The first three bytes of this array receive the red, green, and blue components for color start, the next three bytes receive the components for color start+1, and so forth. Each color component is a value between 0 and 255; increasing values produce more intense colors. The size of the values array must be at least 3*count bytes.

Return value

none

Restrictions

Before calling fg_getdacs(), a logical palette must be defined and realized.

See also

fg_getrgb(), fg_realize(), fg_setdacs()

Examples

Fade