com.luciad.util

LuciadLightspeedClass TLcdOutOfBoundsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.luciad.util.TLcdOutOfBoundsException

All Implemented Interfaces:

Serializable

public class TLcdOutOfBoundsException
extends Exception

TLcdOutOfBoundsException is an Exception that is thrown when a computed value ends up outside its valid bounds.

This may for example happen when a transformed point has no valid coordinates in its new coordinate space. For example, the location of the south pole cannot be expressed in a grid reference with a polar projection of the northern hemisphere.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TLcdOutOfBoundsException()
TLcdOutOfBoundsException(String s)

Method Summary

Modifier and Type	Method and Description
static TLcdOutOfBoundsException	getSharedInstance() Utility method that returns a shared out of bounds exception.
static boolean	internal(byte[] b) For internal development use only.
static String	internal(int i) For internal development use only.
static void	setStackTraceOn(boolean aStackTraceOn) When set to true this ensures that the correct stack trace is built for the shared instance.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdOutOfBoundsException

public TLcdOutOfBoundsException()

TLcdOutOfBoundsException

public TLcdOutOfBoundsException(String s)

Method Detail

getSharedInstance

public static TLcdOutOfBoundsException getSharedInstance()

Utility method that returns a shared out of bounds exception. This method exists solely for performance reasons: classes that throw many out of bounds exceptions should use the exception generated by this method. The stack trace of the exception will not contain the actual location the exception is thrown.

If a correct stack trace is required set the stackTraceOn property to true. This method then creates a new out of bounds exception for every call to this method. This can lead to a severe performance penalty when many exceptions are thrown so use it only for debugging.

See Also:

setStackTraceOn(boolean)

setStackTraceOn

public static void setStackTraceOn(boolean aStackTraceOn)

When set to true this ensures that the correct stack trace is built for the shared instance. Use only for debugging, since this can lead to a severe performance penalty.

Parameters:

aStackTraceOn - whether or not the correct stack trace should be constructed for the shared instance.

See Also:

getSharedInstance()

internal

public static boolean internal(byte[] b)

For internal development use only.

internal

public static String internal(int i)

For internal development use only.