On line guide/help
You are on page 23 of the online help. Navigate sequentially through the guide pages or search for a topic of interest to you.
Index Prev. NextImage
Print an image
Print an image using a graphics file. The supported graphic formats are the most common ones such as: BMP, GIF, JPEG, PNG, SVG
Parameters
Elements / attributes of the <image> element:
<file> (string, required) Image file name, with path. Placeholders are supported, eg. ./images/{product.code}.png. Supported formats: PNG, GIF, JPG / JPEG, BMP, SVG (the format is taken from the file extension).
Coordinate parameters (required) that define the print area of the picture:
<x1> (or <x>) (numeric, float) X coordinate of the upper left corner of the image area
<y1> (or <y>) (numeric, float) Y coordinate of the upper left corner of the image area
<x2> (numeric, float) X coordinate of the bottom right corner of the image area
<y2> (numeric, float) Y coordinate of the bottom right corner of the image area
Instead of x2 and y2, the size of the image area can be set (one of the two methods is required):
<width> (numeric, float) Width of the image area
<height> (numeric, float) Height of the image area
Other parameters:
<align> (string) Position of the cursor after the image: T top-right, M middle-right, B bottom-right, N next line. Usually it is not needed.
<palign> (string, SVG images only) Alignment of the image on the current line: L left, C center, R right
<border> (SVG images only) Border around the image: 0 no border (default), 1 frame
Extra optional parameters:
<printif> Optional expression: the element is printed only if the expression is true, eg. {doc.type}=1. See the Conditional printing page.
Example
Images loaded from files. The file name can contain placeholders.
Image examples