Class RasterLayout

Object
RasterLayout
All Implemented Interfaces:
Cloneable

public class RasterLayout extends Object implements Cloneable
A class describing the desired layout of an OpImage.

The RasterLayout class encapsulates three types of information about an image:

  • The image bounds, comprising the min X and Y coordinates, image width, and image height;
  • The tile grid layout, comprising the tile grid X and Y offsets, the tile width, and the tile height; and

Methods that modify the state of an RasterLayout return a reference to 'this' following the change. This allows multiple modifications to be made in a single expression. This provides a way of modifying an RasterLayout within a superclass constructor call.

  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructs an RasterLayout with no parameters set.
    RasterLayout(int minX, int minY, int width, int height)
    Constructs an RasterLayout with only the image dimension parameters set.
    RasterLayout(int minX, int minY, int width, int height, int tileGridXOffset, int tileGridYOffset, int tileWidth, int tileHeight)
    Constructs an RasterLayout with all its parameters set.
    Constructs an RasterLayout with all its parameters set to equal those of a given RenderedImage .
     
  • Method Summary

    Modifier and Type
    Method
    Description
    Returns a clone of the RasterLayout as an Object.
    boolean
    Tests if the specified Object equals this RasterLayout.
    int
    Returns the value of height if it is valid, and otherwise returns the value from the supplied RenderedImage .
    int
    Returns the value of minX if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of minY if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of tileGridXOffset if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of tileGridYOffset if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of tileHeight if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of tileWidth if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
    Returns the value of width if it is valid, and otherwise returns the value from the supplied RenderedImage.
    int
     
    setHeight(int height)
    Sets height to the supplied value and marks it as valid.
    setMinX(int minX)
    Sets minX to the supplied value and marks it as valid.
    setMinY(int minY)
    Sets minY to the supplied value and marks it as valid.
    setTileGridXOffset(int tileGridXOffset)
    Sets tileGridXOffset to the supplied value and marks it as valid.
    setTileGridYOffset(int tileGridYOffset)
    Sets tileGridYOffset to the supplied value and marks it as valid.
    setTileHeight(int tileHeight)
    Sets tileHeight to the supplied value and marks it as valid.
    setTileWidth(int tileWidth)
    Sets tileWidth to the supplied value and marks it as valid.
    setWidth(int width)
    Sets width to the supplied value and marks it as valid.
     
    Returns a String containing the values of all valid fields.

    Methods inherited from class Object

    finalize, getClass, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • RasterLayout

      public RasterLayout()
      Constructs an RasterLayout with no parameters set.
    • RasterLayout

      public RasterLayout(int minX, int minY, int width, int height, int tileGridXOffset, int tileGridYOffset, int tileWidth, int tileHeight)
      Constructs an RasterLayout with all its parameters set. The sampleModel and colorModel parameters are ignored if null.
      Parameters:
      minX - the image's minimum X coordinate.
      minY - the image's minimum Y coordinate.
      width - the image's width.
      height - the image's height.
      tileGridXOffset - the X coordinate of tile (0, 0).
      tileGridYOffset - the Y coordinate of tile (0, 0).
      tileWidth - the width of a tile.
      tileHeight - the height of a tile.
    • RasterLayout

      public RasterLayout(int minX, int minY, int width, int height)
      Constructs an RasterLayout with only the image dimension parameters set.
      Parameters:
      minX - the image's minimum X coordinate.
      minY - the image's minimum Y coordinate.
      width - the image's width.
      height - the image's height.
    • RasterLayout

      public RasterLayout(RenderedImage im)
      Constructs an RasterLayout with all its parameters set to equal those of a given RenderedImage .
      Parameters:
      im - a RenderedImage whose layout will be copied.
    • RasterLayout

      public RasterLayout(Rectangle bounds)
  • Method Details

    • toRectangle

      public Rectangle toRectangle()
    • getMinX

      public int getMinX()
      Returns the value of minX if it is valid, and otherwise returns the value from the supplied RenderedImage. If minX is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of minX.
    • setMinX

      public RasterLayout setMinX(int minX)
      Sets minX to the supplied value and marks it as valid.
      Parameters:
      minX - the minimum X coordinate of the image, as an int.
      Returns:
      a reference to this RasterLayout following the change.
    • getMinY

      public int getMinY()
      Returns the value of minY if it is valid, and otherwise returns the value from the supplied RenderedImage. If minY is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of minY.
    • setMinY

      public RasterLayout setMinY(int minY)
      Sets minY to the supplied value and marks it as valid.
      Parameters:
      minY - the minimum Y coordinate of the image, as an int.
      Returns:
      a reference to this RasterLayout following the change.
    • getWidth

      public int getWidth()
      Returns the value of width if it is valid, and otherwise returns the value from the supplied RenderedImage. If width is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of width.
    • setWidth

      public RasterLayout setWidth(int width)
      Sets width to the supplied value and marks it as valid.
      Parameters:
      width - the width of the image, as an int.
      Returns:
      a reference to this RasterLayout following the change.
      Throws:
      IllegalArgumentException - if width is non-positive.
    • getHeight

      public int getHeight()
      Returns the value of height if it is valid, and otherwise returns the value from the supplied RenderedImage . If height is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of height.
    • setHeight

      public RasterLayout setHeight(int height)
      Sets height to the supplied value and marks it as valid.
      Parameters:
      height - the height of the image, as an int.
      Returns:
      a reference to this RasterLayout following the change.
      Throws:
      IllegalArgumentException - if height is non-positive.
    • getTileGridXOffset

      public int getTileGridXOffset()
      Returns the value of tileGridXOffset if it is valid, and otherwise returns the value from the supplied RenderedImage. If tileGridXOffset is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of tileGridXOffset.
    • setTileGridXOffset

      public RasterLayout setTileGridXOffset(int tileGridXOffset)
      Sets tileGridXOffset to the supplied value and marks it as valid.
      Parameters:
      tileGridXOffset - the X coordinate of tile (0, 0), as an int.
      Returns:
      a reference to this RasterLayout following the change.
    • getTileGridYOffset

      public int getTileGridYOffset()
      Returns the value of tileGridYOffset if it is valid, and otherwise returns the value from the supplied RenderedImage. If tileGridYOffset is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of tileGridYOffset.
    • setTileGridYOffset

      public RasterLayout setTileGridYOffset(int tileGridYOffset)
      Sets tileGridYOffset to the supplied value and marks it as valid.
      Parameters:
      tileGridYOffset - the Y coordinate of tile (0, 0), as an int.
      Returns:
      a reference to this RasterLayout following the change.
    • getTileWidth

      public int getTileWidth()
      Returns the value of tileWidth if it is valid, and otherwise returns the value from the supplied RenderedImage. If tileWidth is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of tileWidth.
    • setTileWidth

      public RasterLayout setTileWidth(int tileWidth)
      Sets tileWidth to the supplied value and marks it as valid.
      Parameters:
      tileWidth - the width of a tile, as an int.
      Returns:
      a reference to this RasterLayout following the change.
      Throws:
      IllegalArgumentException - if tileWidth is non-positive.
    • getTileHeight

      public int getTileHeight()
      Returns the value of tileHeight if it is valid, and otherwise returns the value from the supplied RenderedImage. If tileHeight is not valid and fallback is null, 0 is returned.
      Returns:
      the appropriate value of tileHeight.
    • setTileHeight

      public RasterLayout setTileHeight(int tileHeight)
      Sets tileHeight to the supplied value and marks it as valid.
      Parameters:
      tileHeight - the height of a tile, as an int.
      Returns:
      a reference to this RasterLayout following the change.
      Throws:
      IllegalArgumentException - if tileHeight is non-positive.
    • toString

      public String toString()
      Returns a String containing the values of all valid fields.
      Overrides:
      toString in class Object
    • clone

      public Object clone()
      Returns a clone of the RasterLayout as an Object.
      Overrides:
      clone in class Object
    • equals

      public boolean equals(Object obj)
      Tests if the specified Object equals this RasterLayout.
      Overrides:
      equals in class Object
      Parameters:
      obj - the Object to test for equality
      Returns:
      true if the specified Object is an instance of RasterLayout and equals this RasterLayout; false otherwise.
      Since:
      JAI 1.1
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object