capPaletteAuto macro (vfw.h)

The capPaletteAuto macro requests that the capture driver sample video frames and automatically create a new palette. You can use this macro or explicitly call the WM_CAP_PAL_AUTOCREATE message.

Syntax

BOOL capPaletteAuto(
     hwnd,
     iFrames,
     iColors
);

Parameters

hwnd

Handle to a capture window.

iFrames

Number of frames to sample.

iColors

Number of colors in the palette. The maximum value for this parameter is 256.

Return value

Type: BOOL

Returns TRUE if successful or FALSE otherwise.If an error occurs and an error callback function is set using the capSetCallbackOnError macro, the error callback function is called.

Remarks

The sampled video sequence should include all the colors you want in the palette. To obtain the best palette, you might have to sample the whole sequence rather than a portion of it.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	vfw.h

See also

Video Capture

Video Capture Macros