This function converts a single pixel to new color space and channel depths.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_IP_pixel_format_convert(
HIGPIXEL hPixel,
enumIGColorSpaceIDs SrcColorSpace,
const AT_INT* SrcChannelDepths,
AT_RGBQUAD* SrcPalette,
enumIGColorSpaceIDs DstColorSpace,
AT_INT DstChannelCount,
const AT_INT* DstChannelDepths,
AT_RGBQUAD* DstPalette
);
|
|
Arguments:
| Name | Type | Description |
| hPixel | HIGPIXEL | Pixel to convert to the new format. |
| SrcColorSpace | enumIGColorSpaceIDs | Source color space of the pixel. |
| SrcChannelDepths | const AT_INT* | Source channel depths of the pixel. Length of the array should be equal to number of channels used by the hPixel. |
| SrcPalette | AT_RGBQUAD* | Source palette used by the pixel, if its color space is Indexed, or null otherwise. |
| DstColorSpace | enumIGColorSpaceIDs | Color space to which to convert the pixel. |
| DstChannelCount | AT_INT | Number of channels for the pixel after conversion. |
| DstChannelDepths | const AT_INT* | New channel depths for the pixel. Length of the array should correspond to the dstColorSpace parameter. |
| DstPalette | AT_RGBQUAD* | Destination palette for the pixel, if destination color space is Indexed, or null otherwise. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call.
Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
Remarks:
Please note that using this function in a cycle for large array of pixels could be inefficient. Consider creating a temporary HIGEAR and converting its color space and channel depths in this case.