playn.android

Class AndroidGraphics

java.lang.Object

playn.core.Graphics

playn.android.AndroidGraphics

public class AndroidGraphics
extends Graphics

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AndroidGraphics.Refreshable An interface implemented by entities that need to store things when our GL context is lost and restore them when we are given a new context.
static interface	AndroidGraphics.ScaleFunc See setCanvasScaleFunc(playn.android.AndroidGraphics.ScaleFunc).

Field Summary

Fields inherited from class playn.core.Graphics

defaultRenderTarget, gl, viewSize

Constructor Summary

Constructors

Constructor and Description
AndroidGraphics(Platform plat, android.graphics.Bitmap.Config bitmapConfig, float scaleFactor)

Method Summary

Modifier and Type	Method and Description
Canvas	createCanvas(float width, float height)
TextLayout	layoutText(String text, TextFormat format)
TextLayout[]	layoutText(String text, TextFormat format, TextWrap wrap)
void	onSurfaceChanged(int pixelWidth, int pixelHeight) Informs the graphics system that the surface into which it is rendering has changed size.
void	onSurfaceCreated() Informs the graphics system that the surface into which it is rendering was created.
void	onSurfaceLost() Informs the graphics system that the surface into which it is rendering was lost.
void	registerFont(android.graphics.Typeface face, String name, Font.Style style, String... ligatureGlyphs) Registers a font with the graphics system.
IDimension	screenSize()
void	setCanvasFilterBitmaps(boolean filterBitmaps) Configures the default bitmap filtering (smoothing) setting used when rendering images to a canvas.
void	setCanvasScaleFunc(AndroidGraphics.ScaleFunc scaleFunc) Configures the scale factor function to use for Canvas.

Methods inherited from class playn.core.Graphics

createCanvas, createTexture, createTexture, queueForDispose, scale

Methods inherited from class java.lang.Object

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

Constructor Detail

AndroidGraphics

public AndroidGraphics(Platform plat,
                       android.graphics.Bitmap.Config bitmapConfig,
                       float scaleFactor)

Method Detail

registerFont

public void registerFont(android.graphics.Typeface face,
                         String name,
                         Font.Style style,
                         String... ligatureGlyphs)

Registers a font with the graphics system.

Parameters:

face - the typeface to be registered. It can be loaded via AndroidAssets.getTypeface(java.lang.String).

name - the name under which to register the font.

style - the style variant of the specified name provided by the font file. For example one might registerFont("myfont.ttf", "My Font", Font.Style.PLAIN) and registerFont("myfontb.ttf", "My Font", Font.Style.BOLD) to provide both the plain and bold variants of a particular font.

ligatureGlyphs - any known text sequences that are converted into a single ligature character in this font. This works around an Android bug where measuring text for wrapping that contains character sequences that are converted into ligatures (e.g. "fi" or "ae") incorrectly reports the number of characters "consumed" from the to-be-wrapped string.

setCanvasFilterBitmaps

public void setCanvasFilterBitmaps(boolean filterBitmaps)

Configures the default bitmap filtering (smoothing) setting used when rendering images to a canvas. The default is not to smooth the bitmaps, pass true to make smoothing the default.

setCanvasScaleFunc

public void setCanvasScaleFunc(AndroidGraphics.ScaleFunc scaleFunc)

Configures the scale factor function to use for Canvas. By default we use the current graphics scale factor, which provides maximum resolution. Apps running on memory constrained devices may wish to lower to lower this scale factor to reduce memory usage for especially large canvases.

onSurfaceCreated

public void onSurfaceCreated()

Informs the graphics system that the surface into which it is rendering was created.

onSurfaceChanged

public void onSurfaceChanged(int pixelWidth,
                             int pixelHeight)

Informs the graphics system that the surface into which it is rendering has changed size. The supplied width and height are in pixels, not display units.

onSurfaceLost

public void onSurfaceLost()

Informs the graphics system that the surface into which it is rendering was lost.

screenSize

public IDimension screenSize()

Specified by:

screenSize in class Graphics

createCanvas

public Canvas createCanvas(float width,
                           float height)

Overrides:

createCanvas in class Graphics

layoutText

public TextLayout layoutText(String text,
                             TextFormat format)

Specified by:

layoutText in class Graphics

layoutText

public TextLayout[] layoutText(String text,
                               TextFormat format,
                               TextWrap wrap)

Specified by:

layoutText in class Graphics