AllocVideoBuffer

Allocate a video overlay buffer of specific dimensions and pixel format.

Declaration

GA_buf * NAPI GA_videoFuncs::AllocVideoBuffer(
    N_int32 width,
    N_int32 height,
    N_int32 format)

Prototype In

snap/graphics.h

Parameters

width

Width of the video overlay window in pixels

height

Height of the video overlay window in pixels

format

Pixel format for the input data (GA_VideoBufferFormatsType)

 

Return Value

Pointer to allocated video overlay buffer, NULL on failure.

Description

This function allocates a hardware video overlay buffer in offscreen video memory with the given dimensions and pixel format. The video overlay window dimensions are used by the driver to determine the stretch factor required to interpolate the input video data to the video output window on the display screen. The format parameter is used to determine the pixel format of the input bitmap data stored in offscreen video memory by the application. The video input formats flags supported are defined by GA_VideoBufferFormatsType. The calling application should check the VideoWindows member of the GA_modeInfo structure for the hardware video overlay window capabilities of the graphics hardware for a specific display mode. This function will fail if the application requests an unssupported format or if the requested features are not available for the device installed in the machine. This function will also fail if the maximum number of video overlay buffers supported by the hardware have already been allocated.

See Also

AllocVideoBuffer, FreeVideoBuffer, SetVideoOutput, SetVideoColorKey, StartVideoFrame, EndVideoFrame

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com