ScaleBy Action

Overview
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
​(1,1,1)(1,1,1)(1,1,1)
​
​(3,3,3)(3,3,3)(3,3,3)
​
​(3,3,3)(3,3,3)(3,3,3)
​
​(0.5,0.75,4)(0.5, 0.75, 4)(0.5,0.75,4)
​
​(0.5,2,0.25)(0.5, 2, 0.25)(0.5,2,0.25)
​
​(0.25,1.5,1)(0.25, 1.5, 1)(0.25,1.5,1)
​
​(2,10,2.5)(2, 10, 2.5)(2,10,2.5)
​
​(1,0.1,0)(1, 0.1, 0)(1,0.1,0)
​
​(2,1,0)(2, 1, 0)(2,1,0)
​
Furthermore, visit the Actions Nodes page for a general introduction to these Nodes, and Scale for more detail about the Scale Attribute.
​Scope: Scene, Function, Prefab.
Attributes
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.
Inputs
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.
Outputs
Output
Type
Description
Instance ID
InstanceID
The assigned Instance ID of the Action.
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.
Example
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.
Scene Configuration
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 (1000,1000,0)(1000, 1000, 0)(1000,1000,0)
 and its Scale Attribute to (0.1,0.1,0)(0.1, 0.1, 0)(0.1,0.1,0)
. See this configuration in the following image:
Scene configuration.
Logic
We then need to configure the Logic. This is done in the Logic Editor.
We use the ScaleBy Action Node with the following Attributes:
By: (4,4,0)(4, 4, 0)(4,4,0)
​
Duration (sec): 444
​
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.
Final result
Finally, the effect of the ScaleBy Action Node when triggered is the following:
Final result.
See Also
​ScaleTo Action​
External Links
​Scaling (geometry) on Wikipedia.

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	The assigned Instance ID of the Action.
`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.

RotateFromTo Action

ScaleTo Action

Last modified 4mo ago

Initial `Scale`	`By`	Final `Scale`
$(1,1,1)$	$(3,3,3)$	$(3,3,3)$
$(0.5, 0.75, 4)$	$(0.5, 2, 0.25)$	$(0.25, 1.5, 1)$
$(2, 10, 2.5)$	$(1, 0.1, 0)$	$(2, 1, 0)$