Image

Functional reference for ImageObject, including its runtime role and the supported settings available in the design environment.

Updated 6 min read
On this page (9 sections)
  1. Functional explanation
  2. Object name
  3. Settings
  4. Position / Size
  5. Actions
  6. Animate Position / Size
  7. Rotation
  8. Access Control
  9. Visibility

Functional explanation

ImageObject displays an image source, typically static or dynamically generated content. It is useful for logos, background graphics, and image-based symbols.

The object is best when the source is a raster image or a stored image payload and the design does not require vector styling. It can be used as a decorative element, a brand mark, or a process illustration.

Prefer SVGObject when the graphic must scale cleanly or needs dynamic fill and stroke styling.

Object name

Set the object name shown in the image decorator context.

SettingDescriptionExampleUnits
Object NameName used to identify the Image object.CompanyLogoText

Settings

Configure the image source and background behavior.

SettingDescriptionExampleUnits
Is BackgroundIndicates that the object is used as a background element.falseBoolean
Image SourceEmbedded base64 image source.data:image/png;base64,...Data URL

Position / Size

Configure the position and size of the Image object.

SettingDescriptionExampleUnits
TopTop position of the object.100px
LeftLeft position of the object.220px
WidthWidth of the object.120px
HeightHeight of the object.80px
Z-indexLayer order of the object. Higher values appear in front of lower values.10Number

Actions

Configure the action list executed when the image is clicked. See the Actions article for every available action type and its settings.

SettingDescriptionExampleUnits
ActionsAction list executed when the image is clicked.Navigate To, open URLAction configuration

Animate Position / Size

Configure the runtime animation settings for height, width, top, and left of the Image object.

22 rows
SettingDescriptionExampleUnits
Animate Height VariableVariable or expression that drives runtime height animation.PLC1.LevelVariable or expression
Animate Height Minimum RawStart of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value.0Raw value
Animate Height Maximum RawEnd of the raw value span. The animated height reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw.100Raw value
Animate Height Minimum pxStart of the pixel span. The animated height runs from 0 px up to the difference between Maximum px and Minimum px.20px
Animate Height Maximum pxEnd of the pixel span. With Minimum px at 0, this is the height at full scale.60px
Animate Height ReverseSets the edge the height grows from. Cleared grows the object upwards from the bottom edge, which suits level and fill graphics. Selected grows it downwards from the top edge.falseBoolean
Animate Width VariableVariable or expression that drives runtime width animation.PLC1.ValueVariable or expression
Animate Width Minimum RawStart of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value.0Raw value
Animate Width Maximum RawEnd of the raw value span. The animated width reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw.100Raw value
Animate Width Minimum pxStart of the pixel span. The animated width runs from 0 px up to the difference between Maximum px and Minimum px.80px
Animate Width Maximum pxEnd of the pixel span. With Minimum px at 0, this is the width at full scale.220px
Animate Width ReverseSets the edge the width grows from. Cleared grows the object to the right from the left edge. Selected grows it to the left from the right edge.falseBoolean
Animate Top VariableVariable or expression that drives runtime top-position animation.PLC1.PositionTopVariable or expression
Animate Top Minimum RawStart of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value.0Raw value
Animate Top Maximum RawEnd of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw.100Raw value
Animate Top Minimum pxStart of the pixel span. A rising value moves the object upwards from its resting position by up to the difference between Maximum px and Minimum px. To move the object downwards, set Minimum px above Maximum px.100px
Animate Top Maximum pxEnd of the pixel span. A rising value moves the object upwards by up to the difference between Maximum px and Minimum px.260px
Animate Left VariableVariable or expression that drives runtime left-position animation.PLC1.PositionLeftVariable or expression
Animate Left Minimum RawStart of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value.0Raw value
Animate Left Maximum RawEnd of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw.100Raw value
Animate Left Minimum pxStart of the pixel span. A rising value moves the object to the right from its resting position by up to the difference between Maximum px and Minimum px. To move the object to the left, set Minimum px above Maximum px.200px
Animate Left Maximum pxEnd of the pixel span. A rising value moves the object to the right by up to the difference between Maximum px and Minimum px.420px

Rotation

Configure the rotation of the image object. The fixed Rotation angle and the free-running rotation are independent and can be combined: the object is first turned to its fixed angle and then keeps turning from there.

Free-running rotation is applied in runtime. In the design environment the object stays still so that it can be selected, moved, and resized.

SettingDescriptionExampleUnits
RotationFixed rotation angle applied to the object. Accepts a value, a variable, or an expression.45Degrees
Transform OriginPoint the object rotates around. Left empty the object turns around its own centre.centerCSS transform origin
Rotate ContinuouslyTurns free-running rotation on while the value resolves to true, which is how a running fan, pump, agitator, or mixer is shown. Accepts true or false, a variable, or an expression, so the movement can follow a run feedback.PLC1.Fan1_RunningExpression
Rotation SpeedSpeed of the free-running rotation in degrees per second, so a larger value turns faster. Accepts a value, a variable, or an expression, which lets the symbol turn at the speed the device reports. A negative value turns the other way.90Degrees per second
Rotation DirectionDirection of the free-running rotation. Accepts a value, a variable, or an expression, so it can follow the direction the drive reports: a positive value turns clockwise and a negative value turns counter clockwise. Clockwise and Counter Clockwise are accepted as text, and a true or false value is read as a reverse signal, where true turns counter clockwise. Leave empty to turn clockwise. Often not needed, because a Rotation Speed that can go negative already sets the direction.-1Signed value

Access Control

Configure access control for the Image object.

SettingDescriptionExampleUnits
Access Control EnableEnables access control evaluation for the object.trueBoolean
Access ControlExpression controlling who can use or see the object.SYSTEM.UserGroups == "Operators"Expression
Access Control FilterCSS filter applied when access control is used to alter the object appearance.blur(0px) contrast(30%)CSS filter

Visibility

Configure the runtime visibility and blinking behavior for the Image object.

SettingDescriptionExampleUnits
VisibilityExpression controlling whether the object is visible.PLC1.ImageVisibleExpression
BlinkExpression or boolean controlling image blinking.PLC1.AlarmActiveBoolean or expression
Blink SpeedBlink speed used during runtime.500ms
Blink OffsetBlink offset used to stagger blinking between objects.falseBoolean
Something missing or wrong in this article? Contact us