Difference between revisions of "LlSetObjectDesc"

From Second Life Wiki
Jump to navigation Jump to search
m (Added caveat to Jira regarding non persistence of dropped attachment and touched on workaround)
Line 10: Line 10:
*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.
*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 '?'.
*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] 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 09:45, 28 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.
  • According to 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 '?'.
  • According to [1] 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.

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

Signature

function void llSetObjectDesc( string desc );