boundingBoxReal: Difference between revisions

Latest revision as of 06:08, 27 November 2023

0.50

GAGlobal

Hover & click on the images for description

Description

Description:: Returns a raw bounding box of given object in model coordinates space. This command is similar to boundingBox but gives more precise measurements.
The alternative syntax allows to specify clipping type to be used, which in some cases could make the result even more precise.
Groups:: Object Manipulation

Syntax 1

Syntax:: boundingBoxReal object
Parameters:: object: Object
Return Value:: Array - the extreme points of the model in format PositionRelative, as well as (since 1.92) bounding box sphere radius, to format [[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]

1.92

Syntax 2

Syntax:

clippingType boundingBoxReal object

Parameters:

clippingType: Number - can be one of:

0 - ClipVisual (can significantly reduce bounding box's size on buildings)
1 - ClipShadow
2 - ClipGeometry
3 - ClipGeneral (same type that is used in the main syntax)

object: Object

Return Value:

Array - the extreme points of the model in format PositionRelative, as well as bounding box sphere radius, to format [[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]

2.14

Syntax 3

Syntax:

boundingBoxReal [object, LOD]

Parameters:

object: Object

LOD: String or Number - can be one of:

"Memory"
"Geometry"
"FireGeometry"
"LandContact"
"HitPoints"
"ViewGeometry"

When Number is used, command searches for a LOD with the similar LOD resolution

Return Value:

Array - the extreme points of the model in format PositionRelative, as well as bounding box sphere radius, to format [[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]

Examples

Example 1:: private _bbr = boundingBoxReal vehicle player; private _p1 = _bbr select 0; private _p2 = _bbr select 1; private _maxWidth = abs ((_p2 select 0) - (_p1 select 0)); private _maxLength = abs ((_p2 select 1) - (_p1 select 1)); private _maxHeight = abs ((_p2 select 2) - (_p1 select 2));
Example 2:: hint str (0 boundingBoxReal cursorObject);

Additional Information

See also:: boundingBox sizeOf boundingCenter

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

@@ Line 1: / Line 1: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma3 |= Game name
+|game1= arma3
+|version1= 0.50
-|0.50|= Game version
+|arg= global
-____________________________________________________________________________________________
-| Returns a bounding box of given object in model coordinates space.  |= Description
+|gr1= Object Manipulation
-____________________________________________________________________________________________
-| '''boundingBoxReal''' obj |= Syntax
+|descr= [[File:Boundingbox.jpg|right|200px]] Returns a raw bounding box of given object in model coordinates space. This command is similar to [[boundingBox]] but gives more precise measurements.<br>
+The alternative syntax allows to specify clipping type to be used, which in some cases could make the result even more precise.
-|p1= obj: [[Object]]  |= PARAMETER1
+|s1= [[boundingBoxReal]] object
-| [[Array]] - An array with the extreme points of the model. Format <nowiki>[[</nowiki>minX, minZ, minY], [maxX, maxZ, maxY<nowiki>]]</nowiki>. |= RETURNVALUE
+|p1= object: [[Object]]
+|r1= [[Array]] - the extreme points of the model in format [[Position#PositionRelative|PositionRelative]], as well as (since {{GVI|arma3|1.92|size= 0.75}}) bounding box sphere radius, to format [<nowiki/>[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]
-|x1= <code>
+|s2= clippingType [[boundingBoxReal]] object
-</code>|= EXAMPLE1
-____________________________________________________________________________________________
+|s2since= arma3 1.92
-|  |= SEEALSO
+|p21= clippingType: [[Number]] - can be one of:
+* 0 - ClipVisual (can significantly reduce bounding box's size on buildings)
+* 1 - ClipShadow
+* 2 - ClipGeometry
+* 3 - ClipGeneral (same type that is used in the main syntax)
-|  |= MPBEHAVIOUR
+|p22= object: [[Object]]
-____________________________________________________________________________________________
-}}
+|r2= [[Array]] - the extreme points of the model in format [[Position#PositionRelative|PositionRelative]], as well as bounding box sphere radius, to format [<nowiki/>[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]
+|s3= [[boundingBoxReal]] [object, LOD]
+|s3since= arma3 2.14
+|p41= object: [[Object]]
+|p42= LOD: [[String]] or [[Number]] - can be one of:
+* {{hl|"Memory"}}
+* {{hl|"Geometry"}}
+* {{hl|"FireGeometry"}}
+* {{hl|"LandContact"}}
+* {{hl|"HitPoints"}}
+* {{hl|"ViewGeometry"}}
+When [[Number]] is used, command searches for a LOD with the similar [[LOD resolutions|LOD resolution]]
+|r3= [[Array]] - the extreme points of the model in format [[Position#PositionRelative|PositionRelative]], as well as bounding box sphere radius, to format [<nowiki/>[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereRadius]
-<h3 style='display:none'>Notes</h3>
+|x1= <sqf>
-<dl class='command_description'>
+private _bbr = boundingBoxReal vehicle player;
-<!-- Note Section BEGIN -->
+private _p1 = _bbr select 0;
+private _p2 = _bbr select 1;
+private _maxWidth = abs ((_p2 select 0) - (_p1 select 0));
+private _maxLength = abs ((_p2 select 1) - (_p1 select 1));
+private _maxHeight = abs ((_p2 select 2) - (_p1 select 2));
+</sqf>
-<!-- Note Section END -->
+|x2= <sqf>hint str (0 boundingBoxReal cursorObject);</sqf>
-</dl>
-<h3 style='display:none'>Bottom Section</h3>
+|seealso= [[boundingBox]] [[sizeOf]] [[boundingCenter]]
-[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
+}}
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]