com.atakmap.android.maps.graphics

Class GLCapture

java.lang.Object

com.atakmap.android.maps.graphics.GLCapture

public abstract class GLCapture
extends java.lang.Object

Abstract class used to capture GL rendering in a Bitmap. The capture will happen asynchronously on the GL thread; delivery of the captured pixels will occur on a separate user thread.

This class takes care of the setup and teardown of the offscreen textures and buffer objects; subclasses are responsible for implementing the rendering code to produce the scene to be captured.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	GLCapture.CaptureCallback Callback for an offscreen capture.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	height
protected android.opengl.GLSurfaceView	view
protected int	width
protected int	x
protected int	y

Constructor Summary

Constructors

Constructor and Description
GLCapture(android.opengl.GLSurfaceView view) Creates a new instance.
GLCapture(android.opengl.GLSurfaceView view, int x, int y, int width, int height) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	capture(GLCapture.CaptureCallback callback) Performs an asynchronous capture.
static void	compress(android.graphics.Bitmap bitmap, int quality, android.graphics.Bitmap.CompressFormat compressFmt, java.io.File target, boolean recycleOnExit) Compresses a bitmap to a target file.
protected abstract void	draw() Subclasses should override to perform the GL rendering they want captured for the callback.
protected void	readPixels(GLCapture.CaptureCallback callback)

Methods inherited from class java.lang.Object

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

Field Detail

view

protected final android.opengl.GLSurfaceView view

x

protected final int x

y

protected final int y

width

protected final int width

height

protected final int height

Constructor Detail

GLCapture

public GLCapture(android.opengl.GLSurfaceView view)

Creates a new instance. The capture region is set to the extents of the specified GLSurfaceView.

Parameters:

view - A GLSurfaceView instance. The instance will be used to queue the offscreen capture on the GL context thread.

GLCapture

public GLCapture(android.opengl.GLSurfaceView view,
                 int x,
                 int y,
                 int width,
                 int height)

Creates a new instance.

Parameters:

view - A GLSurfaceView instance. The instance will be used to queue the offscreen capture on the GL context thread.

x - The x-coordinate of the region of the frame buffer to capture

y - The y-coordinate of the region of the frame buffer to capture

width - The width of the region of the frame buffer to capture

height - The height of the region of the frame buffer to capture

Method Detail

draw

protected abstract void draw()

Subclasses should override to perform the GL rendering they want captured for the callback.

capture

public final void capture(GLCapture.CaptureCallback callback)

Performs an asynchronous capture. The callback will always receive an invocation of GLCapture.CaptureCallback.onCaptureStarted(GLCapture) when the capture begins and one of GLCapture.CaptureCallback.onCaptureComplete(GLCapture, Bitmap) or GLCapture.CaptureCallback.onCaptureError(GLCapture, Throwable) when the capture has either completed successfully or terminated due to an error.

Parameters:

callback - The callback for the capture. May not be null.

readPixels

protected void readPixels(GLCapture.CaptureCallback callback)

compress

public static void compress(android.graphics.Bitmap bitmap,
                            int quality,
                            android.graphics.Bitmap.CompressFormat compressFmt,
                            java.io.File target,
                            boolean recycleOnExit)
                     throws java.io.IOException

Compresses a bitmap to a target file.

Parameters:

bitmap - A bitmap

quality - The quality, 0 for lowest quality, 100 for best quality

compressFmt - The compression format

target - The target file

recycleOnExit - true to recycle the bitmap before the method returns, false otherwise.

Throws:

java.io.IOException - if there is an issue writing the bitmap to a file.