The Java 3D API Specification |
A P P E N D I X D |
Exceptions |
D.1
Indicates an attempt to use a Tranform3D object that is inappropriate for the object in which it is being used. For example,BadTransformException
- Transforms that are used in the scene graph, within a TransformGroup node, must be affine. They may optionally contain a nonuniform scale or a shear, subject to other listed restrictions.
- All transforms in the TransformGroup nodes above a ViewPlatform object must be congruent. This ensures that the Vworld-coordinates-to-ViewPlatform-coordinates transform is angle- and length-preserving with no shear and with uniform scale. only
- Most viewing transforms other than those in the scene graph can contain translation and rotation only.
- The projection transform is allowed to be nonaffine, but it must be either a single-point perspective projection or a parallel projection.
Constructors
public BadTransformException() public BadTransformException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.2
This exception indicates an access to a live or compiled Scene Graph object without the required capability set.CapabilityNotSetException public CapabilityNotSetException() public CapabilityNotSetException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.3
This exception indicates that during aDanglingReferenceException cloneTree
call, an updated reference was requested for a node that did not get cloned. This occurs when a subgraph is duplicated viacloneTree
and has at least one leaf node that contains a reference to a node with no corresponding node in the cloned subgraph. This results in two leaf nodes wanting to share access to the same node.public DanglingReferenceException() public DanglingReferenceException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.4
This exception indicates an illegal state for rendering. It is currently unused.IllegalRenderingStateException public illegalRenderingStateException() public illegalRenderingStateException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.5
This exception indicates an illegal attempt to share a scene graph object. For example, the following are illegal:IllegalSharingException
- Referencing a shared subgraph in more than one virtual universe.
- Using the same component object both in the scene graph and in an immediate-mode graphics context.
- Including an unsupported type of leaf node within a shared subgraph.
- Referencing a BranchGroup node in more than one of the following ways:
Constructors
public IllegalSharingException() public IllegalSharingException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.6
This exception indicates that an operation cannot be completed properly because of a mismatch in the sizes of the object attributes.MismatchedSizeException public MismatchedSizeException() public MismatchedSizeException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.7
This exception extendsMultipleParentException IllegalSharingException
and indicates an attempt to add a node that is already a child of one group node into another group node.public MultipleParentException() public MultipleParentException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.8
This exception indicates an attempt to access or modify a state variable without permission to do so. For example, invoking aRestrictedAccessException set
method for a state variable that is currently read-only.public RestrictedAccessException() public RestrictedAccessException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.9
This exception indicates that one of the live scene graphs attached to a viewable Locale has a cycle in it. Java 3D scene graphs are directed acyclic graphs and, as such, do not permit cycles. This exception is thrown by the Java 3D renderer either at scene graph traversal time or when a scene graph containing a cycle is made live (added as a descendant of a Locale object).SceneGraphCycleException public SceneGraphCycleException() public SceneGraphCycleException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.10
This exception, in theSingularMatrixException javax.vecmath
package, indicates that the inverse of a matrix cannot be computed.public SingularMatrixException() public SingularMatrixException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
D.11
This exception indicates a problem in loading or playing a sound sample.SoundException public SoundException() public SoundException(String str)These create the exception object that outputs the exception message. The first form uses the default message. The second form specifies the message string to be output.
The Java 3D API Specification |