org.geotoolkit.image.io
Class IllegalImageDimensionException

Object
  Throwable
      Exception
          IOException
              IIOException
                  IllegalImageDimensionException

All Implemented Interfaces:

Serializable

public class IllegalImageDimensionException
extends IIOException

Thrown by MultidimensionalImageStore implementations when a slice of data in an hypercube is accessed in an illegal way. For example this exception may be thrown at reading or writing time if the following code:

MultidimensionalImageStore reader = ...;
reader.getDimensionForAPI(DimensionSlice.API.BANDS).addDimensionId(...)

has been invoked, and the identifiers given to the addDimensionId(...) method map to a dimension that can not be sliced through the source bands attribute.

The restrictions are plugins-specific, but a typical restriction is that the subregion to fetch along dimensions 0 and 1 can only be specified through the COLUMNS and ROWS API respectively, using the standard source region attribute.

Since:

3.15

Version:

3.15

Author:

Martin Desruisseaux (Geomatys)

See Also:

Serialized Form

Module:

coverage/geotk-coverageio (download)

View source code for this class

Constructor Summary

IllegalImageDimensionException(String message)
Constructs a new exception with the specified detail message.

IllegalImageDimensionException(String message, Throwable cause)
Constructs a new exception with the specified detail message and cause.

Method Summary

Methods inherited from class Throwable

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

Methods inherited from class Object

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

Constructor Detail

IllegalImageDimensionException

public IllegalImageDimensionException(String message)

Constructs a new exception with the specified detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method.

Parameters:

message - The details message.

IllegalImageDimensionException

public IllegalImageDimensionException(String message,
                                      Throwable cause)

Constructs a new exception with the specified detail message and cause. The cause is saved for later retrieval by the Throwable.getCause() method.

Parameters:

message - The details message.

cause - The cause.