NAME

kcmstest_tiff − color-corrects a tiff image through KCMS

SYNOPSIS

kcmstest_tiff [ −o ][ −u ][ −c ][ −h ][ −g ][ −r ] in_profile out_profile in_tif out_tif

AVAILABILITY

SUNWkcspg

DESCRIPTION

kcmstest_tiff requires the names of the input (scanner usually) profile, the output (monitor usually) profile, the input image’s tiff file, and an output file name.  Takes the in_tif and color corrects the image using the combination of in_profile and out_profile. Currently only correction of 24-bit TIFF images is supported. 

Presumably the input image has been scanned using the scanner described by the input profile.  The output profile should describe the device on which the image is to be displayed (or printed).  Supply the path name to the input image tiff file and a name for the color-corrected output image to be stored in.  Use imagetool(1) or some other display program to view the tiff image on screen, or convert and send the image to a color printer using an appropriate tool. 

Various options are available for the user to try out, see below. 

OPTIONS

-o optimizes the combination of in_profile and out_profile before color correcting the image data. 

-c calls the callback function provided while processing proceeds (this will print callback information to the screen).  The callback functions during optimization of the profiles and evaluation of the image. 

-h hostname indicate that the profiles are located on another host machine and will search for them there.  The kcms_server(1) daemon must be running on the hostname machine. 

-g requests that evaluation of the image use the hint that this is a graphics image. 

-r connects the profiles in the reverse direction (i.e. to simulate a printer output on a monitor for instance). 

in_profile is the full path name of an input profile

out_profile is the full path name of an input profile

in_tif is the full path name of an input tiff image

out_tif is the file name in which to store the output tiff image

EXAMPLES

Example 1:

example% kcmstest_tiff ../profiles/kcmsEKmtk600zs.inp
../profiles/kcmsEKsunsony19.mon images/wales.tif testimage.tif

Use a Microtek scanner input profile, a Sun Sony 19inch display output profile, a sample tiff input image, and provide a testimage file name to store the resulting image in.  Messages appear as follows:

Reading image data
time difference = 0 secs 584728 usec
In profile = ../profiles/kcmsEKmtk600zs.inp,
Out Profile = ../profiles/kcmsEKsunsony19.mon
Evaluating image data
time difference = 2 secs 277112 usec

Example 2:

example% kcmstest_tiff -c -o ../profiles/kcmsEKmtk600zs.inp
../profiles/kcmsEKsunsony19.mon images/wales.tif testimage.tif

request optimization and callback information.  The messages appear as follows:

time difference = 0 secs 443615 usec
In profile = ../profiles/kcmsEKmtk600zs.inp,
Out Profile = ../profiles/kcmsEKsunsony19.mon
Optimizing the complete profile
time difference = 0 secs 137561 usec
Evaluating image data
Optimize+Evaluate is   4 percent completed
Optimize+Evaluate is   9 percent completed
Optimize+Evaluate is  13 percent completed
Optimize+Evaluate is  18 percent completed
Optimize+Evaluate is  22 percent completed
Optimize+Evaluate is  27 percent completed
Optimize+Evaluate is  31 percent completed
Optimize+Evaluate is  36 percent completed
Optimize+Evaluate is  40 percent completed
Optimize+Evaluate is  45 percent completed
Optimize+Evaluate is  50 percent completed
Optimize+Evaluate is  54 percent completed
Optimize+Evaluate is  59 percent completed
Optimize+Evaluate is  63 percent completed
Optimize+Evaluate is  68 percent completed
Optimize+Evaluate is  72 percent completed
Optimize+Evaluate is  77 percent completed
Optimize+Evaluate is  81 percent completed
Optimize+Evaluate is  86 percent completed
Optimize+Evaluate is  90 percent completed
Optimize+Evaluate is  95 percent completed
Optimize+Evaluate is 100 percent completed
time difference = 2 secs 374310 usec

ENVIRONMENT

KCS_PROFILES may be set to the path name of a directory containing personal profiles.  The library will search this directory if the environment variable exists. 

SEE ALSO

profile_demo(6),print_montbls(6),print_header(6), kcms_create(6),  kcms_update(6)

DIAGNOSTICS

kcmstest_tiff will display errors relating to profile existance and access.  Additional information is printed related to the amount of processing time. 

SunOS 5.5  —  Last change: 29 Sept 1994