An image to draw on the page, either on its own, which controls indentation for subsequent elements:
<Output>
<Image ... />
</Outputor as a line element:
<Output>
<Line ... >
<Image ... />
<Line/>
</Output
After a valid (standalone) image specification,
subsequent Line nodes and
HorizontalLine nodes are indented
by the image width in the same
<Output> node,
or until an <ImageEnd>
node is encountered in that
<Output> node.
Note that Expressions in attribute
settings below depend on the parent node context.
Some may only use constant expressions or query column
references from Independent queries.
Child nodes of <Output> nodes in
<Report> context may also
use report query column references.
The file name of the image.
<Image value="'filename.jpg'" />
Default is unset. It makes the
Image not shown.
The image may be suppressed.
<Image value="'filename.jpg'"
suppress="yes" />
Default is false,
i.e. no suppression.
Accepted for RLIB compatibility.
<Image value="'filename.jpg'"
type="'jpg'" />
Default is unset, i.e. autodetect.
Various image formats are supported
with autodetection via gdk-pixbuf.
SVG (Scalable Vector Graphics) is supported
via librsvg.
Image width, measured in points regardless of the Size unit attribute.
<Image value="'filename.jpg'"
width="100" />
Default is unset. The image would not be shown, unless both width and height are set.
When the image is used as a line element, this setting is ignored. Instead, the image is automatically scaled according to the line height.
Image height, measured in points regardless of the Size unit attribute.
<Image value="'filename.jpg'"
height="100" />
Default is unset. The image would not be shown, unless both width and height are set.
When the image is used as a line element, this setting is ignored. Instead, the image is automatically scaled according to the line height.
When the image is used as a line element, this
is the width in which the image is shown.
Its unit is subject to the Size unit attribute,
by default it's measured in text character
width for the parent <Line>.
This setting is only used when the image is a
line element. Two variants are accepted:
<Image value="'filename.jpg'"
text_width="8" />
<Image value="'filename.jpg'"
textWidth="8" />
Default is 0. As a result, the image would be 0 points wide, i.e. not shown.
This setting is ignored when the image is used as an output subsection.
Image background color. When the image is a line element, then the width in which it's shown may be wider than the scaled image width. Or possibly, the image is vector graphics (SVG) and there is no background defined in the image file. Or the image file contains transparency (i.e. PNG). The color background will be shown around the image or where there are transparent pixels.
<Image value="'filename.jpg'"
bgcolor="'red'" />
Default is unset, i.e. white.
Image alignment. When the image is a line
element, then the width in which it's shown may
be wider than the scaled image width. The image
then may be aligned. left,
right and center
are accepted.
<Image value="'filename.jpg'"
align="'center'" />
Default is left alignment.
This setting is ignored when the image is used as an output subsection.