test

KCMS Test Suite User's Guide

EVAL:

EVAL: Command Description

EVAL: functionality corresponds to the KcsEvaluate() call. When this command is interpreted, the KcsEvaluate() function is executed and the status is reported back from the kcmstest command display to the test log.

EVAL: Command Syntax Example

EVAL:Reference=forward; SourcePixLayout=RGBInterLeaved; DestPixLayout=RGBInterLeaved; Callbacks=; ImageIn=test; ImageOut=None; Operation=Forward;

EVAL: Keywords and Values

Table 3-5 presents the EVAL: command keywords and their descriptions.

Table 3-5 EVAL: Command Keywords

Keyword 

Description 

Reference=

Is the name that was assigned when the profiles were connected. 

SourcePixLayout=

Sets the pixel layout structure and, if necessary, restructures the input data. This keyword has one of the following values:

RGBInterLeaved (also called component- or pixel-interleaved)

RGBPlanar

RGBRowInterleaved (also called planar- or band-interleaved)

(For details on these values, see the description of the KcsPixelLayout structure in the SDK manual KCMS Application Developer's Guide)

DestPixLayout=

Sets the pixel layout structure. This keyword has one of the following values: 

RGBInterLeaved

RGBPlanar

RGBRowInterleaved

ImageIn=

Is the image file name that will be processed in the EVAL: command. The image file must be located in the kcmstest/images directory. Only images stored in the TIFF file format can be processed by kcmstest at this time.

ImageOut=

Is the image file name that will be output from the EVAL: command. The image file will be located in the kcmstest/images directory. Only TIFF image file format can be output by kcmstest at this time. In the event that no image output is required, specify None for the image name. Note that TIFF files can use up your disk space very quickly. Be sure to remove them after inspection. Specify NULL if you do not want to save the output image.

Operation=

Defines the operation load hint that will be used to evaluate the data. This keyword has the operation and content hint values listed inTable 3-6. In the table, the keyword value is followed by the corresponding value set in the Operations parameter passed to the KcsEvaluate() function. Only one direction and one content operation hint can appear in a single EVAL: script command, and the complete profile that is evaluated must include the matching operation hint (transform). If, for example, you connect profiles requesting the Reverse operation, and you evaluate the resulting profile requesting the Forward operation, you will get an error.

Callbacks=

Causes kcmstest to perform a KcsSetCallback() call. Callbacks are registered in the log file.

XStatus=

The default expected status is KcsSuccess. If the script command is expected to complete successfully, the XStatus= keyword is not required. In cases where a script command is expected to return a non-success status, the keyword is followed by the corresponding expected, non-success status in hexadecimal format.

Table 3-6 presents the acceptable values for the EVAL: command Operation= keyword.

Table 3-6 EVAL: Command Operation= Keyword Values

Value 

Value Set 

Forward;

KcsOpForward

Reverse;

KcsOpReverse

Simulate;

KcsOpSimilate

Gamut;

KcsOpGamutTest 

ContUnkn;

KcsContUnknown

Graphics;

KcsContGraphics

Image;

KcsContImage

ColorMtrc;

KcsContColorimetric

Note -

The EVAL: command also produces pixel evaluation speeds, in terms of 24-bit pixels per second, for the log file.