ilog.views.maps.raster

Class IlvRasterSubsamplingLoader

java.lang.Object

ilog.views.maps.raster.IlvRasterTileLoader

ilog.views.maps.raster.IlvRasterSubsamplingLoader

All Implemented Interfaces:

IlvPersistentObject, IlvTileLoader, Serializable

public class IlvRasterSubsamplingLoader
extends IlvRasterTileLoader

IlvRasterSubsamplingLoader provides the mechanism for progressive dynamic tiling. Using subsampling to create a degraded version of the definitive image, the image becomes more and more precise in the pixel definition. When the image is drawn, it may add a new task to the tile loader to display it with a better resolution. This depends on the necessary resolution at draw time.

Since:

JViews 7.5

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IlvRasterSubsamplingLoader(IlvInputStream stream) Reads an IlvRasterSubsamplingLoader instance from an input stream.
IlvRasterSubsamplingLoader(IlvRasterProperties rasterProperties, IlvRasterMappedBuffer rasterMappedBuffer, IlvCoordinateTransformation transformation, int tileSize) Creates a loader that will initially display an 8x8 subsample image.

Method Summary

Modifier and Type	Method and Description
static double	getImageSubsamplingFactor() Returns the image subsampling factor.
void	load(IlvTile tile) Function called when a tile has to be loaded.
protected IlvRasterIcon	makeIcon(int subsampling, Point2D.Double p1, Point2D.Double p2) Factory of icons from the subsampling and two corners parameters.
void	release(IlvTile tile) Function called when a tile has to be released.
static void	setImageSubsamplingFactor(double subsamplingFactor) Sets the image subsampling factor.
void	write(IlvOutputStream out) Writes the tile loader to an IlvOutputStream

Methods inherited from class ilog.views.maps.raster.IlvRasterTileLoader

getBytePixel, getInternalTransformation, getIntPixel, getPreviewDelay, getPreviewSubsampling, getProperties, getRasterMappedBuffer, getRasterProperties, getRawImageProducer, getScaledImageProducer, getTransformation, isHighQualityRendering, isLoadRetryingOnOutOfMemory, isPersistent, isSynchronous, rasterTileLoaded, setHighQualityRendering, setLoadRetryingOnOutOfMemory, setPreviewSubsampling, setProperties, setSynchronous, setTransformation, setupIcon

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvRasterSubsamplingLoader

public IlvRasterSubsamplingLoader(IlvRasterProperties rasterProperties,
                                  IlvRasterMappedBuffer rasterMappedBuffer,
                                  IlvCoordinateTransformation transformation,
                                  int tileSize)

Creates a loader that will initially display an 8x8 subsample image.

Parameters:

rasterProperties - The information about the raster.

rasterMappedBuffer - Raster data from the original image.

transformation - The transformation to use to translate from view to geographic coordinates.

tileSize - The size of a tile.

IlvRasterSubsamplingLoader

public IlvRasterSubsamplingLoader(IlvInputStream stream)
                           throws IlvReadFileException

Reads an IlvRasterSubsamplingLoader instance from an input stream.

Parameters:

stream - The input stream to read from.

Throws:

IlvReadFileException - if there is a problem reading from stream.

Method Detail

getImageSubsamplingFactor

public static double getImageSubsamplingFactor()

Returns the image subsampling factor.

Returns:

The image subsampling factor.

See Also:

setImageSubsamplingFactor(double)

setImageSubsamplingFactor

public static void setImageSubsamplingFactor(double subsamplingFactor)

Sets the image subsampling factor. The image subsampling factor allows you to increase or decrease the dynamic loading performance. This is done at the cost of having increased or decreased subsampling when dynamically creating the image. Once the full image is loaded, this factor is not used anymore.

Parameters:

subsamplingFactor - The new image subsampling factor.

write

public void write(IlvOutputStream out)
           throws IOException

Writes the tile loader to an IlvOutputStream

Specified by:

write in interface IlvPersistentObject

Specified by:

write in interface IlvTileLoader

Overrides:

write in class IlvRasterTileLoader

Parameters:

out - the output stream

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

See Also:

IlvRasterTileLoader.write(ilog.views.io.IlvOutputStream)

release

public void release(IlvTile tile)

Function called when a tile has to be released.

Specified by:

release in interface IlvTileLoader

Overrides:

release in class IlvRasterTileLoader

See Also:

IlvRasterTileLoader.release(ilog.views.tiling.IlvTile)

load

public void load(IlvTile tile)
          throws Exception

Function called when a tile has to be loaded. When the tile loader has finished its operation, it should call the function IlvTile.loadComplete to notify the tile listeners.

Specified by:

load in interface IlvTileLoader

Overrides:

load in class IlvRasterTileLoader

Throws:

Exception

See Also:

IlvRasterTileLoader.load(ilog.views.tiling.IlvTile)

makeIcon

protected IlvRasterIcon makeIcon(int subsampling,
                                 Point2D.Double p1,
                                 Point2D.Double p2)

Factory of icons from the subsampling and two corners parameters.

Overrides:

makeIcon in class IlvRasterTileLoader

Parameters:

subsampling - Initial subsampling of the image created.

p1 - The definition rectangle of the object.

p2 - The definition rectangle of the object.

Returns:

The subsampled icon graphic.

See Also:

IlvRasterTileLoader.makeIcon(int, java.awt.geom.Point2D.Double, java.awt.geom.Point2D.Double)