MediaScript Objects and Methods 59
•
•
•
•
colorCorrect()
Transforms an image from a source color space to a destination color space. MediaRich
supports ICC profiles for the following formats: EPS, JPEG, PDF, PS, PSD, and TIFF.
Specifying ICC profiles:
The sourceProfile and destProfile parameters may be specified either as a filename or as an
IccProfile object. By default, profiles are read from the “color:” file system which is defined
by default as a combination of the MediaRich/Shared/Originals/Profiles
directory and the system color profile directory if there is one. The
MediaRich/Shared/Originals/Profiles directory is searched first.
In addition, the special profile names “rgb”, and “cmyk” may be used to designate the
default RGB and CMYK profiles specified in the global.properties file under the property
keys “ColorManager.DefaultRGBProfile” and
“ColorManager.DefaultCMYKProfile”, respectively. You can change these to
designate any default RGB or CMYK profiles you want.
NOTE: If a Color Profile is associated with an RGB image, this is considered unnecessary data and
by default the attached profiles will not be saved to RGB images.
The MediaRich server's local.properties file may be modified to change the default
profile directory. See the MediaRich Administrator’s Guide for more information.
Syntax
colorCorrect(
destProfile @ <"filename.icc">
[sourceProfile @ <"filename.icc">]
[intent @ <"rendering intent">
[overrideEmbedded @ <true, false>
);
Parameters
destProfile - specifies the destination profile. After an image has been colorCorrected,
this profile becomes the embedded profile for the image. The default location for
destination profiles is: MediaRich/Shared/Originals/Profiles
NOTE: You can modify the MediaRich server’s local.properties file to change the default Profiles
directory. See MediaRich Administrator’s Guide for more information.
sourceProfile - specifies the profile to be used as the source for the color transformation
if the image has no embedded profile or if the overrideEmbedded parameter is set to
true. Source profiles must also be located in the /Profiles directory. An ICC profile
embedded in an image is used by default as the sourceProfile, unless the
overrideEmbedded parameter is set to true.
intent - specifies how the transformation from source to destination color space is
effected. The possible values for intent are:
•
“Perceptual” - the default intent and works best with photographic images.
•
“RelativeColorimetric” - corrects the image using the relative white points of the
source and destination ICC profiles.
