mil.nga.geopackage.extension.elevation

Class ElevationTilesPng

java.lang.Object

mil.nga.geopackage.extension.BaseExtension

mil.nga.geopackage.extension.elevation.ElevationTilesCore<TImage>

mil.nga.geopackage.extension.elevation.ElevationTilesCommon<ElevationPngImage>

mil.nga.geopackage.extension.elevation.ElevationTilesPng

public class ElevationTilesPng
extends ElevationTilesCommon<ElevationPngImage>

Tiled Gridded Elevation Data, PNG Encoding, Extension

Since:

1.3.1

Field Summary

Fields inherited from class mil.nga.geopackage.extension.elevation.ElevationTilesCommon

tileDao

Fields inherited from class mil.nga.geopackage.extension.elevation.ElevationTilesCore

algorithm, elevationBoundingBox, elevationProjection, EXTENSION_AUTHOR, EXTENSION_DEFINITION, EXTENSION_NAME, EXTENSION_NAME_NO_AUTHOR, height, requestProjection, sameProjection, width, zoomIn, zoomInBeforeOut, zoomOut

Fields inherited from class mil.nga.geopackage.extension.BaseExtension

extensionsDao, geoPackage

Constructor Summary

Constructors

Constructor and Description
ElevationTilesPng(GeoPackage geoPackage, TileDao tileDao) Constructor, use the elevation tables pixel tile size as the request size width and height
ElevationTilesPng(GeoPackage geoPackage, TileDao tileDao, Integer width, Integer height, Projection requestProjection) Constructor
ElevationTilesPng(GeoPackage geoPackage, TileDao tileDao, Projection requestProjection) Constructor, use the elevation tables pixel tile size as the request size width and height, request as the specified projection

Method Summary

Modifier and Type	Method and Description
ElevationPngImage	createElevationImage(TileRow tileRow) Create an elevation image
ElevationPngImage	createImage(int tileWidth, int tileHeight) Create a new 16 bit single channel image
static ElevationTilesPng	createTileTableWithMetadata(GeoPackage geoPackage, String tableName, BoundingBox contentsBoundingBox, long contentsSrsId, BoundingBox tileMatrixSetBoundingBox, long tileMatrixSetSrsId) Create the elevation tile table with metadata and extension
ElevationPngImage	drawTile(GriddedTile griddedTile, Double[][] elevations) Draw an elevation image tile from the double array of unsigned elevations formatted as Double[row][width]
ElevationPngImage	drawTile(GriddedTile griddedTile, Double[] elevations, int tileWidth, int tileHeight) Draw an elevation image tile from the flat array of elevations of length tileWidth * tileHeight where each elevation is at: (y * tileWidth) + x
ElevationPngImage	drawTile(int[][] unsignedPixelValues) Draw an elevation image tile from the double array of unsigned 16 bit integer pixel values formatted as int[row][width]
ElevationPngImage	drawTile(int[] unsignedPixelValues, int tileWidth, int tileHeight) Draw an elevation image tile from the flat array of unsigned 16 bit integer pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x
ElevationPngImage	drawTile(short[][] pixelValues) Draw an elevation tile from the double array of "unsigned short" pixel values formatted as short[row][width]
ElevationPngImage	drawTile(short[] pixelValues, int tileWidth, int tileHeight) Draw an elevation image tile from the flat array of "unsigned short" pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x
byte[]	drawTileData(GriddedTile griddedTile, Double[][] elevations) Draw an elevation image tile and format as PNG bytes from the double array of unsigned elevations formatted as Double[row][width]
byte[]	drawTileData(GriddedTile griddedTile, Double[] elevations, int tileWidth, int tileHeight) Draw an elevation image tile and format as PNG bytes from the flat array of elevations of length tileWidth * tileHeight where each elevation is at: (y * tileWidth) + x
byte[]	drawTileData(int[][] unsignedPixelValues) Draw an elevation image tile and format as PNG bytes from the double array of unsigned 16 bit integer pixel values formatted as int[row][width]
byte[]	drawTileData(int[] unsignedPixelValues, int tileWidth, int tileHeight) Draw an elevation image tile and format as PNG bytes from the flat array of unsigned 16 bit integer pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x
byte[]	drawTileData(short[][] pixelValues) Draw an elevation tile and format as PNG bytes from the double array of "unsigned short" pixel values formatted as short[row][width]
byte[]	drawTileData(short[] pixelValues, int tileWidth, int tileHeight) Draw an elevation image tile and format as PNG bytes from the flat array of "unsigned short" pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x
Double	getElevationValue(GriddedTile griddedTile, byte[] imageBytes, int x, int y) Get the elevation value
Double	getElevationValue(GriddedTile griddedTile, ElevationPngImage image, int x, int y)
double	getElevationValue(GriddedTile griddedTile, TileRow tileRow, int x, int y) Get the elevation value of the pixel in the tile row image
Double[]	getElevationValues(GriddedTile griddedTile, byte[] imageBytes) Get the elevation values
int	getPixelValue(byte[] imageBytes, int x, int y) Get the pixel value as a 16 bit unsigned integer value
int[]	getPixelValues(byte[] imageBytes) Get the pixel values of the image as 16 bit unsigned integer values
void	setPixelValue(ImageLineInt row, int x, int unsignedPixelValue) Set the pixel value
void	setPixelValue(ImageLineInt row, int x, short pixelValue) Set the pixel value
void	setPixelValue(int[] row, int x, int unsignedPixelValue) Set the pixel value
void	setPixelValue(int[] row, int x, short pixelValue) Set the pixel value
static void	validateImageType(PngReader reader) Validate that the image type is single channel 16 bit

Methods inherited from class mil.nga.geopackage.extension.elevation.ElevationTilesCommon

getElevations, getElevationsUnbounded, getElevationValue, getTileDao

Methods inherited from class mil.nga.geopackage.extension.elevation.ElevationTilesCore

createTileTableWithMetadata, formatUnboundedResults, getAlgorithm, getBicubicInterpolationElevation, getBicubicInterpolationElevation, getBicubicInterpolationElevation, getBilinearInterpolationElevation, getBilinearInterpolationElevation, getBilinearInterpolationElevation, getBilinearInterpolationElevation, getCubicInterpolationElevation, getCubicInterpolationElevation, getDataNull, getElevation, getElevationBoundingBox, getElevationProjection, getElevations, getElevations, getElevations, getElevationsUnbounded, getElevationValue, getElevationValue, getElevationValue, getElevationValues, getElevationValues, getElevationValues, getFloatPixelValue, getGriddedCoverage, getGriddedCoverageDao, getGriddedTile, getGriddedTile, getGriddedTileDao, getHeight, getNearestNeighborElevation, getNearestNeighbors, getOrCreate, getPixelValue, getPixelValue, getPixelValue, getPixelValue, getRequestProjection, getSourceMinAndMax, getTables, getTileMatrixSet, getUnsignedPixelValue, getUnsignedPixelValue, getUnsignedPixelValue, getUnsignedPixelValue, getUnsignedPixelValues, getWidth, getXSource, getYSource, has, isDataNull, isSameProjection, isZoomIn, isZoomInBeforeOut, isZoomOut, padBoundingBox, queryGriddedCoverage, reprojectElevations, setAlgorithm, setHeight, setWidth, setZoomIn, setZoomInBeforeOut, setZoomOut

Methods inherited from class mil.nga.geopackage.extension.BaseExtension

get, getExtensionsDao, getGeoPackage, getOrCreate, has

Methods inherited from class java.lang.Object

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

Constructor Detail

ElevationTilesPng

public ElevationTilesPng(GeoPackage geoPackage,
                         TileDao tileDao,
                         Integer width,
                         Integer height,
                         Projection requestProjection)

Constructor

Parameters:

geoPackage - GeoPackage

tileDao - tile dao

width - elevation response width

height - elevation response height

requestProjection - request projection

ElevationTilesPng

public ElevationTilesPng(GeoPackage geoPackage,
                         TileDao tileDao)

Constructor, use the elevation tables pixel tile size as the request size width and height

Parameters:

geoPackage - GeoPackage

tileDao - tile dao

ElevationTilesPng

public ElevationTilesPng(GeoPackage geoPackage,
                         TileDao tileDao,
                         Projection requestProjection)

Constructor, use the elevation tables pixel tile size as the request size width and height, request as the specified projection

Parameters:

geoPackage - GeoPackage

tileDao - tile dao

requestProjection - request projection

Method Detail

createElevationImage

public ElevationPngImage createElevationImage(TileRow tileRow)

Create an elevation image

Specified by:

createElevationImage in class ElevationTilesCommon<ElevationPngImage>

Parameters:

tileRow - tile row

Returns:

image

getElevationValue

public double getElevationValue(GriddedTile griddedTile,
                                TileRow tileRow,
                                int x,
                                int y)

Get the elevation value of the pixel in the tile row image

Specified by:

getElevationValue in class ElevationTilesCommon<ElevationPngImage>

Parameters:

griddedTile - gridded tile

tileRow - tile row

x - x coordinate

y - y coordinate

Returns:

elevation value

getElevationValue

public Double getElevationValue(GriddedTile griddedTile,
                                ElevationPngImage image,
                                int x,
                                int y)

Specified by:

getElevationValue in class ElevationTilesCore<ElevationPngImage>

getPixelValue

public int getPixelValue(byte[] imageBytes,
                         int x,
                         int y)

Get the pixel value as a 16 bit unsigned integer value

Parameters:

imageBytes - image bytes

x - x coordinate

y - y coordinate

Returns:

pixel value

getPixelValues

public int[] getPixelValues(byte[] imageBytes)

Get the pixel values of the image as 16 bit unsigned integer values

Parameters:

imageBytes - image bytes

Returns:

16 bit unsigned integer pixel values

validateImageType

public static void validateImageType(PngReader reader)

Validate that the image type is single channel 16 bit

Parameters:

reader - png reader

getElevationValue

public Double getElevationValue(GriddedTile griddedTile,
                                byte[] imageBytes,
                                int x,
                                int y)

Get the elevation value

Parameters:

griddedTile - gridded tile

imageBytes - image bytes

x - x coordinate

y - y coordinate

Returns:

elevation value

getElevationValues

public Double[] getElevationValues(GriddedTile griddedTile,
                                   byte[] imageBytes)

Get the elevation values

Parameters:

griddedTile - gridded tile

imageBytes - image bytes

Returns:

elevation values

drawTile

public ElevationPngImage drawTile(short[] pixelValues,
                                  int tileWidth,
                                  int tileHeight)

Draw an elevation image tile from the flat array of "unsigned short" pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x

Parameters:

pixelValues - "unsigned short" pixel values of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(short[] pixelValues,
                           int tileWidth,
                           int tileHeight)

Draw an elevation image tile and format as PNG bytes from the flat array of "unsigned short" pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x

Parameters:

pixelValues - "unsigned short" pixel values of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile bytes

drawTile

public ElevationPngImage drawTile(short[][] pixelValues)

Draw an elevation tile from the double array of "unsigned short" pixel values formatted as short[row][width]

Parameters:

pixelValues - "unsigned short" pixel values as [row][width]

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(short[][] pixelValues)

Draw an elevation tile and format as PNG bytes from the double array of "unsigned short" pixel values formatted as short[row][width]

Parameters:

pixelValues - "unsigned short" pixel values as [row][width]

Returns:

elevation image tile bytes

drawTile

public ElevationPngImage drawTile(int[] unsignedPixelValues,
                                  int tileWidth,
                                  int tileHeight)

Draw an elevation image tile from the flat array of unsigned 16 bit integer pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x

Parameters:

unsignedPixelValues - unsigned 16 bit integer pixel values of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(int[] unsignedPixelValues,
                           int tileWidth,
                           int tileHeight)

Draw an elevation image tile and format as PNG bytes from the flat array of unsigned 16 bit integer pixel values of length tileWidth * tileHeight where each pixel is at: (y * tileWidth) + x

Parameters:

unsignedPixelValues - unsigned 16 bit integer pixel values of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile bytes

drawTile

public ElevationPngImage drawTile(int[][] unsignedPixelValues)

Draw an elevation image tile from the double array of unsigned 16 bit integer pixel values formatted as int[row][width]

Parameters:

unsignedPixelValues - unsigned 16 bit integer pixel values as [row][width]

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(int[][] unsignedPixelValues)

Draw an elevation image tile and format as PNG bytes from the double array of unsigned 16 bit integer pixel values formatted as int[row][width]

Parameters:

unsignedPixelValues - unsigned 16 bit integer pixel values as [row][width]

Returns:

elevation image tile bytes

drawTile

public ElevationPngImage drawTile(GriddedTile griddedTile,
                                  Double[] elevations,
                                  int tileWidth,
                                  int tileHeight)

Draw an elevation image tile from the flat array of elevations of length tileWidth * tileHeight where each elevation is at: (y * tileWidth) + x

Parameters:

griddedTile - gridded tile

elevations - elevations of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(GriddedTile griddedTile,
                           Double[] elevations,
                           int tileWidth,
                           int tileHeight)

Draw an elevation image tile and format as PNG bytes from the flat array of elevations of length tileWidth * tileHeight where each elevation is at: (y * tileWidth) + x

Parameters:

griddedTile - gridded tile

elevations - elevations of length tileWidth * tileHeight

tileWidth - tile width

tileHeight - tile height

Returns:

elevation image tile bytes

drawTile

public ElevationPngImage drawTile(GriddedTile griddedTile,
                                  Double[][] elevations)

Draw an elevation image tile from the double array of unsigned elevations formatted as Double[row][width]

Parameters:

griddedTile - gridded tile

elevations - elevations as [row][width]

Returns:

elevation image tile

drawTileData

public byte[] drawTileData(GriddedTile griddedTile,
                           Double[][] elevations)

Draw an elevation image tile and format as PNG bytes from the double array of unsigned elevations formatted as Double[row][width]

Parameters:

griddedTile - gridded tile

elevations - elevations as [row][width]

Returns:

elevation image tile bytes

createImage

public ElevationPngImage createImage(int tileWidth,
                                     int tileHeight)

Create a new 16 bit single channel image

Parameters:

tileWidth - tile width

tileHeight - tile height

Returns:

image

setPixelValue

public void setPixelValue(ImageLineInt row,
                          int x,
                          short pixelValue)

Set the pixel value

Parameters:

row - image line row

x - x coordinate

pixelValue - pixel value

setPixelValue

public void setPixelValue(int[] row,
                          int x,
                          short pixelValue)

Set the pixel value

Parameters:

row - row array

x - x coordinate

pixelValue - pixel value

setPixelValue

public void setPixelValue(ImageLineInt row,
                          int x,
                          int unsignedPixelValue)

Set the pixel value

Parameters:

row - image line row

x - x coordinate

unsignedPixelValue - unsigned pixel value

setPixelValue

public void setPixelValue(int[] row,
                          int x,
                          int unsignedPixelValue)

Set the pixel value

Parameters:

row - row array

x - x coordinate

unsignedPixelValue - unsigned pixel value

createTileTableWithMetadata

public static ElevationTilesPng createTileTableWithMetadata(GeoPackage geoPackage,
                                                            String tableName,
                                                            BoundingBox contentsBoundingBox,
                                                            long contentsSrsId,
                                                            BoundingBox tileMatrixSetBoundingBox,
                                                            long tileMatrixSetSrsId)

Create the elevation tile table with metadata and extension

Parameters:

geoPackage -

tableName -

contentsBoundingBox -

contentsSrsId -

tileMatrixSetBoundingBox -

tileMatrixSetSrsId -

Returns:

elevation tiles