org.kynosarges.tektosyne.subdivision

Interface SubdivisionFullMap<T,U,V>

Type Parameters:

T - the type of all objects mapped to Subdivision.faces()

U - the type of all objects mapped to Subdivision.edges()

V - the type of all objects mapped to Subdivision.vertices()

All Superinterfaces:

SubdivisionMap<T>

public interface SubdivisionFullMap<T,U,V>
extends SubdivisionMap<T>

Maps all elements of a planar Subdivision to arbitrary objects. Provides an application-specific mapping of all Subdivision.faces(), Subdivision.edges(), and Subdivision.vertices() of a planar Subdivision to arbitrary objects.

All conversion methods have a default implementation that throws UnsupportedOperationException so that clients may selectively implement actual conversion methods for any desired element types.

Since the Subdivision has no knowledge of any SubdivisionFullMap instances that reference it, clients must manually update any such instances whenever the underlying Subdivision changes.

Method Summary

Modifier and Type	Method and Description
default U	fromEdge(SubdivisionEdge edge) Converts the specified SubdivisionEdge into the associated U instance.
default V	fromVertex(PointD vertex) Converts the specified PointD vertex into the associated V instance.
default SubdivisionEdge	toEdge(U value) Converts the specified U instance into the associated SubdivisionEdge.
default PointD	toVertex(V value) Converts the specified V instance into the associated PointD vertex.

Methods inherited from interface org.kynosarges.tektosyne.subdivision.SubdivisionMap

fromFace, source, target, toFace

Method Detail

fromEdge

default U fromEdge(SubdivisionEdge edge)

Converts the specified SubdivisionEdge into the associated U instance.

Parameters:

edge - the SubdivisionEdge to convert

Returns:

the U instance associated with edge

Throws:

java.lang.IllegalArgumentException - if SubdivisionMap.source() does not contain edge

java.lang.UnsupportedOperationException - if not overridden by an implementing class

java.lang.NullPointerException - if edge is null

toEdge

default SubdivisionEdge toEdge(U value)

Converts the specified U instance into the associated SubdivisionEdge.

Parameters:

value - the U instance to convert

Returns:

the SubdivisionEdge associated with value

Throws:

java.lang.IllegalArgumentException - if value does not map to any SubdivisionEdge within SubdivisionMap.source()

java.lang.UnsupportedOperationException - if not overridden by an implementing class

fromVertex

default V fromVertex(PointD vertex)

Converts the specified PointD vertex into the associated V instance.

Parameters:

vertex - the PointD vertex to convert

Returns:

the V instance associated with vertex

Throws:

java.lang.IllegalArgumentException - if SubdivisionMap.source() does not contain vertex

java.lang.UnsupportedOperationException - if not overridden by an implementing class

java.lang.NullPointerException - if vertex is null

toVertex

default PointD toVertex(V value)

Converts the specified V instance into the associated PointD vertex.

Parameters:

value - the V instance to convert

Returns:

the PointD vertex associated with value

Throws:

java.lang.IllegalArgumentException - if value does not map to any PointD vertex within SubdivisionMap.source()

java.lang.UnsupportedOperationException - if not overridden by an implementing class