The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
SetObjectName
llSetObjectName
Summary
Function: llSetObjectName( string name );
Sets the prim's name according to the name parameter.
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 ASCII-7 (non-extended) character set, with the exception of the vertical bar/pipe ("|") character.
- Non-ASCII characters will be replaced with two question marks ("??").
- Objects with all-whitespace names (e.g., a space or a series of spaces) will appear as "(Unnamed)" if they emit chat via llSay, llOwnerSay, llInstantMessage, etc.
- While an object is attached, the script cannot change the name of the object as it appears in the user's inventory.
- 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.
All Issues ~
Search JIRA for related Bugs
Examples
| Set this prim's name
|
Set the root prim's name
|
default
{
state_entry()
{
llSetObjectName("NEW PRIM NAME");
}
}
|
default
{
state_entry()
{
llSetLinkPrimitiveParamsFast(LINK_ROOT,
[PRIM_NAME, "NEW ROOT PRIM NAME"]);
}
}
|
See Also
Functions
Articles
| •
|
Limits
|
–
|
SL limits and constrictions
|
|