Package xj3d.filter.filters

Class TransformFilter

java.lang.Object

xj3d.filter.AbstractFilter

xj3d.filter.NewAbstractFilter

xj3d.filter.filters.TransformFilter

All Implemented Interfaces:

BinaryContentHandler, ContentHandler, ProtoHandler, RouteHandler, ScriptHandler, StringContentHandler

public class TransformFilter
extends NewAbstractFilter

TransformFilter places up to n transforms around an object.

Arguments are:

• -scale1 x y z,
• -rotate1 x y z a(radians),
• -translate1 x y z, or
• -resetTransforms

We keep looking for scale/rotate/translate params until we run out of them. We don't assume that the user provides all three (scale/rotate/translate) for every transform group. In other words, this is valid:
-scale1 1 2 1 -rotate2 0 1 0 3.1415
For each transform specified add a Transform around the input stream. So the above input would do this:

DEF TRANSFORM_FILTER1 Transform { scale 1 2 1 children [ DEF TRANFORM_FILTER2 Transform { rotation 0 1 0 3.115 children [ .... <original content> ] } ] } ResetTransforms will remove any previous TransformFilter. This will only be detected if first node is a Transform. This allows multiple files to be combined together without error. This will be detected by using a DEF name of TRANSFORM_FILTER*.

Version:

$Revision: 1.0 $

Author:

Alan Hudson

Field Summary

Fields inherited from class xj3d.filter.NewAbstractFilter

fieldHasEndedImplicitly, parentTypeStack, suppressCalls

Fields inherited from class xj3d.filter.AbstractFilter

contentHandler, documentLocator, errorHandler, fieldHandler, fieldReader, fieldStack, lastErrorCode, majorVersion, minorVersion, nodeStack, parsingType, protoHandler, routeHandler, scriptHandler

Constructor Summary

Constructors

Constructor	Description
TransformFilter()

Method Summary

Modifier and Type	Method	Description
void	endDocument()	Declaration of the end of the document.
void	endField()	Notification of the end of a field declaration.
void	endNode()	Notification of the end of a node declaration.
void	setArguments(String[] args)	Set the argument parameters to control the filter operation.
void	startField(String name)	Notification of a field declaration.
void	startNode(String name, String defName)	Notification of the start of a node.

Methods inherited from class xj3d.filter.NewAbstractFilter

componentDecl, endExternProtoDecl, endProtoBody, endProtoDecl, endScriptDecl, exportDecl, externProtoURI, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, fieldValue, getContentHandler, getErrorReporter, getLastErrorCode, getProtoHandler, getRouteHandler, getScriptHandler, importDecl, metaDecl, profileDecl, protoFieldDecl, protoIsDecl, routeDecl, scriptFieldDecl, setContentHandler, setDebug, setDocumentLocator, setErrorReporter, setProtoHandler, setRouteHandler, setScriptHandler, startDocument, startExternProtoDecl, startProtoBody, startProtoDecl, startScriptDecl, suppressCalls, useDecl

Methods inherited from class xj3d.filter.AbstractFilter

setParsingType

Methods inherited from class java.lang.Object

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

Constructor Details

TransformFilter

public TransformFilter()

Method Details

endDocument

public void endDocument()
                 throws SAVException,
VRMLException

Declaration of the end of the document. There will be no further parsing and hence events after this.

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class NewAbstractFilter

Throws:

SAVException - This call is taken at the wrong time in the structure of the document

VRMLException - The content provided is invalid for this part of the document or can't be parsed

startNode

public void startNode(String name,
 String defName)
               throws SAVException,
VRMLException

Notification of the start of a node. This is the opening statement of a node and it's DEF name. USE declarations are handled in a separate method.

Specified by:

startNode in interface ContentHandler

Overrides:

startNode in class NewAbstractFilter

Parameters:

name - The name of the node that we are about to parse

defName - The string associated with the DEF name. Null if not given for this node.

Throws:

SAVException - This call is taken at the wrong time in the structure of the document

VRMLException - The content provided is invalid for this part of the document or can't be parsed

endNode

public void endNode()
             throws SAVException,
VRMLException

Notification of the end of a node declaration.

Specified by:

endNode in interface ContentHandler

Overrides:

endNode in class NewAbstractFilter

Throws:

SAVException - This call is taken at the wrong time in the structure of the document

VRMLException - The content provided is invalid for this part of the document or can't be parsed

startField

public void startField(String name)
                throws SAVException,
VRMLException

Notification of a field declaration. This notification is only called if it is a standard node. If the node is a script or PROTO declaration then the ScriptHandler or ProtoHandler methods are used.

Specified by:

startField in interface ContentHandler

Overrides:

startField in class NewAbstractFilter

Parameters:

name - The name of the field declared

Throws:

SAVException - This call is taken at the wrong time in the structure of the document

VRMLException - The content provided is invalid for this part of the document or can't be parsed

endField

public void endField()
              throws SAVException,
VRMLException

Notification of the end of a field declaration. This is called only at the end of an MFNode declaration. All other fields are terminated by either NewAbstractFilter.useDecl(String) or NewAbstractFilter.fieldValue(String).

Specified by:

endField in interface ContentHandler

Overrides:

endField in class NewAbstractFilter

Throws:

SAVException - This call is taken at the wrong time in the structure of the document

VRMLException - The content provided is invalid for this part of the document or can't be parsed

setArguments

public void setArguments(String[] args)

Set the argument parameters to control the filter operation.

Overrides:

setArguments in class NewAbstractFilter

Parameters:

args - The array of argument parameters.