Package org.apache.sis.internal.storage

Class TiledDeferredImage

java.lang.Object

org.apache.sis.image.PlanarImage

org.apache.sis.image.ComputedImage

org.apache.sis.internal.coverage.j2d.BatchComputedImage

org.apache.sis.internal.storage.TiledDeferredImage

All Implemented Interfaces:

RenderedImage, Disposable

final class TiledDeferredImage
extends BatchComputedImage

A rendered image where tiles are loaded only when first needed. Used for RasterLoadingStrategy.AT_GET_TILE_TIME. Other loading strategies should not instantiate this class.

Since:

1.2

Version:

1.2

Field Summary

Fields

Modifier and Type	Field	Description
private final int	height	Number of pixels along X or Y axis in the whole rendered image.
private final TiledGridCoverage.AOI	iterator	Iterator over tiles.
private final int	minTileX	Index of the first tile in the image.
private final int	minTileY	Index of the first tile in the image.
private final int	width	Number of pixels along X or Y axis in the whole rendered image.

Fields inherited from class org.apache.sis.image.ComputedImage

sampleModel, SOURCE_PADDING_KEY

Fields inherited from class org.apache.sis.image.PlanarImage

GRID_GEOMETRY_KEY, MASK_KEY, POSITIONAL_ACCURACY_KEY, SAMPLE_RESOLUTIONS_KEY, STATISTICS_KEY

Constructor Summary

Constructors

Constructor	Description
TiledDeferredImage(int[] imageSize, int[] tileLower, Map<String,Object> properties, TiledGridCoverage.AOI iterator)	Creates a new tiled image.

Method Summary

Modifier and Type	Method	Description
protected Raster[]	computeTiles(Rectangle tiles)	Loads immediately and returns all tiles in the given ranges of tile indices.
ColorModel	getColorModel()	Returns the color model, or null if none.
final int	getHeight()	Returns the number of pixels along Y axis in the whole rendered image.
final int	getMinTileX()	Returns the minimum tile index in the X direction.
final int	getMinTileY()	Returns the minimum tile index in the Y direction.
final int	getMinX()	Returns the minimum x coordinate (inclusive) of this image.
final int	getMinY()	Returns the minimum y coordinate (inclusive) of this image.
final int	getWidth()	Returns the number of pixels along X axis in the whole rendered image.

Methods inherited from class org.apache.sis.internal.coverage.j2d.BatchComputedImage

computeTile, getProperty, getPropertyNames, prefetch

Methods inherited from class org.apache.sis.image.ComputedImage

clearErrorFlags, createTile, dispose, getSampleModel, getSource, getSources, getTile, getTileHeight, getTileWidth, getWritableTileIndices, hasTileWriters, isTileWritable, markDirtyTiles, markTileWritable, sourceTileChanged

Methods inherited from class org.apache.sis.image.PlanarImage

copyData, getBounds, getData, getData, getNumXTiles, getNumYTiles, getTileGridXOffset, getTileGridYOffset, toString, verify

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

width

private final int width

Number of pixels along X or Y axis in the whole rendered image.

height

private final int height

Number of pixels along X or Y axis in the whole rendered image.

minTileX

private final int minTileX

Index of the first tile in the image.

minTileY

private final int minTileY

Index of the first tile in the image.

iterator

private final TiledGridCoverage.AOI iterator

Iterator over tiles. The iterator position should not be modified; instead subsets of this iterator will be created when needed.

Constructor Details

TiledDeferredImage

TiledDeferredImage(int[] imageSize,
 int[] tileLower,
 Map<String,Object> properties,
 TiledGridCoverage.AOI iterator)

Creates a new tiled image.

Parameters:

imageSize - full image size, after subsampling.

tileLower - indices of first tile to read, inclusive.

properties - image properties, or null if none.

Method Details

getColorModel

public ColorModel getColorModel()

Returns the color model, or null if none.

getMinX

public final int getMinX()

Returns the minimum x coordinate (inclusive) of this image.

Specified by:

getMinX in interface RenderedImage

Overrides:

getMinX in class PlanarImage

Returns:

the minimum x coordinate (column) of this image.

getMinY

public final int getMinY()

Returns the minimum y coordinate (inclusive) of this image.

Specified by:

getMinY in interface RenderedImage

Overrides:

getMinY in class PlanarImage

Returns:

the minimum y coordinate (row) of this image.

getWidth

public final int getWidth()

Returns the number of pixels along X axis in the whole rendered image.

getHeight

public final int getHeight()

Returns the number of pixels along Y axis in the whole rendered image.

getMinTileX

public final int getMinTileX()

Returns the minimum tile index in the X direction.

Specified by:

getMinTileX in interface RenderedImage

Overrides:

getMinTileX in class PlanarImage

Returns:

the minimum tile index in the x direction.

getMinTileY

public final int getMinTileY()

Returns the minimum tile index in the Y direction.

Specified by:

getMinTileY in interface RenderedImage

Overrides:

getMinTileY in class PlanarImage

Returns:

the minimum tile index in the y direction.

computeTiles

protected Raster[] computeTiles(Rectangle tiles)
                         throws Exception

Loads immediately and returns all tiles in the given ranges of tile indices.

Specified by:

computeTiles in class BatchComputedImage

Parameters:

tiles - range of tile indices for which to load tiles.

Returns:

loaded tiles for the given indices, in row-major fashion.

Throws:

Exception - if an error occurred when computing tiles.