org.apache.commons.geometry.io.euclidean.threed

Class AbstractBoundaryReadHandler3D

java.lang.Object

org.apache.commons.geometry.io.euclidean.threed.AbstractBoundaryReadHandler3D

All Implemented Interfaces:

BoundaryReadHandler<PlaneConvexSubset,BoundarySource3D>, BoundaryReadHandler3D

Direct Known Subclasses:

ObjBoundaryReadHandler3D, StlBoundaryReadHandler3D, TextBoundaryReadHandler3D

public abstract class AbstractBoundaryReadHandler3D
extends Object
implements BoundaryReadHandler3D

Abstract base class for BoundaryReadHandler3D implementations.

Constructor Summary

Constructors

Constructor and Description
AbstractBoundaryReadHandler3D()

Method Summary

Modifier and Type	Method and Description
Stream<PlaneConvexSubset>	boundaries(GeometryInput in, Precision.DoubleEquivalence precision)
Stream<FacetDefinition>	facets(GeometryInput in) Return a Stream that can be used to access all facet information from the given input stream.
BoundarySource3D	read(GeometryInput in, Precision.DoubleEquivalence precision)
TriangleMesh	readTriangleMesh(GeometryInput in, Precision.DoubleEquivalence precision) Read a triangle mesh from the given input.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.commons.geometry.io.euclidean.threed.BoundaryReadHandler3D

facetDefinitionReader

Methods inherited from interface org.apache.commons.geometry.io.core.BoundaryReadHandler

getFormat

Constructor Detail

AbstractBoundaryReadHandler3D

public AbstractBoundaryReadHandler3D()

Method Detail

read

public BoundarySource3D read(GeometryInput in,
                             Precision.DoubleEquivalence precision)

Specified by:

read in interface BoundaryReadHandler<PlaneConvexSubset,BoundarySource3D>

readTriangleMesh

public TriangleMesh readTriangleMesh(GeometryInput in,
                                     Precision.DoubleEquivalence precision)

Read a triangle mesh from the given input. Implementations may throw runtime exceptions if mathematically invalid boundaries are encountered.

Specified by:

readTriangleMesh in interface BoundaryReadHandler3D

Parameters:

in - input stream to read from

precision - precision context used for floating point comparisons

Returns:

triangle mesh containing the data from the given input stream

boundaries

public Stream<PlaneConvexSubset> boundaries(GeometryInput in,
                                            Precision.DoubleEquivalence precision)

Specified by:

boundaries in interface BoundaryReadHandler<PlaneConvexSubset,BoundarySource3D>

facets

public Stream<FacetDefinition> facets(GeometryInput in)

Return a Stream that can be used to access all facet information from the given input stream. The input stream is expected to contain data in the format supported by this handler.

The underlying input stream is closed when the returned stream is closed. Callers should therefore use the returned stream in a try-with-resources statement to ensure that all resources are properly released.

  try (Stream<FacetDefinition> stream = handler.facets(in)) {
      // access stream content
  }
 

The following exceptions may be thrown during stream iteration:

• IllegalArgumentException if mathematically invalid data is encountered
• IllegalStateException if a parsing or syntax error occurs
• UncheckedIOException if an I/O error occurs

Specified by:

facets in interface BoundaryReadHandler3D

Parameters:

in - input stream to read from; this is not closed when the returned stream is closed

Returns:

stream providing access to the facet information from the given input stream