[name]

A sphere defined by a center and radius.

Constructor

[name]( [param:Vector3 center], [param:Float radius] )

[page:Vector3 center] - center of the sphere. Default is a [page:Vector3] at (0, 0, 0).

Creates a new [name].

Properties

[property:Vector3 center]

A [page:Vector3] defining the center of the sphere. Default is (0, 0, 0).

The radius of the sphere. Default is 0.

Methods

[method:Sphere applyMatrix4]( [param:Matrix4 matrix] )

[page:Matrix4 matrix] - the [Page:Matrix4] to apply

Transforms this sphere with the provided [page:Matrix4].

[method:Vector3 clampPoint]( [param:Vector3 point], [param:Vector3 target] )

[page:Vector3 point] - [page:Vector3] The point to clamp.
[page:Vector3 target] — the result will be copied into this Vector3.

Clamps a point within the sphere. If the point is outside the sphere, it will clamp it to the closest point on the edge of the sphere. Points already inside the sphere will not be affected.

[method:Sphere clone]()

Returns a new sphere with the same [page:.center center] and [page:.radius radius] as this one.

[method:Boolean containsPoint]( [param:Vector3 point] )

[page:Vector3 point] - the [page:Vector3] to be checked

Checks to see if the sphere contains the provided [page:Vector3 point] inclusive of the surface of the sphere.

[method:Sphere copy]( [param:Sphere sphere] )

Copies the values of the passed sphere's [page:.center center] and [page:.radius radius] properties to this sphere.

[method:Float distanceToPoint]( [param:Vector3 point] )

Returns the closest distance from the boundary of the sphere to the [page:Vector3 point]. If the sphere contains the point, the distance will be negative.

[method:this expandByPoint]( [param:Vector3 point] )

[page:Vector3 point] - [page:Vector3] that should be included in the sphere.

Expands the boundaries of this sphere to include [page:Vector3 point].

[method:Boolean isEmpty]()

Checks to see if the sphere is empty (the radius set to a negative number).
Spheres with a radius of 0 contain only their center point and are not considered to be empty.

[method:Sphere makeEmpty]()

Makes the sphere empty by setting [page:.center center] to (0, 0, 0) and [page:.radius radius] to -1.

[method:Boolean equals]( [param:Sphere sphere] )

Checks to see if the two spheres' centers and radii are equal.

[method:Box3 getBoundingBox]( [param:Box3 target] )

[page:Box3 target] — the result will be copied into this Box3.

Returns a[link:https://en.wikipedia.org/wiki/Minimum_bounding_box Minimum Bounding Box] for the sphere.

[method:Boolean intersectsBox]( [param:Box3 box] )

[page:Box3 box] - [page:Box3] to check for intersection against.

Determines whether or not this sphere intersects a given [page:Box3 box].

[method:Boolean intersectsPlane]( [param:Plane plane] )

[page:Plane plane] - Plane to check for intersection against.

Determines whether or not this sphere intersects a given [page:Plane plane].

[method:Boolean intersectsSphere]( [param:Sphere sphere] )

[page:Sphere sphere] - Sphere to check for intersection against.

Checks to see if two spheres intersect.

[method:Sphere set]( [param:Vector3 center], [param:Float radius] )

[page:Vector3 center] - center of the sphere.

Please note that this method only copies the values from the given center.

[method:Sphere setFromPoints]( [param:Array points], [param:Vector3 optionalCenter] )

[page:Array points] - an [page:Array] of [page:Vector3] positions.
[page:Vector3 optionalCenter] - Optional [page:Vector3] position for the sphere's center.

Computes the minimum bounding sphere for an array of [page:Array points]. If [page:Vector3 optionalCenter]is given, it is used as the sphere's center. Otherwise, the center of the axis-aligned bounding box encompassing [page:Array points] is calculated.

[method:Sphere translate]( [param:Vector3 offset] )

Translate the sphere's center by the provided offset [page:Vector3].

[method:this union]( [param:Sphere sphere] )

[page:Sphere sphere] - Bounding sphere that will be unioned with this sphere.

Expands this sphere to enclose both the original sphere and the given sphere.