javax.microedition.lcdui.game.GameCanvas Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of microemu-midp Show documentation
midp
The newest version!
/*
 *  MicroEmulator
 *  Copyright (C) 2005 Andres Navarro
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2.1 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

package javax.microedition.lcdui.game;

import javax.microedition.lcdui.Canvas;
import javax.microedition.lcdui.Graphics;
import javax.microedition.lcdui.Image;

import org.microemu.GameCanvasKeyAccess;
import org.microemu.MIDletBridge;


/**
 *
 * @author Andres Navarro
 * @author radoshi
 */
public abstract class GameCanvas extends Canvas {
    // keystate constants
    public static final int UP_PRESSED = 1 << Canvas.UP;
    public static final int DOWN_PRESSED = 1 << Canvas.DOWN;
    public static final int LEFT_PRESSED = 1 << Canvas.LEFT;
    public static final int RIGHT_PRESSED = 1 << Canvas.RIGHT;
    public static final int FIRE_PRESSED = 1 << Canvas.FIRE;
    public static final int GAME_A_PRESSED = 1 << Canvas.GAME_A;
    public static final int GAME_B_PRESSED = 1 << Canvas.GAME_B;
    public static final int GAME_C_PRESSED = 1 << Canvas.GAME_C;
    public static final int GAME_D_PRESSED = 1 << Canvas.GAME_D;
    
    // true if this GameCanvas doesn't generate
    // key events for the game keys
    private boolean suppressKeyEvents;
    // the latched state of the keys
    // reseted on call to getKeyStates
    private int latchedKeyState;
    // the current keys state
    // this is copied to latchedKeyState
    // on call to getKeyState
    private int actualKeyState;
    
    Image offscreenBuffer;
    
    private class KeyAccess implements GameCanvasKeyAccess 
    {
        public boolean suppressedKeyEvents(GameCanvas canvas) {
            return canvas.suppressKeyEvents;
        }
        
        public void recordKeyPressed(GameCanvas canvas, int gameCode) {
            int bit = 1 << gameCode;
            latchedKeyState |= bit;
            actualKeyState |= bit;
        }
        
        public void recordKeyReleased(GameCanvas canvas, int gameCode) {
            int bit = 1 << gameCode;
            actualKeyState &= ~bit;
        }
        
        public void setActualKeyState(GameCanvas canvas, int keyState) {
            actualKeyState = keyState;
        }
        
        public void initBuffer() {
            offscreenBuffer = Image.createImage(getWidth(), getHeight());
        }
    }
    
    /** Creates a new instance of GameCanvas */
    protected GameCanvas(boolean suppressKeyEvents) 
    {
        MIDletBridge.registerGameCanvasKeyAccess(this, new KeyAccess());
        
        this.suppressKeyEvents = suppressKeyEvents;
        // never should the size of the Canvas become greater than this
        // if the size reported by Canvas.getXXX() isn't the maximum for
        // a given Canvas implementation other methods should be used to
        // obtain the maximum possible size for such particular implementation
        this.offscreenBuffer = Image.createImage(this.getWidth(), this.getHeight());
    }
    
    protected Graphics getGraphics() {
        return offscreenBuffer.getGraphics();
    }
    
    public void paint(Graphics g) {
        g.drawImage(offscreenBuffer, 0, 0, Graphics.TOP | Graphics.LEFT);
    }
    
    public void flushGraphics(int x, int y, int width, int height) {
        // i dont know if this is correct, the specification is a little
        // vague here.
        // For example this methods fail if the paint method is
        // overriden with something else
        repaint(x, y, width, height);
        serviceRepaints();
    }

    public void flushGraphics() {
    	
        // NOTE see comment at the other flushGraphics method
        repaint();
        serviceRepaints();
    }

    public int getKeyStates() {
    	synchronized(this) {
	        int ret = latchedKeyState;
	        latchedKeyState = actualKeyState;
	        return ret;
    	}
    }
    
    // TODO
    // should isDoubleBuffered from class Canvas return true in this class??
}