com.openinventor.inventor.errors

Class SoDebugError

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.errors.SoError

com.openinventor.inventor.errors.SoDebugError

public class SoDebugError
extends SoError

Debug error handling. SoDebugError is used for all errors reported from Open Inventor library. These errors are typically programmer errors, such as passing a null reference or an out-of-range index. The post() method takes the name of the Open Inventor method that detected the error, to aid the programmer in debugging.

See SoError for full discussion of error handling in Open Inventor.

See also:

SoMemoryError, SoReadError, SoGLError

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SoDebugError.Handler
static class	SoDebugError.Severities Error severity.

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	INFO Deprecated. Use SoDebugError.Severities.INFO instead.
static int	SERROR Deprecated. Use SoDebugError.Severities.SERROR instead.
static int	WARNING Deprecated. Use SoDebugError.Severities.WARNING instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoDebugError() Default constructor.

Method Summary

Modifier and Type	Method and Description
SoDebugError.Severities	getSeverity() Returns severity of error (for use by handlers).
static void	post(java.lang.String methodName, java.lang.String formatString) Posts an error.
static void	postInfo(java.lang.String methodName, java.lang.String formatString) Posts an informational (non-error) message.
static void	postWarning(java.lang.String methodName, java.lang.String formatString) Posts a warning.
static void	setHandlerCallback(SoDebugError.Handler h) Sets the handler for SoDebugError class.

Methods inherited from class com.openinventor.inventor.errors.SoError

getDebugString, post, setHandlerCallback

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

SERROR

@Deprecated
public static final int SERROR

Deprecated. Use SoDebugError.Severities.SERROR instead.

WARNING

@Deprecated
public static final int WARNING

Deprecated. Use SoDebugError.Severities.WARNING instead.

INFO

@Deprecated
public static final int INFO

Deprecated. Use SoDebugError.Severities.INFO instead.

Constructor Detail

SoDebugError

public SoDebugError()

Default constructor.

Method Detail

setHandlerCallback

public static void setHandlerCallback(SoDebugError.Handler h)

Sets the handler for SoDebugError class.

getSeverity

public SoDebugError.Severities getSeverity()

Returns severity of error (for use by handlers).

postInfo

public static void postInfo(java.lang.String methodName,
                            java.lang.String formatString)

Posts an informational (non-error) message.

post

public static void post(java.lang.String methodName,
                        java.lang.String formatString)

Posts an error.

postWarning

public static void postWarning(java.lang.String methodName,
                               java.lang.String formatString)

Posts a warning.