List of Video Color Check Utilities

3DS Max Plug-In SDK

List of Video Color Check Utilities

These functions may be used to correct a pixel with RGB values that will give "unsafe" values of chrominance signal or composite signal amplitude when encoded into an NTSC or PAL color signal. This happens for certain high-intensity high-saturation colors that are rare in real scenes, but can easily be present in computer generated images.

Prototype:

void BuildHotTable(int video_type = VID_NTSC);

Remarks:

Implemented by the System.

A developer will never to need to call this method. It is maintained by MAX. The table that is stored depends only on the state of the NTSC/PAL switch and 3ds max updates it whenever this switch is changed, and on startup.

Parameters:

int video_type = VID_NTSC

The type of color checking to perform. One of the following values:

VID_NTSC

VID_PAL

Prototype:

int HotLimit(Color48 *thepix, int method = HOT_SCALE_LUM);

Remarks:

Implemented by the System.

This method is called to perform the video color check for each pixel.

Parameters:

Color48 *thepix

The pixel to check and correct if necessary.

int method = HOT_SCALE_LUM

One of the following values:

HOT_FLAG

Flag the pixel as black.

HOT_SCALE_LUM

Correct by scaling the luminance.

HOT_SCALE_SAT

Correct by scaling the saturation.

Return Value:

Nonzero if the color was corrected; otherwise if no problems then zero.