Package javax.media.j3d
Class ShaderError
- java.lang.Object
-
- javax.media.j3d.ShaderError
-
public class ShaderError extends java.lang.ObjectShaderError is a container object that holds the details of a runtime error that occurs while compiling or executing a programmable shader.- Since:
- Java 3D 1.4
-
-
Field Summary
Fields Modifier and Type Field Description static intCOMPILE_ERRORIndicates that an error occurred while compiling a shader.static intLINK_ERRORIndicates that an error occurred while linking a shader.static intNO_ERRORIndicates that no error occurred.static intSHADER_ATTRIBUTE_LOOKUP_ERRORIndicates a error in looking up the location of a uniform shader attribute name within a given shader program.static intSHADER_ATTRIBUTE_NAME_NOT_SET_ERRORIndicates a error caused by a ShaderAttribute whose name does not appear in the list of shader attribute names in the corresponding ShaderProgram object.static intSHADER_ATTRIBUTE_TYPE_ERRORIndicates a error in the type of the attribute versus what the shader program was expecting.static intUNSUPPORTED_LANGUAGE_ERRORIndicates that the specified shading language is not supported on the screen display device.static intVERTEX_ATTRIBUTE_LOOKUP_ERRORIndicates a error in looking up a vertex attribute name within a given shader program.
-
Constructor Summary
Constructors Constructor Description ShaderError()Constructs a new ShaderError object indicating no error.ShaderError(int errorCode, java.lang.String errorMessage)Constructs a new ShaderError object with the given error code and message.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Canvas3DgetCanvas3D()Returns the canvas associated with this shader error.java.lang.StringgetDetailMessage()Returns the detail message for this shader error.intgetErrorCode()Returns the error code for this shader error.java.lang.StringgetErrorMessage()Returns the error message for this shader error.GeometrygetGeometry()Returns the geometry associated with this shader error.ShadergetShader()Returns the shader object associated with this shader error.ShaderAppearancegetShaderAppearance()Returns the shader appearance associated with this shader error.ShaderAttributegetShaderAttribute()Returns the shader attribute associated with this shader error.ShaderAttributeSetgetShaderAttributeSet()Returns the shader attribute set associated with this shader error.ShaderProgramgetShaderProgram()Returns the shader program associated with this shader error.Shape3DgetShape3D()Returns the shape node associated with this shader error.voidprintVerbose()Prints a verbose error report to System.err.voidprintVerbose(java.io.PrintStream printStream)Prints a verbose error report to the specified PrintStream.voidsetCanvas3D(Canvas3D canvas)Sets the canvas associated with this shader error.voidsetDetailMessage(java.lang.String detailMessage)Sets the detail message for this shader error.voidsetErrorCode(int errorCode)Sets the error code for this shader error.voidsetErrorMessage(java.lang.String errorMessage)Sets the error message for this shader error.voidsetGeometry(Geometry geometry)Sets the geometry associated with this shader error.voidsetShader(Shader shader)Sets the shader object associated with this shader error.voidsetShaderAppearance(ShaderAppearance shaderApp)Sets the shader appearance associated with this shader error.voidsetShaderAttribute(ShaderAttribute shaderAttribute)Sets the shader attribute associated with this shader error.voidsetShaderAttributeSet(ShaderAttributeSet shaderAttributeSet)Sets the shader attribute set associated with this shader error.voidsetShaderProgram(ShaderProgram shaderProgram)Sets the shader program associated with this shader error.voidsetShape3D(Shape3D shape)Sets the shape node associated with this shader error.java.lang.StringtoString()Returns a short string that describes this shader error.
-
-
-
Field Detail
-
NO_ERROR
@Native public static final int NO_ERROR
Indicates that no error occurred.- See Also:
- Constant Field Values
-
COMPILE_ERROR
@Native public static final int COMPILE_ERROR
Indicates that an error occurred while compiling a shader.- See Also:
- Constant Field Values
-
LINK_ERROR
@Native public static final int LINK_ERROR
Indicates that an error occurred while linking a shader.- See Also:
- Constant Field Values
-
VERTEX_ATTRIBUTE_LOOKUP_ERROR
@Native public static final int VERTEX_ATTRIBUTE_LOOKUP_ERROR
Indicates a error in looking up a vertex attribute name within a given shader program.- See Also:
- Constant Field Values
-
SHADER_ATTRIBUTE_LOOKUP_ERROR
@Native public static final int SHADER_ATTRIBUTE_LOOKUP_ERROR
Indicates a error in looking up the location of a uniform shader attribute name within a given shader program.- See Also:
- Constant Field Values
-
SHADER_ATTRIBUTE_NAME_NOT_SET_ERROR
@Native public static final int SHADER_ATTRIBUTE_NAME_NOT_SET_ERROR
Indicates a error caused by a ShaderAttribute whose name does not appear in the list of shader attribute names in the corresponding ShaderProgram object.- See Also:
- Constant Field Values
-
SHADER_ATTRIBUTE_TYPE_ERROR
@Native public static final int SHADER_ATTRIBUTE_TYPE_ERROR
Indicates a error in the type of the attribute versus what the shader program was expecting.- See Also:
- Constant Field Values
-
UNSUPPORTED_LANGUAGE_ERROR
@Native public static final int UNSUPPORTED_LANGUAGE_ERROR
Indicates that the specified shading language is not supported on the screen display device.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
ShaderError
public ShaderError()
Constructs a new ShaderError object indicating no error. The error code is set toNO_ERROR. All other fields are initialized to null, including the error message.
-
ShaderError
public ShaderError(int errorCode, java.lang.String errorMessage)Constructs a new ShaderError object with the given error code and message. All other fields are initialized to null.- Parameters:
errorCode- the error code for this shader error.errorMessage- a short error message describing this shader error.
-
-
Method Detail
-
printVerbose
public void printVerbose()
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(java.io.PrintStream printStream)
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 error report.
-
setErrorCode
public void setErrorCode(int errorCode)
Sets the error code for this shader error. This represents the type of error that occurred.- Parameters:
errorCode- the error code for this shader error.
-
getErrorCode
public int getErrorCode()
Returns the error code for this shader error.- Returns:
- the error code.
-
setErrorMessage
public void setErrorMessage(java.lang.String errorMessage)
Sets the error message for this shader error. This is a short message describing the error, and is included as part of toString().- Parameters:
errorMessage- a short error message describing this shader error.
-
getErrorMessage
public java.lang.String getErrorMessage()
Returns the error message for this shader error.- Returns:
- a short error message describing this shader error.
-
setDetailMessage
public void setDetailMessage(java.lang.String detailMessage)
Sets the detail message for this shader error. This is a detailed error message, typically produced by the shader compiler, and is not included as part of toString().- Parameters:
detailMessage- a detailed message describing this shader error in more detail.
-
getDetailMessage
public java.lang.String getDetailMessage()
Returns the detail message for this shader error.- Returns:
- the detail message for this shader error.
-
setCanvas3D
public void setCanvas3D(Canvas3D canvas)
Sets the canvas associated with this shader error.- Parameters:
canvas- the canvas associated with this shader error.
-
getCanvas3D
public Canvas3D getCanvas3D()
Returns the canvas associated with this shader error.- Returns:
- the canvas associated with this shader error.
-
setShape3D
public void setShape3D(Shape3D shape)
Sets the shape node associated with this shader error.- Parameters:
shape- the shape node associated with this shader error.
-
getShape3D
public Shape3D getShape3D()
Returns the shape node associated with this shader error.- Returns:
- the shape node associated with this shader error.
-
setGeometry
public void setGeometry(Geometry geometry)
Sets the geometry associated with this shader error.- Parameters:
geometry- the geometry associated with this shader error.
-
getGeometry
public Geometry getGeometry()
Returns the geometry associated with this shader error.- Returns:
- the geometry associated with this shader error.
-
setShaderAppearance
public void setShaderAppearance(ShaderAppearance shaderApp)
Sets the shader appearance associated with this shader error.- Parameters:
shaderApp- the shader appearance associated with this shader error.
-
getShaderAppearance
public ShaderAppearance getShaderAppearance()
Returns the shader appearance associated with this shader error.- Returns:
- the shader appearance associated with this shader error.
-
setShaderProgram
public void setShaderProgram(ShaderProgram shaderProgram)
Sets the shader program associated with this shader error.- Parameters:
shaderProgram- the shader program associated with this shader error.
-
getShaderProgram
public ShaderProgram getShaderProgram()
Returns the shader program associated with this shader error.- Returns:
- the shader program associated with this shader error.
-
setShader
public void setShader(Shader shader)
Sets the shader object associated with this shader error.- Parameters:
shader- the shader object associated with this shader error.
-
getShader
public Shader getShader()
Returns the shader object associated with this shader error.- Returns:
- the shader object associated with this shader error.
-
setShaderAttributeSet
public void setShaderAttributeSet(ShaderAttributeSet shaderAttributeSet)
Sets the shader attribute set associated with this shader error.- Parameters:
shaderAttributeSet- the shader attribute set associated with this shader error.
-
getShaderAttributeSet
public ShaderAttributeSet getShaderAttributeSet()
Returns the shader attribute set associated with this shader error.- Returns:
- the shader attribute set associated with this shader error.
-
setShaderAttribute
public void setShaderAttribute(ShaderAttribute shaderAttribute)
Sets the shader attribute associated with this shader error.- Parameters:
shaderAttribute- the shader attribute associated with this shader error.
-
getShaderAttribute
public ShaderAttribute getShaderAttribute()
Returns the shader attribute associated with this shader error.- Returns:
- the shader attribute associated with this shader error.
-
toString
public java.lang.String toString()
Returns a short string that describes this shader 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.- Overrides:
toStringin classjava.lang.Object- Returns:
- a string representation of this shader error.
-
-