Difference between revisions of "LlSetObjectName"
Jump to navigation
Jump to search
Felis Darwin (talk | contribs) (Fix link) |
Lady Sumoku (talk | contribs) m (Replaced old <LSL> block with <source lang="lsl2">) |
||
| Line 26: | Line 26: | ||
! '''Set the root prim's name''' | ! '''Set the root prim's name''' | ||
{{!}}- | {{!}}- | ||
{{!!}}< | {{!!}}<source lang="lsl2"> | ||
default | default | ||
{ | { | ||
| Line 34: | Line 34: | ||
} | } | ||
} | } | ||
</ | </source> | ||
{{!!}} | {{!!}} | ||
< | <source lang="lsl2"> | ||
default | default | ||
{ | { | ||
| Line 45: | Line 45: | ||
} | } | ||
} | } | ||
</ | </source> | ||
{{!}}} | {{!}}} | ||
|helpers | |helpers | ||
Revision as of 13:22, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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 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
| 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
| • | 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
- ^ 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 ); |