## GetBBox

### Introduced

v1.0

### Description

Computes the bounding box of a list of objects.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:
For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.
For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

### Scripting Syntax

    GetBBox( [InputObj], [FineComputation], [LowerBoundX], [LowerBoundY], [LowerBoundZ], [UpperBoundX], [UpperBoundY], [UpperBoundZ] );

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObj | String | List of objects. Default Value: Current selection
FineComputation | Boolean | True to compute the bounding box on the surface, False to compute the bounding box on the control points. Default Value: FALSE
LowerBoundX | Double | Returns the lower X coordinate of the bounding box.
LowerBoundY | Double | Returns the lower Y coordinate of the bounding box.
LowerBoundZ | Double | Returns the lower Z coordinate of the bounding box.
UpperBoundX | Double | Returns the upper X coordinate of the bounding box.
UpperBoundY | Double | Returns the upper Y coordinate of the bounding box.
UpperBoundZ | Double | Returns the upper Z coordinate of the bounding box.

### Examples

#### 1. JScript Example

    NewScene( null, false ) ;
    var oSphere = ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface", "MySphere" ) ;
    oSphere.PosX = 2 ;
    oSphere.PosY = -1 ;
    var oTorus = ActiveSceneRoot.AddGeometry( "Torus", "NurbsSurface", "MyTorus" ) ;
    oTorus.PosX = 2 ;
    oTorus.PosY = 5 ;
    var oObjs = new ActiveXObject("XSI.Collection") ;
    oObjs.Add( oSphere  ) ;
    oObjs.Add( oTorus ) ;
    var aRtn = GetBBox( oObjs ) ;
    xmin = aRtn.value( "LowerBoundX" );
    ymin = aRtn.value( "LowerBoundY" );
    zmin = aRtn.value( "LowerBoundZ" );
    xmax = aRtn.value( "UpperBoundX" );
    ymax = aRtn.value( "UpperBoundY" );
    zmax = aRtn.value( "UpperBoundZ" );
    LogMessage( "Lower Bound: " + xmin + " / " + ymin + " / " + zmin ) ;
    LogMessage( "Upper Bound: " + xmax + " / " + ymax + " / " + zmax ) ;
    // Build a Cube that shows the bounding box
    var oCube = ActiveSceneRoot.AddPrimitive("Cube") ;
    oCube.length = 1 ;
    oCube.PosX = ( xmax + xmin ) / 2 ;
    oCube.PosY = ( ymax + ymin ) / 2 ;
    oCube.PosZ = ( zmax + zmin ) / 2 ;
    oCube.sclx = xmax - xmin ;
    oCube.scly = ymax - ymin ;
    oCube.sclz = zmax - zmin ;

#### 2. VBScript Example

    dim xmin, ymin, zmin, xmax, ymax, zmax
    dim list
    set list = GetValue( "SelectionList" )
    GetBBox list, FALSE, xmin, ymin, zmin, xmax, ymax, zmax
    LogMessage "Lower Bound: " & xmin & " / " & ymin & " / " & zmin
    LogMessage "Upper Bound: " & xmax & " / " & ymax & " / " & zmax

### See Also

Geometry.GetBoundingBox Geometry.GetBoundingCapsule Geometry.GetBoundingSphere