Shayton Equilibrium Kitchen Utensil 2003 User Manual

MediaScript Objects and Methods 59

•

c o l o r C o r r e c t ( )

Transforms an image from a source color space to a destination color space. MediaRich
supports ICC proﬁles for the following formats: EPS, JPEG, PDF, PS, PSD, and TIFF.

Specifying ICC profiles:

The sourceProﬁle and destProﬁle parameters may be speciﬁed either as a ﬁlename or as an
IccProﬁle object. By default, proﬁles are read from the “color:” ﬁle system which is deﬁned
by default as a combination of the MediaRich/Shared/Originals/Profiles
directory and the system color proﬁle directory if there is one. The
MediaRich/Shared/Originals/Profiles

directory is searched ﬁrst.

In addition, the special proﬁle names “rgb”, and “cmyk” may be used to designate the
default RGB and CMYK proﬁles speciﬁed in the global.properties ﬁle under the property
keys “ColorManager.DefaultRGBProfile” and
“ColorManager.DefaultCMYKProfile”, respectively. You can change these to
designate any default RGB or CMYK proﬁles you want.

NOTE:

If a Color Proﬁle is associated with an RGB image, this is considered unnecessary data and

by default the attached proﬁles will not be saved to RGB images.

The MediaRich server's local.properties ﬁle may be modiﬁed to change the default
proﬁle 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

- speciﬁes the destination proﬁle. After an image has been colorCorrected,

this proﬁle becomes the embedded proﬁle for the image. The default location for
destination proﬁles is: MediaRich/Shared/Originals/Profiles

NOTE:

You can modify the MediaRich server’s local.properties ﬁle to change the default Proﬁles

directory. See MediaRich Administrator’s Guide for more information.

sourceProfile

- speciﬁes the proﬁle to be used as the source for the color transformation

if the image has no embedded proﬁle or if the overrideEmbedded parameter is set to
true. Source proﬁles must also be located in the /Profiles directory. An ICC proﬁle
embedded in an image is used by default as the sourceProfile, unless the
overrideEmbedded

parameter is set to true.

intent

- speciﬁes 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 proﬁles.