The Encodian population engine supports image insertion using the following two methods:
Please ensure you have followed the Document Preparation steps, please also review the Image Formatting options.
Slide Preparation
When using the image token you must add the token inside a shape, please follow this instruction:
Insert Image - Hyperlink
The URL must be publicly accessible, if the URL requires authentication the image cannot be accessed and therefore would not be inserted.
Example File: Encodian - Template Syntax - Image - Hyperlink.pptx
Example JSON Data:
{
"imageUrl": "https://cdn.apps-encodian.com/logos/enc-small-logo.png"
}
The image token requires a single parameter, the URL value, see below:
<<image [imageUrl]>>
This generates the following output:
Clearly, this doesn't look great! This has happened as by default the image will be constrained to the size of the shape containing the token.
To address this issue either increase the size of the shape or use the 'fitSize' switch to dynamically alter the size of the shape aligned to the size of the image as explained in the Image Formatting section of this article.
<<image [imageUrl] -fitSize>>
This generates the following output:
Insert Image - Base64
Example File: Encodian - Template Syntax - Image - Base64.pptx
Example JSON Data:
{
"imageBase64": "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"
}
The image token requires a single parameter, the Base64 value, see below:
<<image [imageBase64]>>
This generates the following output:
Clearly, this doesn't look great! This has happened as by default the image will be constrained to the size of the shape containing the token.
To address this issue either increase the size of the shape or use the 'fitSize' switch to dynamically alter the size of the shape aligned to the size of the image as explained in the Image Formatting section of this article.
<<image [imageUrl] -fitSize>>
This generates the following output:
Image Formatting
The image token requires a single parameter, the URL value, see below:
<<image [imageUrl]>>
Additionally, the following switches can be added to control how the image is formatted once inserted into the text box within the document:
The -keepRatio preserves the size of the textbox and stretches the image within bounds of the shape preserving the ratio of the image.
<<image [imageUrl] -keepRatio>>
The -fitHeight preserves the width of the textbox but changes its height according to the ratio of the image.
<<image [imageUrl] -fitHeight>>
The -fitWidth preserves the height of the textbox but changes its width according to the ratio of the image.
<<image [imageUrl] -fitWidth>>
The -fitSize changes the size of the textbox according to the size of the image.
<<image [imageUrl] -fitSize>>
The -fitSizeLim changes the size of the textbox according to the size of the image without increasing the size of the textbox.
<<image [imageUrl] -fitSizeLim>>
0 Comments