LlGetBoundingBox - Revision history

Frionil Fang: make it even clearer that it's based on physics and not the visual appearance

2024-10-09T14:32:46Z

make it even clearer that it's based on physics and not the visual appearance

← Older revision		Revision as of 07:32, 9 October 2024
Line 11:		Line 11:
	\|caveats=		\|caveats=
	* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned. This also applies if {{LSLP\|object}} is an agent sitting on an object - the bounding box of the sat-upon object (including the agent's shape) is returned.		* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned. This also applies if {{LSLP\|object}} is an agent sitting on an object - the bounding box of the sat-upon object (including the agent's shape) is returned.
	* ~~Attachments have no~~ bounding ~~boxes of their own (as they have no physical interaction{{Footnote\|~~[[Phantom]] and [[~~VolumeDetect~~]] do have physics interactions, which is why they still have bounding boxes.~~\|Phantom and VolumeDetect do~~ have ~~physics interactions, which is why~~ they ~~still~~ have ~~bounding boxes.}})~~, instead the bounding box of the avatar is returned.		* The bounding box is determined by the physics models, not the visual representation.
			** A child prim with its physics mode set to none will not affect the bounding box.
			** [[Phantom]] and [[llVolumeDetect\|volume detect]] objects do have physics interactions, which is why they still have bounding boxes.
			** Attachments have no bounding boxes of their own as they have no physics interaction, instead the bounding box of the avatar is returned.

	\|constants		\|constants

Sei Lisa: What is the bounding box of a group? :)

2022-09-24T17:53:53Z

What is the bounding box of a group? :)

← Older revision		Revision as of 10:53, 24 September 2022
Line 1:		Line 1:
	{{LSL_Function		{{LSL_Function
	\|inject-2={{LSL_Function/uuid\|object\|sim=*}}		\|inject-2={{LSL_Function/uuid\|object\|sim=*\|group=}}
	\|func_id=277\|func_sleep=0.0\|func_energy=10.0		\|func_id=277\|func_sleep=0.0\|func_energy=10.0
	\|func=llGetBoundingBox\|return_type=list		\|func=llGetBoundingBox\|return_type=list

ObviousAltIsObvious Resident at 08:40, 22 January 2015

2015-01-22T08:40:42Z

← Older revision		Revision as of 01:40, 22 January 2015
Line 14:		Line 14:

	\|constants		\|constants
	\|examples=<~~lsl~~>default//An avatar bounding box ruler thingy		\|examples=<source lang="lsl2">default//An avatar bounding box ruler thingy
	{		{
	state_entry()		state_entry()
Line 31:		Line 31:
	"\nBounding Box Size: " + (string)size, <1.0, 1.0, 1.0>, 1.0);		"\nBounding Box Size: " + (string)size, <1.0, 1.0, 1.0>, 1.0);
	}		}
	}</~~lsl~~>		}</source>

	<~~lsl~~>		<source lang="lsl2">
	// Enclose a named object in the tightest possible box		// Enclose a named object in the tightest possible box
	// that is aligned with the object's root prim axes.		// that is aligned with the object's root prim axes.
Line 69:		Line 69:
	}		}
	}		}
	</~~lsl~~>		</source>

	\|helpers=		\|helpers=
	<~~lsl~~>		<source lang="lsl2">
	//(bool) isInPrim - determines whether a given vector position in the region is within the borders of a cuboid,		//(bool) isInPrim - determines whether a given vector position in the region is within the borders of a cuboid,
	// respecting the cuboid's rotation.		// respecting the cuboid's rotation.
Line 126:		Line 126:
	return TRUE;		return TRUE;
	}		}
	</~~lsl~~>		</source>
	\|also_functions={{LSL DefineRow\|\|[[llGetAgentSize]]\|}}		\|also_functions={{LSL DefineRow\|\|[[llGetAgentSize]]\|}}
	\|also_events		\|also_events

Strife Onizuka: I'm sure that was an error. On symmetric shapes it wouldn't be noticeable.

2013-01-18T06:38:02Z

I'm sure that was an error. On symmetric shapes it wouldn't be noticeable.

← Older revision		Revision as of 23:38, 17 January 2013
Line 80:		Line 80:
	vector min = llList2Vector(bb, 0);		vector min = llList2Vector(bb, 0);
	vector max = llList2Vector(bb, 1);		vector max = llList2Vector(bb, 1);
	vPos = (llGetPos() ~~- vPos~~) / llGetRot();		vPos = (vPos - llGetPos()) / llGetRot();
	float fTemp;		float fTemp;
	if (min.x > max.x)		if (min.x > max.x)

Strife Onizuka: Is there any indication that min and max values are ever reserved? llGetPos() - vPos looks inverted.

2013-01-16T04:58:31Z

Is there any indication that min and max values are ever reserved? llGetPos() - vPos looks inverted.

@@ Line 71: / Line 71: @@
 </lsl>
-|helpers
+|helpers=
 |also_functions={{LSL DefineRow||[[llGetAgentSize]]|}}
 |also_events

Pedro Oval: Fix description and add example demonstrating the behavior

2012-08-14T18:42:50Z

Fix description and add example demonstrating the behavior

@@ Line 8: / Line 8: @@
 |return_text=that is the bounding box of {{LSLP|object}} relative to its root prim, in [[Viewer_coordinate_frames#local|local coordinates]].<br/>Format: <code>[ (vector) {{HoverText|min_corner|vector min_corner;}}, (vector) {{HoverText|max_corner|vector max_corner;}} ]</code>
 |spec=
-The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have it's faces aligned to the region axises.
+The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have its faces aligned to the object's local axes.
 |caveats=
 * Regardless if {{LSLP|object}} is a non-root prim, the bounding box of the object is returned.  This also applies if {{LSLP|object}} is an agent sitting on an object - the bounding box of the sat-upon object (including the agent's shape) is returned.
@@ Line 32: / Line 32: @@
+     }
 }</lsl>
 |helpers

Maestro Linden: Clarifying behavior per SVC-1174

2012-07-27T18:34:11Z

Clarifying behavior per SVC-1174

← Older revision		Revision as of 11:34, 27 July 2012
Line 10:		Line 10:
	The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have it's faces aligned to the region axises.		The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have it's faces aligned to the region axises.
	\|caveats=		\|caveats=
	* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned.		* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned. This also applies if {{LSLP\|object}} is an agent sitting on an object - the bounding box of the sat-upon object (including the agent's shape) is returned.
	* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.		* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.

	~~==== Server 1.36 and Beyond ====~~
	* When an avatar sits on an object, the reported bounding box for the avatar is unchanged.

	~~==== Before Server 1.36 ====~~
	* The reported box for objects and avatars is too small by 0.1 meter in all three dimensions, missing the physics tolerance buffer. This error is retained for backward script compatibility. Subtract <0.05, 0.05, 0.05> from min_corner and add <0.05, 0.05, 0.05> to max_corner for a corrected box.
	\|constants		\|constants
	\|examples=<lsl>default//An avatar bounding box ruler thingy		\|examples=<lsl>default//An avatar bounding box ruler thingy

Strife Onizuka: oops ~_~

2012-07-27T05:11:39Z

oops ~_~

← Older revision		Revision as of 22:11, 26 July 2012
Line 12:		Line 12:
	* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned.		* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned.
	* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.		* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.
	* If {{LSLP\|object}} is an avatar seated upon an object, the bounding box returned is that of the object.

	==== Server 1.36 and Beyond ====		==== Server 1.36 and Beyond ====

Strife Onizuka: oops ~_~

2012-07-27T05:11:05Z

oops ~_~

← Older revision		Revision as of 22:11, 26 July 2012
Line 13:		Line 13:
	* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.		* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.
	* If {{LSLP\|object}} is an avatar seated upon an object, the bounding box returned is that of the object.		* If {{LSLP\|object}} is an avatar seated upon an object, the bounding box returned is that of the object.
	** When an avatar sits on an object, they are linked to the object (triggering the [[changed]] event with the [[CHANGED_LINK]] flag), given a {{LSLGC\|\|link number}} (which can be used to manipulate their position with [[llSetLinkPrimitiveParamsFast]]), and their physical shape added to the object (which cannot be set to [[PRIM_PHANTOM\|phantom]], [[VolumeDetect]] or [[PRIM_PHYSICS_SHAPE_NONE\|physics ignore]]).

	==== Server 1.36 and Beyond ====		==== Server 1.36 and Beyond ====

Strife Onizuka at 05:07, 27 July 2012

2012-07-27T05:07:05Z

← Older revision		Revision as of 22:07, 26 July 2012
Line 4:		Line 4:
	\|func=llGetBoundingBox\|return_type=list		\|func=llGetBoundingBox\|return_type=list
	\|p1_type=key\|p1_name=object		\|p1_type=key\|p1_name=object
	\|func_footnote=The bounding box is for the entire link set, not just the requested prim.<br/>Returns an empty list (<code>[]</code>) if ~~'''~~object~~'''~~ is not found.		\|func_footnote=The bounding box is for the entire link set, not just the requested prim.<br/>Returns an empty list (<code>[]</code>) if {{LSLP\|object}} is not found.
	\|func_desc		\|func_desc
	\|return_text=that is the bounding box of ~~'''~~object~~'''~~ relative to its root prim, in [[Viewer_coordinate_frames#local\|local coordinates]].<br/>Format: <code>[ (vector) {{HoverText\|min_corner\|vector min_corner;}}, (vector) {{HoverText\|max_corner\|vector max_corner;}} ]</code>		\|return_text=that is the bounding box of {{LSLP\|object}} relative to its root prim, in [[Viewer_coordinate_frames#local\|local coordinates]].<br/>Format: <code>[ (vector) {{HoverText\|min_corner\|vector min_corner;}}, (vector) {{HoverText\|max_corner\|vector max_corner;}} ]</code>
	\|spec=		\|spec=
	The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have it's faces aligned to the region axises.		The physical representation of an object is made up of the shape of the prims and avatars seated upon it. The bounding box is the smallest possible cuboid which can contain the physical representation of the object and have it's faces aligned to the region axises.
	\|caveats=		\|caveats=
	* Regardless if ~~'''~~object~~'''~~ is a non-root prim, the bounding box of the object is returned.		* Regardless if {{LSLP\|object}} is a non-root prim, the bounding box of the object is returned.
	* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.		* Attachments have no bounding boxes of their own (as they have no physical interaction{{Footnote\|[[Phantom]] and [[VolumeDetect]] do have physics interactions, which is why they still have bounding boxes.\|Phantom and VolumeDetect do have physics interactions, which is why they still have bounding boxes.}}), instead the bounding box of the avatar is returned.
			* If {{LSLP\|object}} is an avatar seated upon an object, the bounding box returned is that of the object.
			** When an avatar sits on an object, they are linked to the object (triggering the [[changed]] event with the [[CHANGED_LINK]] flag), given a {{LSLGC\|\|link number}} (which can be used to manipulate their position with [[llSetLinkPrimitiveParamsFast]]), and their physical shape added to the object (which cannot be set to [[PRIM_PHANTOM\|phantom]], [[VolumeDetect]] or [[PRIM_PHYSICS_SHAPE_NONE\|physics ignore]]).

	==== Server 1.36 and Beyond ====		==== Server 1.36 and Beyond ====