Second Life Wiki - User contributions [en]

UUID

2012-11-05T17:02:44Z

Kreechur Resident: /* Land UUIDs */

{{Help |Glossary=*}}{{LSL Header}}

UUID is an abbreviation for '''Universally Unique Identifier'''. It is a 128-bit (16 byte) value which is generated in such a way as to make collisions very unlikely. They are often represented as a string of 32 hex characters with four dashes interspersed. See [http://en.wikipedia.org/wiki/UUID Wikipedia on UUIDs] for more information.

In LSL they are stored in the [[key]] variable type (which is a specialized form of a string).

== The UUID and Secondlife ==
In Second Life every object and every avatar has an UUID and they can be split up into four groups: Asset, Instance, Account and Land UUID's.

SL uses Version 4 UUIDs as defined in {{RFC|4122|target=section-4.1.3}}, though there are some that are not V4.

=== Inventory ===
Inventory as it is thought of is really only a permissions layer. The inventory item, is really just a wrapper around an [[asset]]. The wrapper contains the permissions, creator & owner of the asset and a link to the asset. The link is the asset UUID.

=== Asset UUIDs ===
Asset UUIDs are used as the handle for all types that can be inventory items. The asset UUID is what is returned by [[llGetInventoryKey]] and by the "Copy UUID" feature in the client. Full (asset) permissions are required to get the UUID. Assets are immutable (they cannot be modified); when the user is editing an asset, they are in fact creating new assets. The appearance is that modified inventory items are assigned new UUIDs.

* Animation
* Gestures
* Objects
* Notecards
* Scripts
* Sounds
* Textures (including sculpty textures)
----
*When an Object is modified in-world, it is not assigned a new asset UUID until it is derezzed, copied back to inventory or during sim-state save. Modifying an instance of an asset will not update other instances or inventory copies.
*Brand new notecards are just asset wrappers without an asset. That is to say, new notecards have an asset UUID of [[NULL_KEY]]. The asset isn't created until the notecard is edited and then saved.
*Assets that are no longer inventory and are not referenced by any script are eventually deleted. Before they are deleted they are place in a database where they await deletion but can still be revived.

=== Instance UUIDs ===
Every time an object is [[rez]]zed, all of the prims (including the root prim) are assigned instance UUIDs. An avatar's attachments keeps it's instance UUIDs when the user teleports or moves from one region to another (they are not kept when an avatar logs off). The instance UUID is what is returned by [[llGetKey]] and other functions.

=== Account UUIDs ===
Account UUIDs are assigned during the creation process and never change. They are generally public information.
* Avatar - Public
* Group - Public or private depending on setup.
The avatar UUID is returned by [[llGetOwner]] and other functions.

=== Land UUIDs ===
* Parcel
* Region
----
* This information is technically available to the public but there is no interface to get at it directly (the UUIDs are sent to the client but consumed internally and never exposed to the user).
** The parcel UUID is returned by [[llGetParcelDetails]].
* Only one instance of these can exist in-world at any time.
** When copied, new UUIDs are assigned.
* Modification does not cause a new UUID to be assigned.

Viewer URI Name Space

2011-09-07T22:17:36Z

Kreechur Resident: corrected /chat to reflect that it does not work on channel 0

{{ProtocolNav}}

== Overview ==

The SL client supports links of the format secondlife://Region/123/45/67/, which have traditionally specified a region name and x/y/z location. This means "run Second Life viewer and show Region on the world map".

The new URL scheme has 3 slashes, and allows direct control of the user interface and login. For example, secondlife:///app/login

Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports. SLURLs that work with external browsers include:
* <nowiki>secondlife://<region name></nowiki>
* secondlife:///app/login

In chat, dialogs and other user interface elements, these URLs will be highlighted as clickable links, often with custom formatting including icons. The full functionality is available in Viewer 2.0 and up. Clickable links without formatting were available only in older versions' chat and IM history.

These links also may be known as ''Viewer URL Namespace'', ''SLAPP URLs'' or ''Application SLURL''.

== Syntax ==

'''<nowiki>secondlife://</nowiki>'''
: '''<region_name>''' log in to this region or, if logged in, show information and offer teleport
:: '''/<local_x>''' optional X position, defaults to 128
::: '''/<local_y>''' optional Y position, defaults to 128
:::: '''/<local_z>''' optional Z position, defaults to 0

: '''/app'''
:: '''/agent'''
::: '''/<agent_id>'''
:::: '''/about''' open agent's profile, with 2nd Life tab selected
:::: '''/inspect''' display info dialog for agent (2.0)
:::: '''/im''' start an IM session with the agent (2.0)
:::: '''/offerteleport''' display teleport offer dialog (2.0)
:::: '''/pay''' display pay resident dialog (2.0)
:::: '''/requestfriend''' display friendship offer dialog (2.0)
:::: '''/mute''' add to block list (2.0)
:::: '''/unmute''' remove from block list (2.0)
:::: '''/completename''' replace the URL with the avatar's display and user names,
:::::e.g. "hmm <nowiki>secondlife:///app/agent/eea40b5a-553d-4a07-b1ca-9f6e2f867814/complete</nowiki> wow" in chat becomes "hmm Cerise (cerise.sorbet) wow" (2.4)
:::: '''/displayname''' replace the URL with the avatar's display name (2.4)
:::: '''/username''' replace the URL with the avatar's username e.g. "user.name" (2.4)
:: '''/appearance'''
::: '''/show''' display the sidebar appearance tab (2.0)
:: '''/balance'''
::: '''/request''' request a L$ balance update from the server (2.0)
:: '''/chat'''
::: '''/<channel>''' any channel number greater than 0
:::: '''/<text>'''
:: '''/classified'''
::: '''/<classified_id>'''
:::: '''/about''' open floater describing classified
:: '''/event'''
::: '''/<event_id>'''
:::: '''/about''' open floater describing event
:: '''/group'''
::: '''/<group_id>'''
:::: '''/about''' open floater describing group
:::: '''/inspect''' display info dialog for group (2.0)
::: '''/create''' open the create group dialog (1.20)
::: '''/list'''
:::: '''/show''' open the list of groups to which user belongs (1.20)
:: '''/help'''
::: '''/<help_query>''' optional help topic (2.0)
:: '''/inventory'''
::: '''/<inventory_id>'''
:::: '''/select''' inventory offer (2.0)
::: '''/show''' open the inventory sidebar tab (2.0)
:: '''/login''' log in on launch. External and internal browsers.
::: see below for query parameters, of course, values are URL escaped
:: '''/maptrackavatar'''
::: '''/<friend_id>''' find a friend on the world map, requires permission (2.4)
:: '''/objectim'''
::: '''/<object_id>''' display an info dialog for the object sending this message (2.0)
:::: '''?name=<object_name>'''
:::: '''&owner=<owner_id>'''
:::: '''&groupowned=true''' (add if the object is deeded to a group)
:::: '''&slurl=<region>/<x>/<y>/<z>'''
:: '''/parcel'''
::: '''/<parcel_id>'''
:::: '''/about''' open floater describing place
:: '''<strike>/region'''
::: '''/<region_id>'''
:::: '''/about''' information from database about that region? list of parcels? covenant?</strike>
:: '''/search'''
::: '''/<category>''' "all", "people", "places", "events", "groups", "wiki", "destinations", "classifieds"
:::: '''/<search_term>''' open a search floater with matching results (2.0)
:: '''/sharewithavatar'''
::: '''/<agent_id>''' open an inventory share/IM window for agent (2.4)
:: '''/teleport'''
::: '''/<region_name>''' teleport instantly to this region, no dialog
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0
:: '''/voicecallavatar'''
::: '''/<agent_id>''' start a private voice session (2.4)
:: '''/worldmap''' open the map with this destination selected (2.0)
::: '''/<region_name>'''
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0

This could be extended to things like:
: '''/app/event/<event_id>/subscribe''' to register for notifications
: '''/app/parcel/<parcel_id>/teleport''' to teleport to a specific location

== Login Query Parameters ==
{| border="1"
|-
| first || the account first name
|-
| last || the account last name
|-
| session || the secure session id
|-
| location || login location, format TBD, optional
|}

[[Category:Name Spaces]]
[[Category:Search]]
[[Category:LSL Chat]]
[[Category:LSL_Dialog]]

AGENT

2011-07-07T12:44:58Z

Kreechur Resident:

{{LSL Constant
|name=AGENT
|type=integer
|value={{LSL Hex|0x1}}
|desc=If it is contained in the result of llDetectedType(), it means it is avatar.<br />If it is used as an filter of llSensor() or llSensorRepeat(), it will search for avatars.
|constants={{LSL Constants Sensor|no_wrapper=true|examples=*}}
|caveats=There is no avatar whose llDetectedType() is ''equal to'' 1([[AGENT]]) since there is no avatar who doesn't require the physical calculation, even if they are just standing. Standing agent's type will be equal to 3([[AGENT]]<nowiki>|</nowiki>[[ACTIVE]]). Sitting agent's type will be equal to 5([[AGENT]]<nowiki>|</nowiki>[[PASSIVE]]).
|functions=
{{LSL DefineRow||[[llDetectedType]]|}}
{{LSL DefineRow||[[llSensor]]|}}
{{LSL DefineRow||[[llSensorRepeat]]|}}
|events=
|cat1=Sensor
|cat2
|cat3
|cat4
}}

User:LindaB Helendale/UTF8StringLength

2011-04-20T12:45:01Z

Kreechur Resident:

{{LSL Header}}
UTF8StringLength : returns the number of bytes a string takes in UTF-8 coding.

Channel communication, llOwnerSay, notecards, email, http calls, etc. use UTF-8 coding, with one character taking one, two or three bytes. The limits of message length are defined as bytes (e.g. llEmail 4500 bytes, llSay 1024 bytes). This function can be used to guard against clipped messages and to split long messages to parts that fit in the limits.

Explanation of the formula:
L is the string length in utf-8 we want.
N is the length of the string escaped by llEscapeURL.
In the escaped string utf-8 characters with [1, 2, 3] bytes
map to strings of [1, 6, 9] plain ascii chars, with each triplet
of the form %XX.
Let P be the number of '%' characters in the escaped string,
and n1, n2 and n3 the number of 1,2 and 3 byte characters. Then
L = n1 + 2 n2 + 3 n3
N = n1 + 6 n2 + 9 n3
P = 2 n1 + 3 n3
Substitute P to N
N = n1 + 3 P => n1 = N - 3 P
and substitute in L
L = (N - 3 P) + P = N - 2 P

Another way to derive the formula, more intuitively:
In the escaped string every % represents triplet %XX, corresponding to
one byte in the UTF-8 code, and it increases the escaped string length
by three, thus subtracting 2*number of "%"'s from the escaped string
length gives the number of bytes.

You may use this script any way you wish.
(c) LindaB Helendale

<lsl>
integer UTF8StringLength(string str) {
// UTF8StringLength : returns the number of bytes a string takes in UTF-8 coding.
// Useful in guarding against limits in communication to avoid clipped messages.
// LindaB Helendale, permission to use this script in any way granted.
string strEscaped = llEscapeURL(str);
integer N = llStringLength(strEscaped);
integer P = llGetListLength(llParseStringKeepNulls(strEscaped,["%"],[]))-1;
return N - 2 * P ;
}
</lsl>

Demo script to see it works:
<lsl>
integer UTF8StringLength(string str) {
// UTF8StringLength : returns the number of bytes a string takes in UTF-8 coding.
// Useful in guarding against limits in communication to avoid clipped messages.
// LindaB Helendale, permission to use this script in any way granted.
string strEscaped = llEscapeURL(str);
integer N = llStringLength(strEscaped);
integer P = llGetListLength(llParseStringKeepNulls(strEscaped,["%"],[]))-1;
return N - 2 * P ;
}

test(string s) {
llOwnerSay("[" + s + "] Length: " + (string)llStringLength(s) + " characters, " + (string)UTF8StringLength(s) + " bytes");
}

default
{
state_entry()
{
test("This should be 24 bytes.");
test("% or %% won't break it :)");
test("ÄÖÅ are two bytes each, they add 3 bytes.");
test("these 20 three-byte chars add 40 bytes ☈☉☊☋☌☍☎☏☐☑☒ℋℌℍℏℐℑℒ⚃㐎.");
}
}
</lsl>
With output
[04:45] demo: [This should be 24 bytes.] Length: 24 characters, 24 bytes
[04:45] demo: [% or %% won't break it :)] Length: 25 characters, 25 bytes
[04:45] demo: [ÄÖÅ are two bytes each, they add 3 bytes.] Length: 41 characters, 44 bytes
[04:45] demo: [these 20 three-byte chars add 40 bytes ☈☉☊☋☌☍☎☏☐☑☒ℋℌℍℏℐℑℒ⚃㐎.] Length: 60 characters, 100 bytes

{{#vardefine:sort|UTF8StringLength}}{{LSLC|Examples}}
[[Category:LSL Examples]]