Java 2D API: 5 -

CONTENTS | PREV | NEXT Java 2D API

5.1 Interfaces and Classes

The immediate mode imaging APIs in the Java 2D API can be grouped into six categories: interfaces, image data classes, image operation classes, sample model classes, color model classes, and exceptions.

5.1.1 Imaging Interfaces

Interface

Description

BufferedImageOp

Describes single-input/single-output operations performed on BufferedImage objects. Implemented by AffineTransformOp, ColorConvertOp, ConvolveOp, LookupOp, and RescaleOp.

RasterOp

Defines single-input/single-output operations performed on Raster objects. Implemented by AffineTransformOp, BandCombineOp, ColorConvertOp, ConvolveOp, LookupOp, and RescaleOp.

RenderedImage

Defines a common protocol for objects that contain or can produce image data in the form of Rasters.

WritableRenderedImage

Extends: RenderedImage
Defines a common protocol for objects that contain or can produce image data in the form of Rasters which can be modified.

TileObserver

Defines a protocol for objects that want to be notified when the modification state of a WritableRenderedImage changes.

5.1.2 Image Data Classes

Class

Description

BufferedImage

Extends: Image
Implements: WriteableRenderedImage
An image with an accessible data buffer. A BufferedImage has a ColorModel and a Raster of image data.

ByteLookupTable

Extends: LookupTable
A LookupTable that contains byte data.

DataBuffer

Wraps one or more data arrays holding pixel data. Each data array is called a bank.

DataBufferByte

Extends: DataBuffer (Final)
A data buffer that stores bytes of data. (Used in Java Advanced Imaging API)

DataBufferInt

Extends: DataBuffer (Final))
A data buffer that stores integer data.(Used in Java Advanced Imaging API)

DataBufferShort

Extends: DataBuffer (Final)
A data buffer that stores short data.(Used in Java Advanced Imaging API)

DataBufferUShort

Extends: DataBuffer (Final)
A data buffer that stores unsigned short data.

Kernel

A matrix that describes how an input pixel and its surrounding pixels affect the value of an output pixel in a ConvolveOp filtering operation.

LookupTable

Extends: Object
A table that maps values from single-banded pixel data to color values.

Raster

A rectangular array of pixels from which you can retrieve image data. A Raster contains a DataBuffer and a SampleModel.

ShortLookupTable

Extends: LookupTable
A lookup table that contains short data.

WritableRaster

Extends: Raster
A Raster that you can modify.

5.1.3 Image Operation Classes

Class

Description

AffineTransformOp

Implements: BufferedImageOp, RasterOp
A class that defines an affine transform to perform a linear mapping from 2D coordinates in a source Image or Raster to 2D coordinates in the destination image or Raster. This class can perform either bilinear or nearest neighbor affine transform operations.

BandCombineOp

Implements: RasterOp
Using a specified matrix, this operation performs an arbitrary linear combination of bands in a Raster.

BufferedImageFilter

Extends: ImageFilter
An ImageFilter that provides a simple means of using a BufferedImageOp (a single-source/single-destination image operator) to filter a BufferedImage or Raster.

ColorConvertOp

Implements: BufferedImageOp, RasterOp
Performs a pixel-by-pixel color conversion of the data in the source image.

ConvolveOp

Implements: BufferedImageOp, RasterOp
Uses a Kernel to perform a convolution on the source image. A convolution is a spatial operation where the pixels surrounding the input pixel are multiplied by a kernel value to generate the value of the output pixel. The Kernel mathematically defines the relationship between the pixels in the immediate neighborhood of the input pixel and the output pixel.

LookupOp

Implements: BufferedImageOp, RasterOp
Performs a lookup operation from the source to the destination. For Rasters, the lookup operates on sample values. For BufferedImages, the lookup operates on color and alpha components.

RescaleOp

Implements: BufferedImageOp, RasterOp
Performs a pixel-by-pixel rescaling of the data in the source image by multiplying each pixel value by a scale factor and then adding an offset.

5.1.4 Sample Model Classes

Class

Description

BandedSampleModel

Extends: ComponentSampleModel (Final)
Provides access to image data stored with like samples stored as bands in separate banks of a DataBuffer. A pixel consists of one sample from each band.

ComponentSampleModel

Extends: SampleModel
Provides access to image data stored with each sample of a pixel residing in a separate element of a DataBuffer. Different types of pixel interleaving are supported.

MultiPixelPackedSampleModel

Extends: SampleModel
Provides access to image data stored with multiple one-sample pixels packed into one element of a DataBuffer.

PixelInterleavedSampleModel

Extends: ComponentSampleModel
Provides access to image data stored with the sample data for each pixel in adjacent elements of the data array, and all elements in a single bank of a DataBuffer.

SampleModel

An abstract class that defines a mechanism for extracting sample data from an image without knowing how the underlying data is stored in a DataBuffer.

SinglePixelPackedSampleModel

Extends: SampleModel
Provides access to image data stored with all the samples belonging to an individual pixel packed into one element of a DataBuffer.

5.1.5 Color Model Classes

Class

Description

ColorModel

Implements: Transparency
JDK1.1 class. An abstract class that defines methods for translating from image pixel values to color components such as red, green, and blue.

ComponentColorModel

Extends: ColorModel
A ColorModel that can handle an arbitrary ColorSpace and an array of color components to match the ColorSpace. This class can be used to represent most color models on most types of GraphicsDevices.

DirectColorModel

Extends: PackedColorModel
JDK1.1 class. A ColorModel that represents pixel values that have RGB color components embedded directly in the bits of the pixel. This color model is similar to an X11 TrueColor visual. The default RGB ColorModel returned by ColorModel.getRGBdefault is a DirectColorModel.

IndexColorModel

Extends: ColorModel
JDK1.1 class. A ColorModel that represents pixel values that are indices into a fixed color map in the sRGB ColorSpace.

PackedColorModel

Extends: ColorModel
An abstract ColorModel that represents pixel values that have color components embedded directly in the bits of a pixel. DirectColorModel extends PackedColorModel to support pixels that contain RGB color components.

5.1.6 Exception Classes

Class

Description

ImagingOpException

Extends: RuntimeException
Thrown if one of the BufferedImageOp or RasterOp filter methods can't process the image.

RasterFormatException

Extends: RuntimeException
Thrown if there is invalid layout information in the Raster.

CONTENTS | PREV | NEXT

Interface	Description
BufferedImageOp	Describes single-input/single-output operations performed on BufferedImage objects. Implemented by AffineTransformOp, ColorConvertOp, ConvolveOp, LookupOp, and RescaleOp.
RasterOp	Defines single-input/single-output operations performed on Raster objects. Implemented by AffineTransformOp, BandCombineOp, ColorConvertOp, ConvolveOp, LookupOp, and RescaleOp.
RenderedImage	Defines a common protocol for objects that contain or can produce image data in the form of Rasters.
WritableRenderedImage	Extends: RenderedImage Defines a common protocol for objects that contain or can produce image data in the form of Rasters which can be modified.
TileObserver	Defines a protocol for objects that want to be notified when the modification state of a WritableRenderedImage changes.

Class	Description
BufferedImage	Extends: Image Implements: WriteableRenderedImage An image with an accessible data buffer. A BufferedImage has a ColorModel and a Raster of image data.
ByteLookupTable	Extends: LookupTable A LookupTable that contains byte data.
DataBuffer	Wraps one or more data arrays holding pixel data. Each data array is called a bank.
DataBufferByte	Extends: DataBuffer (Final) A data buffer that stores bytes of data. (Used in Java Advanced Imaging API)
DataBufferInt	Extends: DataBuffer (Final)) A data buffer that stores integer data.(Used in Java Advanced Imaging API)
DataBufferShort	Extends: DataBuffer (Final) A data buffer that stores short data.(Used in Java Advanced Imaging API)
DataBufferUShort	Extends: DataBuffer (Final) A data buffer that stores unsigned short data.
Kernel	A matrix that describes how an input pixel and its surrounding pixels affect the value of an output pixel in a ConvolveOp filtering operation.
LookupTable	Extends: Object A table that maps values from single-banded pixel data to color values.
Raster	A rectangular array of pixels from which you can retrieve image data. A Raster contains a DataBuffer and a SampleModel.
ShortLookupTable	Extends: LookupTable A lookup table that contains short data.
WritableRaster	Extends: Raster A Raster that you can modify.

Class	Description
AffineTransformOp	Implements: BufferedImageOp, RasterOp A class that defines an affine transform to perform a linear mapping from 2D coordinates in a source Image or Raster to 2D coordinates in the destination image or Raster. This class can perform either bilinear or nearest neighbor affine transform operations.
BandCombineOp	Implements: RasterOp Using a specified matrix, this operation performs an arbitrary linear combination of bands in a Raster.
BufferedImageFilter	Extends: ImageFilter An ImageFilter that provides a simple means of using a `BufferedImageOp` (a single-source/single-destination image operator) to filter a BufferedImage or Raster.
ColorConvertOp	Implements: BufferedImageOp, RasterOp Performs a pixel-by-pixel color conversion of the data in the source image.
ConvolveOp	Implements: BufferedImageOp, RasterOp Uses a Kernel to perform a convolution on the source image. A convolution is a spatial operation where the pixels surrounding the input pixel are multiplied by a kernel value to generate the value of the output pixel. The Kernel mathematically defines the relationship between the pixels in the immediate neighborhood of the input pixel and the output pixel.
LookupOp	Implements: BufferedImageOp, RasterOp Performs a lookup operation from the source to the destination. For Rasters, the lookup operates on sample values. For BufferedImages, the lookup operates on color and alpha components.
RescaleOp	Implements: BufferedImageOp, RasterOp Performs a pixel-by-pixel rescaling of the data in the source image by multiplying each pixel value by a scale factor and then adding an offset.

Class	Description
BandedSampleModel	Extends: ComponentSampleModel (Final) Provides access to image data stored with like samples stored as bands in separate banks of a `DataBuffer`. A pixel consists of one sample from each band.
ComponentSampleModel	Extends: SampleModel Provides access to image data stored with each sample of a pixel residing in a separate element of a DataBuffer. Different types of pixel interleaving are supported.
MultiPixelPackedSampleModel	Extends: SampleModel Provides access to image data stored with multiple one-sample pixels packed into one element of a DataBuffer.
PixelInterleavedSampleModel	Extends: ComponentSampleModel Provides access to image data stored with the sample data for each pixel in adjacent elements of the data array, and all elements in a single bank of a DataBuffer.
SampleModel	An abstract class that defines a mechanism for extracting sample data from an image without knowing how the underlying data is stored in a DataBuffer.
SinglePixelPackedSampleModel	Extends: SampleModel Provides access to image data stored with all the samples belonging to an individual pixel packed into one element of a DataBuffer.

Class	Description
ColorModel	Implements: Transparency JDK1.1 class. An abstract class that defines methods for translating from image pixel values to color components such as red, green, and blue.
ComponentColorModel	Extends: ColorModel A ColorModel that can handle an arbitrary ColorSpace and an array of color components to match the ColorSpace. This class can be used to represent most color models on most types of GraphicsDevices.
DirectColorModel	Extends: PackedColorModel JDK1.1 class. A ColorModel that represents pixel values that have RGB color components embedded directly in the bits of the pixel. This color model is similar to an X11 TrueColor visual. The default RGB ColorModel returned by ColorModel`.`getRGBdefault is a DirectColorModel.
IndexColorModel	Extends: ColorModel JDK1.1 class. A ColorModel that represents pixel values that are indices into a fixed color map in the sRGB ColorSpace.
PackedColorModel	Extends: ColorModel An abstract `ColorModel` that represents pixel values that have color components embedded directly in the bits of a pixel. DirectColorModel extends PackedColorModel to support pixels that contain RGB color components.

Class	Description
ImagingOpException	Extends: `RuntimeException` Thrown if one of the BufferedImageOp or RasterOp filter methods can't process the image.
RasterFormatException	Extends: `RuntimeException` Thrown if there is invalid layout information in the Raster.