Second Life Wiki - User contributions [en]

LlGetAgentSize

2009-08-22T12:26:43Z

Sathirali Yoshikawa:

{{LSL Function/avatar|id|sim=*}}{{LSL_Function
|func_id=218|func_sleep=0.0|func_energy=10.0
|func=llGetAgentSize|return_type=vector|p1_type=key|p1_name=id
|func_footnote={{LSL Const|ZERO_VECTOR|vector|{{LSL VR|0.0|0.0|0.0}}}} is returned if '''id''' is not in the region or if it is not an avatar.
|func_desc
|return_text=that is the size of the requested avatar by '''id'''.
|spec
|caveats
|constants
|examples=
<lsl>//A simple script that makes a box hover above the owner's head.
default {
state_entry(integer i) {
key owner = llGetOwner();
vector pos = llList2Vector(llGetObjectDetails(owner, [OBJECT_POS]),0);
vector agent = llGetAgentSize(owner);
pos.z += 0.5 + agent.z / 2;//"pos" needs to be adjusted so it appears above the owner.
if(agent)//makes sure it found the owner, a zero vector evaluates as false
llSetPos(pos);
}
touch_start(integer num) {
llResetScript();
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetObjectDetails]]|}}
{{LSL DefineRow||[[llGetBoundingBox]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llRequestAgentData]]|}}
|also_events
|also_tests
|also_articles
|notes=
* This function is a good way to quickly test...
** if an avatar is in the same region.
** if a UUID known to be in the region is an avatar.

To use this function to test either case use as follows
<lsl>if(llGetAgentSize(uuid)) {
//uuid is an avatar in the region
} else {
//uuid is not an avatar in the region
}</lsl>

* The returned vector holds the size of the avatar's bounding box{{Footnote|In fact the returned height is much smaller than the bounding box height. To get the actual avatar height in meters (counting shoes, and with a +/-3cm precision) apply a factor of 1.125. You can test this by changing a prim to with llSetScale and compare the size!}}, of which only the height (z) varies. Width (x) and depth (y) are constant. (0.45m and 0.6m respectively).
|cat1
|cat2=Avatar
|cat3
|cat4
}}

LlGetAgentSize

2009-08-22T12:24:01Z

Sathirali Yoshikawa: Undo revision 446983 by Henri Beauchamp (Talk)

{{LSL Function/avatar|id|sim=*}}{{LSL_Function
|func_id=218|func_sleep=0.0|func_energy=10.0
|func=llGetAgentSize|return_type=vector|p1_type=key|p1_name=id
|func_footnote={{LSL Const|ZERO_VECTOR|vector|{{LSL VR|0.0|0.0|0.0}}}} is returned if '''id''' is not in the region or if it is not an avatar.
|func_desc
|return_text=that is the size of the requested avatar by '''id'''.
|spec
|caveats
|constants
|examples=
<lsl>//A simple script that makes a box hover above the owner's head.
default {
state_entry(integer i) {
key owner = llGetOwner();
vector pos = llList2Vector(llGetObjectDetails(owner, [OBJECT_POS]),0);
vector agent = llGetAgentSize(owner);
pos.z += 0.5 + agent.z / 2;//"pos" needs to be adjusted so it appears above the owner.
if(agent)//makes sure it found the owner, a zero vector evaluates as false
llSetPos(pos);
}
touch_start(integer num) {
llResetScript();
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetObjectDetails]]|}}
{{LSL DefineRow||[[llGetBoundingBox]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llRequestAgentData]]|}}
|also_events
|also_tests
|also_articles
|notes=
* This function is a good way to quickly test...
** if an avatar is in the same region.
** if a UUID known to be in the region is an avatar.

To use this function to test either case use as follows
<lsl>if(llGetAgentSize(uuid)) {
//uuid is an avatar in the region
} else {
//uuid is not an avatar in the region
}</lsl>

* The returned vector holds the size of the avatar's bounding box{{Footnote|In fact the returned height is much smaller than the bounding box height. To get the actual avatar height in meters (counting shoes, and with a +/-3cm precision) apply a factor of 1.125}}, of which only the height (z) varies. Width (x) and depth (y) are constant. (0.45m and 0.6m respectively). You can test this by changing a prim to with llSetScale and compare the size!
|cat1
|cat2=Avatar
|cat3
|cat4
}}

LlGetAgentSize

2009-06-11T22:12:56Z

Sathirali Yoshikawa:

{{LSL Function/avatar|id|sim=*}}{{LSL_Function
|func_id=218|func_sleep=0.0|func_energy=10.0
|func=llGetAgentSize|return_type=vector|p1_type=key|p1_name=id
|func_footnote={{LSL Const|ZERO_VECTOR|vector|{{LSL VR|0.0|0.0|0.0}}}} is returned if '''id''' is not in the region or if it is not an avatar.
|func_desc
|return_text=that is the size of the requested avatar by '''id'''.
|spec
|caveats
|constants
|examples=
<lsl>//A simple script that makes a box hover above the owner's head.
default {
state_entry(integer i) {
key owner = llGetOwner();
vector pos = llList2Vector(llGetObjectDetails(owner, [OBJECT_POS]),0);
vector agent = llGetAgentSize(owner);
pos.z += 0.5 + agent.z / 2;//"pos" needs to be adjusted so it appears above the owner.
if(agent)//makes sure it found the owner, a zero vector evaluates as false
llSetPos(pos);
}
touch_start(integer num) {
llResetScript();
}
}</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetObjectDetails]]|}}
{{LSL DefineRow||[[llGetBoundingBox]]|}}
{{LSL DefineRow||[[llGetAgentInfo]]|}}
{{LSL DefineRow||[[llRequestAgentData]]|}}
|also_events
|also_tests
|also_articles
|notes=
* This function is a good way to quickly test...
** if an avatar is in the same region.
** if a UUID known to be in the region is an avatar.

To use this function to test either case use as follows
<lsl>if(llGetAgentSize(uuid)) {
//uuid is an avatar in the region
} else {
//uuid is not an avatar in the region
}</lsl>

* The returned vector holds the size of the avatar's bounding box{{Footnote|In fact the returned height is much smaller than the bounding box height. To get the actual avatar height in meters (counting shoes, and with a +/-3cm precision) apply a factor of 1.125}}, of which only the height (z) varies. Width (x) and depth (y) are constant. (0.45m and 0.6m respectively).
|cat1
|cat2=Avatar
|cat3
|cat4
}}