com.atakmap.android.imagecapture

Class TiledCanvas

java.lang.Object

android.graphics.Canvas

com.atakmap.android.imagecapture.TiledCanvas

public class TiledCanvas
extends android.graphics.Canvas

Image which is split into tiles stored within a file This is a method of writing to/reading from bitmaps without loading the entire image into memory. Also allows canvas drawing over multiple tiles Supported inputs: Monochrome, RGB, RGBA Supported outputs: RGB, RGBA

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TiledCanvas.ProgressCallback

Nested classes/interfaces inherited from class android.graphics.Canvas

android.graphics.Canvas.EdgeType, android.graphics.Canvas.VertexMode

Field Summary

Fields

Modifier and Type	Field and Description
protected int	_channels
protected java.io.File	_file
protected int	_fullHeight
protected int	_fullWidth
protected boolean	_postDrawn
protected int	_tileHeight
protected int	_tileWidth
protected boolean	_valid

Fields inherited from class android.graphics.Canvas

ALL_SAVE_FLAG

Constructor Summary

Constructors

Constructor and Description
TiledCanvas(java.io.File file, int tileWidth, int tileHeight)

Method Summary

Modifier and Type	Method and Description
static void	bitmapToBytes(android.graphics.Bitmap bmp, java.nio.ByteBuffer dest, boolean recycle) Convert a bitmap to an array of bytes
static android.graphics.Bitmap	bytesToBitmap(java.nio.ByteBuffer byteData, int width, int height, int channels) Convert an array of RGB or RGBA data to an ARGB bitmap
boolean	copyToFile(java.io.File file, android.graphics.Bitmap.CompressFormat format, int quality)
boolean	copyToFile(java.io.File file, java.lang.String format, java.lang.String[] options) Copy the entire image to another file type
android.graphics.Bitmap	createThumbnail(int width, int height) Create a thumbnail of the entire image Aspect ratio will be maintained, meaning desired width/height may not be the same as the output width/height
int	getChannels()
java.io.File	getFile()
int	getHeight()
int	getTileCount()
int	getTileCountX()
int	getTileCountY()
int	getTileHeight()
int	getTileWidth()
int	getWidth()
boolean	postDraw(CapturePP postDraw) Run post-processing drawing on the entire image (1 tile at a time) Result is automatically saved back to the original image NOTE: This is meant to be run once per canvas.
boolean	postDraw(CapturePP postDraw, TiledCanvas.ProgressCallback callback) Run post-processing drawing on the entire image (1 tile at a time) Result is automatically saved back to the original image NOTE: This is meant to be run once per canvas.
android.graphics.Bitmap	readTile(int tileX, int tileY) Read a tile based on its cell position I.e.
android.graphics.Bitmap	readTile(int x, int y, int width, int height) Read a tile from the image into a bitmap
boolean	valid()
boolean	writeTile(android.graphics.Bitmap bmp, int tileX, int tileY) Write a bitmap to the tile at the specified cell position See readTile(int, int) for more info.
boolean	writeTile(android.graphics.Bitmap bmp, int x, int y, boolean tileCell, boolean recycle) Write a bitmap to the image at a specified position

Methods inherited from class android.graphics.Canvas

clipOutPath, clipOutRect, clipOutRect, clipOutRect, clipOutRect, clipPath, clipPath, clipRect, clipRect, clipRect, clipRect, clipRect, clipRect, clipRect, concat, disableZ, drawArc, drawArc, drawARGB, drawBitmap, drawBitmap, drawBitmap, drawBitmap, drawBitmap, drawBitmap, drawBitmapMesh, drawCircle, drawColor, drawColor, drawColor, drawColor, drawColor, drawDoubleRoundRect, drawDoubleRoundRect, drawLine, drawLines, drawLines, drawOval, drawOval, drawPaint, drawPath, drawPicture, drawPicture, drawPicture, drawPoint, drawPoints, drawPoints, drawPosText, drawPosText, drawRect, drawRect, drawRect, drawRenderNode, drawRGB, drawRoundRect, drawRoundRect, drawText, drawText, drawText, drawText, drawTextOnPath, drawTextOnPath, drawTextRun, drawTextRun, drawTextRun, drawVertices, enableZ, getClipBounds, getClipBounds, getDensity, getDrawFilter, getMatrix, getMatrix, getMaximumBitmapHeight, getMaximumBitmapWidth, getSaveCount, isHardwareAccelerated, isOpaque, quickReject, quickReject, quickReject, restore, restoreToCount, rotate, rotate, save, saveLayer, saveLayer, saveLayer, saveLayer, saveLayerAlpha, saveLayerAlpha, saveLayerAlpha, saveLayerAlpha, scale, scale, setBitmap, setDensity, setDrawFilter, setMatrix, skew, translate

Methods inherited from class java.lang.Object

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

Field Detail

_file

protected final java.io.File _file

_fullWidth

protected final int _fullWidth

_fullHeight

protected final int _fullHeight

_tileWidth

protected final int _tileWidth

_tileHeight

protected final int _tileHeight

_channels

protected final int _channels

_valid

protected final boolean _valid

_postDrawn

protected boolean _postDrawn

Constructor Detail

TiledCanvas

public TiledCanvas(java.io.File file,
                   int tileWidth,
                   int tileHeight)

Method Detail

getFile

public java.io.File getFile()

getWidth

public int getWidth()

Overrides:

getWidth in class android.graphics.Canvas

getHeight

public int getHeight()

Overrides:

getHeight in class android.graphics.Canvas

getTileWidth

public int getTileWidth()

getTileHeight

public int getTileHeight()

getChannels

public int getChannels()

getTileCount

public int getTileCount()

getTileCountX

public int getTileCountX()

getTileCountY

public int getTileCountY()

valid

public boolean valid()

readTile

public android.graphics.Bitmap readTile(int tileX,
                                        int tileY)

Read a tile based on its cell position I.e. For a 3x3 tiled image the middle tile cell position would be tileX = 1, tileY = 1

Parameters:

tileX - X-position of the tile

tileY - Y-position of the tile

Returns:

Bitmap copy of the tile or null if failed

readTile

public android.graphics.Bitmap readTile(int x,
                                        int y,
                                        int width,
                                        int height)

Read a tile from the image into a bitmap

Parameters:

x - Left-wise position to read from

y - Top-wise position to read from

width - Width of the tile to read

height - Height of the tile to read

Returns:

Bitmap copy of the tile or null if failed

writeTile

public boolean writeTile(android.graphics.Bitmap bmp,
                         int tileX,
                         int tileY)

Write a bitmap to the tile at the specified cell position See readTile(int, int) for more info.

Parameters:

bmp - Bitmap to read from

tileX - X-position of the tile

tileY - Y-position of the tile

Returns:

True if successful

writeTile

public boolean writeTile(android.graphics.Bitmap bmp,
                         int x,
                         int y,
                         boolean tileCell,
                         boolean recycle)

Write a bitmap to the image at a specified position

Parameters:

bmp - Bitmap to read from

x - Left-wise position to write to

y - Top-wise position to write to

tileCell - True if the x,y pair is a tile cell location

recycle - True if it's okay to recycle the bitmap

Returns:

True if successful

copyToFile

public boolean copyToFile(java.io.File file,
                          java.lang.String format,
                          java.lang.String[] options)

Copy the entire image to another file type

Parameters:

file - File to copy to

format - File format

options - List of options (key=value)

Returns:

True if successful

copyToFile

public boolean copyToFile(java.io.File file,
                          android.graphics.Bitmap.CompressFormat format,
                          int quality)

createThumbnail

public android.graphics.Bitmap createThumbnail(int width,
                                               int height)

Create a thumbnail of the entire image Aspect ratio will be maintained, meaning desired width/height may not be the same as the output width/height

Parameters:

width - Desired width

height - Desired height

Returns:

The thumbnail as a bitmap

postDraw

public boolean postDraw(CapturePP postDraw,
                        TiledCanvas.ProgressCallback callback)

Run post-processing drawing on the entire image (1 tile at a time) Result is automatically saved back to the original image NOTE: This is meant to be run once per canvas.

Parameters:

postDraw - The post-processor

callback - Progress callback

Returns:

True if successful

postDraw

public boolean postDraw(CapturePP postDraw)

Run post-processing drawing on the entire image (1 tile at a time) Result is automatically saved back to the original image NOTE: This is meant to be run once per canvas.

Parameters:

postDraw - The post-processor

Returns:

True if successful

bytesToBitmap

public static android.graphics.Bitmap bytesToBitmap(java.nio.ByteBuffer byteData,
                                                    int width,
                                                    int height,
                                                    int channels)

Convert an array of RGB or RGBA data to an ARGB bitmap

Parameters:

byteData - Byte buffer

width - Width of the bitmap

height - Height of the bitmap

channels - Number of channels

Returns:

A newly created bitmap

bitmapToBytes

public static void bitmapToBytes(android.graphics.Bitmap bmp,
                                 java.nio.ByteBuffer dest,
                                 boolean recycle)

Convert a bitmap to an array of bytes

Parameters:

bmp - Bitmap to convert

dest - Byte array to store converted RGBA pixels

recycle - True to recycle the bitmap