Added row at top of board to show floating block entry and killing piece

placement.  Went back to not allowing the player to be killed by shaft
pieces.  Initial work on improved keyboard input.


git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@755 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/util/KeyTranslator.java

@@ -0,0 +1,34 @@
+//
+// $Id: KeyTranslator.java,v 1.1 2001/12/12 16:55:06 shaper Exp $
+
+package com.threerings.yohoho.puzzle.util;
+
+/**
+ * The key translator interface provides a means whereby the keyboard
+ * manager can map a key code to the logical {@link
+ * com.samskivert.swing.Controller} action command that it represents.
+ */
+public interface KeyTranslator
+{
+    /**
+     * Returns whether there is an action command for the key
+     * corresponding to the given keycode.  The translator may have a
+     * mapping for an action command for a key press or a key release of
+     * the key, or both.
+     */
+    public boolean hasCommand (int keyCode);
+
+    /**
+     * Returns the action command string associated with a key press of
+     * the key corresponding to the given key code, or <code>null</code>
+     * if there is no associated command.
+     */
+    public String getPressCommand (int keyCode);
+
+    /**
+     * Returns the action command string associated with a key release of
+     * the key corresponding to the given key code, or <code>null</code>
+     * if there is no associated command.
+     */
+    public String getReleaseCommand (int keyCode);
+}