Syntax
Document.ConvertColor ( CameraType, ScaleR, ScaleG, ScaleB, XOffset, YOffset [, BgdR, BgdG, BgdB ])
Parameters
ColorCameraType CameraType - type of camera which acquired the image being converted
mxLISAA (0) : Apogee one-shot color cameras, the Starlight Xpress SXV-H9, and other cameras using the SONY ICX285AQ, ICX084AK, and similar sensors
mxMX5C (1) : Starlight XPress MX5C
mxMX7CFast (2) : Starlight XPress MX7C operated in "fast" mode
mxMX7CInterlaced (3) : Starlight XPress MX7C operated in "interlaced" mode
mxMeadeDSI (4) : Meade Deep Sky Imager
mxRGGBHighQual (5) : Same as mxLISAA, but uses the high-quality algorithm
mxSSDSI1 (6) : Orion StarShoot Deep Space Imager 1
mxSSDSI2 (7) : Orion StarShoot Deep Space Imager 2
Float ScaleR - scale factor to be applied to Red plane, in percent
Float ScaleG - scale factor to be applied to Green plane, in percent
Float ScaleB - scale factor to be applied to Blue plane, in percent
Boolean XOffset - X-axis offset flag (may be required by some cameras)
Boolean YOffset - Y-axis offset flag (may be required by some cameras)
Float BgdR - [optional] background level in Red channel
Float BgdG - [optional] background level in Green channel
Float BgdB - [optional] background level in Blue channel
Returns
Nothing
Remarks
Converts a raw (monochrome) image taken by a "one-shot" color camera into a color image. One-shot cameras have an internal mask of pixel-sized filters of alternating colors as part of the CCD sensor; this method is used to convert the color information image into the standard RGB color plane format. The parameter CameraType must be set to indicate the type of camera that produced the image, and, in the case of the MX7C, the mode in which it was operating.
The three parameters ScaleR, ScaleG, and ScaleB are used to compensate for differing sensitivities in the three color bands. The nominal value for each is 100.0; adjust these if necessary to correct any consistent color cast in your camera's images. The XOffset and YOffset flags correct for possible misalignment of the camera's filter mask and may also have to be experimented with to achieve correct color rendition for your camera.
In most cases, the background level parameters BgdR, BgdG, and BgdB can be omitted, in which case MaxIm DL will determine their proper values automatically. Supplying values for these will suppress the automatic computation.
This method is equivalent to the Convert Color command.