llScaleByFactor

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

ScaleByFactor

llScaleByFactor

Summary

Function: integer llScaleByFactor( float scaling_factor );

0.0	Forced Delay
10.0	Energy

Attempts to resize the entire object by scaling_factor, maintaining the size-position ratios of the prims.

Resizing is subject to prim scale limits and linkability limits. This function can not resize the object if the linkset is physical, a pathfinding character, in a keyframed motion, or if resizing would cause the parcel to overflow.
Returns a boolean (an integer) TRUE if it succeeds, FALSE if it fails.

• float

scaling_factor

–

The multiplier to be used with the prim sizes and their local positions.

Caveats

• Due to floating point precision issues (often, sqrt(x*x) != x), avoid rescaling by the values returned by llGetMinScaleFactor and llGetMaxScaleFactor. To guarantee successful rescaling, use values slightly within the limits returned by those functions.

Examples

<lsl>// Touching this script causes the object to double or halve in size.

integer growing;

default {

   state_entry()
   {
       llSay(PUBLIC_CHANNEL, "Touch to toggle scale.");
   }

   touch_start(integer num_detected)
   {
       growing = !growing;

       float min_factor = llGetMinScaleFactor();
       float max_factor = llGetMaxScaleFactor();

       llSay(PUBLIC_CHANNEL, "min_scale_factor = " + (string)min_factor
                           + "\nmax_scale_factor = " + (string)max_factor);

       integer success;

       if (growing) success = llScaleByFactor(2.0);
       else         success = llScaleByFactor(0.5);

       if (!success) llSay(PUBLIC_CHANNEL, "Scaling failed!");
   }

}</lsl>

See Also

Functions

•	llScaleByFactor
•	llGetMaxScaleFactor
•	llGetMinScaleFactor

Deep Notes

This function is roughly equivalent to the following: <lsl> float VectorAbsStatistics(integer flag, vector a){

   return llListStatistics(flag, [llFabs(a.x), llFabs(a.y), llFabs(a.z)]);

}

integer ScaleByFactor(float scale) {

   vector root = llGetScale() * scale;

   if (VectorAbsStatistics(LIST_STAT_MAX, root) > 64

History

• Mentioned in Simulator_User_Group/Transcripts/2013.12.10
• Mentioned in Simulator_User_Group/Transcripts/2013.12.17

Signature
function integer llScaleByFactor( float scaling_factor );