com.luciad.format.object3d.obj

LuciadFusionClass TLcdOBJMeshDecoder

java.lang.Object

com.luciad.format.object3d.obj.TLcdOBJMeshDecoder

All Implemented Interfaces:

ILcdInputStreamFactoryCapable

public class TLcdOBJMeshDecoder
extends Object
implements ILcdInputStreamFactoryCapable

A decoder for WaveFront OBJ files. This decoder creates an ILcd3DMesh object.

The decoder supports the following OBJ data constructs:

• Vertices
• Normal vectors
• Texture coordinates
• Faces
• Groups
• Material libraries

Other geometric data (e.g. lines, curves, surfaces) or non-geometric information (e.g. rendering attributes) are ignored.

A typical use-case is to use an OBJ file to style a point with a 3D icon. For data on a Lightspeed view, this is achieved by creating a TLsp3DIconStyle containing the OBJ icon. This icon style can then be used as style for your point. The creation of the icon style is illustrated in the following snippet:

   TLsp3DIconStyle iconStyle = TLsp3DIconStyle.newBuilder().icon( "iconFile.obj" ).build();
 

The LuciadLightspeed developer guide contains more information on how to use the created TLsp3DIconStyle in your layer factory.

Note that Lightspeed also supports the use of Collada data for 3D icons. See the package documentation of com.luciad.format.object3d for more information.

Constructor Summary

Constructors

Constructor and Description
TLcdOBJMeshDecoder()

Method Summary

Modifier and Type	Method and Description
ILcd3DMesh	decodeMesh(String aSourceName) Decodes a .OBJ file from the specified source.
ILcdInputStreamFactory	getInputStreamFactory() Returns the input stream factory that is used.
void	setInputStreamFactory(ILcdInputStreamFactory aILcdInputStreamFactory) Sets the input stream factory to be used.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdOBJMeshDecoder

public TLcdOBJMeshDecoder()

Method Detail

setInputStreamFactory

public void setInputStreamFactory(ILcdInputStreamFactory aILcdInputStreamFactory)

Description copied from interface: ILcdInputStreamFactoryCapable

Sets the input stream factory to be used.

Specified by:

setInputStreamFactory in interface ILcdInputStreamFactoryCapable

Parameters:

aILcdInputStreamFactory - the input stream factory to be used.

getInputStreamFactory

public ILcdInputStreamFactory getInputStreamFactory()

Description copied from interface: ILcdInputStreamFactoryCapable

Returns the input stream factory that is used.

Specified by:

getInputStreamFactory in interface ILcdInputStreamFactoryCapable

Returns:

the input stream factory that is used.

decodeMesh

public ILcd3DMesh decodeMesh(String aSourceName)
                      throws IOException

Decodes a .OBJ file from the specified source. Returns an ILcd3DMesh representing the decoded 3D model.

Parameters:

aSourceName - the file to be decoded

Returns:

an ILcd3DMesh

Throws:

IOException - if the file cannot be decoded