com.hdcookbook.grin.test.bigjdk
Class ScalingDirectDrawEngine

java.lang.Object
  com.hdcookbook.grin.animator.AnimationEngine
      com.hdcookbook.grin.animator.ClockBasedEngine
          com.hdcookbook.grin.test.bigjdk.ScalingDirectDrawEngine

All Implemented Interfaces:

java.lang.Runnable

public class ScalingDirectDrawEngine
extends ClockBasedEngine

A double-buffered animation engine that uses direct draw, and applies a scaling divisor. This is based off of DirectDrawEngine, with some adjustments to make it work on big JDK and provide scaling.

See Also:

DirectDrawEngine

Field Summary

Fields inherited from class com.hdcookbook.grin.animator.AnimationEngine

modelTimeSkipped, renderContext, repaintBounds, targetsCanOverlap, transparent

Constructor Summary

ScalingDirectDrawEngine(int scaleDivisor, GenericMain main)
Create a new ScalingDirectDrawEngine.

Method Summary

protected void	callPaintTargets() Paint the current frame into the right graphics buffer.
protected void	clearArea(int x, int y, int width, int height) Called from showFrame() to cause an area to be cleared in the current frame.
protected void	finishedFrame() Called when the engine is finished drawing the current frame.
java.awt.Component	getComponent() Get the component that this animation engine renders into.
int	getHeight() Get the height of the area we display over
int	getWidth() Get the width of the area we display over
void	initContainer(java.awt.Container container, java.awt.Rectangle bounds) Initialize this engine with its parent container and the position and size of the engine within the container.
protected boolean	needsFullRedrawInAnimationLoop() Tell us whether or not this style of animation requires a full redraw of everything on the screen in each pass through the animation loop.
protected void	runAnimationLoop() The inner loop for the animation thread.
protected void	terminatingEraseScreen() Erase the screen because the AnimationManager is terminating.
java.lang.String	toString()

Methods inherited from class com.hdcookbook.grin.animator.ClockBasedEngine

getFps, pause, setFps, skipFrames, start

Methods inherited from class com.hdcookbook.grin.animator.AnimationEngine

advanceModel, checkDestroy, checkNewClients, destroy, destroyRequested, getAnimationClients, getDrawTargets, getEraseTargets, getModelTimeSkipped, getNumDrawTargets, getNumEraseTargets, initClients, initialize, paintFrame, paintNextFrameFully, paintTargets, repaintFrame, resetAnimationClients, run, setAllowOverlappingTargets, setDrawTargetCollapseThreshold, setThreadPriority, showFrame

Methods inherited from class java.lang.Object

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

Constructor Detail

ScalingDirectDrawEngine

public ScalingDirectDrawEngine(int scaleDivisor,
                               GenericMain main)

Create a new ScalingDirectDrawEngine. It needs to be initialized with the various initXXX methods (including the inherited ones).

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

initContainer

public void initContainer(java.awt.Container container,
                          java.awt.Rectangle bounds)

Initialize this engine with its parent container and the position and size of the engine within the container. This should be called exactly once, before start() is called. A good time to call this would be in the animationInitialize() call within the context code passed to initialize().

The Component will be set to the specified bounds, and an internal double buffer may be created to these bounds. The container is expected to have a null layout; if it doesn't, this might change the widget's size to be different than the bounds passed in (and therefore the double buffer). The container must be visible when this is called.

Specified by:

initContainer in class AnimationEngine

See Also:

AnimationEngine.initialize(com.hdcookbook.grin.animator.AnimationContext), AnimationContext.animationInitialize()

getWidth

public int getWidth()

Get the width of the area we display over

Specified by:

getWidth in class AnimationEngine

Returns:

the width

getHeight

public int getHeight()

Get the height of the area we display over

Specified by:

getHeight in class AnimationEngine

Returns:

the height

getComponent

public java.awt.Component getComponent()

Get the component that this animation engine renders into. This is added by the engine to the container.

Specified by:

getComponent in class AnimationEngine

Returns:

the component, or null if initContainer hasn't been called yet.

See Also:

AnimationEngine.initialize(com.hdcookbook.grin.animator.AnimationContext), AnimationContext.animationInitialize()

clearArea

protected void clearArea(int x,
                         int y,
                         int width,
                         int height)

Called from showFrame() to cause an area to be cleared in the current frame.

Specified by:

clearArea in class AnimationEngine

See Also:

AnimationEngine.showFrame()

needsFullRedrawInAnimationLoop

protected boolean needsFullRedrawInAnimationLoop()

Tell us whether or not this style of animation requires a full redraw of everything on the screen in each pass through the animation loop. This is called from the animation loop.

This is always false for direct draw. Because we maintian our own double buffer, nothing external can damage its contents.

Specified by:

needsFullRedrawInAnimationLoop in class AnimationEngine

callPaintTargets

protected void callPaintTargets()
                         throws java.lang.InterruptedException

Paint the current frame into the right graphics buffer. The subclass implementation of this method should call paintTargets(Graphics2D).

Specified by:

callPaintTargets in class AnimationEngine

Throws:

java.lang.InterruptedException

See Also:

AnimationEngine.paintFrame(java.awt.Graphics2D)

runAnimationLoop

protected void runAnimationLoop()
                         throws java.lang.InterruptedException

The inner loop for the animation thread. This implementation uses System.currentTimeMillis() and wait() to keep a steady frame rate. This method can be overridden for animation styles that have a different synch mechanism, like SFAA. If this is done, be sure to look inside this method, and obey the same semantic contract.

This method must call checkNewClients() outside of any synchronized block at least once per frame. This should be done at the beginning of the frame before any model updates or animation work is done.

This method must check destroyRequested() at least once per frame, and if it's true, bail out of the loop. To advance the model by one frame, it should call advanceModel(). When it wants to show a frame (and not skip it), it should call showFrame(), which will cause callPaintTargets() to be called.

Of course, the animation loop should also check Thread.interrupted() regularly.

Overrides:

runAnimationLoop in class ClockBasedEngine

Throws:

java.lang.InterruptedException

See Also:

AnimationEngine.destroyRequested(), AnimationEngine.advanceModel(), AnimationEngine.showFrame(), AnimationEngine.callPaintTargets()

finishedFrame

protected void finishedFrame()

Called when the engine is finished drawing the current frame. This should flush the results to the screen, if needed. The framework guarantees that each call to callPaintTargets() will be followed by a call to finishedFrame(), even if the thread is interrupted or there's a RuntimeException that terminates the thread.

Specified by:

finishedFrame in class AnimationEngine

terminatingEraseScreen

protected void terminatingEraseScreen()

Erase the screen because the AnimationManager is terminating. This is called in the animation thread as a result of a call to destroy(), just before the animation thread terminates.

Specified by:

terminatingEraseScreen in class AnimationEngine