Scale

Scale

Description

Scales elements to an absolute ratio of the original geometry or by a relative amount.

Scripting Syntax

Scale( [InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Reference], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents] )

Parameters

Parameter	Type	Description
InputObjs	String	List of objects or components to scale. Default Value: Selected elements
X	Double	X scaling Default Value: 1.0
Y	Double	Y scaling Default Value: 1.0
Z	Double	Z scaling Default Value: 1.0
Delta	siDeltaMode	Whether to scale the object a relative to its current size or the geometry Default Value: siRelative
RefMode	siRefMode	The reference mode to scale orientated to Default Value: siLocal
Center	siCenterMode	Whether to scale the object or its center. Note: If an object does not have a scaleable center, then scaling its center scales the object. Default Value: siObj
AxesFilter	siAxesFilter	Determines which of the x,y,z arguments are valid (used with Absolute mode only). Default Value: siXYZ
Reference	String	If using the By Reference mode, specified the reference to use Default Value: "" Possible Values: • : Reference not used (World) • Grid: Use the center of the Grid
SplitLocalComponents	Boolean	Specifies whether to scale all components independently in Local mode Default Value: False
PropTagOnly	Boolean	Specifies whether to restrict proportional to tagged components only Default Value: False
Pivot	Boolean	If true the specified global pivot point is used for scaling Default Value: False
PivotX	Double	X position of the pivot point Default Value: 0.0
PivotY	Double	Y position of the pivot point Default Value: 0.0
PivotZ	Double	Z position of the pivot point Default Value: 0.0
ConstructionMode [in/out]	siConstructionMode	In which construction mode will the deformation be applied. This only applies when scaling geometry components. Default Value: Use the current construction mode
SlideComponents	Boolean	Constrain components to surface during translation. Works like shrink wrap for points/polygons while edges are constrained along adjacent polygon edges. Currently only supported for mesh objects. Default Value: False

Examples

VBScript Example

dim object
set object = GetPrim( "Null" )

' Scale the selected objects to 5 times their current size in X
Scale ,5

' Scale the selected objects 5 times their geometric size in Y
Scale ,,5,,siAbsolute

' Scale a given object to half its current size in X, Y and Z
Scale object,0.5,0.5,0.5

See Also

Translate

Rotate

ResetTransform

Autodesk Softimage v7.5