ScaleBy Action

The ScaleBy Action Node.
The ScaleBy Action Node continuously scales an Object, thus creating an Animation. The final values of the
Scale
Attribute are determined by multiplying the initial ones with the values specified by the user in either the Attribute or Input Socket By
of the Node. Find an example of how to use this Node and its effect over an Object at the end of this page.The following table shows several examples of how the
Scale
values of an Object change for different By
values:Initial Scale | By | Final Scale |
| | |
| | |
| | |
Furthermore, visit the Actions Nodes page for a general introduction to these Nodes, and Scale for more detail about the
Scale
Attribute.
The ScaleBy Action Node Attributes.
Attribute | Type | Description |
---|---|---|
By | Vector3 | The number by which the Scale Attribute values will be multiplied, if none is received in the By Input Socket. |
Duration (sec) | Float | The total time of the Action, if none is given in the Duration Input Socket. |
Interpolation | Drop-down | The Interpolation method to use for calculating the intermediate values of the Scale . It can be Linear, Sine Ease In, Sine Ease In Out, or Sine Ease Out. |
Input | Type | Description |
---|---|---|
Instance ID | InstanceID | The assigned Instance ID of the Action. If nothing is received, it automatically assigns 0 as the Instance ID. |
(►) Start | Pulse | A standard Input Pulse, to trigger the execution of the Node. |
Object ID | ObjectID | The ID of the target Object. |
Duration | Float | The total time (in seconds). |
By | Vector3 | The number by which the Scale Attribute values will be multiplied, along the X, Y, Z axes. |
Output | Type | Description |
---|---|---|
Instance ID | InstanceID | |
OnStart (►) | Pulse | Flows to the next Node following ScaleBy Action when the Action starts. |
OnEnd (►) | Pulse | Flows to the next Node following ScaleBy Action when the Action stops. |
This section shows a simple example of how to use the ScaleBy Action Node and the effect it has on an Object. We start by configuring the Scene, then build the Logic, and finally show the result.
We consider a Scene with two Objects: a red ellipse over a black background, both of which can be easily created in the Scene Outliner. Then, we set the
Size
Attribute of the ellipse to and its
Scale
Attribute to . See this configuration in the following image:

Scene configuration.
We use the ScaleBy Action Node with the following Attributes:
By
:Duration (sec)
:Interpolation
:Linear
And we connect to it the Object Node of the red ellipse and a Pulse to the
Start
Input Socket. Thus, having the following Logic configuration:
Logic configuration.
Finally, the effect of the ScaleBy Action Node when triggered is the following:

Final result.
Last modified 4mo ago