IQuadEdge (Core 2.0 API)

All Known Implementing Classes:

QuadEdge, SemiVirtualEdge
```
public interface IQuadEdge
```
Defines methods for accessing the data in a quad-edge implementation.
In general, get operations can be performed without any degradation of performance. However, set operations on quad-edges often require down casting (narrow casting) of object references. In ordinary applications, the performance cost of down casting is small. But for TIN applications require very large data sets with repeated modifications to the edge structure of the TIN, this cost can degrade processing rates by as much as 25 percent. Thus this interface avoids specifying any methods that set edge relationships (connections).
See the definition of IConstraint for a discussion of constrained regions.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Vertex`	`getA()` Gets the initial vertex for this edge.
`Vertex`	`getB()` Gets the second vertex for this edge.
`IQuadEdge`	`getBaseReference()` Gets the reference to the side-zero edge of the pair.
`int`	`getConstraintIndex()` Gets the index of the constraint associated with this edge.
`IQuadEdge`	`getDual()` Gets the dual edge to this instance.
`IQuadEdge`	`getDualFromReverse()` Gets the dual of the reverse reference of the edge.
`IQuadEdge`	`getForward()` Gets the forward reference of the edge.
`IQuadEdge`	`getForwardFromDual()` Gets the forward reference of the dual.
`int`	`getIndex()` Gets the index value for this edge.
`double`	`getLength()` Gets the length of the edge.
`IQuadEdge`	`getReverse()` Gets the reverse reference of the edge.
`IQuadEdge`	`getReverseFromDual()` Gets the reverse link of the dual.
`int`	`getSide()` Indicates which side of an edge a particular IQuadEdge instance is attached to.
`boolean`	`isConstrained()` Indicates whether an edge is constrained.
`boolean`	`isConstrainedRegionBorder()` Indicates whether an edge represents the border of a constrained region.
`boolean`	`isConstrainedRegionInterior()` Indicates whether the edge is in the interior of a constrained region.
`boolean`	`isConstrainedRegionMember()` Indicates whether the edge is a member of a constrained region (is in the interior or serves as the border of a polygon-based constraint).
`boolean`	`isSynthetic()` Indicates whether the synthetic flag is set for the edge.
`Iterable<IQuadEdge>`	`pinwheel()` Gets an instance of an iterable that performs a pinwheel operation.
`void`	`setConstrained(int constraintIndex)` Sets an edge as constrained and sets its constraint index.
`void`	`setConstrainedRegionBorderFlag()` Sets a flag indicating that the edge is an edge of a constrained region.
`void`	`setConstrainedRegionInteriorFlag()` Sets the constrained region membership flag for the edge to true.
`void`	`setConstraintIndex(int constraintIndex)` Sets the constraint index for this edge.
`void`	`setSynthetic(boolean status)` Sets the synthetic flag for the edge.

- Method Detail
  - getA
```
Vertex getA()
```
    Gets the initial vertex for this edge.
    
    Returns:
    
    a valid reference.
  - getB
```
Vertex getB()
```
    Gets the second vertex for this edge.
    
    Returns:
    
    a valid reference or a null for a ghost edge.
  - getBaseReference
```
IQuadEdge getBaseReference()
```
    Gets the reference to the side-zero edge of the pair.
    
    Returns:
    
    a link to the side-zero edge of the pair.
  - getDual
```
IQuadEdge getDual()
```
    Gets the dual edge to this instance.
    
    Returns:
    
    a valid edge.
  - getForwardFromDual
```
IQuadEdge getForwardFromDual()
```
    Gets the forward reference of the dual.
    
    Returns:
    
    a valid reference
  - getReverseFromDual
```
IQuadEdge getReverseFromDual()
```
    Gets the reverse link of the dual.
    
    Returns:
    
    a valid reference
  - getIndex
```
int getIndex()
```
    Gets the index value for this edge. In general, the index value is intended for memory management and edge pools. Thus, it may not be set by application code. In some applications involving edge-traversal operations, it is used to maintain a bitmap of visited edges.
    When an edge is allocated, it is set with an arbitrary index value. This value will not change while the edge remains allocated by and edge-pool instance. As soon as the edge is released, it is likely to have its index value reassigned.
    
    Returns:
    
    a positive integer value
  - getSide
```
int getSide()
```
    Indicates which side of an edge a particular IQuadEdge instance is attached to. The side value is a strictly arbitrary index used for algorithms that need to be able to assign a unique index to both sides of an edge.
    
    Returns:
    
    a value of 0 or 1.
  - getLength
```
double getLength()
```
    Gets the length of the edge.
    
    Returns:
    
    a positive floating point value
  - getForward
```
IQuadEdge getForward()
```
    Gets the forward reference of the edge.
    
    Returns:
    
    a valid reference.
  - getReverse
```
IQuadEdge getReverse()
```
    Gets the reverse reference of the edge.
    
    Returns:
    
    a valid reference.
  - getDualFromReverse
```
IQuadEdge getDualFromReverse()
```
    Gets the dual of the reverse reference of the edge.
    
    Returns:
    
    a valid reference.
  - getConstraintIndex
```
int getConstraintIndex()
```
    Gets the index of the constraint associated with this edge.
    
    Returns:
    
    a positive value; may be zero if not specified.
  - setConstraintIndex
```
void setConstraintIndex(int constraintIndex)
```
    Sets the constraint index for this edge. This method does not necessarily set an edge to a constrained status. In some implementations the constraint index may be used as a way of associating ordinary edges with a neighboring constraint. Constraint index values must be positive integers. The range of supported values will depend on the specific class that implements this interface. Please refer to the class documentation for specific values.
    
    Parameters:
    
    constraintIndex - a positive number indicating which constraint a particular edge is associated with.
  - isConstrained
```
boolean isConstrained()
```
    Indicates whether an edge is constrained.
    
    Returns:
    
    true if the edge is constrained; otherwise, false.
  - setConstrained
```
void setConstrained(int constraintIndex)
```
    Sets an edge as constrained and sets its constraint index. Note that once an edge is constrained, it cannot be set to a non-constrained status. Constraint index values must be positive integers. The range of supported values will depend on the specific class that implements this interface. Please refer to the class documentation for specific values.
    
    Parameters:
    
    constraintIndex - positive number indicating which constraint a particular edge is associated with.
  - isConstrainedRegionMember
```
boolean isConstrainedRegionMember()
```
    Indicates whether the edge is a member of a constrained region (is in the interior or serves as the border of a polygon-based constraint). A constrained region member is not necessarily a constrained edge.
    
    Returns:
    
    true if the edge is a member of an region; otherwise false.
  - isConstrainedRegionInterior
```
boolean isConstrainedRegionInterior()
```
    Indicates whether the edge is in the interior of a constrained region. Both sides of the edge lie within the interior of the region. All points along the edge will lie within the interior of the region with the possible exception of the endpoints. The endpoints may lie on the border of the region. An interior edge for a constrained region is not a constrained edge. Interior edges are also classified as "member" edges of a constrained region.
    
    Returns:
    
    true if the edge is in the interior of an region; otherwise false.
  - isConstrainedRegionBorder
```
boolean isConstrainedRegionBorder()
```
    Indicates whether an edge represents the border of a constrained region. Border edges will always be constrained. Border edges are also classified as "member" edges of a constrained region.
    
    Returns:
    
    true if the edge is the border of the constrained region; otherwise, false.
  - setConstrainedRegionBorderFlag
```
void setConstrainedRegionBorderFlag()
```
    Sets a flag indicating that the edge is an edge of a constrained region.
  - setConstrainedRegionInteriorFlag
```
void setConstrainedRegionInteriorFlag()
```
    Sets the constrained region membership flag for the edge to true.
  - setSynthetic
```
void setSynthetic(boolean status)
```
    Sets the synthetic flag for the edge. Synthetic edges are those that do not arise naturally from the TIN-building logic but are created by special operations.
    
    Parameters:
    
    status - true if the edge is synthetic; otherwise, false.
  - isSynthetic
```
boolean isSynthetic()
```
    Indicates whether the synthetic flag is set for the edge.
    
    Returns:
    
    true if the edge is synthetic; otherwise, false.
  - pinwheel
```
Iterable<IQuadEdge> pinwheel()
```
    Gets an instance of an iterable that performs a pinwheel operation. This instance may be used in a Java for statement
```
    for(IQuadEdge e: startingEdge.pinwheel()){
    }
 
```
    Returns:
    
    a valid Iterable.

Interface IQuadEdge

Method Summary

Method Detail

getA

getB

getBaseReference

getDual

getForwardFromDual

getReverseFromDual

getIndex

getSide

getLength

getForward

getReverse

getDualFromReverse

getConstraintIndex

setConstraintIndex

isConstrained

setConstrained

isConstrainedRegionMember

isConstrainedRegionInterior

isConstrainedRegionBorder

setConstrainedRegionBorderFlag

setConstrainedRegionInteriorFlag

setSynthetic

isSynthetic

pinwheel