Difference between revisions of "LlSetObjectName"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 14: Line 14:
* Names can only consist of the 95 printable characters found in the {{wikipedia|ASCII|ASCII-7}} (non-extended) character set.
* Names can only consist of the 95 printable characters found in the {{wikipedia|ASCII|ASCII-7}} (non-extended) character set.
** Non-ASCII characters will be replaced with two question marks ("??").
** Non-ASCII characters will be replaced with two question marks ("??").
* While an object is attached, the script cannot change the name of the object as it appears in the user's inventory. This behavior [http://forums-archive.secondlife.com/255/ab/84853/1.html was a bug], but it [https://jira.secondlife.com/browse/SVC-3429?focusedCommentId=267372&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-267372 remained long enough to become permanent].
* While an object is attached, the script cannot change the name of the object as it appears in the user's inventory.{{Footnote|2=Whether or not this is a bug is still debated, regardless LL has said they will not fix it. This behavior was first recognized as a pain point in 2006 and only confirmed to be lava-flowed more recently (2011).|1=Whether or not this is a bug is still debated, regardless LL has said they will not fix it. This behavior was first recognized as a pain point in [http://forums-archive.secondlife.com/255/ab/84853/1.html 2006] and only confirmed to be lava-flowed [https://jira.secondlife.com/browse/SVC-3429?focusedCommentId=267372&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-267372 more recently (2011)].}}
** 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; 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 <!--somebody please verify this--> cause the inventory name of the attachment to be the changed name.
** When attachment is dropped (to the ground) and taking it into inventory, the inventory item will have the new name (not the old).
* 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.
|constants
|constants

Revision as of 22:55, 19 May 2012

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 are cut short.
  • Names can only consist of the 95 printable characters found in the "Wikipedia logo"ASCII-7 (non-extended) character set.
    • Non-ASCII characters will be replaced with two question marks ("??").
  • While an object is attached, the script cannot change the name of the object as it appears in the user's inventory.[1]
    • 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.
    • When attachment is dropped (to the ground) and taking it into inventory, the inventory item will have the new name (not the old).
  • 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

Footnotes

  1. ^ Whether or not this is a bug is still debated, regardless LL has said they will not fix it. This behavior was first recognized as a pain point in 2006 and only confirmed to be lava-flowed more recently (2011).

Signature

function void llSetObjectName( string name );