org.apache.commons.geometry.examples.io.threed.obj

Class OBJReader

java.lang.Object

org.apache.commons.geometry.examples.io.threed.obj.OBJReader

public final class OBJReader
extends Object

Class for reading TriangleMesh objects from OBJ files. Only vertex and face definitions are read from the input; other OBJ keywords are ignored.

Instances of this class are not thread-safe.

See Also:

Wavefront .obj file

Constructor Summary

Constructors

Constructor and Description
OBJReader()

Method Summary

Modifier and Type	Method and Description
TriangleMesh	readTriangleMesh(File file, DoublePrecisionContext precision) Read a TriangleMesh from the given OBJ file.
TriangleMesh	readTriangleMesh(Reader reader, DoublePrecisionContext precision) Read a TriangleMesh from the given reader.
TriangleMesh	readTriangleMesh(URL url, DoublePrecisionContext precision) Read a TriangleMesh from the given url representing an OBJ file.

Methods inherited from class java.lang.Object

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

Constructor Detail

OBJReader

public OBJReader()

Method Detail

readTriangleMesh

public TriangleMesh readTriangleMesh(File file,
                                     DoublePrecisionContext precision)
                              throws IOException

Read a TriangleMesh from the given OBJ file. The file is read using the UTF-8 charset.

Parameters:

file - file to read from

precision - precision context to use in the created mesh

Returns:

a new mesh object

Throws:

IOException - if an IO operation fails

IllegalArgumentException - if invalid OBj syntax is encountered in the input

readTriangleMesh

public TriangleMesh readTriangleMesh(URL url,
                                     DoublePrecisionContext precision)
                              throws IOException

Read a TriangleMesh from the given url representing an OBJ file. The input is read using the UTF-8 charset.

Parameters:

url - url to read from

precision - precision context to use in the created mesh

Returns:

a new mesh object

Throws:

IOException - if an IO operation fails

IllegalArgumentException - if invalid OBj syntax is encountered in the input

readTriangleMesh

public TriangleMesh readTriangleMesh(Reader reader,
                                     DoublePrecisionContext precision)
                              throws IOException

Read a TriangleMesh from the given reader. The reader is not closed.

Parameters:

reader - the reader to read input from

precision - precision context to use in the created mesh

Returns:

a new mesh object

Throws:

IOException - if an IO operation fails

IllegalArgumentException - if invalid OBj syntax is encountered in the input