Second Life Wiki - User contributions [en]

PRIM ROT LOCAL

2014-01-10T07:41:08Z

KiraCodie Resident: added example using link set primitive params

<onlyinclude>{{#if:

{{#vardefine:rot_local_const|{{LSL Const|PRIM_ROT_LOCAL|integer|29|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's local rotation}}}}

{{#vardefine:p_rot_desc|Any valid rotation}}

{{#switch:{{{1|}}}
|get={{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats-get}}}}
|set={{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats-set}}}}

}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_ROT_LOCAL
|type=integer
|value=29
|desc=PRIM_ROT_LOCAL is used to get or set the prim's local rotation.
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:rot_local_const}}, |i_end= ]);
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
{{LSL Generic/Caveats|caveats={{#var:caveats-set}}|title=*}}
|toc=llSetPrimitiveParams
|i1_type=rotation|i1_name=rot
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:rot_local_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text={{LSL Generic/Caveats|caveats={{#var:caveats-get}}|title=*}}
|toc=llGetPrimitiveParams
|r1_type=rotation|r1_name=rot
}}
|examples=<lsl>integer isRotated = FALSE;
vector rotated = <25, 25, 0>;
rotation notRotated = ZERO_ROTATION;
rotation rot;

default
{
state_entry()
{
rotated *= DEG_TO_RAD;
rot = llEuler2Rot( rotated );
}

touch_start(integer total_number)
{
if( isRotated )
{
llSetLinkPrimitiveParams( 2, [PRIM_ROT_LOCAL, notRotated] );
isRotated = FALSE;
}

else if( !isRotated )
{
isRotated = TRUE;
llSetLinkPrimitiveParams( 2, [PRIM_ROT_LOCAL, rot] );
}
}
}
</lsl>
|constants=

|functions=
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetRot]]|}}
{{LSL DefineRow||[[llSetRot]]|}}
{{LSL DefineRow||[[llSetLocalRot]]|}}
{{LSL DefineRow||[[llGetLocalRot]]|}}
{{LSL DefineRow||[[llGetRootRotation]]|}}
{{LSL DefineRow||[[llGetObjectDetails]]|}}
|events=

|location
|cat1
|cat2=Rotation
|cat3=Movement
|cat4
}}

LlDetectedTouchUV

2013-12-14T06:41:29Z

KiraCodie Resident: The example wouldn't run for the second example with 12 columns, because Columns was misspelled.

{{LSL_Function
|inject-2={{LSL_Function/detected|index|touchUV|simple=*}}
|func_id=337|func_sleep=0.0|func_energy=10.0
|func=llDetectedTouchUV
|return_type=vector|return_text=that is the texture coordinates for where the prim was touched. The {{LSLP|x}} & {{LSLP|y}} vector positions contain the horizontal ({{LSLP|u}}) & vertical ({{LSLP|v}}) texture coordinates respectively (<code>{{NoWrap|{{LSL_VR|{{LSLPT|u}}|{{LSLPT|v}}|0.0}}}}</code>). Like [[llDetectedTouchST]], the interval of each component will be {{Interval|gte=0.0|center=component|lte=1.0}} unless the texture repeats are set to a non-default value. Increasing or decreasing the texture repeats of the face will change this interval accordingly. Additionally, unlike with [[llDetectedTouchST]], changing a texture's rotation will change the results of this function.

{{LSL Const|TOUCH_INVALID_TEXCOORD|vector|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when the touch UV coordinates cannot be determined. See [[#Caveats|Caveats]] for further details.
|p1_type=integer|p1_name=index
|func_footnote=For the {{LSLGC|Touch|touch}} category of events only. The prim that was touched may not be the prim receiving the event, use [[llDetectedLinkNumber]] to check for this; likewise you can use [[llDetectedTouchFace]] to determine which face was touched.
|func_desc
|spec=
|caveats=
*{{LSL Const|TOUCH_INVALID_TEXCOORD|vector|{{LSL_VR|-1.0|-1.0|0.0}}}} is returned when...
** The avatar's viewer does not support face touch detection.
*** To check if face touch detection is supported check the return of [[llDetectedTouchFace]].
** The touch has moved off the surface of the prim.
** The touch happened too close to the edge of the face to determine a location.
** The event triggered is not a {{LSLGC|Touch|touch}} event.
|examples=
<lsl>
default
{
touch_start(integer total_number)
{
integer face = llDetectedTouchFace(0);
vector touchUV = llDetectedTouchUV(0);

// ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the texture
// touchUV.x goes across the texture from the left to the right
// touchUV.y goes across the texture from the bottom to the top

if (face == TOUCH_INVALID_FACE)
// {
llWhisper(PUBLIC_CHANNEL, "Sorry, your viewer doesn't support touched faces.");
// }
else if (touchUV == TOUCH_INVALID_TEXCOORD)
// {
llWhisper(PUBLIC_CHANNEL, "Sorry, the touch position upon the texture could not be determined.");
// }
else
// {
llSay(PUBLIC_CHANNEL, "llDetectedTouchUV(" + (string)touchUV + ")"
+ "\ntouchUV.x = " + (string)touchUV.x
+ "\ntouchUV.y = " + (string)touchUV.y);
// }
}
}
</lsl>
<lsl>
integer numberOfRows = 12;
integer numberOfColumns = 12;

default
{
touch_start(integer num_detected)
{
vector touchUV = llDetectedTouchUV(0);

// ZERO_VECTOR (<0.0, 0.0, 0.0> ... the origin) is in the bottom left corner of the texture
// touchUV.x goes across the texture from the left to the right
// touchUV.y goes across the texture from the bottom to the top

integer columnIndex = llFloor(touchUV.x * numberOfColumns);
integer rowIndex = llFloor(touchUV.y * numberOfRows);
integer cellIndex = (rowIndex * numberOfColumns) + columnIndex;

llSay(PUBLIC_CHANNEL, "UV grid (" + (string)columnIndex + ", " + (string)rowIndex + ") --> cell " + (string)cellIndex);
}
}
</lsl>
|helpers
|related
|also_functions=
{{LSL DefineRow||[[llDetectedLinkNumber]]}}
{{LSL DefineRow||[[llDetectedTouchFace]]}}
{{LSL DefineRow||[[llDetectedTouchST]]}}
{{LSL DefineRow||[[llDetectedTouchPos]]}}
{{LSL DefineRow||[[llDetectedTouchNormal]]}}
{{LSL DefineRow||[[llDetectedTouchBinormal]]}}
|also_events=
{{LSL DefineRow||[[touch_start]]|}}
{{LSL DefineRow||[[touch]]|}}
{{LSL DefineRow||[[touch_end]]|}}
|also_articles
|notes
|history=*Introduced in {{SVN|870|rev=92872|trunk=*|anchor=file14|date=Wednesday, 23 July 2008}}.
*Server support available in Second Life Server 1.24.7.98039, client support in Release Candidate viewer 1.21.4 (98167).
|cat1=Touch
|cat2
|cat3
|cat4
}}

PRIM PHANTOM

2013-11-25T09:12:21Z

KiraCodie Resident: added an example

<onlyinclude>{{#if:

{{#vardefine:phantom_const|{{LSL Const|PRIM_PHANTOM|integer|5|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the object's phantom status}}}}

}}</onlyinclude>{{#if:

{{LSL_Function/boolean|boolean}}

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Object}}
|name=PRIM_PHANTOM
|type=integer
|value=5
|desc=Used to get or set the object's [[STATUS_PHANTOM|phantom]] {{LSLGC|Status|status}}.
|pa={{LSL Constant/List|i_front=[ {{#var:phantom_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
*NOTE: This sets the entire object (linkset) when used in either function.
|i1_type=integer|i1_name=boolean
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:phantom_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text
|r1_type=integer|r1_name=boolean
|toc=llGetPrimitiveParams
}}
|examples=<lsl>default
{
state_entry()
{
llSetPrimitiveParams([PRIM_PHANTOM, TRUE]); // makes the prim phantom...

integer isPhantom = llList2Integer(llGetPrimitiveParams([PRIM_PHANTOM]), 0);

if( isPhantom == 1 )
{
llSetText("Object is Phantom", <1, 1, 1>, 1.0);
}

else
{
llSetText("Object is Solid", <1, 1, 1>, 1.0);
}
}
}</lsl>
|constants=
{{LSL DefineRow||[[STATUS_PHANTOM]]|}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetStatus]]|}}
{{LSL DefineRow||[[llGetStatus]]|}}
|events=
{{LSL DefineRow||[[changed]]|}}
|location
|cat1
|cat2=Status
|cat3=Phantom
|cat4
}}

PRIM PHYSICS

2013-11-25T09:07:02Z

KiraCodie Resident: fixed error in scripted example

<onlyinclude>{{#if:

{{#vardefine:physics_const|{{LSL Const|PRIM_PHYSICS|integer|3|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the object's physical status}}}}

}}</onlyinclude>{{#if:

{{LSL_Function/boolean|boolean}}

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Object}}
|name=PRIM_PHYSICS
|type=integer
|value=3
|desc=Used to get or set the object's [[STATUS_PHYSICS|physics]] {{LSLGC|Status|status}}. When enabled the object responds to SL physics.
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:physics_const}}, |i_end= ]);
|text={{LSL Constant/PrimParamText|set}}
|i1_type=integer|i1_name=boolean
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:physics_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text={{LSL Constant/PrimParamText|get}}
|r1_type=integer|r1_name=boolean
|toc=llGetPrimitiveParams
}}
|examples=<lsl>default
{
state_entry()
{
llSetPrimitiveParams([PRIM_PHYSICS, TRUE]); // makes the prim physical...

integer isPhysical = llList2Integer(llGetPrimitiveParams([PRIM_PHYSICS]), 0);

if( isPhysical == 1 )
{
llSetText("Object is Physical", <1, 1, 1>, 1.0);
}

else
{
llSetText("Object is non-Physical", <1, 1, 1>, 1.0);
}
}
}</lsl>
|caveats=
*calls to set PRIM_PHYSICS in attachments fail silently
|constants=
{{LSL DefineRow||[[STATUS_PHYSICS]]|}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetStatus]]|}}
{{LSL DefineRow||[[llGetStatus]]|}}
|events
|location
|cat1=Status
|cat2=Physics
|cat3
}}

PRIM PHYSICS

2013-11-25T09:00:03Z

KiraCodie Resident: added example of setting and getting the Prim Physics

<onlyinclude>{{#if:

{{#vardefine:physics_const|{{LSL Const|PRIM_PHYSICS|integer|3|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the object's physical status}}}}

}}</onlyinclude>{{#if:

{{LSL_Function/boolean|boolean}}

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Object}}
|name=PRIM_PHYSICS
|type=integer
|value=3
|desc=Used to get or set the object's [[STATUS_PHYSICS|physics]] {{LSLGC|Status|status}}. When enabled the object responds to SL physics.
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:physics_const}}, |i_end= ]);
|text={{LSL Constant/PrimParamText|set}}
|i1_type=integer|i1_name=boolean
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:physics_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text={{LSL Constant/PrimParamText|get}}
|r1_type=integer|r1_name=boolean
|toc=llGetPrimitiveParams
}}
|examples=<lsl>default
{
state_entry()
{
llSetPrimitiveParams([PRIM_PHYSICS, TRUE]); // makes the prim physical...

if(llGetPrimitiveParams([PRIM_PHYSICS]) == TRUE)
{
llSetText("Object is Physical", <1, 1, 1>, 1.0);
}

else
{
llSetText("Object is non-Physical", <1, 1, 1>, 1.0);
}
}
}</lsl>
|caveats=
*calls to set PRIM_PHYSICS in attachments fail silently
|constants=
{{LSL DefineRow||[[STATUS_PHYSICS]]|}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetStatus]]|}}
{{LSL DefineRow||[[llGetStatus]]|}}
|events
|location
|cat1=Status
|cat2=Physics
|cat3
}}

OBJECT STREAMING COST

2013-11-25T07:54:05Z

KiraCodie Resident: added example

{{LSL Constant
|name={{PAGENAMEE}}
|type=integer
|value=15
|desc=This is a flag used with [[llGetObjectDetails]] to get the [[Mesh/Mesh_Streaming_Cost|streaming/download cost]] of the object.
|examples=<lsl>getStreamingCost( key id )
{
list downloadWeight = llGetObjectDetails( id, [OBJECT_STREAMING_COST] );

llSetText( "Download (streaming) cost\n" + llList2String( downloadWeight, 0 ),
<1, 0, 0>, 1.0 );
}

default
{
state_entry()
{
llSetMemoryLimit( 6000 ); // set memory limit

getStreamingCost( llGetOwner() ); // get the streaming cost of the owner
}

touch_start(integer total_number)
{
getStreamingCost( llDetectedKey(0) ); // the person that touched the box streaming weight
}
}
</lsl>
|functions={{LSL DefineRow||[[llGetObjectDetails]]}}
|constants={{!}}{{LSL_Constants/Object_Details}}
|events
|cat1=Prim
|cat2=
|cat3
|cat4
}}

OBJECT RUNNING SCRIPT COUNT

2013-11-25T07:08:30Z

KiraCodie Resident: added example

{{LSL Constant
|inject-1
|name={{PAGENAMEE}}
|type=integer
|value=9
|desc=This is a flag used with [[llGetObjectDetails]] to get the number of [[LlGetScriptState|running]] scripts.
|examples=<lsl>// an example that demonstrates running scripts, total scripts, memory usage, and script time usage.

default
{
touch_start( integer params )
{
key toucher = llDetectedKey(0);

list scriptInfo = llGetObjectDetails( toucher, [OBJECT_TOTAL_SCRIPT_COUNT, OBJECT_RUNNING_SCRIPT_COUNT, OBJECT_SCRIPT_TIME, OBJECT_SCRIPT_MEMORY]);

string displayMessage = llGetDisplayName( toucher ) + ", has " + llList2String( scriptInfo, 1 ) +
" number of scripts running, with a total of " + llList2String( scriptInfo, 0 ) +
" scripts.\nThese take up " + (string)(llList2Integer( scriptInfo, 3 ) * 1024) +
" KiB of memory while using up " + (string)(llList2Float( scriptInfo, 2 ) * 1000) +
"ms of script time.";

llSetPrimitiveParams([ PRIM_TEXT, displayMessage, <0, 1, 1>, 1.0 ]);
}
}</lsl>
|functions={{LSL DefineRow||[[llGetObjectDetails]]}}
|constants={{!}}{{LSL_Constants/Object_Details}}
|events
|cat1=Prim
|cat2=
|cat3
|cat4
}}

OBJECT TOTAL SCRIPT COUNT

2013-11-25T07:07:33Z

KiraCodie Resident: Added an example to the OBJECT_TOTAL_SCRIPT_COUNT

{{LSL Constant
|inject-1
|name={{PAGENAMEE}}
|type=integer
|value=10
|desc=This is a flag used with [[llGetObjectDetails]] to get the total number of scripts, running or not.
|examples=<lsl>// an example that demonstrates running scripts, total scripts, memory usage, and script time usage.

default
{
touch_start( integer params )
{
key toucher = llDetectedKey(0);

list scriptInfo = llGetObjectDetails( toucher, [OBJECT_TOTAL_SCRIPT_COUNT, OBJECT_RUNNING_SCRIPT_COUNT, OBJECT_SCRIPT_TIME, OBJECT_SCRIPT_MEMORY]);

string displayMessage = llGetDisplayName( toucher ) + ", has " + llList2String( scriptInfo, 1 ) +
" number of scripts running, with a total of " + llList2String( scriptInfo, 0 ) +
" scripts.\nThese take up " + (string)(llList2Integer( scriptInfo, 3 ) * 1024) +
" KiB of memory while using up " + (string)(llList2Float( scriptInfo, 2 ) * 1000) +
"ms of script time.";

llSetPrimitiveParams([ PRIM_TEXT, displayMessage, <0, 1, 1>, 1.0 ]);
}
}</lsl>
|functions={{LSL DefineRow||[[llGetObjectDetails]]}}
|constants={{!}}{{LSL_Constants/Object_Details}}
|events
|cat1=Prim
|cat2=
|cat3
|cat4
}}

PRIM OMEGA

2013-11-22T03:27:10Z

KiraCodie Resident: added an additional example

<onlyinclude>{{#if:

{{#vardefine:omega_const|{{LSL Const|PRIM_OMEGA|integer|18|c=Used to {{GetSet|{{{1|}}}|get the object's llTargetOmega settings|rotate the object at on the given axis at the given rate|/}} }}}}

{{#vardefine:caveats|{{#var:caveats}}
*[[PRIM_OMEGA]] on nonphysical objects, and child prims of physical objects, is only a client side effect; the object or prim will collide as non-moving geometry.
*[[PRIM_OMEGA]] cannot be used on avatars sitting on the object. It will emit the error message "PRIM_OMEGA disallowed on agent".
*If [[PRIM_OMEGA]] does not appear to be working, make sure that that Develop > Network > Velocity Interpolate Objects is enabled on the viewer.}}

{{#vardefine:p_axis_desc|arbitrary axis to rotate the object around}}
{{#vardefine:p_spinrate_desc|rate of rotation in radians per second}}
{{#vardefine:p_gain_desc|also modulates the final spinrate and disables the rotation behavior if zero}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_OMEGA
|type=integer
|value=32
|desc=Used to make the object spin at the specified axis and rate, or retrieve spin settings. See [[llTargetOmega]] for specification.
|examples=<lsl>
// Set this prim rotating
llTargetOmega(<1.0,3.0,0.5>, TWO_PI, 1.0);

// Read back this prim's current target omega
list current_omega = llListToList( llGetPrimitiveParams([PRIM_OMEGA]); // should be [PRIM_OMEGA, axis, spinrate, gain]
vector axis = llList2Vector(current_omega, 1); // Should be <1.0,3.0,0.5>
float spinrate = llList2Float(current_omega, 2); // Should be TWO_PI
float gain = llList2Float(current_omega, 3); // Should be 1.0

// Set all child prims rotating
llSetLinkPrimitiveParamsFast(LINK_ALL_CHILDREN, [PRIM_OMEGA, <1.0,3.0,0.5>, TWO_PI, 1.0]);
</lsl>
Also, can use llSetPrimitiveParams for the root prim.
<lsl>// will need two prims linked together for this script.
default
{
state_entry()
{
// make some sort of rotation angle for the omega...
vector rotationAngle = <2.3, 5.5, 9.7> * llTan(85);

// rotate the main prim slowly using the same rotataion angle, rate, and gain...
llSetPrimitiveParams([ PRIM_OMEGA, rotationAngle * 0.3, 1.0, 1.0 ]);

// rotate the link satellite prim separately around its own axis
// it will rotate also around the main prim because the main prim is rotating.
llSetLinkPrimitiveParams(2, [ PRIM_OMEGA, rotationAngle, 1.0, 1.0 ]);
}
}
</lsl>
|constants
|pa={{LSL Constant/List|i_front=[ {{#var:omega_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
|i1_type=vector|i1_name=axis
|i2_type=float|i2_name=spinrate
|i3_type=float|i3_name=gain
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:omega_const}} ]);|
|r_front=Returns the [[list]] [ |r_end= ]
|text
|toc=llGetPrimitiveParams
|r1_type=vector|r1_name=axis
|r2_type=float|r2_name=spinrate
|r3_type=float|r3_name=gain
}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llTargetOmega]]|}}
|events
|location
|history=*Introduced in [[Release Notes/Second Life RC BlueSteel/11#11.06.20.233291|Second Life RC BlueSteel 11.06.20.233291]], June 22, 2011
*Rolled to main server channel the week of 7/11/2011
|cat1
|cat2=Effects
|cat3=Physics
|cat4=Rotation
}}

PRIM ROTATION

2013-11-22T03:18:09Z

KiraCodie Resident: Giving an example of Prim Rotation

<onlyinclude>{{#if:

{{#vardefine:rotation_const|{{LSL Const|PRIM_ROTATION|integer|8|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the prim's rotation. See also PRIM_ROT_LOCAL which has a more consistent behavior.}}}}

{{#vardefine:p_rot_desc|Any valid rotation}}

{{#ifeq:{{{1|set}}}|set|{{Issues/SVC-93}}}}

{{#vardefine:caveats-get|{{#var:caveats-get}}
* {{LSLP|rot}} is always the [[Viewer_coordinate_frames#global|global rotation]], even if the prim is a child or the root prim of an [[attachment]].
* [[PRIM_ROTATION]] incorrectly reports the avatars rotation when called on the root of an attached object. Use [[PRIM_ROT_LOCAL]] for the root prim instead.
}}

{{#switch:{{{1|}}}
|get={{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats-get}}{{#vardefine:caveats-get}}}}
|set={{#vardefine:caveats|{{#var:caveats}}
{{#var:caveats-set}}{{#vardefine:caveats-set}}}}

}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_ROTATION
|type=integer
|value=8
|desc=PRIM_ROTATION is used to get or set the prim's rotation.
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:rotation_const}}, |i_end= ]);
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
{{LSL Generic/Caveats|caveats={{#var:caveats-set}}|title=*}}
|toc=llSetPrimitiveParams
|i1_type=rotation|i1_name=rot
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:rotation_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text={{LSL Generic/Caveats|caveats={{#var:caveats-get}}|title=*}}
|toc=llGetPrimitiveParams
|r1_type=rotation|r1_name=rot
}}
|examples=<lsl>default
{
state_entry()
{
/* This is rotates only once and just gradually that once */
vector rotationAngle = <2.3, 5.5, 9.7>;
rotation rot = llEuler2Rot( rotationAngle );
llSetLinkPrimitiveParams(2, [ PRIM_ROTATION, rot ]);
}
}
</lsl>
|constants=

|functions=
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetRot]]|}}
{{LSL DefineRow||[[llSetRot]]|}}
{{LSL DefineRow||[[llSetLocalRot]]|}}
{{LSL DefineRow||[[llGetLocalRot]]|}}
{{LSL DefineRow||[[llGetRootRotation]]|}}
{{LSL DefineRow||[[llGetObjectDetails]]|}}
|events=

|location
|cat1
|cat2=Rotation
|cat3=Movement
|cat4
}}

PRIM TEXT

2013-11-22T03:08:53Z

KiraCodie Resident: add an example of setting PRIM_TEXT and getting it...

<onlyinclude>{{#if:

{{LSL Function/limits}}
{{LSL Function/color|color}}
{{LSL Function/alpha|alpha}}

{{#vardefine:p_text_set_hover|floating text to display}}
{{#vardefine:p_text_get_hover|floating text displayed}}
{{#vardefine:p_text_hover|{{#switch:{{{1|}}}|get={{#var:p_text_get_hover}}|set={{#var:p_text_set_hover}}|floating text}}}}

{{#vardefine:p_text_set_desc|[[:Category:LSL Floating Text|floating text]] to display}}
{{#vardefine:p_text_get_desc|[[:Category:LSL Floating Text|floating text]] displayed}}
{{#vardefine:p_text_desc|{{#switch:{{{1|}}}|get={{#var:p_text_get_desc}}|set={{#var:p_text_set_desc}}|[[:Category:LSL Floating Text|floating text]]}}}}

{{#vardefine:text_const|{{LSL Const|PRIM_TEXT|integer|26|c=Used to {{GetSet|{{{1|}}}|get|set|/}} the object's floating text}}}}

{{#vardefine:caveats|{{#var:caveats}}
* Do not rely on [[:Category:LSL Floating Text|Floating Text]] as a storage medium; it is neither secure nor finalized.
** Floating text has been altered in past server updates, breaking existing content; future changes may occur.
** Even "invisible"{{Footnote|1=Floating text with an {{LSLP|alpha}} set to 0.0 is rendered "invisible"|2=Floating text with an alpha set to 0.0 is rendered {{String|invisible}}}} floating text is transmitted to the client.
*** It can be viewed by anyone with a client that is capable of rendering text that is supposed to be invisible.
*** The network packets that contain the text can be sniffed and the text read.}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_TEXT
|type=integer
|value=26
|desc=Used to get or set the object's [[:Category:LSL Floating Text|floating text]].
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:text_const}}, |i_end= ]);|
|text=Syntax for: [[llSetPrimitiveParams]], [[llSetLinkPrimitiveParams]] & [[llSetLinkPrimitiveParamsFast]]
|i1_type=string|i1_name=text_set|i1_disp=text
|i2_type=vector|i2_name=color
|i3_type=float|i3_name=alpha
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:text_const}}|i_end= ]);|
|r_front=Returns the list [ |r_end= ]
|text=Syntax for: [[llGetPrimitiveParams]], [[llGetLinkPrimitiveParams]]
|r1_type=string|r1_name=text_get|r1_disp=text
|r2_type=vector|r2_name=color
|r3_type=float|r3_name=alpha
|toc=llGetPrimitiveParams
}}
|examples=<lsl>default
{
state_entry()
{
// a string to display
string displayMessage = llGetDisplayName( llGetOwner() ) + ", test number ";

// just so could test changing the displayMessage
integer loopControl;
for( loopControl = 1; loopControl < 3; ++loopControl )
{
// on first iteration set the text
if( loopControl == 1 )
{
llSetPrimitiveParams([PRIM_TEXT, displayMessage + (string)loopControl + ".", <1, 0, 0>, 1.0]);
}

// on second iteration get the text and say it.
else if( loopControl == 2 )
{
llSay(0, llDumpList2String(llGetPrimitiveParams([PRIM_TEXT]), " "));
}
}
}
}</lsl>
|constants=
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParamsFast]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetText]]|}}
|events
|location
|cat1
|cat2=Floating Text
|cat3
|cat4
}}

LlScriptProfiler

2013-11-19T13:09:32Z

KiraCodie Resident:

{{LSL_Function
|func_id=???|func_sleep=0.0|func_energy=10.0
|func=llScriptProfiler
|return_type
|p1_type=integer|p1_name=flags|p1_desc=[[#Constants|PROFILE_*]] flags
|func_desc=Enables or disables the scripts profiling state.
|Return_text
|func_footer
|spec=
This function's behavior is dependent upon the VM the script is using. [[#Mono|Mono]] is the new VM, [[#LSO|LSO]] is the old VM. The big difference between between Mono and LSO is that Mono scripts run faster and can utilize four times more memory.

===Mono===

Use this function with [[PROFILE_SCRIPT_MEMORY]] to enable memory profiling at a severe script performance penalty. Use it with [[PROFILE_NONE]] to disable profiling. During and after a profiling run [[llGetSPMaxMemory]] will return the most memory used at any one time.

===LSO===

This function has no effect for scripts not compiled to Mono.

|caveats=
*Scripts compiled to LSO can not be profiled for memory use.
*The profile state will reset to [[PROFILE_NONE]] if:
** the object the script is in is de-rezed, rezed or changes regions (via region cross or teleport)
** the region that object with the script is in shuts down or restarts
** if the script is reset or taken to or from inventory
* There is up to 100x performance penalty to the script being profiled (but not the region).
|constants={{{!}} class='sortable' id='Constants' {{prettytable}}
{{!}}- {{hl2}}
! Constant
! Val
! Description
{{!}}-
{{!}} [[PROFILE_NONE]]
{{!}} 0
{{!}} Disables profiling
{{!}}-
{{!}} [[PROFILE_SCRIPT_MEMORY]]
{{!}} 1
{{!}} Enables memory profiling
{{!}}}
|examples=
Calling llScriptProfiler can look like this:
<lsl>
llScriptProfiler(PROFILE_SCRIPT_MEMORY);
my_func();
llScriptProfiler(PROFILE_NONE);
llOwnerSay("This script used at most " + (string)llGetSPMaxMemory() + " bytes of memory during my_func.");
</lsl>

This is how it looks in a script as an example:
<lsl>// need to run something for the profile to register...
workerMethod()
{
float mathNumber = 3 * PI + 3 * llSin( PI );
llSetText( "Answer: " + (string)mathNumber, <1, 0, 0>, 1.0 );
}

default
{
state_entry()
{
llSetMemoryLimit( 5000 ); // set the memory limit

// call up the profiler, execute a method, stop profiler
llScriptProfiler( PROFILE_SCRIPT_MEMORY );
workerMethod();
llScriptProfiler( PROFILE_NONE );

// display memory usage...
llSay(0, "Memory used: " + (string)llGetSPMaxMemory() + " bytes, total memory: " +
(string)llGetMemoryLimit() + " bytes." );
}
}

// outputs
// Object: Memory used: 4968 bytes, total memory: 5000 bytes.</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetSPMaxMemory]]}}
{{LSL DefineRow||[[llGetMemoryLimit]]|}}
{{LSL DefineRow||[[llSetMemoryLimit]]|}}
|also_events
|also_tests
|also_articles
|notes
|lso
|cat1=Script
|cat2=Memory
|cat3=Script Profiler
|cat4
|history = Date of Release [[ Release_Notes/Second_Life_Server/11#11.06.17.233176 | 17/06/2011 ]]
}}

LlScriptProfiler

2013-11-19T13:09:06Z

KiraCodie Resident: Added another script to help explain how ScriptProfiler works as people may not be sure where the method being profiled comes from.

{{LSL_Function
|func_id=???|func_sleep=0.0|func_energy=10.0
|func=llScriptProfiler
|return_type
|p1_type=integer|p1_name=flags|p1_desc=[[#Constants|PROFILE_*]] flags
|func_desc=Enables or disables the scripts profiling state.
|Return_text
|func_footer
|spec=
This function's behavior is dependent upon the VM the script is using. [[#Mono|Mono]] is the new VM, [[#LSO|LSO]] is the old VM. The big difference between between Mono and LSO is that Mono scripts run faster and can utilize four times more memory.

===Mono===

Use this function with [[PROFILE_SCRIPT_MEMORY]] to enable memory profiling at a severe script performance penalty. Use it with [[PROFILE_NONE]] to disable profiling. During and after a profiling run [[llGetSPMaxMemory]] will return the most memory used at any one time.

===LSO===

This function has no effect for scripts not compiled to Mono.

|caveats=
*Scripts compiled to LSO can not be profiled for memory use.
*The profile state will reset to [[PROFILE_NONE]] if:
** the object the script is in is de-rezed, rezed or changes regions (via region cross or teleport)
** the region that object with the script is in shuts down or restarts
** if the script is reset or taken to or from inventory
* There is up to 100x performance penalty to the script being profiled (but not the region).
|constants={{{!}} class='sortable' id='Constants' {{prettytable}}
{{!}}- {{hl2}}
! Constant
! Val
! Description
{{!}}-
{{!}} [[PROFILE_NONE]]
{{!}} 0
{{!}} Disables profiling
{{!}}-
{{!}} [[PROFILE_SCRIPT_MEMORY]]
{{!}} 1
{{!}} Enables memory profiling
{{!}}}
|examples=
Calling llScriptProfiler can look like this:
<lsl>
llScriptProfiler(PROFILE_SCRIPT_MEMORY);
my_func();
llScriptProfiler(PROFILE_NONE);
llOwnerSay("This script used at most " + (string)llGetSPMaxMemory() + " bytes of memory during my_func.");
</lsl>

This would be how it looks in a script as an example:
<lsl>// need to run something for the profile to register...
workerMethod()
{
float mathNumber = 3 * PI + 3 * llSin( PI );
llSetText( "Answer: " + (string)mathNumber, <1, 0, 0>, 1.0 );
}

default
{
state_entry()
{
llSetMemoryLimit( 5000 ); // set the memory limit

// call up the profiler, execute a method, stop profiler
llScriptProfiler( PROFILE_SCRIPT_MEMORY );
workerMethod();
llScriptProfiler( PROFILE_NONE );

// display memory usage...
llSay(0, "Memory used: " + (string)llGetSPMaxMemory() + " bytes, total memory: " +
(string)llGetMemoryLimit() + " bytes." );
}
}

// outputs
// Object: Memory used: 4968 bytes, total memory: 5000 bytes.</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetSPMaxMemory]]}}
{{LSL DefineRow||[[llGetMemoryLimit]]|}}
{{LSL DefineRow||[[llSetMemoryLimit]]|}}
|also_events
|also_tests
|also_articles
|notes
|lso
|cat1=Script
|cat2=Memory
|cat3=Script Profiler
|cat4
|history = Date of Release [[ Release_Notes/Second_Life_Server/11#11.06.17.233176 | 17/06/2011 ]]
}}

LlGetMemoryLimit

2013-11-19T12:56:19Z

KiraCodie Resident: Just added a small example based on code I submitted to the LSL Get SP Max Memory Limit

{{LSL_Function
|func_id=???|func_sleep=0.0|func_energy=???
|func=llGetMemoryLimit
|return_type=integer
|func_desc=Get the maximum memory a script can use.
|Return_text=amount of memory the script can use in bytes.
|func_footer
|spec=

;Mono:Gets the memory limit for the script.
* The memory limit can be up to 64k.
* The default memory limit is 64k{{Footnote|Prior to scripts being able to set their own limit, the limit was set to 64k}}.
* The memory limit is not the amount of real memory actually used by the script, just the upper limit on how much it could use.

;LSO:LSO scripts will always use exactly 16k

|helpers
|examples=<lsl>default
{
state_entry()
{
llSetMemoryLimit( 4000 ); // set the memory limit

// display memory usage...
llSay(0, "Memory used: " + (string)llGetFreeMemory() + " bytes, total memory: " +
(string)llGetMemoryLimit() + " bytes." );
}
}

// outputs
// Object: Memory used: 124 bytes, total memory: 4000 bytes.</lsl>
|also_functions=
{{LSL DefineRow||[[llSetMemoryLimit]]|}}
{{LSL DefineRow||[[llGetFreeMemory]]|}}
{{LSL DefineRow||[[llGetUsedMemory]]|}}
{{LSL DefineRow||[[llGetObjectDetails]]|}}
|also_events
|also_tests
|also_articles
|notes
|lso
|cat1=Script
|cat2=Memory
|cat3=Script Profiler
|cat4
|history = Date of Release [[ Release_Notes/Second_Life_Server/11#11.08.10.238207 | 10/08/2011 ]]
}}

LlGetSPMaxMemory

2013-11-19T12:49:32Z

KiraCodie Resident: Added an example that was a simple rotation script.

{{LSL_Function
|func_id=???|func_sleep=0.0|func_energy=???
|func=llGetSPMaxMemory
|return_type=integer
|func_desc
|Return_text=of the most bytes used while [[LlScriptProfiler]] was last active.
|func_footer
|spec=
This function's behavior is dependent upon the VM the script is using. [[#Mono|Mono]] is the new VM, [[#LSO|LSO]] is the old VM. The big difference between between Mono and LSO is that Mono scripts run faster and can utilize four times more memory.

===Mono===

During and after a [[LlScriptProfiler]] profiling run, llGetSPMaxMemory will return the most memory used during profiling.

=== LSO ===

This function has no effect for scripts not compiled to Mono. It will always return 16384, the fixed LSO memory size.
|caveats
|constants
|examples=<lsl>// need to run something for the profile to register...
ScriptRotate()
{
llTargetOmega(<0.5, 0.7, 0.2>, 0.75, 0.75);
}

default
{
state_entry()
{
llSetMemoryLimit( 5000 ); // set the memory limit

// call up the profiler, execute a method, stop profiler
llScriptProfiler( PROFILE_SCRIPT_MEMORY );
ScriptRotate();
llScriptProfiler( PROFILE_NONE );

// display memory usage...
llSay(0, "Memory used: " + (string)llGetSPMaxMemory() + " bytes, total memory: " +
(string)llGetMemoryLimit() + " bytes." );
}
}

// outputs
// Object: Memory used: 4448 bytes, total memory: 5000 bytes.</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetFreeMemory]]|}}
{{LSL DefineRow||[[llGetUsedMemory]]|}}
{{LSL DefineRow||[[llGetMemoryLimit]]|}}
{{LSL DefineRow||[[llSetMemoryLimit]]|}}
|also_events
|also_tests
|also_articles
|notes
|lso
|cat1=Script
|cat2=Memory
|cat3=Script Profiler
|cat4
|history = Date of Release [[ Release_Notes/Second_Life_Server/11#11.06.17.233176 | 17/06/2011 ]]
}}

PARCEL DETAILS SEE AVATARS

2013-11-03T02:00:29Z

KiraCodie Resident:

{{LSL Constant
|name={{PAGENAMEE}}
|type=integer
|value=6
|desc=This is a flag used with [[llGetParcelDetails]] to get the "See and chat with residents on this parcel" setting.
|examples=<LSL>// returns parcel data.
string getParcelDataRequest()
{
string message; //stores a temp message.

// get parcel name and details on if others can see avatars on the parcel from other parcels
list parcelData = llGetParcelDetails( llGetPos(), [PARCEL_DETAILS_NAME, PARCEL_DETAILS_SEE_AVATARS] );

// name the parcel and prepare the message.
message = "Parcel name is: " + llList2String( parcelData, 0 );

// determine if people can see avatars (1 = can see, 0 = can't see)
if( llList2String( parcelData, 1 ) == "0" )
{
message += ", avatars on other parcels can't see avatars on this parcel.";
}

// else they can see
else
{
message +=", avatars on other parcels can see avatars on this parcel.";
}

return message;
}

default
{
state_entry()
{
// calls the method for getting parcel data.
llOwnerSay( getParcelDataRequest() );
}
}
</LSL>
|functions={{LSL DefineRow||[[llGetParcelDetails]]}}
|constants={{!}}{{LSL_Constants/Parcel_Details}}
|events
|cat1=Parcel/Details
|cat2
|cat3
|cat4
}}

DATA ONLINE

2013-11-02T19:35:15Z

KiraCodie Resident:

{{LSL Constant
|inject-1={{Issues/SVC-6831}}
|name=DATA_ONLINE
|type=integer
|value=1
|desc=Used with [[llRequestAgentData]] to return a string that contains the integer boolean for if the user is online (or not). [[TRUE]] if online, [[FALSE]] if offline.
|pa=
|text=
|pb=
|examples=<lsl>key queryID; // the id key

default
{
state_entry()
{
key id = llGetOwner(); // get the owner key
queryID = llRequestAgentData( id, DATA_ONLINE ); // returns if the owner is online or not
}

dataserver( key query, string info )
{
// find the correct query id
if( query == queryID )
{
string message;

// convert the info to an actual message
if( info == "1" )
{
message = "Online";
}

else if( info == "0" )
{
message = "Offline";
}

// display that they are online or offline in owner say.
llOwnerSay( "The owner of this object is: " + message );
}
}
}</lsl>
|constants=
{{!}}
{{{!}} {{Prettytable|style=margin-top:0;margin-right:0;}}
{{LSL_Constants/llRequestAgentData}}
{{!}}}
|functions=
{{LSL DefineRow||[[llRequestAgentData]]|}}
|events=
{{LSL DefineRow||[[dataserver]]|}}
|location
|cat1
|cat2
|cat3
|cat4
}}

DATA SIM STATUS

2013-10-30T18:31:21Z

KiraCodie Resident: This is to provide an example of DATA_SIM_STATUS for people to see how to use it.

{{LSL Constant
|name=DATA_SIM_STATUS
|type=integer
|value=6
|desc=Returns one of these strings.
* "up": simulator currently up and running
* "down": simulator currently down
* "starting": simulator currently starting
* "stopping": simulator currently stopping
* "crashed": simulator has crashed
* "unknown": simulator status unknown or unknown simulator
|pa=
|text=
|pb=
|examples=<lsl>key queryData;

default
{
// querry immediately for simulator data on current status of sim.
state_entry()
{
queryData = llRequestSimulatorData( llGetRegionName(), DATA_SIM_STATUS );
}

// if another owner or the region changes where the script operates in reset script
changed( integer isChanged )
{
if( isChanged & CHANGED_REGION )
{
llResetScript();
}

if( isChanged & CHANGED_OWNER )
{
llResetScript();
}
}

// how to handle the query information.
dataserver( key queryID, string info )
{
if( queryID == queryData )
{
// output to upper case characters the current state of the sim.
llOwnerSay( "This region is currently: " + llToUpper(info) );
}
}
}</lsl>
|constants=

|functions=
{{LSL DefineRow||[[llRequestSimulatorData]]|}}
|events=

|location
|cat1
|cat2
|cat3
|cat4
}}