Package xj3d.filter.importer

Class STLFileParser

java.lang.Object

xj3d.filter.importer.STLFileParser

All Implemented Interfaces:

NonWeb3DFileParser

public class STLFileParser
extends Object
implements NonWeb3DFileParser

File parser implementation that reads STL files and generates an X3D stream of events.

Version:

Grammar $Revision: 1.12 $

Author:

Justin Couch

Constructor Summary

Constructors

Constructor	Description
STLFileParser()	Create a new instance of this parser

Method Summary

Modifier and Type	Method	Description
DocumentLocator	getDocumentLocator()	Fetch the locator used by this parser.
void	initialize()	Initialise the internals of the parser at start up.
List<String>	parse(InputSource input, String[] style)	Parse the input now.
void	setContentHandler(ContentHandler ch)	Set the content handler instance.
void	setDocumentUrl(String url)	Set the base URL of the document that is about to be parsed.
void	setErrorHandler(ErrorHandler eh)	Set the error handler instance.
void	setErrorReporter(org.j3d.util.ErrorReporter eh)	Set the error reporter instance.
void	setProtoHandler(ProtoHandler ph)	Set the proto handler instance.
void	setRouteHandler(RouteHandler rh)	Set the route handler instance.
void	setScriptHandler(ScriptHandler sh)	Set the script handler instance.

Methods inherited from class java.lang.Object

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

Constructor Details

STLFileParser

public STLFileParser()

Create a new instance of this parser

Method Details

initialize

public void initialize()

Initialise the internals of the parser at start up. If you are not using the detailed constructors, this needs to be called to ensure that all internal state is correctly set up.

Specified by:

initialize in interface NonWeb3DFileParser

setDocumentUrl

public void setDocumentUrl(String url)

Set the base URL of the document that is about to be parsed. Users should always call this to make sure we have correct behaviour for the ContentHandler's startDocument() call.

The URL is cleared at the end of each document run. Therefore it is imperative that it get's called each time you use the parser.

Specified by:

setDocumentUrl in interface NonWeb3DFileParser

Parameters:

url - The document url to set

getDocumentLocator

public DocumentLocator getDocumentLocator()

Fetch the locator used by this parser. This is here so that the user of this parser can ask for it and set it before calling startDocument(). Once the scene has started parsing in this class it is too late for the locator to be set. This parser does set it internally when asked for a scene but there may be other times when it is not set.

Specified by:

getDocumentLocator in interface NonWeb3DFileParser

Returns:

The locator used for syntax errors

setContentHandler

public void setContentHandler(ContentHandler ch)

Set the content handler instance.

Specified by:

setContentHandler in interface NonWeb3DFileParser

Parameters:

ch - The content handler instance to use

setRouteHandler

public void setRouteHandler(RouteHandler rh)

Set the route handler instance.

Specified by:

setRouteHandler in interface NonWeb3DFileParser

Parameters:

rh - The route handler instance to use

setScriptHandler

public void setScriptHandler(ScriptHandler sh)

Set the script handler instance.

Specified by:

setScriptHandler in interface NonWeb3DFileParser

Parameters:

sh - The script handler instance to use

setProtoHandler

public void setProtoHandler(ProtoHandler ph)

Set the proto handler instance.

Specified by:

setProtoHandler in interface NonWeb3DFileParser

Parameters:

ph - The proto handler instance to use

setErrorHandler

public void setErrorHandler(ErrorHandler eh)

Set the error handler instance.

Specified by:

setErrorHandler in interface NonWeb3DFileParser

Parameters:

eh - The error handler instance to use

setErrorReporter

public void setErrorReporter(org.j3d.util.ErrorReporter eh)

Set the error reporter instance. If this is also an ErrorHandler instance, the document locator will also be set.

Specified by:

setErrorReporter in interface NonWeb3DFileParser

Parameters:

eh - The error handler instance to use

parse

public List<String> parse(InputSource input,
 String[] style)
                   throws IOException,
VRMLException

Parse the input now.

Specified by:

parse in interface NonWeb3DFileParser

Parameters:

input - The stream to read from

style - The style or null or no styling

Returns:

Null if no parsing issues or a message detailing the issues

Throws:

IOException - An I/O error while reading the stream

VRMLParseException - A parsing error occurred in the file

VRMLException