BufferedImageOp (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.awt.image
Interface BufferedImageOp

All Known Implementing Classes:
  AffineTransformOp, ColorConvertOp, ConvolveOp, LookupOp, RescaleOp

public interface BufferedImageOp

This interface describes single-input/single-output operations performed on `BufferedImage` objects. It is implemented by `AffineTransformOp`, `ConvolveOp`, `ColorConvertOp`, `RescaleOp`, and `LookupOp`. These objects can be passed into a `BufferedImageFilter` to operate on a `BufferedImage` in the ImageProducer-ImageFilter-ImageConsumer paradigm.

Classes that implement this interface must specify whether or not they allow in-place filtering-- filter operations where the source object is equal to the destination object.

This interface cannot be used to describe more sophisticated operations such as those that take multiple sources. Note that this restriction also means that the values of the destination pixels prior to the operation are not used as input to the filter operation.

See Also:
  `BufferedImage`, `BufferedImageFilter`, `AffineTransformOp`, `BandCombineOp`, `ColorConvertOp`, `ConvolveOp`, `LookupOp`, `RescaleOp`

Method Summary
`BufferedImage` | `createCompatibleDestImage(BufferedImage src, ColorModel destCM)` Creates a zeroed destination image with the correct size and number of bands.
`BufferedImage` | `filter(BufferedImage src, BufferedImage dest)` Performs a single-input/single-output operation on a `BufferedImage`.
`Rectangle2D` | `getBounds2D(BufferedImage src)` Returns the bounding box of the filtered destination image.
`Point2D` | `getPoint2D(Point2D srcPt, Point2D dstPt)` Returns the location of the corresponding destination point given a point in the source image.
`RenderingHints` | `getRenderingHints()` Returns the rendering hints for this operation.

Method Detail

### filter

    public BufferedImage filter(BufferedImage src,
                                BufferedImage dest)

  Performs a single-input/single-output operation on a `BufferedImage`. If the color models for the two images do not match, a color conversion into the destination color model is performed. If the destination image is null, a `BufferedImage` with an appropriate `ColorModel` is created.

  An `IllegalArgumentException` may be thrown if the source and/or destination image is incompatible with the types of images $ allowed by the class implementing this filter.

  Parameters:
    `src` - The `BufferedImage` to be filtered
    `dest` - The `BufferedImage` in which to store the results$
  Returns:
    The filtered `BufferedImage`.
  Throws:
    `IllegalArgumentException` - If the source and/or destination image is not compatible with the types of images allowed by the class implementing this filter.

### getBounds2D

    public Rectangle2D getBounds2D(BufferedImage src)

  Returns the bounding box of the filtered destination image. An `IllegalArgumentException` may be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.

  Parameters:
    `src` - The `BufferedImage` to be filtered
  Returns:
    The `Rectangle2D` representing the destination image's bounding box.

### createCompatibleDestImage

    public BufferedImage createCompatibleDestImage(BufferedImage src,
                                                   ColorModel destCM)

  Creates a zeroed destination image with the correct size and number of bands. An `IllegalArgumentException` may be thrown if the source image is incompatible with the types of images allowed by the class implementing this filter.

  Parameters:
    `src` - The `BufferedImage` to be filtered
    `destCM` - `ColorModel` of the destination. If null, the `ColorModel` of the source is used.
  Returns:
    The zeroed destination image.

### getPoint2D

    public Point2D getPoint2D(Point2D srcPt,
                              Point2D dstPt)

  Returns the location of the corresponding destination point given a point in the source image. If `dstPt` is specified, it is used to hold the return value.

  Parameters:
    `srcPt` - the `Point2D` that represents the point in the source image
    `dstPt` - The `Point2D` in which to store the result
  Returns:
    The `Point2D` in the destination image that corresponds to the specified point in the source image.

### getRenderingHints

    public RenderingHints getRenderingHints()

  Returns the rendering hints for this operation.

  Returns:
    The `RenderingHints` object for this `BufferedImageOp`

  Overview | Package | Class | Use | Tree | Deprecated | Index | Help

  JavaTM 2 Platform
  Std. Ed. v1.4.1_"07"

  PREV CLASS NEXT CLASS | FRAMES NO FRAMES
  SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

  Submit a bug or feature
  For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

  Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.