Defining animation scale
Quite often we cannot animate large objects (warehouses, railway stations, etc.) in their actual size. That is why when animating such objects we reduce their sizes several times, i.e. scale the animation of the objects being modeled.
With the special element
you can set the scale of the animation, i.e. the ratio of the object's animation to the actual size of the object. Actually the scale is set as a ratio of pixels of the animation to the physical units of length.
You can see that there is always a chosen unit of length to pixel correspondence notice under the scale element for your convenience.
The scale element does not belong to any level.
There are two alternative methods to set the animation scale through use of the element
Taking into consideration the dimensions of the animation figure
This mode is used when the scale of the animation is associated with the object's real size.
Just specifying the correspondence between physical units of length and pixels of model’s animation. This mode is used when you select the optimal scale on your own.
You define scale once for all the shapes on the agent diagram, so there can be only one ruler on the agent diagram. However, different agents may have different scales.
You can use the
view to set the required scale, or drag its end to set the number of pixels that should correspond to one unit of length. There are two modes that you can use to set up the scale. In the
view of the scale, you will find the property
option is the default choice for the scale. And also by default, the
Ruler length corresponds to
10 meters. It means that if you drag the ruler end in the graphical editor, its length will remain conventional
10 meters, and the number of pixels will be divided by ten to define how many pixels are in one meter. So, to change the scale, drag its square handle or change the
property. Since the ruler lengthitself does not change (it remains 10 meters) the scale will change when the number of pixels it covers changes.
- Another way is for the scale to be
In this case, to change the scale, specify the number of pixels that correspond to one unit of length in the
field located below. Choose the required unit of length from the drop-down list on the right-hand side. Now, even if you change the
property here, the scale itself will remain the same.
To set the scale of agent animation according to its real size
Let us define the scale, for instance, for a train car animation in the model.
Move the diagram
down and you will find the
element located above X-axis on the agent's diagram.
- Move the scale ruler so that it coincides exactly with the animation figure length. First, position the scale along the figure. To move with pixel precision, hold down Alt key while dragging the element with the mouse. We can also recommend you
also to zoom the graphical editor diagram using the
- Match the end points of the ruler with the figure length. Stretch the scale ruler by dragging its end with the mouse. We again recommend holding down the Alt key while dragging.
- Now set the required scale. In this particular case the train car real length corresponds to 27 meters. Go to the ruler
view. Leave the
option selected. Specify
Ruler length corresponds to
- You can see that the dimensions are the same now on both dimension lines. Now you can easily set object lengths and distances for a given type of agent, and AnyLogic will use the scale that you have set here.
- If we run the model now, we will get realistic size right away:
Visible on upper agent
– If selected, the scale is also visible on the upper agent where this agent lives.
– If selected, the scale is
locked. Locked shapes do not react to mouse clicks - it is impossible to select them in the graphical editor until you unlock them. It is frequently needed when you want to prevent editing this shape while drawing other shapes near it.
– Here you specify whether the shape is visible on the animation at the model runtime, or not. Using the control, choose
– The length of the shape on an agent's diagram, in pixels.
– Here you can choose how this element defines the scale of your model's animation.
Use this mode if you know the real size of the objects that the animation figures represent.
Use this mode if you know the exact scale for this agent's animation.
AnyLogic supports both popular measurements: metric system (units of length: cm, m, km) and English (inches, feet, miles).
– X-coordinate of the
– Y-coordinate of the
– The rotation angle of the
Scaling agent animations on GIS map