CombineContext (NASA World Wind)

java.lang.Object
- gov.nasa.worldwind.util.combine.CombineContext

All Implemented Interfaces:

Disposable
```
public class CombineContext
extends Object
implements Disposable
```
CombineContext provides a suitcase of state used by Combinable shapes to generate a complex set of contours by applying boolean operations to one or more shapes. Instances of CombineContext are typically created and configured by a controller that operates on one or more combinable shapes and implements the boolean operation that is applied to those shapes, such as ShapeCombiner. The parameters used by shapes and by the controller are as follows: a globe, a minimum resolution in radians, a region of interest, and a GLU tessellator. The globe is used by shapes that define geometry relative to a globe. The resolution is used to filter shape detail and compute geometry for resolution independent shapes. Shape geometry outside of the region of interest may be ignored, clipped, or simplified at the discretion of the shape.
CombineContext initializes its GLU tessellator according to the conventions for Combinable shapes. See the Combinable interface documentation for information on drawing Combinable contours. The complex set of contours computed as a result of drawing shapes into the tessellator are collected in the context's contour list. This list may be accessed by calling getContours().

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`CombineContext.TessCallbackAdapter` Implementation of GLUtessellatorCallback that forwards GLU tessellator callbacks to protected methods on CombineContext.

Field Summary

Fields
Modifier and Type	Field and Description
`protected ArrayList<Sector>`	`boundingSectors` The shape bounding sectors associated with this context.
`protected ContourList`	`contours` The list of contours representing the result of a boolean operation on one or more Combinable shapes.
`protected ArrayList<LatLon>`	`currentContour` The vertices of the current contour currently being assembled.
`protected Globe`	`globe` The globe associated with the context.
`protected boolean`	`isBoundingSectorMode` Indicates whether this context is currently operating in bounding sector mode.
`protected double`	`resolution` A minimum resolution in radians used to filter shape detail and compute resolution independent geometry.
`protected Sector`	`sector` A geographic sector indicating the context's region of interest.
`protected GLUtessellator`	`tess` The GLU tessellator used to draw shape contours.

Constructor Summary

Constructors
Constructor and Description
`CombineContext(Globe globe, double resolution)` Creates a new combine context with the specified globe, resolution, and the default region of interest.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addBoundingSector(Sector sector)` Adds the specified geographic sector to this context's list of shape bounding sectors.
`void`	`addContour(Iterable<? extends LatLon> contour)` Adds the specified iterable to this context's list of contours.
`void`	`dispose()` Releases the releases GLU tessellator resources associated with this context.
`List<Sector>`	`getBoundingSectors()` Returns the shape bounding sectors associated with this context.
`ContourList`	`getContours()` Returns the list of contours representing the result of a boolean operation on one or more Combinable shapes.
`Globe`	`getGlobe()` Returns the globe associated with this context.
`double`	`getResolution()` Returns the context's minimum resolution in radians.
`Sector`	`getSector()` Returns the context's region of interest as a geographic sector.
`GLUtessellator`	`getTessellator()` Returns the GLU tessellator used to draw shape contours.
`boolean`	`isBoundingSectorMode()` Indicates whether this context is currently operating in bounding sector mode.
`void`	`removeAllBoundingSectors()` Removes all entries from this context's list of shape bounding sectors.
`void`	`removeAllContours()` Removes all entries from this context's list of contours.
`void`	`setBoundingSectorMode(boolean tf)` Specifies whether this context is currently operating in bounding sector mode.
`void`	`setGlobe(Globe globe)` Specifies the globe associated with this context.
`void`	`setResolution(double resolution)` Specifies the context's minimum resolution in radians.
`void`	`setSector(Sector sector)` Specifies the context's region of interest as a geographic sector.
`protected void`	`tessBegin(int type)`
`protected void`	`tessCombine(double[] coords, Object[] vertexData, float[] weight, Object[] outData)`
`protected void`	`tessEnd()`
`protected void`	`tessError(int errno)`
`protected void`	`tessVertex(Object vertexData)`

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

- Field Detail
  - boundingSectors
```
protected ArrayList<Sector> boundingSectors
```
    The shape bounding sectors associated with this context.
  - contours
```
protected ContourList contours
```
    The list of contours representing the result of a boolean operation on one or more Combinable shapes.
  - currentContour
```
protected ArrayList<LatLon> currentContour
```
    The vertices of the current contour currently being assembled. Used by the tess* methods.
  - globe
```
protected Globe globe
```
    The globe associated with the context.
  - isBoundingSectorMode
```
protected boolean isBoundingSectorMode
```
    Indicates whether this context is currently operating in bounding sector mode.
  - resolution
```
protected double resolution
```
    A minimum resolution in radians used to filter shape detail and compute resolution independent geometry.
  - sector
```
protected Sector sector
```
    A geographic sector indicating the context's region of interest.
  - tess
```
protected GLUtessellator tess
```
    The GLU tessellator used to draw shape contours. Initalized during construction.
- Constructor Detail
  - CombineContext
```
public CombineContext(Globe globe,
                      double resolution)
```
    Creates a new combine context with the specified globe, resolution, and the default region of interest.
    
    Parameters:
    
    globe - the globe to associate with this context. Shape geometry defined relative to a globe must use this globe to compute that geometry.
    
    resolution - the minimum resolution, in radians. Used to filter shape detail and compute geometry for resolution independent shapes.
    
    Throws:
    
    IllegalArgumentException - if the globe is null.
- Method Detail
  - addBoundingSector
```
public void addBoundingSector(Sector sector)
```
    Adds the specified geographic sector to this context's list of shape bounding sectors.
    
    Parameters:
    
    sector - the sector to add.
    
    Throws:
    
    IllegalArgumentException - if the sector is null.
  - addContour
```
public void addContour(Iterable<? extends LatLon> contour)
```
    Adds the specified iterable to this context's list of contours.
    
    Parameters:
    
    contour - the contour to add.
    
    Throws:
    
    IllegalArgumentException - if the contour is null.
  - dispose
```
public void dispose()
```
    Releases the releases GLU tessellator resources associated with this context.
    
    Specified by:
    
    dispose in interface Disposable
  - getBoundingSectors
```
public List<Sector> getBoundingSectors()
```
    Returns the shape bounding sectors associated with this context. This list is populated by Combinable shapes when the context is in bounding sector mode.
    
    Returns:
    
    the shape bounding sectors associated with this context.
    
    See Also:
    
    isBoundingSectorMode()
  - getContours
```
public ContourList getContours()
```
    Returns the list of contours representing the result of a boolean operation on one or more Combinable shapes.
    
    Returns:
    
    the list of contours associated with this context.
  - getGlobe
```
public Globe getGlobe()
```
    Returns the globe associated with this context. Shape geometry defined relative to a globe must use this globe to compute that geometry.
    
    Returns:
    
    the globe associated with this context.
  - getResolution
```
public double getResolution()
```
    Returns the context's minimum resolution in radians. Used to filter shape detail and compute resolution independent geometry.
    
    Returns:
    
    the minimum resolution, in radians.
  - getSector
```
public Sector getSector()
```
    Returns the context's region of interest as a geographic sector. Shape geometry outside of this region may be ignored, clipped, or simplified at the discretion of the shape.
    
    Returns:
    
    the geographic sector indicating the context's region of interest.
  - getTessellator
```
public GLUtessellator getTessellator()
```
    Returns the GLU tessellator used to draw shape contours. The GLU tessellator is configured according to the conventions for Combinable shapes. See the Combinable interface documentation for information on drawing Combinable contours. The complex set of contours computed as a result of drawing shapes into the tessellator are collected in the context's contour list. This list may be accessed by calling getContours().
    
    Returns:
    
    the GLU tessellator used to draw shape contours.
  - isBoundingSectorMode
```
public boolean isBoundingSectorMode()
```
    Indicates whether this context is currently operating in bounding sector mode. When Combinable.combine(CombineContext) is called in this mode, a shape adds its geographic bounding sector to the context by calling addBoundingSector(Sector). See the Combinable interface documentation for more information.
    
    Returns:
    
    true if the context is currently in bounding sector mode, otherwise false.
  - removeAllBoundingSectors
```
public void removeAllBoundingSectors()
```
    Removes all entries from this context's list of shape bounding sectors.
  - removeAllContours
```
public void removeAllContours()
```
    Removes all entries from this context's list of contours.
  - setBoundingSectorMode
```
public void setBoundingSectorMode(boolean tf)
```
    Specifies whether this context is currently operating in bounding sector mode. When Combinable.combine(CombineContext) is called in this mode, a shape adds its geographic bounding sector to the context by calling addBoundingSector(Sector). See the Combinable interface documentation for more information.
    
    Parameters:
    
    tf - true to set the context is bounding sector mode, otherwise false.
  - setGlobe
```
public void setGlobe(Globe globe)
```
    Specifies the globe associated with this context. Shape geometry defined relative to a globe must use this globe to compute that geometry.
    
    Parameters:
    
    globe - the globe to associate with this context.
    
    Throws:
    
    IllegalArgumentException - if the globe is null.
  - setResolution
```
public void setResolution(double resolution)
```
    Specifies the context's minimum resolution in radians. Used to filter shape detail and compute resolution independent geometry.
    
    Parameters:
    
    resolution - the minimum resolution, in radians.
  - setSector
```
public void setSector(Sector sector)
```
    Specifies the context's region of interest as a geographic sector. Shape geometry outside of this region may be ignored, clipped, or simplified at the discretion of the shape.
    
    Parameters:
    
    sector - a geographic sector indicating the context's region of interest.
    
    Throws:
    
    IllegalArgumentException - if the sector is null.
  - tessBegin
```
protected void tessBegin(int type)
```
  - tessCombine
```
protected void tessCombine(double[] coords,
                           Object[] vertexData,
                           float[] weight,
                           Object[] outData)
```
  - tessEnd
```
protected void tessEnd()
```
  - tessError
```
protected void tessError(int errno)
```
  - tessVertex
```
protected void tessVertex(Object vertexData)
```

Class CombineContext

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

boundingSectors

contours

currentContour

globe

isBoundingSectorMode

resolution

sector

tess

Constructor Detail

CombineContext

Method Detail

addBoundingSector

addContour

dispose

getBoundingSectors

getContours

getGlobe

getResolution

getSector

getTessellator

isBoundingSectorMode

removeAllBoundingSectors

removeAllContours

setBoundingSectorMode

setGlobe

setResolution

setSector

tessBegin

tessCombine

tessEnd

tessError

tessVertex