Image configuration objects

An image configuration object contains various printer characteristics that the image print transform function and the Convert Image API use when creating output. An image configuration object is a list of characteristics that are supported by the printer it represents, acting as a template that guides the transform process. Each image configuration object has values for the following:

Data stream format
Photometric interpretation
Resolution units
Horizontal resolution
Vertical resolution
Compression type
Bits per sample
No-print borders (left, right, top, bottom)

All of these fields can be overridden by using the Convert Image API and specifying a value for the field of the same name.

See the Convert Image (QIMGCVTI, QimgCvtImg) API in the Programming topic collection for a list of image configuration objects.

Output attributes

The following output attributes are derived from the image configuration object:

Data stream format
Photometric interpretation
Resolution units
Horizontal resolution
Vertical resolution
Compression type
Bits per sample
No print borders (left, right, top, bottom)

Note:

If any of the above attributes are specified in the user-defined data attribute of the spooled file with the Convert Image API, then only those attributes that are not specified will be derived from the image configuration object.

The output paper size attribute is derived from the printer device description if the output data stream format is AFP data stream and the printer is an IPDS™ printer that has AFP(*YES) specified in the configuration.

The Paper Size attribute is derived from the printer file (spooled file attributes) if the output data stream format is not AFP data stream and the printer is not an IPDS printer that has AFP(*YES) specified in the configuration.