Difference between revisions of "LlSetObjectName"

From Second Life Wiki
Jump to navigation Jump to search
(Felt like a little more could be said.)
Line 12: Line 12:
|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.
====Attachment Names====
* While an object is attached, the script cannot change the name of the object as it appears in the user's inventory. This is intended to reduce user confusion when searching for attached objects.
* 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; when the attachment is detached (to inventory, not dropped) this name change is discarded and the name in inventory is used instead.
** 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.
** 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.
* Changes to the names of child prims will be saved back to inventory when the object is detached to inventory. They survive detachment.

Revision as of 22:23, 8 July 2011

Summary

Function: llSetObjectName( string name );

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.
  • While an object is attached, the script cannot change the name of the object as it appears in the user's inventory. This is intended to reduce user confusion when searching for attached objects.
    • Changes to the name of the root prim (with llSetObjectName for example) will not be saved to inventory; when 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.
All Issues ~ Search JIRA for related Bugs

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

Search JIRA for related Issues

Signature

function void llSetObjectName( string name );