character.java

J2ME下的ISOMetric引擎。该引擎实现了通过手机或PDA等设备进行游戏编程开发的基本手段。

package isoj2me;

import java.util.*;
import javax.microedition.lcdui.*;

/**
 * <p>isoj2me: Character</p>
 * <p>This class manages Characters.</p>
 * <p>Copyright: Copyright (c) 2004</p>
 * <p>License: Lesser GPL (http://www.gnu.org)</p>
 * <p>Company: <a href=http://www.mondonerd.com target="_blank">Mondonerd.com</a></p>
 * @author Massimo Maria Avvisati
 * @version alpha 0.4
 */

public class Character {
  public boolean isMoving = false;
  public String name = "";
  public int x = 0;
  public int y = 0;
  public int z = 0;

  public int modifierX = 0; //This changes the painting coordinates in the draw function
  public int modifierY = 0; //This changes the painting coordinates in the draw function

  private int frame = 0;
  private Hashtable actions = new Hashtable(6);
  private String currentAction = null;
  public int speed = 500;
  private Hashtable frames = new Hashtable();

  private long startTime = System.currentTimeMillis();
  private long endTime = 0;

  public Character() {
  }

  /**
   * Create a new character.
   * @param name Name/code of the character
   */
  public Character(String name) {
    this.name = name;
  }

  /**
   * Create a new character
   * @param name Name or code of the character
   * @param x x on the map
   * @param y y on the map
   * @param z layer on the map
   */

  public Character(String name, int x, int y, int z) {
    this.name = name;
    this.x = x;
    this.y = y;
    this.z = z;
  }

  /**
   * This draw the character at given coordinates on given Graphics. This method also change the current frame (if more than one) for the current action.
   * @param x x
   * @param y y
   * @param g given Graphics where to paint the character
   */

  public void draw(int x, int y, Graphics g) {
    endTime = System.currentTimeMillis();
    long deltaTime = 0;
    if (currentAction != null && actions.containsKey(currentAction)) {
      String tempFrame = "";

      if (frame > Integer.parseInt(actions.get(currentAction).toString())) {
	frame = 0;
      }
      if (frame > 0) {
	tempFrame = frame + "";
      }
      Image temp_image = Utility.loadImage(currentAction + tempFrame, frames);
      //int temp_x = x + (width - temp_image.getWidth()) / 2;

      g.drawImage(temp_image, x + modifierX,
		  y - temp_image.getHeight() + modifierY,
		  g.TOP | g.LEFT);
      deltaTime = endTime - startTime;
      if (deltaTime >= speed) {
	changeFrame();
	startTime = System.currentTimeMillis();
      }

    }

  }

  /**
   * Store an action into this character action list.
   * @param action basic string used to load frames
   * @param frames number of frames for this action
   */

  public void putAction(String action, int frames) {
    actions.put(action, frames + "");
  }

  /**
   * This return the name that identify the action that is performed in this moment by the character
   * @return basic string for this action
   */

  public String getCurrentAction() {
    return currentAction;
  }

  /**
   * Calculate the current frame and return the associated Image object
   * @return current Image used
   */

  public Image getCurrentImage() {
    Image temp_image = null;
    if (currentAction != null && actions.containsKey(currentAction)) {
      String tempFrame = "";

      if (frame > Integer.parseInt(actions.get(currentAction).toString())) {
	frame = 0;
      }
      if (frame > 0) {
	tempFrame = frame + "";
      }
      temp_image = Utility.loadImage(currentAction + tempFrame, frames);
    }

    return temp_image;
  }

  /**
   * Set the current action for this character. The action have to be already in the actions list
   * @param action name of the action to perform
   */

  public void setCurrentAction(String action) {
    if (actions.containsKey(action)) {
      currentAction = action;
    }
  }

  private void changeFrame() {
    if (actions.containsKey(currentAction)) {
      int numberOfFrames = Integer.parseInt(actions.get(currentAction).toString());
      frame++;
      if (frame > numberOfFrames) {
	frame = 0;
      }
    }
    else {
      frame = 0;
    }
  }

  /**
   * Return the name of the Character
   * @return name of the Character
   */

  public String toString() {
    return this.name;
  }

}