Difference between revisions of "LlSetObjectDesc"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 8: Line 8:
|spec
|spec
|caveats=
|caveats=
*The object description is limited to 127 bytes, any string longer then that will be truncated.
*The 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 '?'{{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 '?'{{Footnote|This is because the pipe character historically has been used to separate fields in the serialized version of inventory.}}.
*When an object is detached, changes made by script to the name and description (of the root prim) of the attachment will be lost. While the object is attached the name and description can be changed but it will not be reflected in inventory. These limitations do ''not'' apply to child prims.
*When an object is detached, changes made by script to the name and description (of the root prim) of the attachment will be lost. While the object is attached the name and description can be changed but it will not be reflected in inventory. These limitations do ''not'' apply to child prims.

Revision as of 18:49, 30 March 2009

Summary

Function: llSetObjectDesc( string description );

Sets the prims description

• string description

Caveats

  • The 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].
  • When an object is detached, changes made by script to the name and description (of the root prim) of the attachment will be lost. While the object is attached the name and description can be changed but it will not be reflected in inventory. These limitations do not apply to child prims.

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   Name or description change, of an attached object, is rolled back when object is detached

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

All Issues

~ Search JIRA for related Issues
   llSetObjectDesc and editor panel have different description string length limits
   Name or description change, of an attached object, is rolled back when object is detached

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 description );