RasterLayout (Geotools modules 21.0 API)

Object
- RasterLayout

```
public class RasterLayout
extends Object
```
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 and Description
`RasterLayout()` 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.
`RasterLayout(Rectangle bounds)`
`RasterLayout(RenderedImage im)` Constructs an `RasterLayout` with all its parameters set to equal those of a given `RenderedImage`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Object`	`clone()` Returns a clone of the `RasterLayout` as an Object.
`boolean`	`equals(Object obj)` Tests if the specified `Object` equals this `RasterLayout`.
`int`	`getHeight()` Returns the value of height if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getMinX()` Returns the value of `minX` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getMinY()` Returns the value of `minY` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getTileGridXOffset()` Returns the value of `tileGridXOffset` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getTileGridYOffset()` Returns the value of `tileGridYOffset` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getTileHeight()` Returns the value of tileHeight if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getTileWidth()` Returns the value of `tileWidth` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`getWidth()` Returns the value of `width` if it is valid, and otherwise returns the value from the supplied `RenderedImage`.
`int`	`hashCode()`
`RasterLayout`	`setHeight(int height)` Sets height to the supplied value and marks it as valid.
`RasterLayout`	`setMinX(int minX)` Sets `minX` to the supplied value and marks it as valid.
`RasterLayout`	`setMinY(int minY)` Sets `minY` to the supplied value and marks it as valid.
`RasterLayout`	`setTileGridXOffset(int tileGridXOffset)` Sets `tileGridXOffset` to the supplied value and marks it as valid.
`RasterLayout`	`setTileGridYOffset(int tileGridYOffset)` Sets `tileGridYOffset` to the supplied value and marks it as valid.
`RasterLayout`	`setTileHeight(int tileHeight)` Sets tileHeight to the supplied value and marks it as valid.
`RasterLayout`	`setTileWidth(int tileWidth)` Sets `tileWidth` to the supplied value and marks it as valid.
`RasterLayout`	`setWidth(int width)` Sets `width` to the supplied value and marks it as valid.
`Rectangle`	`toRectangle()`
`String`	`toString()` Returns a String containing the values of all valid fields.

Methods inherited from class Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - 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.
    
    sampleModel - the image's SampleModel.
    
    colorModel - the image's ColorModel.
  - 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 Detail
  - 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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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.
    
    Parameters:
    
    fallback - the RenderedImage fallback.
    
    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

Class RasterLayout

Constructor Summary

Method Summary

Methods inherited from class Object

Constructor Detail

RasterLayout

RasterLayout

RasterLayout

RasterLayout

RasterLayout

Method Detail

toRectangle

getMinX

setMinX

getMinY

setMinY

getWidth

setWidth

getHeight

setHeight

getTileGridXOffset

setTileGridXOffset

getTileGridYOffset

setTileGridYOffset

getTileWidth

setTileWidth

getTileHeight

setTileHeight

toString

clone

equals

hashCode