Pictures

This feature works with ODT, ODS, ODP, ODG, XLSX, and DOCX files.

If an error occurs for some reasons (fetch failed, image type not supported), a replacement error image is used.

The place to insert the marker on the temporary picture may change depends on the file format:

  • ODS, ODP and ODG files: set the marker on the image title

  • ODT file: set the marker on the image alternative text, image description

  • DOCX and XLSX files: set the marker either on the image title, image description, or alternative text

Accepted images types: .jpeg, .png, and .gif. .svg are working only for ODS/ODT reports.

Images exceptions

  • it is not possible to create images loops in XLSX, ODS, and ODG files, it produces an invalid report

  • for ODP, it is not possible to create a loop of images inside a single slide, but it is possible to create images loops through 2 slides or more

Image anchor

The image anchor type changes the rendering behavior and particular cases are not valid.

On LibreOffice

To update the anchor type of an image on LibreOffice: Right-click the Image > Properties > Type > Anchor.

Anchor typePrint engine behavior

As character

Best choice: the replacement of a single image or a loop of images is possible.

To page To paragraph To character

The image is floating, it not possible to create a loop of images, only a single image replacement is accepted.

On Word

To update the position type of an image on Word: Double-left-click the Image > Picture Format tab > Position.

Position typePrint engine behavior

In line with text

Best choice: the replacement of a single image or a loop of images is possible.

With text wrapping

The image is floating, it not possible to create a loop of images, only a single image replacement is accepted.

imageFit formatter

This formatter works with ODT and DOCX files.

The imageFit formatter sets how the image should be resized to fit its container. An argument has to be passed to the formatter:

  • fillWidth : the replaced image is sized to fill the element’s content-box width

    • the aspect ratio does not change

  • contain: the replaced image is scaled to maintain its aspect ratio while fitting within the element’s content-box (the temporary image)

  • fill: the replaced image is sized to fill the element’s content-box (the temporary image)

    • the entire image will fill the box of the previous image

    • if the object's aspect ratio does not match the aspect ratio of its box, then the object will be stretched to fit

{d.image:imageFit(contain)}
// or
{d.image:imageFit(fill)}
// or
{d.image} // 'fillWidth' is set by default

Last updated