image (PPTX)

A PowerPoint command that replaces the content of an image placeholder with a specified value. The value can be either a URL or a file. Once executed, the command updates the placeholder by displaying the new image provided in the value parameter. The command is added as the Alt Text of an image placeholder within the template.

Syntax:

dynamo image(value,lockWidth,lockHeight)

With required attributes only:

dynamo image(value)

Attributes

#1 - value
Required	Value type	EL-evaluated
Yes	String, File	Yes
Defines the image to be displayed instead of the image placeholder. The value can be provided as a URL in String format, or as a File.

#2 - lockWidth
Required	Value type	EL-evaluated
No	Boolean	No
Determines whether the image placeholder's width is locked. When `true`, the new image is automatically resized to match the placeholder's height. If `false`, the new image retains its original height.

#3 - lockHeight
Required	Value type	EL-evaluated
No	Boolean	No
Determines whether the image placeholder's height is locked. When `true`, the new image is automatically resized to match the placeholder's height. If `false`, the new image retains its original height.

Examples

In its basic use, dynamo image only requires its first attribute value to be defined.

CODE

dynamo image(coverImage)
dynamo image(companyLogo)

The second and third attribute lockWidth and lockHeight can be used to determine if the original size of the image is to be used or not. If the width and height are locked, the new image will resize to fit into the image placeholder, which can cause distortion if the aspect ratio is not the same.

CODE

dynamo image(coverImage,true)
dynamo image(coverImage,true,true)