# Package org.apache.sis.image

package org.apache.sis.image
Provides helper classes for handling Java2D rendered images together with some operations. This package does not provide any geospatial functionalities; it works only on sample or pixel values stored in `RenderedImage`s. Those rendered images have the following capabilities:

- Images may have an arbitrary number of bands (not necessarily RGB).
- Sample values can be bytes, shorts (signed or unsigned), integers or floating-point values.
- Images can be tiled.

This package is used as a basis for georectified or georeferenceable grid coverages.

## Usage note

Some images are writable. But modifying pixel values should be done by invoking the `getWritableTile(…)` and `releaseWritableTile(…)` methods of `WritableRenderedImage` interface. Do not cast directly a `Raster` to `WritableRaster` even when the cast is safe, because some raster data may be shared by many tiles having identical content. Furthermore, changes in pixel values may be lost if `releaseWritableTile(…)` is not invoked.

Since:
  1.0

- Class
  Description
  Colorizer
  Colorization algorithm to apply for colorizing a computed image.
  Colorizer.Target
  Information about the computed image to colorize.
  ComputedImage
  An image with tiles computed on-the-fly and cached for future reuse.
  DataType
  Identification of the primitive type used for storing sample values in an image.
  ErrorHandler
  Action to perform when errors occurred while reading or writing some tiles in an image.
  ErrorHandler.Report
  Information about errors that occurred while reading or writing tiles in an image.
  ImageCombiner
  Combines an arbitrary number of images into a single one.
  ImageLayout
  Preferences about the tiling of an image in relationship with a given image size.
  ImageProcessor
  A predefined set of operations on images.
  ImageProcessor.Mode
  Execution modes specifying whether operations can be executed in parallel.
  ImageProcessor.Resizing
  Deprecated, for removal: This API element is subject to removal in a future version.
  Replaced by `ImageLayout`.
  Interpolation
  Algorithm for image interpolation (resampling).
  PixelIterator
  An iterator over sample values in a raster or an image.
  PixelIterator.Builder
  Builds pixel iterators for specified region of interest, window size or iteration order.
  PixelIterator.Window<T extends Buffer>
  Contains the sample values in a moving window over the image.
  PlanarImage
  Base class of `RenderedImage` implementations in Apache SIS.
  ResampledImage
  An image which is the result of resampling the pixel values of another image.
  SequenceType
  Specifies the order in which attribute value records are assigned to grid points.
  TransferType<T extends Buffer>
  The type of data used to transfer pixels.
  WritablePixelIterator
  A pixel iterator capable to write sample values.