Size Dynamic Properties for 2D

The ClosedSize buttonDynamics toolbar:
Dynamics ribbon:
 in the ClosedDimensions section  of the 2D Dynamics ribbon and on the ClosedDynamics toolbarUse the buttons on this toolbar to create, modify, copy, and delete dynamic objects and actions.
 on the Dynamics tab, allows you to define an object that changes size based on the real-time value of its connected data point. The object automatically sizes to scale for incoming data points, such that a 100 percent scale equals the full size of the drawn object. During runtime mode, the Size connection re-sizes the object in proportion to the percentage of the high and low ranges of the connected data point. You can override the size by defining range override values.

Below are the properties for the 2D Size dynamic. (For 3D Size dynamic properties, refer to Size Dynamic Properties for 3D.) Common properties such as Name, Description, Tooltips and other common features that appear for common objects have been omitted from this table. The properties listed in the table are those you would set as part of your Size dynamic definition. You determine the default values for the Size dynamic's properties by setting them on the Preferences tab; for more information about these preferences, refer to New Size Default Settings.

Unique Properties for a Size Dynamic

Property

Settings

Description

Data

DataSource

An input, value, expression, or OPC data source.

Data connections can be typed directly into the DataSource. Click the ellipsis [...] button and in Data Browser you can select tags in the system. You can also create Expressions in the Data Browser

DragDropDataSource

True or False

True indicates that the data source can, during runtime, be dragged by a user and dropped into another component so that the size dynamic affects the component it is dropped into.

LowLimit

Value

Low limit is used as a boundary condition in animation.

HighLimit

Value

High limit is used as a boundary condition in animation.

ActiveWhen

Range Settings

Sets discrete ranges when animation occurs.

Dynamic Behavior

AnimationMode

Analog or Discrete

Analog – The size of the object is determined by values coming from the data source.

Discrete – The start and stop of the object's change in size is determined by values coming from the data source.

StartPercent

Value

EndPercent

Value

SizeMode

Direction

Defines the direction of the size action.

Size Mode Options

Different size actions are selected from this drop down list.

SizeHorizontal

True or False

Indicates whether the object will resize horizontally (x-axis).

SizeVertical

True of False

Indicates whether the object will resize vertically (y-axis).

HorizontalAnchor

Percentage

Horizontal (x-axis) percentage offset from the center of the object of the resize anchor point: range (0%, left edge; 50%, center; 100%, right edge).

VerticalAnchor

Percentage

Vertical (y-axis) percentage offset from the center of the object of the resize anchor point: range (0%, top; 50%, center; 100%, bottom).

Clip

True or False

This property shows an object moved beyond the display area as missing the outside portion but otherwise the same shape. False changes the bounding box and resizes the object to fit inside the display.

Bias

True of False

Resizes the object about an axis like a bias bar. You can see the bias bar in the operations shown in the figure above.

Dynamic Behavior - Detents (Analog AnimationMode only)

DetentType

None, Number of Detents, Delta Value

Detents are the steps that an animation can have.

DetentValue

Number

The number is the number of steps used in the animation. Use more steps for smoother animation.

DetentOrigin

Value

Specifies the starting analog value from which subsequent steps are calculated.

Dynamic Behavior - Discrete (Discrete AnimationMode only)

StartDelay

Value

A delay time before the activated animation will begin (milliseconds). Can be assigned to a data source.

Duration

Value

The time it takes for an animation to complete a cycle (milliseconds). Can be assigned to a datasource.

SkipInitialDuration

True or False

Set to True when you want to skip the first data update.

AccelerationRatio

Percentage

The percentage of the animation's Duration spent accelerating over time.

DecelerationRatio

Percentage

The percentage of the animation's Duration spent accelerating over time.

AnimateWhenTrue

True or False

Run the animation when the data source returns a value that evaluates to True or 1.

ReverseAnimateWhenFalse

True or False

Run the animation in reverse when the data source returns a value that evaluates to True or 1.

AutoReverse

True or False

Runs the automation to the end and then runs the automation backwards creating an infinite loop.

RepeatCount

Number

The number of times an animation is performed for a discrete mode. For an infinite number of times set the number to -1.

FillBehavior

HoldEnd or Stop

Sets the behavior of the animation at the end of its motion

FreezingWhenNotAnimated

True or False

When false the animation goes to the default state when it ends. When true the animation stays in its last state when it ends.

Dynamic Behavior - Toggle (Discrete AnimationMode only)

PeriodicToggleRate

Value or DataSource

The time interval in milliseconds between toggling the state or flashing the object. May be assigned to a data source.

DynamicStateWhenToggleOff

True or False

Indicates that when this dynamic is not toggling that the alternate state of the dynamic should be used.

ToolTip

ShowToolTip

True or False

 

ShowDescription

True, False, or Default

 

ShowDataSourceName

True, False, or Default

 

ShowDataSourceValue

True, False, or Default

 

ShowErrorInformation

True, False, or Default

 

For more information, refer to Object Properties.

The Size dynamic supports:

  • A single movement

  • A variable response to a data source

  • Or an animation.

Example

To get a sense how a simple Size dynamic would work, let's create a Rectangle object and add a size dynamic that expands the rectangle. The original rectangle is a state = 0, and the expanded rectangle is given a state with a value of 1. A runtime user will input a value into a Data Entry object, and that value will trigger the action.

To create a data input Size dynamic:

  1. Click on the Data Entry icon in the Text Objects group on the Dynamics ribbon, then click on the display canvas to create that object on the design surface.

  2. In the Data Entry object's DataSource property, enter the following statement: localsim::var1
    This creates a variable for the local simulator that the Rectangle object will use as its DataSource property.

  3. On the Home ribbon, click on the Rectangle tool and then click and drag a rectangle onto the design surface.

  4. Select the Rectangle object in the display, then click on the Size dynamic in the Dimensions group on the Dynamic ribbon. The cursor changes to a resize cursor.

  5. Drag one of the reshape handles of the rectangle to the new larger size.

  6. Set the following properties: DataSource,  localsim::var1; LowLimit, 0; HighLimit, 10;. ActiveWhen, Always; SizeMode, Up; DetentType, Number of Detents; and DetentValue, 10.

  7. Click the Runtime button.

In runtime you can enter any value between 0 and 10 and the rectangle will grow vertically from 0% to 100% in 10 different steps. Entering 5 into the Data Entry box gives you a rectangle that is 50% of the full size; while entering 9 would be 90%. Any number above 10 is rounded to 10 and gives you 100% of the size. You can therefore see how you could use this method to create an indicator. If the DataSource were a tag, then the value would change the size. A colored rectangle could be used as the level indicator inside a tank shape with a cut away window.

In the figure below, the Data Entry box and the rectangle were aligned at their top edges. In runtime the value 5 shows the box at its 50% level.

A Size Dynamic with User Input

The rectangle is at half height (5 out of 10)

See also:

Find and Replace Properties in Displays and Symbols

Preferences