Dynamic Objects

Dynamic objects are "placeholder" objects that can be dynamically replaced with other objects when the project is published as an image. They are usually only useful when you are using an Image Template file with Corda® Server™.

Dynamic objects define basic style definitions that are applied to the object dynamically inserted by Corda Server. This lets you maintain a consistent look and feel across the objects in an Image Template file

Dynamic objects are especially useful for dynamically swapping maps into an Image Template file, so that you do not have to create a new Image Template file for each map you want to display.

Creating Dynamic Objects

Corda 7 supports two different types of Dynamic objects, one for maps and one for objects of other types. Map Dynamic objects include additional configuration options that are not applicable to other object types.

To add a dynamic object

  1. Select Insert > Insert Dynamic Object.

  2. In the Create Dynamic Object dialog, specify if the Dynamic object is for maps only or for objects other than maps.

  3. Click OK.

    Corda Builder™ adds an empty frame (the Dynamic Object) that contains the words Dynamic Map Object or Dynamic Object to the project. Resize, copy, and delete this object just like any other object in the project.

Configuring Dynamic Objects

Once created, configure dynamic objects in Object Properties as you would any other object in a Corda Builder project.

Preview

When previewing an Image Template file, you might want to see an actual object of the type that will replace the dynamic object. Specify a preview object for the dynamic object from Object Properties. Doing so involves two attributes:

More information on these attributes is available in the Corda 7 Object Reference.

Dynamic Object Legends

You can associate a legend with a dynamic object just as you would for any other object type that supports a legend. For more information, see Legends. The dynamic object’s legend displays as long as the replacing object supports a legend. The dynamic object legend also overrides any existing legend that may be associated with the replacing object.

If no legend is specified with the dynamic object, and one is associated with the replacing object, the replacing object legend is displayed.

Sizing Dynamic Objects

The replacing object occupies the position and assumes the size defined by the dynamic object. If the replacing object is smaller or larger than the than the defined dynamic object dimensions, it is resized to match the dynamic object’s dimensions.

To ensure that the replacing object maintains its proportions, enable the Dynamic Object > Preserve Proportions attribute in Object Properties. This resizes the replacing object proportionally until either the height or width matches that of the dynamic object.

More information on this attribute is available in the Corda 7 Object Reference.

PCScript

Corda Builder automatically generates basic PCScript for objects in an Image Template file, including dynamic objects. The Corda Builder-generated PCScript focuses on those objects that are most likely to be dynamically updated by Corda Server. This default PCScript is useful as a template for creating custom PCScript you might need to manipulate dynamic objects with Corda Server.

View default PCScript from either the PCScript or Sample Code dialogs:

Map Layers

Map dynamic objects automatically include two layers, one Area layer and one Points layer. These dynamic object layers let you configure the look and feel applied to the layers of the dynamically-provided map that replaces the dynamic object.

When multiple layers of the same type are in the dynamically-provided map, layer settings from the dynamic object are applied in the following ways:

For information about replacing a dynamic object in an Image Template file, see Dynamic Objects in the Corda 7 Developer Reference.