Difference between revisions of "LlSetObjectName"

From Second Life Wiki
Jump to navigation Jump to search
m (attachment warning was only in llgetobjectdesc)
(Felt like a little more could be said.)
Line 11: Line 11:
|spec
|spec
|caveats=
|caveats=
*The name is limited to 63 characters. Longer prim names appeared cut short.
* The name is limited to 63 characters. Longer prim names appeared cut short.
*When an attached 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. This caveat does ''not'' apply to child prims.
====Attachment Names====
* While an attachment is attached, the script cannot change the name of the attachment as it appears in the user's inventory. This is intended to reduce user confusion when searching for attachments.
** Changes to the name of the root prim (with [[llSetObjectName]] for example) will not be saved to inventory; if the attachment is detached (to inventory, not dropped) this name change is discarded and the name in inventory is used instead.
** Dropping an attachment (to the ground) and taking it into inventory will <!--somebody please verify this--> cause the inventory name of the attachment to be the changed name.
* Changes to the names of child prims will be saved back to inventory when the object is detached to inventory. They survive detachment.
|constants
|constants
|examples=<lsl>default
|examples=<lsl>default

Revision as of 21:20, 8 July 2011

Summary

Function: llSetObjectName( string name );
0.0 Forced Delay
10.0 Energy

Sets the prim's name according to the name parameter.

• string name

If this function is called from a child prim in a linked set, it will change the name of the child prim and not the root prim.

Caveats

  • The name is limited to 63 characters. Longer prim names appeared cut short.

Attachment Names

  • While an attachment is attached, the script cannot change the name of the attachment as it appears in the user's inventory. This is intended to reduce user confusion when searching for attachments.
    • Changes to the name of the root prim (with llSetObjectName for example) will not be saved to inventory; if the attachment is detached (to inventory, not dropped) this name change is discarded and the name in inventory is used instead.
    • Dropping an attachment (to the ground) and taking it into inventory will cause the inventory name of the attachment to be the changed name.
  • Changes to the names of child prims will be saved back to inventory when the object is detached to inventory. They survive detachment.

Examples

<lsl>default {

   state_entry()
   {
       string yyyy1mm1dd = llGetDate();
       string name = yyyy1mm1dd + " " + llGetObjectName();
       llOwnerSay("llSetObjectName(\"" + name + "\")");
       llSetObjectName(name);
   }
}</lsl>

See Also

Functions

•  llGetObjectName Get the prims name
•  llGetLinkName Get a linked prims name
•  llGetObjectDesc Get the prims description
•  llSetObjectDesc Set the prims description
•  llGetObjectDetails Get a list of object details

Articles

•  Limits SL limits and constrictions

Deep Notes

Signature

function void llSetObjectName( string name );