CMSTAG(1) CMS CMSTAG(1)
NAME
cmstag - associate an ICC device profile with one or more image files
SYNOPSIS
cmstag [ -f | -n] [ -s source_profile ]
[ -o out_file ] image_files
DESCRIPTION
cmstag associates an International Color Consortium (ICC) profile with
one or more image files. The image files need not all be in the same
format. There are two possible ways to associate the profile with the
image(s). By default, or if the -f flag is set, the full ICC profile
will be embedded as a tag in the image file(s). If the -n flag is set,
then only the name of the file will be embedded. This approach is only
useful if the image file and profile are guaranteed to always reside on
the same machine. All files specified will be tagged with the same
profile.
Command Line Options
cmstag supports the following command line options:
-s source_profile
Specifies the (source) profile to associate with the image(s).
If a path name is provided, that is where the profile will be
looked for. Otherwise, the profile will be looked for in the
default profile directory: /usr/share/cms/profiles. If this
option is not set, the user's CMS_SETTING_RGB profile will be
used. If that is not set, an error will result.
-f Requires that the full ICC profile be embedded in the image
file(s). This option is mutually exclusive with the -n option.
-n Requires that only the name of the ICC profile be embedded in
the image file(s). This option is mutually exclusive with the
-s option.
-o out_file
If only one file is being tagged, an output file may be
specied. The tagged image will be stored in out_file. If more
than one image is being tagged, an error results.
imagefiles
One or more files to be "tagged" with the ICC profile. All
image files will be tagged with the same profile in the same
way.
ERRORS
cmstag tags each image file separately. An error in processing one file
ususally does not prevent the processing of other files.
Page 1
CMSTAG(1) CMS CMSTAG(1)
The following are error conditions:
⊕ the specified image file can not be opened for reading;
⊕ the specified image file can not be opened for writing;
⊕ the specified image file is not in a supported image file format.
Supported formats are: SGI image file, TIFF, JPEG/JFIF, and GIF.
⊕ the specified source profile can not be found, or is not an ICC
profile.
FILES
/usr/share/cms/profiles directory in which system device profiles are
stored
Page 2