Image
Includes an external Graphic. Allowed graphic formats are PDF (.pdf), PNG (.png) and JPEG (.jpg). See below for a limitation on the number of included PDF files.
Allowed attributes: class, clip, dpiwarn, fallback, file, height, href, id, maxheight, maxsize, maxwidth, minheight, minwidth, naturalsize, padding-bottom, padding-left, padding-right, padding-top, page, rotate, width
Child elements: (none)
Parent elements: B, Case, Color, Fontface, ForAll, Frame, I, Loop, NoBreak, Otherwise, Overlay, Paragraph, PlaceObject, Position, Td, Transformation, U, URL, Until, While
CSS class for this element.
When yes, the image keeps its apsect ratio if both width and hight is given. To be able to fit the image into the given dimensions, the image gets clipped.
yes: |
Keep the aspect ratio and cut off left/right or top/bottom edges. |
no: |
Distort the image to make it fit in the given area. |
Warn if the image gets lower resultion than given.
The filename of the replacement image if the file is not found. If none given, a red 'file not found' image will gets displayed.
Filename of the image. Can be a file in the search path or a file-URI for absolute paths (e.g. file:///path/to/image.pdf).
Image height. One of 'auto' (default, take image width), length (such as '3cm') or number (in grid cells).
An URL (http:// or file:) of the image. If external, it will be downloaded and cached in TEMPDIR/sp/images (which can be configured by setting the configuration file key imagecache). Alternative to ›file‹. When file: is used as a protocol, it can be a relative path. If no protocol is given, file: is assumed.
CSS id for this element.
The maximum height of the image. Only used when clip="no". Value is a number (grid cells) or a length.
The PDF box that represents the maximum width. Default is “cropbox”.
The maximum width of the image. Only used when clip="no". Value is a number (grid cells), a length or the value »100%« for full width image.
The minimum height of the image. Only used when clip="no". Value is a number (grid cells) or a length.
The nimimum width of the image. Only used when clip="no". Value is a number (grid cells), a length or the value »100%« for full width image.
The PDF box that represents the visible area. Default is “cropbox”.
Set the inner distance (width between contents and the border) to the bottom edge.
Set the inner distance (width between contents and the border) to the left edge.
Set the inner distance (width between contents and the border) to the right edge.
Set the inner distance (width between contents and the border) to the top edge.
The page number from the PDF. Default is 1 (include the first page).
Rotate the image in steps of 90°. The amount of movement is defined by the specified angle; if positive, the movement will be clockwise, if negative, it will be counter-clockwise.
Image width. One of 'auto' (default, take image width), '100%' (whole area width), length (such as '3cm') or number (in grid cells).
The values of the attributes naturalsize and maxsize can be ‘artbox’, ‘bleedbox’, ‘cropbox’, ‘mediabox’ and ‘trimbox’. These two values are used to enlarge the image for the bleed. In the second example below the designated view port of the image is defined in the artbox, but the image has a larger area (the cropbox) that is used for bleeding.
<Record element="productdata"> <PlaceObject column="{ $column }"> <Image width="10" file="{ string(.) }"/> </PlaceObject> </Record>
Takes the file name of the image from the contents of the current element in the data file (here: productdata). Sample data XML:
<productdata>image.pdf</productdata>
The number of pages in a PDF file can be determined with the XPath function sd:number-of-pages(
Attention. The number of PDF files that can be included in a document is limited. This limit can be increased in is system dependant. On Mac OS X it can be queried with ulimit -a and set for example with ulimit -n 1024.