Package org.web3d.vrml.renderer

Class DefaultNodeFactory

java.lang.Object

org.web3d.vrml.renderer.DefaultNodeFactory

All Implemented Interfaces:

Cloneable, VRMLNodeFactory

Direct Known Subclasses:

NRNodeFactory, OGLNodeFactory

public class DefaultNodeFactory
extends Object
implements VRMLNodeFactory, Cloneable

Implementation of the VRMLNodeFactory that produces implementations of the nodes and can be customized for a specific renderer.

This implementation serves two purposes - generalised node factory implementation and the base of a renderer-specific implementation. The class is a full instance allowing it to be used directly, but the constructor is marked protected so that you can't create an instance directly. However, you can use the static factory method to fetch the singleton instance for that particular renderer type.

Property Files

Yes, there are a lot used by this class. Most of them we don't know until runtime because the loading of one file is used to find the definition of another file to load with further property information. There is a much more in-depth tutorial on how to extend Xj3D on the website, so this is just an overview.

At the top of the pile is xj3d.properties. This file is used at startup of the factory. In here, is located the list of profiles supported, components supported and renderers supported. The list of profiles are then used to load a separate property file for each profile, with the file name profile_name.properties. The file name is all lower case, regardless of what the initial formal profile name is. In the profile properties file is the title and the list of each component and level that is required for that profile.

After the profiles, there is a list of the components that may be supported. This list just points to the property file that contains the definition of the component. These files may be placed anywhere, however, for the inbuilt components of Xj3D, you will find the property files in this package (directory). Users wishing to create custom components may place them anywhere, so long as they are findable in the CLASSPATH at runtime. Each file contains a title, name of the implementor and a URL of that implementor. In addition, it contains the definition of the maximum level supported by that component and the list of nodes that are provided at each level. This class is longer a singleton. setProfile was clearing the supported nodes each time. This meant multiple threads with different profiles got messed up.

Version:

$Revision: 2.9 $

Author:

Justin Couch

Field Summary

Fields

Modifier and Type	Field	Description
static final String	JAVA3D_RENDERER	Definition of the Java3D renderer
protected int	majorVersion	The major version of the spec this file belongs to.
protected int	minorVersion	The minor version of the spec this file belongs to.
static final String	MOBILE_RENDERER	Definition of the Mobile renderer
static final String	NULL_RENDERER	Definition of the null renderer
static final String	OPENGL_RENDERER	Definition of the OpenGL renderer

Fields inherited from interface org.web3d.vrml.lang.VRMLNodeFactory

ANY_LEVEL

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DefaultNodeFactory(String rendererID)	Construct an instance of the factory for the given renderer type.

Method Summary

Modifier and Type	Method	Description
ComponentInfo	addComponent(String name, int level)	Add a component level requirement to the factory nodes.
static void	clearCachedInfo()	Convenience method to clear all the cached information so that we start again with new information.
Object	clone()	Create a clone of this factory.
static VRMLNodeFactory	createFactory(String rendererID)	Factory method to create an instance of the node factory that can be used for a specific renderer.
VRMLNode	createVRMLNode(String nodeName, boolean staticNode)	Create a new node instance from the given node name.
VRMLNode	createVRMLNode(String component, String nodeName, boolean staticNode)	Create a new node instance of the given node that exists in the given profile.
VRMLNode	createVRMLNode(VRMLNode node, boolean staticNode)	Create a new node instance that is a cloned copy of the given node.
void	disableComponent(int[] specVersion, String componentName, int level)	Disable a component.
ComponentInfo	findComponent(String name, int level)	Check to see if the given component could be found on the system at the given level.
ProfileInfo	findProfile(String name)	Check to see if the given profile could be found on the system.
ComponentInfo[]	getAvailableComponents()	List all of the available components that this factory is capable of supporting.
String[]	getAvailableProfileNames()	Convenience method to get just the names all the available profiles that this factory is capable of supporting.
ProfileInfo[]	getAvailableProfiles()	List the all the available profiles that this factory is capable of supporting.
int[]	getMaxSupportedSpecVersion()	Get the maximum supported spec version.
int[]	getSpecVersion()	Get the spec version that this node factory is currently set to.
static VRMLNodeFactory	newInstance(String rendererID)	Factory method to create an new instance of the node factory every time the method is called.
void	setErrorReporter(org.j3d.util.ErrorReporter reporter)	Register an error reporter with the engine so that any errors generated by the loading of script code can be reported in a nice, pretty fashion.
void	setProfile(String profile)	Set the profile that is to be supported for the following nodes.
void	setSpecVersion(int major, int minor)	Set specification version

Methods inherited from class java.lang.Object

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

Field Details

JAVA3D_RENDERER

public static final String JAVA3D_RENDERER

Definition of the Java3D renderer

See Also:

• Constant Field Values

NULL_RENDERER

public static final String NULL_RENDERER

Definition of the null renderer

See Also:

• Constant Field Values

OPENGL_RENDERER

public static final String OPENGL_RENDERER

Definition of the OpenGL renderer

See Also:

• Constant Field Values

MOBILE_RENDERER

public static final String MOBILE_RENDERER

Definition of the Mobile renderer

See Also:

• Constant Field Values

majorVersion

protected int majorVersion

The major version of the spec this file belongs to.

minorVersion

protected int minorVersion

The minor version of the spec this file belongs to.

Constructor Details

DefaultNodeFactory

protected DefaultNodeFactory(String rendererID)

Construct an instance of the factory for the given renderer type.

Parameters:

rendererID - The ID of the renderer to use for this factory

Method Details

setErrorReporter

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

Description copied from interface: VRMLNodeFactory

Register an error reporter with the engine so that any errors generated by the loading of script code can be reported in a nice, pretty fashion. Setting a value of null will clear the currently set reporter. If one is already set, the new value replaces the old.

Specified by:

setErrorReporter in interface VRMLNodeFactory

Parameters:

reporter - The instance to use or null

setSpecVersion

public void setSpecVersion(int major,
 int minor)
                    throws UnsupportedSpecVersionException

Set specification version

Specified by:

setSpecVersion in interface VRMLNodeFactory

Parameters:

major - 2 (VRML97), 3, or 4

minor - 0, 1, 2, 3

Throws:

UnsupportedSpecVersionException

getSpecVersion

public int[] getSpecVersion()

Description copied from interface: VRMLNodeFactory

Get the spec version that this node factory is currently set to.

Specified by:

getSpecVersion in interface VRMLNodeFactory

Returns:

An int array of major, minor version.

setProfile

public void setProfile(String profile)
                throws UnsupportedProfileException

Description copied from interface: VRMLNodeFactory

Set the profile that is to be supported for the following nodes. Calling this method will clear all previously set profile and components.

Specified by:

setProfile in interface VRMLNodeFactory

Parameters:

profile - The profile name to use

Throws:

UnsupportedProfileException - The profile is not unsupported by this implementation

getMaxSupportedSpecVersion

public int[] getMaxSupportedSpecVersion()

Description copied from interface: VRMLNodeFactory

Get the maximum supported spec version.

Specified by:

getMaxSupportedSpecVersion in interface VRMLNodeFactory

Returns:

An int array of major, minor version.

disableComponent

public void disableComponent(int[] specVersion,
 String componentName,
 int level)

Description copied from interface: VRMLNodeFactory

Disable a component. Typically done when something finds out it cannot support the component.

Specified by:

disableComponent in interface VRMLNodeFactory

Parameters:

specVersion - The spec version. Major, Minor.

componentName - The component name

level - The component level and higher to disable

addComponent

public ComponentInfo addComponent(String name,
 int level)
                           throws UnsupportedComponentException

Description copied from interface: VRMLNodeFactory

Add a component level requirement to the factory nodes. If that component or level is not supported, an exception is thrown. If the level is ANY_LEVEL then that says to find the highest supported component.

Specified by:

addComponent in interface VRMLNodeFactory

Parameters:

name - The name of the component

level - The level of the component to support

Returns:

The component information declaration matching the input

Throws:

UnsupportedComponentException - The component is not unsupported by this implementation

findComponent

public ComponentInfo findComponent(String name,
 int level)

Description copied from interface: VRMLNodeFactory

Check to see if the given component could be found on the system at the given level. If it is, it will be automatically added to the available component list. This is relative to the given specification level that has been set for this factory instance.

Specified by:

findComponent in interface VRMLNodeFactory

Parameters:

name - The name of the component

level - The level of the component to support

Returns:

The component definition if found, null if not

findProfile

public ProfileInfo findProfile(String name)

Description copied from interface: VRMLNodeFactory

Check to see if the given profile could be found on the system. If it is, it will be automatically added to the available profile list. This is relative to the given specification level that has been set for this factory instance.

Specified by:

findProfile in interface VRMLNodeFactory

Parameters:

name - The name of the profile

Returns:

The profile definition if found, null if not

getAvailableProfiles

public ProfileInfo[] getAvailableProfiles()

Description copied from interface: VRMLNodeFactory

List the all the available profiles that this factory is capable of supporting. It is not the list of set profiles to filter for.

Specified by:

getAvailableProfiles in interface VRMLNodeFactory

Returns:

A list of the supported profiles

getAvailableProfileNames

public String[] getAvailableProfileNames()

Description copied from interface: VRMLNodeFactory

Convenience method to get just the names all the available profiles that this factory is capable of supporting. It is not the list of set profiles to filter for.

Specified by:

getAvailableProfileNames in interface VRMLNodeFactory

Returns:

A list of the supported profile names

getAvailableComponents

public ComponentInfo[] getAvailableComponents()

Description copied from interface: VRMLNodeFactory

List all of the available components that this factory is capable of supporting.

Specified by:

getAvailableComponents in interface VRMLNodeFactory

Returns:

The definition of all the available components

createVRMLNode

public VRMLNode createVRMLNode(String nodeName,
 boolean staticNode)
                        throws UnsupportedNodeException

Description copied from interface: VRMLNodeFactory

Create a new node instance from the given node name. A best guess is made to the node's profile that it belongs to. This means that it could occasionally get it wrong if there are conflicting node names. If the node does not exist in the set profile + component then an exception is thrown. If it is part of the profile, but has not yet been implemented then null is returned.

Specified by:

createVRMLNode in interface VRMLNodeFactory

Parameters:

nodeName - The name of the node instance to create

staticNode - Whether this node will be modified

Returns:

An instance of the node, uninitialised or null.

Throws:

UnsupportedNodeException - The node is not part of the declared profile and components

createVRMLNode

public VRMLNode createVRMLNode(String component,
 String nodeName,
 boolean staticNode)
                        throws UnsupportedComponentException,
UnsupportedNodeException

Description copied from interface: VRMLNodeFactory

Create a new node instance of the given node that exists in the given profile. If the node does not exist in that profile then an exception is thrown. If it is part of the profile, but has not yet been implemented then null is returned.

Specified by:

createVRMLNode in interface VRMLNodeFactory

Parameters:

component - The name of the component to create the name for

nodeName - The name of the node instance to create

staticNode - Whether this node is will be modified

Returns:

An instance of the node, uninitialised or null.

Throws:

UnsupportedComponentException - The component is not in the list of usable components currently set

UnsupportedNodeException - The node is not part of the declared profile and components

createVRMLNode

public VRMLNode createVRMLNode(VRMLNode node,
 boolean staticNode)

Description copied from interface: VRMLNodeFactory

Create a new node instance that is a cloned copy of the given node. The copy shall be a shallow copy. All of the node's direct field data has full copies of the values made, but any referenced child nodes are not included in the copy.

The primary use of this method is in generating proto instances from a set of template nodes. The parser of the proto will be responsible for making sure the children scene graphs are correctly built by successive calls to this method. Note that this implies the source node may well be from a different renderer implementation to the output form.

Specified by:

createVRMLNode in interface VRMLNodeFactory

Parameters:

node - The node instance to create a copy of

staticNode - Whether this node is will be modified

Returns:

An instance of the node initialised to the values or null.

createFactory

public static VRMLNodeFactory createFactory(String rendererID)

Factory method to create an instance of the node factory that can be used for a specific renderer.

Parameters:

rendererID - The ID of the renderer to use for this factory

Returns:

newInstance

public static VRMLNodeFactory newInstance(String rendererID)

Factory method to create an new instance of the node factory every time the method is called.

Parameters:

rendererID - The ID of the renderer to use for this factory

Returns:

clearCachedInfo

public static void clearCachedInfo()

Convenience method to clear all the cached information so that we start again with new information. This will clear all global information, not just the info in the current instance.

clone

public Object clone()
             throws CloneNotSupportedException

Description copied from interface: VRMLNodeFactory

Create a clone of this factory. The clone will have the same profile and component mix already constructed.

Specified by:

clone in interface VRMLNodeFactory

Overrides:

clone in class Object

Returns:

A cloned copy of this instance

Throws:

CloneNotSupportedException - Was not able to clone the object