ImageGear Professional for Linux
IG_cpm_profile_set
| ImageGear Professional > API Reference Guide > Core Component API Reference > Core Component Functions Reference > Color Profile Management Functions > IG_cpm_profile_set |
This function sets new value of color profile associated with color space given by nColorSpace parameter to profile group given by nProfileGroup parameter.
|
Copy Code
|
|
|---|---|
AT_ERRCODE LACCUAPI IG_cpm_profile_set(
AT_MODE nColorSpace,
DWORD nProfileGroup
LPAT_BYTE lpRawData,
DWORD dwRawSize,
AT_BOOL bConvert
);
|
|
| Name | Type | Description |
| nColorSpace | AT_MODE | IN: color space ID which profile to replace. Current supported values: IG_COLOR_SPACE_RGBIG_COLOR_SPACE_CMYK. |
| nProfileGroup | DWORD | IN: color profile group where to set profile. Possible values: IG_CP_GRP_WORKINGIG_CP_GRP_IMPORTIG_CP_GRP_EXPORTIG_CP_GRP_DISPLAY. |
| lpRawData | LPAT_BYTE | IN: raw data of new profile. Can be either NULL or pointer to memory buffer that contains valid color profile in format specified by ICC.1:1998-09. |
| dwRawSize | DWORD | IN: length of data stored in lpRawData. |
| bConvert | AT_BOOL | IN: if TRUE then this function converts all images associated with old profile to new profile, but if FALSE it simply replaces profile without any conversion. |
Return value is a code of last error or 0 if success.
This function does not process image pixels.
If the last parameter is set to TRUE, then all associated images with previous format are converted to new color profile. In the case that nColorSpace does not match the same color space that is used in color profile or color profile is in invalid or unsupported format, then error is returned.
Please note that color profile management is disabled by default. See Working with ImageGear Color Profile Manager for information about how to activate it.