Difference between revisions of "SetScale"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>Laisren
(Reworking function documentation to provide _detailed_ Parameter info (possible template prototype).)
imported>Speedo
(Please include variable types when giving syntax; removed byline)
Line 4: Line 4:


==Syntax==
==Syntax==
  SetScale <''percent''>
  SetScale ''Percent:float''


==Syntax Description==
==Syntax Description==
Line 51: Line 51:
[[Category: Statistics Functions]]
[[Category: Statistics Functions]]
[[Category: Statistics Functions (CS 1.0)]]
[[Category: Statistics Functions (CS 1.0)]]
<hr>
<font size="1">ShareAlike Attribution: Part of this article is based on original work by Laisren; used under license terms.</font>

Revision as of 01:11, 25 March 2008

SetScale (function/command)

This command sets the scale (relative size) of the referenced object to the specified value.

Syntax

SetScale Percent:float

Syntax Description

Parameter Type Optional or Required Details
percent Float Required The scale, expressed as a decimal percentage; 1.00 = 100% (normal size), 0.90 = 90% of normal size, and so on.

Valid values are from 0.50 (50%) to 2.00 (200%).
A value of 1.00 returns the item to its default size.
Leading or trailing zeros are recommended, but not required (i.e. 1.5 = 1.50).

Example

The following example sets the scale of the selected object to 150%:

SetScale 1.50

Additional Details (Notes)

  • The Reference (referenceID/called object) can be specified in Console Mode by pre-selecting the object.
  • The scale is limited in the range of 0.5 - 2.0. Higher or lower values do not generate errors, but have no effect beyond that range.
    • Use OBSE's SetScaleEX for sizes outside of that range.
  • When used on a player in first person, changes do not affect the character's model when he switches to third person. Also, although this command does automatically change the point of view of the character while in first person, the camera does not move nearly as much as would be expected in most scaling operations.
  • When called on NPCs, the value supplied is treated as a multiplier to the character's base scale, which is determined by the NPC's race. So calling setScale 1.5 on a High Elf, which has a base scale of 1.1, results in a scale of 1.65, and the same value will be returned by getScale.
  • To update the collision info, you'll need to Disable and re-Enable the referenced object.

See Also