PictureEffects REALbasic Plugin

NTSCColorFilter Method

To make the picture compatible with NTSC devices then use the NTSCColorFilter function. NTSC devices have a reduced ability to display hot colors, and this filter adjust those colors as needed.

NTSCColorFilter(
   p as Picture,
   mask as Picture,
   progress as IProgressHandler) as Picture

Parameters

p
The source picture to work with (can be 24 or 32 bits).
mask
To limit the filtering to certain pixels then set a picture defining the mask to this parameter. Pass nil to this parameter if the filtering should not be limited to certain pixels.

The mask picture must be a 32 bit picture and must be same size as the src picture. If the mask picture is not 32 bits and same size as the src picture then the function will fail and leave the result picture unchanged.
progress
Use this parameter to use a progress class to get progress feedback from this function. This class must be a class that Implements the IProgressHandler Interface which is defined in this plugin.

Pass nil to this parameter if you don't need progress feedback.

Progress feedback will slow the filter down.

Returns

Picture
If the filter was successful: A reference to the modified picture.

If the src picture was not 32 bits or 24 bits then a nil will be returned.

Remarks

Supported Platforms:

  • MacOS X PPC - (Mach-O)
  • MacOS X Universal Binary (Mach-O)
  • Win32 - Windows
  • Linux x86

    Unsupported Platforms:

    See Also

    GlobalMethods Global