VDGetCLUTInUse
The VDGetCLUTInUse function allows an application to obtain the color lookup table used by a video digitizer component. By using the Palette Manager, the application can then set the destination so that it uses the same lookup table.
pascal VideoDigitizerError VDGetCLUTInUse
(VideoDigitizerComponent ci,
CTabHandle *colorTableHandle);
ci
- Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's
OpenComponent function.
colorTableHandle
- Contains a pointer to a field that is to receive a color table handle. The video digitizer component returns a handle to its color lookup table. Applications can then set the destination to use this returned color table. Your application is responsible for disposing of this handle.
DESCRIPTION
In general, applications use this function only when a video digitizer component does not allow applications to specify lookup tables with the VDUseThisCLUT function. Applications can determine whether a digitizer component supports specified lookup tables by examining the component's output capability flags. Specifically, if the digiOutDoesILUT flag is set to 1, the digitizer component allows applications to specify color lookup tables. Applications can use the VDGetCurrentFlags function (described on page 8-25) to obtain the input capability flags of a component.
RESULT CODES
| noErr | 0 | No error |
| memFullErr | -108 | Not enough room in heap zone |
| digiUnimpErr | -2201 | Function not supported |
