本节书摘来异步社区《Java 2D游戏编程入门》一书中的第2章，第2.3节，作者：【美】Timothy Wright（莱特），更多章节内容可以访问云栖社区“异步社区”公众号查看。
2.3 处理鼠标输入
SimpleMouseInput类位于javagames.util包中，它和前面小节中开发的键盘输入类非常相似。处理鼠标按键的方式与处理键盘按键的方式相同。实现MouseListener接口的类包含了如下的方法：
mouseClicked(MouseEvent e)
mouseEntered(MouseEvent e)
mouseExited(MouseEvent e)
mousePressed(MouseEvent e)
mouseReleased(MouseEvent e)```
这个接口中的两个方法，mouseEntered()和mouseExited()，负责处理鼠标光标移动。另外3个方法用于鼠标按键。就像键盘监听器一样，按下和释放方法会记录鼠标按钮的状态，而点击方法则会被忽略。为了确定按下了哪个鼠标按键，鼠标事件包含了如下的方法：public int MouseEvent.getButton()`
这个方法所返回的值，映射到如下的常量：
MouseEvent.NOBUTTON = 0
MouseEvent.BUTTON1 = 1
MouseEvent.BUTTON2 = 2
MouseEvent.BUTTON3 = 3```
按键的编号是从1开始而不是从0开始的，0表示没有按键，在引用鼠标按键数组的时候，不需要将按键编号减1。除了这一点小小的差别，鼠标按键和键盘按键的处理方式相同，也包括buttonDown()和buttonDownOnce()方法。
还有其他的鼠标状态可供程序使用，例如鼠标指针的位置和状态。和MouseListener接口的mouseEntered()和mouseExited()方法一样，鼠标输入类也实现了MouseMotionListener接口。mouseDragged(MouseEvent e)
mouseMoved(MouseEvent e)`
针对鼠标事件，如果鼠标进入或离开了组件监听，所有这4个方法（进入、退出、拖拽和移动）都会捕获鼠标的位置并通知程序。如下的方法会获取鼠标的当前位置：
public Point MouseEvent.getPoint()```
当轮询鼠标输入时，会复制这个值并使其可供游戏循环使用。当前的鼠标位置，对于如下的方法来说是可用的：public Point SimpleMouseInput.getPosition()`
最后，为了监控鼠标滚轮的输入，输入类实现了MouseWheelListener：
mouseWheelMoved(MouseEvent e)```
如下的方法返回了鼠标滚轮的点击。如果这个数值是负值，表示滚轮已经从用户那里移走了。如果这个值是正的，表示滚轮已经朝着用户移动了。public int MouseWheelEvent.getWheelRotation()`
这个值也保存在poll()方法中，并且可通过如下方法供游戏循环使用：
public int SimpleMouseInput.getNotches()```
SimpleMouseInput类的代码如下：package javagames.util;
import java.awt.*;
import java.awt.event.*;
public class SimpleMouseInput
implements MouseListener, MouseMotionListener, MouseWheelListener {
private static final int BUTTON_COUNT = 3;
private Point mousePos;
private Point currentPos;
private boolean[] mouse;
private int[] polled;
private int notches;
private int polledNotches;
public SimpleMouseInput() {
mousePos = new Point( 0, 0 );
currentPos = new Point( 0, 0 );
mouse = new boolean[ BUTTON_COUNT ];
polled = new int[ BUTTON_COUNT ];
}
public synchronized void poll() {
mousePos = new Point( currentPos );
polledNotches = notches;
notches = 0;
for( int i = 0; i < mouse.length; ++i ) {
if( mouse[i] ) {
polled[i]++;
} else {
polled[i] = 0;
}
}
}
public Point getPosition() {
return mousePos;
}
public int getNotches() {
return polledNotches;
}
public boolean buttonDown( int button ) {
return polled[ button - 1 ] > 0;
}
public boolean buttonDownOnce( int button ) {
return polled[ button - 1 ] == 1;
}
public synchronized void mousePressed( MouseEvent e ) {
int button = e.getButton() - 1;
if( button >= 0 && button < mouse.length ) {
mouse[ button ] = true;
}
}
public synchronized void mouseReleased( MouseEvent e ) {
int button = e.getButton() - 1;
if( button >= 0 && button < mouse.length ) {
mouse[ button ] = false;
}
}
public void mouseClicked( MouseEvent e ) {
// Not needed
}
public synchronized void mouseEntered( MouseEvent e ) {
mouseMoved( e );
}
public synchronized void mouseExited( MouseEvent e ) {
mouseMoved( e );
}
public synchronized void mouseDragged( MouseEvent e ) {
mouseMoved( e );
}
public synchronized void mouseMoved( MouseEvent e ) {
currentPos = e.getPoint();
}
public synchronized void mouseWheelMoved( MouseWheelEvent e ) {
notches += e.getWheelRotation();
}
}`
SimpleMouseExample如图2.2所示，它位于javagames.input包中，为第一个示例添加了很多新的内容。这个示例以主动渲染示例代码为基础，添加了键盘和鼠标输入类；它不仅展示了所有3种类型的鼠标输入，而且也是使用Graphics对象绘制到屏幕的第一个示例。
首先需要注意的是，创建GUI时的方法调用。这些调用添加了KeyboardInput和Simple MouseInput作为组件的监听器。注意，尽管给JFrame和Canvas都添加了键盘，但是只给Canvas添加了鼠标。当应用程序初次启动时，如果没有给JFrame添加键盘事件的话，它不会处理键盘事件。一旦画布对象接受到焦点，它将会接受键盘输入，但在画布被选中之前，都只有JFrame接受键盘输入。在游戏循环中，添加了如下的方法调用：
public void processInput()```
在这个方法中，对键盘和鼠标都进行了轮询，以确保它们的数据可用。当初次按下鼠标按键时，会设置绘制标志。对于保持鼠标按键按下的每一帧，都会向该行的数据结构添加一个新的点。当按键释放的时候，该标志被清除，并且向列表添加一个空的对象，标志该行的结束。通过这种方式，该数据结构可以同时保存所有的行。
当按下C键的时候，该行从数据结构中清除。如果用户缺乏绘画技巧的话（就像我一样），这会允许他们重新开始。渲染方法也有新的代码加入。除了显示帧速率，还给出了使用该应用程序的说明，并把当前鼠标的位置显示为字符串。
鼠标滚轮用来选择一个颜色索引。如下的代码使用模除运算符和绝对值来保证索引是一个有效值，无论所获取的索引有多大或多小。// SimpleMouseExample.java
colorIndex += mouse.getNotches();
Color color = COLORS[ Math.abs( colorIndex % COLORS.length ) ];
g.setColor( color );`
%操作符将会保证值在(–3, 3)之间。因为对一个负值进行模除运算，会得到0或者一个负值，所以使用绝对值来保证数组索引位于(0, size –1)之间。
最后，绘制了线条。由于在数据结构中插入了空的值，我们添加了代码以确保没有点为空的时候才绘制线条。
package javagames.input;
import java.awt.*;
import java.awt.event.*;
import java.awt.image.*;
import java.util.*;
import javagames.util.*;
import javax.swing.*;
public class SimpleMouseExample extends JFrame
implements Runnable {
private FrameRate frameRate;
private BufferStrategy bs;
private volatile boolean running;
private Thread gameThread;
private SimpleMouseInput mouse;
private KeyboardInput keyboard;
private ArrayList<Point> lines = new ArrayList<Point>();
private boolean drawingLine;
private Color[] COLORS = {
Color.RED,
Color.GREEN,
Color.YELLOW,
Color.BLUE
};
private int colorIndex;
public SimpleMouseExample() {
frameRate = new FrameRate();
}
protected void createAndShowGUI() {
Canvas canvas = new Canvas();
canvas.setSize( 640, 480 );
canvas.setBackground( Color.BLACK );
canvas.setIgnoreRepaint( true );
getContentPane().add( canvas );
setTitle( "Simple Mouse Example" );
setIgnoreRepaint( true );
pack();
// Add key listeners
keyboard = new KeyboardInput();
canvas.addKeyListener( keyboard );
// Add mouse listeners
mouse = new SimpleMouseInput();
canvas.addMouseListener( mouse );
canvas.addMouseMotionListener( mouse );
canvas.addMouseWheelListener( mouse );
setVisible( true );
canvas.createBufferStrategy( 2 );
bs = canvas.getBufferStrategy();
canvas.requestFocus();
gameThread = new Thread( this );
gameThread.start();
}
public void run() {
running = true;
frameRate.initialize();
while( running ) {
gameLoop();
}
}
private void gameLoop() {
processInput();
renderFrame();
sleep( 10L );
}
private void renderFrame() {
do {
do {
Graphics g = null;
try {
g = bs.getDrawGraphics();
g.clearRect( 0, 0, getWidth(), getHeight() );
render( g );
} finally {
if( g != null ) {
g.dispose();
}
}
} while( bs.contentsRestored() );
bs.show();
} while( bs.contentsLost() );
}
private void sleep( long sleep ) {
try {
Thread.sleep( sleep );
} catch( InterruptedException ex ) { }
}
private void processInput() {
keyboard.poll();
mouse.poll();
if( keyboard.keyDownOnce( KeyEvent.VK_SPACE ) ) {
System.out.println("VK_SPACE");
}
// if button is pressed for first time,
// start drawing lines
if( mouse.buttonDownOnce( MouseEvent.BUTTON1 ) ) {
drawingLine = true;
}
// if the button is down, add line point
if( mouse.buttonDown( MouseEvent.BUTTON1 ) ) {
lines.add( mouse.getPosition() );
// if the button is not down but we were drawing,
// add a null to break up the lines
} else if( drawingLine ) {
lines.add( null );
drawingLine = false;
}
// if ’C’ is down, clear the lines
if( keyboard.keyDownOnce( KeyEvent.VK_C ) ) {
lines.clear();
}
}
private void render( Graphics g ) {
colorIndex += mouse.getNotches();
Color color = COLORS[ Math.abs( colorIndex % COLORS.length ) ];
g.setColor( color );
frameRate.calculate();
g.drawString( frameRate.getFrameRate(), 30, 30 );
g.drawString( "Use mouse to draw lines", 30, 45 );
g.drawString( "Press C to clear lines", 30, 60 );
g.drawString( "Mouse Wheel cycles colors", 30, 75 );
g.drawString( mouse.getPosition().toString(), 30, 90 );
for( int i = 0; i < lines.size() - 1; ++i ) {
Point p1 = lines.get( i );
Point p2 = lines.get( i + 1 );
// Adding a null into the list is used
// for breaking up the lines when
// there are two or more lines
// that are not connected
if( !( p1 == null || p2 == null ) )
g.drawLine( p1.x, p1.y, p2.x, p2.y );
}
}
protected void onWindowClosing() {
try {
running = false;
gameThread.join();
} catch( InterruptedException e ) {
e.printStackTrace();
}
System.exit( 0 );
}
public static void main( String[] args ) {
final SimpleMouseExample app = new SimpleMouseExample();
app.addWindowListener( new WindowAdapter() {
public void windowClosing( WindowEvent e ) {
app.onWindowClosing();
}
});
SwingUtilities.invokeLater( new Runnable() {
public void run() {
app.createAndShowGUI();
}
});
}
