3D Lingo Dictionary > O-S > scale (command) |
![]() ![]() ![]() |
scale (command)
Syntax
member(whichCastmember
).node(whichNode
).scale(xScale
,yScale
,zScale
) member(whichCastmember
).node(whichNode
).scale(uniformScale
)transform
.scale(xScale
,yScale
,zScale
)transform
.scale(uniformScale
)
Description
3D transform command; applies a scaling after the current positional, rotational, and scale offsets held by a referenced node's transform or the directly referenced transform. The scaling must be specified as either a set of three scalings along the corresponding axes or as a single scaling to be applied uniformly along all axes. You can specify the individual scalings using the xScale
, yScale
and zScale
parameters, otherwise you can specify the uniform scaling amount using the uniformScale
parameter.
A node can be a camera, group, light or model object. Using the scale
command adjusts the referenced node's transform.scale
property, but it does not have any visual effect on lights or cameras as they do not contain geometry.
The scaling values provided must be greater than zero.
Examples
This example first displays the transform.scale
property for the model named Moon, then it scales the model using the scale
command, finally it displays the resulting transform.scale
value.
put member("Scene").model("Moon").transform.scale -- vector( 1.0000, 1.0000, 1.0000) member("Scene").model("Moon").scale(2.0,1.0,0.5) put member("Scene").model("Moon").transform.scale -- vector( 2.0000, 1.0000, 0.5000)
This statement scales the model named Pluto uniformly along all three axes by 0.5
, resulting in the model displaying at half of its size.
member("Scene").model("Pluto").scale(0.5)
This statement scales the model named Oval in a nonuniform manner, scaling it along its Z axis but not its X or Y axes.
member("Scene").model("Pluto").scale(0.0, 0.0, 0.5)
See also
transform (property)
, preScale()
, scale (transform)
![]() ![]() ![]() |