Difference between revisions of "LlSetObjectDesc"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 1: Line 1:
{{LSL_Function/limits}}{{LSL_Function
{{Issues/VWR-437}}{{Issues/VWR-3429}}{{LSL_Function/limits}}{{LSL_Function
|func=llSetObjectDesc
|func=llSetObjectDesc
|func_id=271|func_sleep=0.0|func_energy=10.0
|func_id=271|func_sleep=0.0|func_energy=10.0
Line 8: Line 8:
|spec
|spec
|caveats=*The object description is limited to 127 bytes, any string longer then that will be truncated.
|caveats=*The object description is limited to 127 bytes, any string longer then that will be truncated.
*According to [http://jira.secondlife.com/browse/VWR-437 VWR-437] if you set the description to longer then 256 bytes the object may no longer be rezzable. Use caution if using this field to store data.
*The pipe character | is not legal in an object's description, it will be replaced by a '?'{{Footnote|This is because the pipe character historically has been used to separate fields in the serialized version of inventory.}}.
*The pipe character | is not legal in an object's description, it will be replaced by a '?'.
*According to [http://jira.secondlife.com/browse/SVC-3429 SVC-3429] the description field will not persist on the root prim of an attached object if detached. It will persist if dropped.  One workaround is to store the description in a child prim which is persisted.
|constants
|constants
|examples=<lsl>//store the owner's name in the prim description
|examples=<lsl>//store the owner's name in the prim description

Revision as of 17:31, 30 March 2009

Summary

Function: llSetObjectDesc( string desc );
0.0 Forced Delay
10.0 Energy

Sets the prims description

• string desc

Caveats

  • The object description is limited to 127 bytes, any string longer then that will be truncated.
  • The pipe character | is not legal in an object's description, it will be replaced by a '?'[1].

Examples

<lsl>//store the owner's name in the prim description default {

   touch_start(integer total_number)
   {
       string temp;
       temp = llKey2Name(llGetOwner());
       llSetObjectDesc(temp);
   }
}</lsl>

See Also

Functions

•  llGetObjectDesc Gets the prim description.
•  llGetObjectName Gets the prim name.
•  llSetObjectName Sets the prim name.

Articles

•  Limits SL limits and constrictions
•  Prim Attribute Overloading

Deep Notes

Footnotes

  1. ^ This is because the pipe character historically has been used to separate fields in the serialized version of inventory.

Signature

function void llSetObjectDesc( string desc );