nl.colorize.multimedialib.renderer

Class AnimationLoopRenderer

java.lang.Object

nl.colorize.multimedialib.renderer.AnimationLoopRenderer

All Implemented Interfaces:

RenderContext, Renderer

Direct Known Subclasses:

GDXRenderer, Java2DRenderer

public abstract class AnimationLoopRenderer
extends java.lang.Object
implements Renderer, RenderContext

Base implementation of a renderer that tries to perform frame updates as close to the targeted framerate as possible, but changes the frequency of frame renders depending on performance. This means that several frame updates may occur before a frame is rendered, to ensure performance does not have too much influence on application logic.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	framerate
protected ScaleStrategy	scaling

Constructor Summary

Constructors

Constructor and Description
AnimationLoopRenderer(ScaleStrategy scaling, int framerate)

Method Summary

Modifier and Type	Method and Description
void	drawText(java.lang.String text, BitmapFont font, int x, int y) Implements drawing text by drawing each of the characters as an image using the specified bitmap font.
int	getCanvasHeight()
int	getCanvasWidth()
float	getFrameTime()
protected abstract InputDevice	getInputDevice()
ScaleStrategy	getScaleStrategy()
protected abstract Rect	getScreenBounds()
RenderStats	getStats()
int	getTargetFramerate()
protected void	performFrameUpdate() Performs a frame update.
void	registerCallback(RenderCallback callback)
protected abstract boolean	shouldSyncFrames() If this method returns true, the renderer is responsible for keeping frame updates synchronized with the targeted framerate.
void	unregisterCallback(RenderCallback callback)

Methods inherited from class java.lang.Object

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

Methods inherited from interface nl.colorize.multimedialib.renderer.Renderer

getMediaLoader, initialize, terminate

Methods inherited from interface nl.colorize.multimedialib.renderer.RenderContext

drawBackground, drawImage, drawRect, drawSprite

Field Detail

scaling

protected ScaleStrategy scaling

framerate

protected int framerate

Constructor Detail

AnimationLoopRenderer

public AnimationLoopRenderer(ScaleStrategy scaling,
                             int framerate)

Method Detail

performFrameUpdate

protected void performFrameUpdate()

Performs a frame update. This will result in one or multiple frame updates followed by rendering a frame, as described in the class documentation.

shouldSyncFrames

protected abstract boolean shouldSyncFrames()

If this method returns true, the renderer is responsible for keeping frame updates synchronized with the targeted framerate. If so, the renderer might intentionally slow down frame updates by sleeping.

If this method returns false, the underlying platform is responsible for synchronizing frames, and in these cases the renderer will still adapt the number of frame updates versus the number of frame renders, but it will not sleep to slow down the animation loop.

getCanvasWidth

public int getCanvasWidth()

Specified by:

getCanvasWidth in interface RenderContext

Specified by:

getCanvasWidth in interface Renderer

getCanvasHeight

public int getCanvasHeight()

Specified by:

getCanvasHeight in interface RenderContext

Specified by:

getCanvasHeight in interface Renderer

getScreenBounds

protected abstract Rect getScreenBounds()

drawText

public void drawText(java.lang.String text,
                     BitmapFont font,
                     int x,
                     int y)

Implements drawing text by drawing each of the characters as an image using the specified bitmap font.

Specified by:

drawText in interface RenderContext

getScaleStrategy

public ScaleStrategy getScaleStrategy()

Specified by:

getScaleStrategy in interface Renderer

getTargetFramerate

public int getTargetFramerate()

Specified by:

getTargetFramerate in interface Renderer

getFrameTime

public float getFrameTime()

getInputDevice

protected abstract InputDevice getInputDevice()

getStats

public RenderStats getStats()

Specified by:

getStats in interface Renderer

registerCallback

public void registerCallback(RenderCallback callback)

Specified by:

registerCallback in interface Renderer

unregisterCallback

public void unregisterCallback(RenderCallback callback)

Specified by:

unregisterCallback in interface Renderer