Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Setting Video Destinations

VDPreflightGlobalRect

You can use the VDPreflightGlobalRect function in your application to verify that a video digitizer component can support a set of destination settings intended for use with the VDSetPlayThruGlobalRect function (described in the previous section).

pascal VideoDigitizerError VDPreflightGlobalRect 
                                    (VideoDigitizerComponent ci, 
                                       GrafPtr theWindow, 
                                       Rect *globalRect);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

theWindow

Contains a pointer to the destination window.

globalRect

Contains a pointer to a rectangle that specifies the size and location of the video destination. This rectangle must be in the coordinate system of the destination window specified by the theWindow parameter. If the video digitizer component cannot accommodate this rectangle, it changes the coordinates in the structure to specify a rectangle that it can support and sets the result to qtParamErr.

DESCRIPTION

The application provides the desired settings as parameters to this function. The video digitizer component then examines those settings. If the digitizer component can support the specified settings, it sets the result code to noErr. If the digitizer component cannot support the settings, it alters the input settings to reflect values that it can support and returns a result code of qtParamErr.

Applications should use this function to determine whether a video digitizer supports placing destination video into a rectangle that crosses screens. Digitizers that do not support this capability return a result of digiUnimpErr.

RESULT CODES

noErr	0	No error
digiUnimpErr	-2201	Function not supported
qtParamErr	-2202	Invalid parameter value