Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback Interface Reference

Interface with callback methods for the raster data retriever to call. More...

Public Member Functions
void	OnCanceled (Luciad.Models.MultilevelTileCoordinate tileCoordinate)
	Call this method when the request for the raster tile data was canceled.
void	OnDataAvailable (Luciad.Models.MultilevelTileCoordinate tileCoordinate, Luciad.Containers.DataEntity data)
	Call this method when you have retrieved the raster tile data in its raw form.
void	OnDataNotAvailable (Luciad.Models.MultilevelTileCoordinate tileCoordinate)
	Call this method when there is no data available for the tile coordindate.
void	OnError (Luciad.Models.MultilevelTileCoordinate tileCoordinate, string message)
	Call this method when there is an error to retrieve the raster tile data.
void	OnImageAvailable (Luciad.Models.MultilevelTileCoordinate tileCoordinate, Luciad.Drawing.Image image)
	Call this method when you have retrieved the raster tile data and have decoded it as an image.

Detailed Description

Interface with callback methods for the raster data retriever to call.

There is usually no need to make a user implementation. An implementation to call the methods on is provided by the raster model implementation that has been created using either a MultilevelTiledRasterModelBuilder or a QuadTreeRasterModelBuilder.

Since

2022.1

Member Function Documentation

OnCanceled()

void Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback.OnCanceled

(

Luciad.Models.MultilevelTileCoordinate

tileCoordinate

)

Call this method when the request for the raster tile data was canceled.

Parameters

tileCoordinate

the tile coordinate for which the request was canceled.

OnDataAvailable()

void Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback.OnDataAvailable	(	Luciad.Models.MultilevelTileCoordinate	tileCoordinate,
		Luciad.Containers.DataEntity	data )

Call this method when you have retrieved the raster tile data in its raw form.

Supported mime types for the raster tile data:

Imagery:

• image/png
• image/jpeg
• image/tiff (containing RGB(A))

Elevation:

• image/tiff (containing a single channel with floating point data)

Parameters

tileCoordinate	the tile coordinate for which the raster tile data was retrieved.
data	the raster tile data.

OnDataNotAvailable()

void Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback.OnDataNotAvailable

(

Luciad.Models.MultilevelTileCoordinate

tileCoordinate

)

Call this method when there is no data available for the tile coordindate.

Parameters

tileCoordinate

the tile coordinate for which there is no raster tile data.

OnError()

void Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback.OnError	(	Luciad.Models.MultilevelTileCoordinate	tileCoordinate,
		string	message )

Call this method when there is an error to retrieve the raster tile data.

Parameters

tileCoordinate	the tile coordinate for which there is no raster tile data.
message	a message to detail what went wrong.

OnImageAvailable()

void Luciad.Models.Rasters.IMultilevelTiledRasterDataRetrieverCallback.OnImageAvailable	(	Luciad.Models.MultilevelTileCoordinate	tileCoordinate,
		Luciad.Drawing.Image	image )

Call this method when you have retrieved the raster tile data and have decoded it as an image.

Supported image types:

Imagery:

• PixelFormat.Rgb888
• PixelFormat.Rgba8888

Elevation:

• PixelFormat.Float32

For best performance, use non alpha-premultiplied images. When alpha-premultiplied images are returned, they need to be copied and converted to non alpha-premultiplied images, which has a performance cost.

Parameters

tileCoordinate	the tile coordinate for which the raster tile data was retrieved.
image	the raster tile data decoded into an image.