Sphere (Bonzai Engine bonzaiengine.com Copyright © 2007-2015 Jérôme Jouvie)

java.lang.Object
- com.bonzaiengine.visibility.Sphere

All Implemented Interfaces:

IInterpolable<Sphere>, IData<Sphere>, IValueCopy<Sphere>, IVolume<Sphere>, java.lang.Cloneable
```
public final class Sphere
extends java.lang.Object
implements IVolume<Sphere>
```

Constructor Summary

Constructors
Constructor and Description

Sphere(Vec3 center, float radius)

Constructors
Constructor and Description
`Sphere(Vec3 center, float radius)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Sphere`	`addScale(Sphere current, Sphere next, float t)`
`Sphere`	`clone()`
`Sphere`	`concatenate(Sphere other)` Concatenate this volume with other in a new `IVolume` object
`float`	`distanceToPlane(Plane plane, boolean min)`
`static Sphere`	`empty()`
`Vec3`	`getCenter()`
`Vec3`	`getCenter(Vec3 dst)`
`float`	`getRadius()`
`float`	`getVolume()`
`boolean`	`insideFrustum(Frustum frustum)`
`Sphere`	`interpolate(Sphere current, Sphere next, float t)` Interpolate `this` bounding sphere with `s` and return the new interpolated bounding sphere.
`Vec3[]`	`intersection(Line line)` Line-Sphere Intersection
`Circle`	`intersection(Sphere sphere)` Sphere-Sphere Intersection System of 5 equations but 4 unknown: (x-x0)²+(y-y0)²+(z-z0)²=R² (x-x1)²+(y-y1)²+(z-z1)²=r² x = x0 + k * x1-x0 y = y0 y1-y0 z = z0 z1-z0 which can be written as : x(x1-x0) + y(y1-y0) + z(z1-z0) = (R²-r² + x1²-x0² + y1²-y0² + z1²-z0²) / 2 x/(x1-x0) + y/(y1-y0 = x0/(x1-x0) - y0/(y1-y0) Reference to find to radius formula: Weisstein, Eric W.
`IntersectTest`	`intersectTest(Frustum frustum)` Test the intersection between this `IBoundingVolume` and the specified `Frustum`.
`IntersectTest`	`intersectTest(Sphere s)`
`Vec3`	`limitInVolume(Vec3 dst, Vec3 src)` Limit a point location in this volume.
`static Sphere`	`max()`
`Sphere`	`set(Sphere s)`
`Sphere`	`set(Vec3 center, float radius)`
`void`	`setCenter(Vec3 src)`
`void`	`setRadius(float radius)`
`Sphere`	`subtract(Sphere bv1, Sphere bv2)`
`java.lang.String`	`toString()`
`Sphere`	`transform(Sphere bs, Mat4x4 matrix)`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Sphere
```
public Sphere(Vec3 center,
              float radius)
```
- Method Detail
  - empty
```
public static Sphere empty()
```
  - max
```
public static Sphere max()
```
  - toString
```
public final java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - clone
```
public final Sphere clone()
```
    Specified by:
    
    clone in interface IData<Sphere>
    
    Specified by:
    
    clone in interface IValueCopy<Sphere>
    
    Specified by:
    
    clone in interface IVolume<Sphere>
    
    Overrides:
    
    clone in class java.lang.Object
  - set
```
public final Sphere set(Sphere s)
```
    Specified by:
    
    set in interface IValueCopy<Sphere>
  - getVolume
```
public final float getVolume()
```
    Specified by:
    
    getVolume in interface IVolume<Sphere>
    
    Returns:
    
    the volume of this Sphere
  - transform
```
public final Sphere transform(Sphere bs,
                              Mat4x4 matrix)
```
    Specified by:
    
    transform in interface IVolume<Sphere>
    
    Parameters:
    
    bs - a IBoundingVolume
    
    matrix - a Mat4x4
    
    Returns:
    
    this = matrix * bv
  - concatenate
```
public final Sphere concatenate(Sphere other)
```
    Description copied from interface: IVolume
    
    Concatenate this volume with other in a new IVolume object
    
    Specified by:
    
    concatenate in interface IVolume<Sphere>
    
    Parameters:
    
    other - a IBoundingVolume
    
    Returns:
    
    new concatenated volume
    
    See Also:
    
    Volumes.concatenate(IVolume, IVolume)
  - limitInVolume
```
public final Vec3 limitInVolume(Vec3 dst,
                                Vec3 src)
```
    Limit a point location in this volume. The point is displaced to the closest location if outside the volume.
    
    Specified by:
    
    limitInVolume in interface IVolume<Sphere>
    
    Parameters:
    
    src - source point
    
    dst - destination vector to store the result
    
    Returns:
    
    dst
  - intersectTest
```
public IntersectTest intersectTest(Sphere s)
```
    Specified by:
    
    intersectTest in interface IVolume<Sphere>
    
    Parameters:
    
    s - another volume
    
    Returns:
    
    true if this and the specified volume collides
  - interpolate
```
public final Sphere interpolate(Sphere current,
                                Sphere next,
                                float t)
```
    Interpolate this bounding sphere with s and return the new interpolated bounding sphere.
    
    Specified by:
    
    interpolate in interface IInterpolable<Sphere>
    
    Specified by:
    
    interpolate in interface IData<Sphere>
    
    Specified by:
    
    interpolate in interface IVolume<Sphere>
    
    Parameters:
    
    current -
    
    next -
    
    t - value in the range [0.; 1.]
    
    Returns:
    
    this containing the interpolated bounding sphere
  - addScale
```
public final Sphere addScale(Sphere current,
                             Sphere next,
                             float t)
```
    Specified by:
    
    addScale in interface IVolume<Sphere>
    
    Parameters:
    
    current - a IBoundingVolume
    
    next - a IBoundingVolume
    
    Returns:
    
    this = bv1 + bv2 * t
  - subtract
```
public Sphere subtract(Sphere bv1,
                       Sphere bv2)
```
    Specified by:
    
    subtract in interface IVolume<Sphere>
    
    Parameters:
    
    bv1 - a IBoundingVolume
    
    bv2 - a IBoundingVolume
    
    Returns:
    
    this = bv1 - bv2
  - insideFrustum
```
public final boolean insideFrustum(Frustum frustum)
```
    Specified by:
    
    insideFrustum in interface IVolume<Sphere>
    
    Returns:
    
    true if the volume is inside the frustum.
  - intersectTest
```
public final IntersectTest intersectTest(Frustum frustum)
```
    Description copied from interface: IVolume
    
    Test the intersection between this IBoundingVolume and the specified Frustum.
    
    Specified by:
    
    intersectTest in interface IVolume<Sphere>
    
    Returns:
    
    VolumeIntersection.Intersect if inside and intersect.
    VolumeIntersection.Inside if inside but not intersect.
    VolumeIntersection.Outisde if outside.
    
    See Also:
    
    IntersectTest, IVolume.insideFrustum(Frustum)
  - distanceToPlane
```
public final float distanceToPlane(Plane plane,
                                   boolean min)
```
    Specified by:
    
    distanceToPlane in interface IVolume<Sphere>
    
    Parameters:
    
    plane - a Plane
    
    min - true: minimum distance
    false: maximum distance
    
    Returns:
    
    negative value: volume intersect of is outside.
    positive value: distance of the closest point
  - intersection
```
public final Circle intersection(Sphere sphere)
```
    Sphere-Sphere Intersection
    System of 5 equations but 4 unknown:
    (x-x0)²+(y-y0)²+(z-z0)²=R²
    (x-x1)²+(y-y1)²+(z-z1)²=r²
    x = x0 + k * x1-x0
    y = y0 y1-y0
    z = z0 z1-z0
    which can be written as :
    x(x1-x0) + y(y1-y0) + z(z1-z0) = (R²-r² + x1²-x0² + y1²-y0² + z1²-z0²) / 2 x/(x1-x0) + y/(y1-y0 = x0/(x1-x0) - y0/(y1-y0) Reference to find to radius formula:
    Weisstein, Eric W. "Sphere-Sphere Intersection." From MathWorld--A Wolfram Web Resource
    http://mathworld.wolfram.com/Sphere-SphereIntersection.html
    
    Parameters:
    
    sphere -
    
    Returns:
    
    the circle intersection
  - intersection
```
public final Vec3[] intersection(Line line)
```
    Line-Sphere Intersection
    
    Parameters:
    
    line -
    
    Returns:
    
    0, 1 or 2 intersection points
    
    See Also:
    
    http://en.wikipedia.org/wiki/Line-sphere_intersection
  - set
```
public final Sphere set(Vec3 center,
                        float radius)
```
  - getCenter
```
public final Vec3 getCenter()
```
  - getCenter
```
public final Vec3 getCenter(Vec3 dst)
```
  - setCenter
```
public final void setCenter(Vec3 src)
```
  - getRadius
```
public final float getRadius()
```
  - setRadius
```
public final void setRadius(float radius)
```

Class Sphere

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Sphere

Method Detail

empty

max

toString

clone

set

getVolume

transform

concatenate

limitInVolume

intersectTest

interpolate

addScale

subtract

insideFrustum

intersectTest

distanceToPlane

intersection

intersection

set

getCenter

getCenter

setCenter

getRadius

setRadius