|
| |
|
| java.lang.Object
 javax.media.j3d.RenderingError
| RenderingError | | public class RenderingError extends Object (Code) | | RenderingError is a container object that holds the details of
a runtime error that occurs in the Java 3D rendering system.
since:
Java 3D 1.5 |
| Field Summary | |
| final public static int | CONTEXT_CREATION_ERROR
Indicates that an error occurred while creating an OpenGL or D3D
graphics context. | | final public static int | GRAPHICS_CONFIG_ERROR
Indicates that an error occurred while getting the best graphics
configuration or while testing whether a given graphics config is
supported. | | final public static int | NO_ERROR
Indicates that no error occurred. | | final public static int | OFF_SCREEN_BUFFER_ERROR
Indicates a error in creating a rendering buffer for an off-screen
Canvas3D. | | final public static int | UNEXPECTED_RENDERING_ERROR
Indicates that an unexpected rendering exception was caught by the
Java 3D renderer thread. |
| Constructor Summary | |
| public | RenderingError()
Constructs a new RenderingError object indicating no error. | | public | RenderingError(int errorCode, String errorMessage)
Constructs a new RenderingError object with the given error code
and message. |
| CONTEXT_CREATION_ERROR | | final public static int CONTEXT_CREATION_ERROR(Code) | | Indicates that an error occurred while creating an OpenGL or D3D
graphics context. This can happen either when querying
the Canvas3D properties or when rendering.
|
| GRAPHICS_CONFIG_ERROR | | final public static int GRAPHICS_CONFIG_ERROR(Code) | | Indicates that an error occurred while getting the best graphics
configuration or while testing whether a given graphics config is
supported.
|
| NO_ERROR | | final public static int NO_ERROR(Code) | | Indicates that no error occurred.
|
| OFF_SCREEN_BUFFER_ERROR | | final public static int OFF_SCREEN_BUFFER_ERROR(Code) | | Indicates a error in creating a rendering buffer for an off-screen
Canvas3D.
|
| UNEXPECTED_RENDERING_ERROR | | final public static int UNEXPECTED_RENDERING_ERROR(Code) | | Indicates that an unexpected rendering exception was caught by the
Java 3D renderer thread.
|
| RenderingError | | public RenderingError()(Code) | | Constructs a new RenderingError object indicating no error. The
error code is set to NO_ERROR. All other fields
are initialized to null, including the error message.
|
| RenderingError | | public RenderingError(int errorCode, String errorMessage)(Code) | | Constructs a new RenderingError object with the given error code
and message. All other fields are initialized to null.
Parameters:
errorCode - the error code for this rendering error.
Parameters:
errorMessage - a short error message describing thisrendering error. |
| getCanvas3D | | public Canvas3D getCanvas3D()(Code) | | Returns the canvas associated with this rendering error.
the canvas associated with this rendering error. |
| getDetailMessage | | public String getDetailMessage()(Code) | | Returns the detail message for this rendering error.
the detail message for this rendering error. |
| getErrorCode | | public int getErrorCode()(Code) | | Returns the error code for this rendering error.
the error code. |
| getErrorMessage | | public String getErrorMessage()(Code) | | Returns the error message for this rendering error.
a short error message describing this rendering error. |
| getGraphicsDevice | | public GraphicsDevice getGraphicsDevice()(Code) | | Returns the graphics device associated with this rendering error.
the graphics device associated with this rendering error. |
| printVerbose | | public void printVerbose()(Code) | | Prints a verbose error report to System.err. This verbose
output includes the error code, error message, detail message,
and all relevant Java 3D objects.
|
| printVerbose | | public void printVerbose(PrintStream printStream)(Code) | | Prints a verbose error report to the specified PrintStream.
This verbose output includes the error code, error message,
detail message, and all relevant Java 3D objects.
Parameters:
printStream - the print stream on which to print the errorreport. |
| setCanvas3D | | public void setCanvas3D(Canvas3D canvas)(Code) | | Sets the canvas associated with this rendering error.
Parameters:
canvas - the canvas associated with this rendering error. |
| setDetailMessage | | public void setDetailMessage(String detailMessage)(Code) | | Sets the detail message for this rendering error. This is a more
detailed error message that is not included as part of toString().
Parameters:
detailMessage - a detailed message describing thiserror in more detail. |
| setErrorCode | | public void setErrorCode(int errorCode)(Code) | | Sets the error code for this rendering error. This represents the
type of error that occurred.
Parameters:
errorCode - the error code for this rendering error. |
| setErrorMessage | | public void setErrorMessage(String errorMessage)(Code) | | Sets the error message for this rendering error. This is a short
message describing the error, and is included as part of
toString().
Parameters:
errorMessage - a short error message describing thisrendering error. |
| setGraphicsDevice | | public void setGraphicsDevice(GraphicsDevice graphicsDevice)(Code) | | Sets the graphics device associated with this rendering error.
Parameters:
graphicsDevice - the graphics device associated with this rendering error. |
| toString | | public String toString()(Code) | | Returns a short string that describes this rendering error. The
string is composed of the textual description of the errorCode,
a ": ", and the errorMessage field. If the errorMessage is
null then the ": " and the errorMessage are omitted.
a string representation of this rendering error. |
|
|
|