image-fit

Specifies how InfoPrint adjusts an image to fit on the printed page.

GUI label

Image fit

DSS

PSF, Email

Type

Resettable, single-valued, per-document

Allowed Values

You can specify one of these fixed values:

Value Image formats
position-and-trim All image formats
scale-to-fit TIFF, GIF, and JPEG image formats

Default Value

No default value

Usage Guidelines

  • When the value of image-fit is position-and-trim, images larger than the page size are trimmed to fit on any sides that extend beyond the page boundary. For example, if the top left corner of the image is aligned with the top left corner of the logical page, the right side and bottom of the image are trimmed off.

    Use the x-image-shift, x-image-shift-back, y-image-shift, and y-image-shift-back attributes to adjust the positioning of the image on the page.

    Images smaller than the page size are not changed.

  • Images larger than the page size are reduced proportionately in both dimensions to fit. The whole image is preserved, but it is smaller than the original.

    Images smaller than the page size are not changed.

  • InfoPrint validates and schedules jobs using this attribute against the destination attribute image-fit-supported.