boundingBox: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(clarified coordinates)
m (Text replacement - "\{\{Feature *\| *Informative *\| ([^↵]+) *\}\}" to "{{Feature|informative|$1}}")
 
(64 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Returns a bounding box of given object in model coordinate space.  |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| [[Array]] <nowiki>=</nowiki> '''boundingBox''' model |= Syntax
|game4= tkoh
|version4= 1.00


|p1= model : [[Object]] |= Parameter 1
|game5= arma3
|version5= 0.50


| [[Array]] - An array with the extreme points of the model. Format: [[minX, minY, minZ], [maxX, maxY, maxZ]]
|gr1= Object Manipulation


[[Image:BoundingBox.jpg|200px]] |= Return value
|descr= [[File:Boundingbox.jpg|right|200px]] Returns a bounding box of given object in model coordinate space, adjusted according to destruction/animation of an object. This command is rather generous on the size estimation, for more precise coordinates use [[boundingBoxReal]].
____________________________________________________________________________________________
{{Feature|informative|In {{GVI|arma3|1.92}} The output of both syntaxes got extended to include bounding sphere diameter. See also [[sizeOf]].}}


|x1= <code>_box <nowiki>=</nowiki> '''boundingBox''' _abrams</code>|= Example 1
|s1= [[boundingBox]] object
____________________________________________________________________________________________


| |= See also
|p1= object: [[Object]]


}}
|r1= [[Array]] - an array with the extreme points of the model in format [[Position#PositionRelative|PositionRelative]], as well as bounding box sphere diameter.<br>Format [<nowiki/>[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereDiameter].
 
|s2= clippingType [[boundingBox]] object
 
|s2since= arma3 1.92
 
|p21= clippingType: [[Number]] - clipping type could be:
* 0 - ClipVisual (could significantly reduce the size of bounding boxes on buildings)
* 1 - ClipShadow
* 2 - ClipGeometry
* 3 - ClipGeneral (Default, the same type that is used in main syntax)
 
|p22= object: [[Object]]


<h3 style="display:none">Notes</h3>
|r2= [[Array]] - an array with the extreme points of the model bounding box in format [[Position#PositionRelative|PositionRelative]], as well as bounding box sphere diameter.<br>Format [<nowiki/>[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereDiameter].
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>private _box = boundingBox _abrams;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>hint str (0 boundingBox cursorObject);</sqf>


[[Category:Scripting Commands|BOUNDINGBOX]]
|seealso= [[sizeOf]] [[boundingBoxReal]] [[boundingCenter]] [[BIS_fnc_boundingBoxDimensions]]
[[Category:Scripting Commands ArmA|BOUNDINGBOX]]
}}
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]

Latest revision as of 18:11, 15 March 2024

Hover & click on the images for description

Description

Description:
Boundingbox.jpg
Returns a bounding box of given object in model coordinate space, adjusted according to destruction/animation of an object. This command is rather generous on the size estimation, for more precise coordinates use boundingBoxReal.
In Arma 3 logo black.png1.92 The output of both syntaxes got extended to include bounding sphere diameter. See also sizeOf.
Groups:
Object Manipulation

Syntax

Syntax:
boundingBox object
Parameters:
object: Object
Return Value:
Array - an array with the extreme points of the model in format PositionRelative, as well as bounding box sphere diameter.
Format [[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereDiameter].

Alternative Syntax

Syntax:
clippingType boundingBox object
Parameters:
clippingType: Number - clipping type could be:
  • 0 - ClipVisual (could significantly reduce the size of bounding boxes on buildings)
  • 1 - ClipShadow
  • 2 - ClipGeometry
  • 3 - ClipGeneral (Default, the same type that is used in main syntax)
object: Object
Return Value:
Array - an array with the extreme points of the model bounding box in format PositionRelative, as well as bounding box sphere diameter.
Format [[xmin, ymin, zmin], [xmax, ymax, zmax], boundingSphereDiameter].

Examples

Example 1:
private _box = boundingBox _abrams;
Example 2:
hint str (0 boundingBox cursorObject);

Additional Information

See also:
sizeOf boundingBoxReal boundingCenter BIS_fnc_boundingBoxDimensions

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