ilog.views.maps.servlet

Class IlvManagerTiler

java.lang.Object

ilog.views.maps.servlet.IlvManagerTiler

public class IlvManagerTiler
extends Object

IlvManagerTiler is used to generate a pyramid of tile images from a map. These images can be used by a map servlet as pregenerated tiles for thin-client applications.

Since:

JViews 8.0

Field Summary

Fields

Modifier and Type	Field and Description
static String	SCALE_LEVELS Deprecated. Beginning with Perforce JViews 8.1, use the constant IlvMapTileGeneratorConstants.SCALE_LEVELS_PROPERTY instead.
static String	TILE_SIZE Deprecated. Beginning with Perforce JViews 8.1, use the constant IlvMapTileGeneratorConstants.TILE_SIZE_PROPERTY instead.

Constructor Summary

Constructors

Constructor and Description
IlvManagerTiler() Creates a new IlvManagerTiler.

Method Summary

Modifier and Type	Method and Description
void	createTiles(String ivl, IlvRect areaToTile, File outputBase, long maxDiskSize) Creates a set of tiled images from an existing map.
void	createTiles(String ivl, IlvRect areaToTile, File outputBase, long maxDiskSize, int tileSize, double[] scaleLevels) Create a set of tiled images for the specified map.
int	getImageFormat() Returns the compression format used to write the tiled images.
static void	main(String[] args) The command line method used to generate tiles for a map.
void	setImageFormat(int format) Sets the compression format used to write the image tiles.

Methods inherited from class java.lang.Object

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

Field Detail

TILE_SIZE

@Deprecated
public static String TILE_SIZE

Deprecated. Beginning with Perforce JViews 8.1, use the constant IlvMapTileGeneratorConstants.TILE_SIZE_PROPERTY instead.

The IlvNamedProperty containing the tile size parameter

SCALE_LEVELS

@Deprecated
public static String SCALE_LEVELS

Deprecated. Beginning with Perforce JViews 8.1, use the constant IlvMapTileGeneratorConstants.SCALE_LEVELS_PROPERTY instead.

The IlvNamedProperty containing the scale levels parameter

Constructor Detail

IlvManagerTiler

public IlvManagerTiler()

Creates a new IlvManagerTiler.

Method Detail

createTiles

public void createTiles(String ivl,
                        IlvRect areaToTile,
                        File outputBase,
                        long maxDiskSize)
                 throws IOException,
                        IlvReadFileException,
                        IlvCoordinateTransformationException

Creates a set of tiled images from an existing map.

Parameters:

ivl - The filename of the map to open.

areaToTile - The area of interest in the map for which tiles should be rendered. Set this value to null so the tiling process is not limited to a region.

outputBase - The output folder where tile images are created.

maxDiskSize - The maximum disk space allocated to tile creation. The tile creation process stops as soon as this limit is reached, no matter how many tiles remain to be generated.

Throws:

IOException - if an I/O exception occurs while the map file is being read.

IlvReadFileException - if a reading exception occurs during map file reading.

IlvCoordinateTransformationException - if the specified area of interest is not compatible with the current map projection.

See Also:

IlvAreaOfInterest

createTiles

public void createTiles(String ivl,
                        IlvRect areaToTile,
                        File outputBase,
                        long maxDiskSize,
                        int tileSize,
                        double[] scaleLevels)
                 throws IOException,
                        IlvReadFileException,
                        IlvCoordinateTransformationException

Create a set of tiled images for the specified map.

Parameters:

ivl - The filename for the map to be opened.

areaToTile - The area of interest in the map for which tiles will be rendered. Set this value to null so the tiling process is not limited to a region.

outputBase - The output folder where tile images are created.

maxDiskSize - The maximum disk space allocated to tile creation. The tile creation process stops as soon as this limit is reached, no matter how many tiles remain to be generated.

tileSize - The size of the tiled images to generate. This value is set in pixels.

scaleLevels - the scale levels of the map for which tiles will be created. If this value is set to to null, this parameter should be embedded in the map.

Throws:

IOException - if an I/O exception occurs while the map file is being read.

IlvReadFileException - if a reading exception occurs while the map file is being read.

IlvCoordinateTransformationException - if the specified area of interest is not compatible with the current map projection.

setImageFormat

public void setImageFormat(int format)

Sets the compression format used to write the image tiles.

Note: if format in not compatible, IlvFileTileManager.JPEG_FORMAT is used.

Parameters:

format - The image format.

getImageFormat

public int getImageFormat()

Returns the compression format used to write the tiled images.

Returns:

The image format.

See Also:

setImageFormat(int )

main

public static void main(String[] args)

The command line method used to generate tiles for a map.

Parameters:

args - The arguments to pass to this method. These arguments are in the following order:

mapFilename outputDirectory maxDiskSize