Doodle3D-Slicer/three.js-master/docs/api/math/Box3.html
2015-06-12 15:58:26 +02:00

263 lines
7.1 KiB
HTML
Executable File

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<script src="../../list.js"></script>
<script src="../../page.js"></script>
<link type="text/css" rel="stylesheet" href="../../page.css" />
</head>
<body>
<h1>[name]</h1>
<div class="desc">Represents a boundary box in 3d space.</div>
<h2>Constructor</h2>
<h3>[name]([page:Vector3 min], [page:Vector3 max])</h3>
<div>
min -- Lower (x, y, z) boundary of the box.<br />
max -- Upper (x, y, z) boundary of the box.
</div>
<div>
Creates a box bounded by min and max.
</div>
<h2>Properties</h2>
<h3>[property:Vector3 min]</h3>
<div>
Lower (x, y, z) boundary of this box.
</div>
<h3>[property:Vector3 max]</h3>
<div>
Upper (x, y, z) boundary of this box.
</div>
<h2>Methods</h2>
<h3>[method:Box3 set]([page:Vector3 min], [page:Vector3 max]) [page:Box3 this]</h3>
<div>
min -- Lower (x, y, z) boundary of the box. <br />
max -- Upper (x, y, z) boundary of the box.
</div>
<div>
Sets the lower and upper (x, y, z) boundaries of this box.
</div>
<h3>[method:Box3 applyMatrix4]([page:Matrix4 matrix]) [page:Box3 this]</h3>
<div>
matrix -- The [page:Matrix4] to apply
</div>
<div>
Transforms this Box3 with the supplied matrix.
</div>
<h3>[method:Vector3 clampPoint]([page:Vector3 point], [page:Vector3 optionalTarget])</h3>
<div>
point -- Position to clamp. <br />
optionalTarget -- If specified, the clamped result will be copied here.
</div>
<div>
Clamps *point* within the bounds of this box.
</div>
<h3>[method:Boolean isIntersectionBox]([page:Box3 box])</h3>
<div>
box -- Box to check for intersection against.
</div>
<div>
Determines whether or not this box intersects *box*.
</div>
<h3>[method:Box3 setFromPoints]([page:Array points]) [page:Box3 this]</h3>
<div>
points -- Set of points that the resulting box will envelop.
</div>
<div>
Sets the upper and lower bounds of this box to include all of the points in *points*.
</div>
<h3>[method:Box3 setFromObject]([page:Object3D object]) [page:Box3 this]</h3>
<div>
object -- [page:Object3D] to compute the bounding box for.
</div>
<div>
Computes the world-axis-aligned bounding box of an object (including its children),
accounting for both the object's, and childrens', world transforms
</div>
<h3>[method:Vector3 size]([page:Vector3 optionalTarget])</h3>
<div>
optionalTarget -- If specified, the result will be copied here.
</div>
<div>
Returns the width, height, and depth of this box.
</div>
<h3>[method:Box3 union]([page:Box3 box])</h3>
<div>
box -- Box that will be unioned with this box.
</div>
<div>
Unions this box with *box* setting the upper bound of this box to the greater of the
two boxes' upper bounds and the lower bound of this box to the lesser of the two boxes'
lower bounds.
</div>
<h3>[method:Vector3 getParameter]([page:Vector3 point], [page:Vector3 optionalTarget])</h3>
<div>
point -- Point to parametrize.
optionalTarget -- If specified, the result will be copied here.
</div>
<div>
Returns point as a proportion of this box's width and height.
</div>
<h3>[method:Box3 intersect]([page:Box3 box]) [page:Box3 this]</h3>
<div>
box -- Box to intersect with.
</div>
<div>
Returns the intersection of this and *box*, setting the upper bound of this box to the lesser </br>
of the two boxes' upper bounds and the lower bound of this box to the greater of the two boxes' </br>
lower bounds.
</div>
<h3>[method:Boolean containsBox]([page:Box3 box])</h3>
<div>
box -- Box to test for inclusion.
</div>
<div>
Returns true if this box includes the entirety of *box*. If this and *box* overlap exactly,</br>
this function also returns true.
</div>
<h3>[method:Boolean containsPoint]([page:Vector3 point])</h3>
<div>
point -- [page:Vector3] to check for inclusion.
</div>
<div>
Returns true if the specified point lies within the boundaries of this box.
</div>
<h3>[method:Box3 translate]([page:Vector3 offset]) [page:Box3 this]</h3>
<div>
offset -- Direction and distance of offset.
</div>
<div>
Adds *offset* to both the upper and lower bounds of this box, effectively moving this box </br>
*offset* units in 3D space.
</div>
<h3>[method:Boolean empty]()</h3>
<div>
Returns true if this box includes zero points within its bounds.</br>
Note that a box with equal lower and upper bounds still includes one point, the
one both bounds share.
</div>
<h3>[method:Box3 clone]()</h3>
<div>
Returns a copy of this box.
</div>
<h3>[method:Boolean equals]([page:Box3 box])</h3>
<div>
box -- Box to compare.
</div>
<div>
Returns true if this box and *box* share the same lower and upper bounds.
</div>
<h3>[method:Box3 expandByPoint]([page:Vector3 point]) [page:Box3 this]</h3>
<div>
point -- Point that should be included in the box.
</div>
<div>
Expands the boundaries of this box to include *point*.
</div>
<h3>[method:Box3 expandByScalar]([page:float scalar]) [page:Box3 this]</h3>
<div>
scalar -- Distance to expand.
</div>
<div>
Expands each dimension of the box by *scalar*. If negative, the dimensions of the box <br/>
will be contracted.
</div>
<h3>[method:Box3 expandByVector]([page:Vector3 vector]) [page:Box3 this]</h3>
<div>
vector -- Amount to expand this box in each dimension.
</div>
<div>
Expands this box equilaterally by *vector*. The width of this box will be
expanded by the x component of *vector* in both directions. The height of
this box will be expanded by the y component of *vector* in both directions.
The depth of this box will be expanded by the z component of *vector* in
both directions.
</div>
<h3>[method:Box3 copy]([page:Box3 box]) [page:Box3 this]</h3>
<div>
box -- Box to copy.
</div>
<div>
Copies the values of *box* to this box.
</div>
<h3>[method:Box3 makeEmpty]() [page:Box3 this]</h3>
<div>
Makes this box empty.
</div>
<h3>[method:Vector3 center]([page:Vector3 optionalTarget])</h3>
<div>
optionalTarget -- If specified, the result will be copied here.
</div>
<div>
Returns the center point of this box.
</div>
<h3>[method:Sphere getBoundingSphere]([page:Sphere optionalTarget])</h3>
<div>
optionalTarget -- [page:Sphere] to optionally set the result to.
</div>
<div>
Gets a sphere that bounds the box.
</div>
<h3>[method:Float distanceToPoint]([page:Vector3 point])</h3>
<div>
point -- Point to measure distance to.
</div>
<div>
Returns the distance from any edge of this box to the specified point. </br>
If the point lies inside of this box, the distance will be 0.
</div>
<h3>[method:Box3 setFromCenterAndSize]([page:Vector3 center], [page:Vector3 size]) [page:Box3 this]</h3>
<div>
center -- Desired center position of the box. <br />
size -- Desired x and y dimensions of the box.
</div>
<div>
Centers this box on *center* and sets this box's width and height to the values specified
in *size*.
</div>
<h2>Source</h2>
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
</body>
</html>