本文講述一個畫圖板應用程序的設計,屏幕抓圖以下:
java
『IShape』數組
這是全部圖形類(此後稱做模型類)都應該實現接口,外部的控制類,好比畫圖板類就經過這個接口跟模型類「交流」。名字開頭的I表示它是一個接口(Interface),這是eclipse用的一個命名法則,以爲挺有用的,就借鑑來了。這個接口定義了兩個方法:eclipse
- public void draw(java.awt.Graphics2D g);
-
- public void processCursorEvent(java.awt.event.MouseEvent evt, int type);
下面這個class diagram顯示了全部圖形類的結構圖。FreeShape, RectBoundedShape,和PolyGon這三個類直接實現了IShape接口。其中,FreeShape和RectBoundedShape是抽象類,分別表明不規則圖形(好比鉛筆畫圖)和以一個長方形爲邊界的規則圖形,因爲分屬於這兩個類別的圖形對於鼠標事件的處理基本上都是一致的,因此就抽象出來這兩個父類,避免重複代碼。PolyGon是一個具體類,它的命名沒有采用Polygon是爲了不同java.awt.Polygon重名。它表明的圖形是多邊形,因爲它獨特的鼠標處理方式,它不屬於上面兩種類型圖形的任何一種,因此它直接實現了IShape接口。ide
IShape接口所定義的兩個方法究竟是怎麼被用到的呢?這個問題如今還不能馬上解答。在下面的部分,咱們先講述FreeShape所定義的不規則圖形及其兩個具體子類PolyLine和Eraser,而後在這個基礎上講述一個縮略版的畫圖板類,到那個時候,上面問題的答案也就天然揭曉了。以後,咱們再繼續講述其餘的圖形類。函數
『FreeShape』工具
講到FreeShape,咱們不得不先說一下PointsSet這個類。這是一個util類,被FreeShape和PolyGon用到,表明一個有序的點集合,並提供方便的方法來加入新的點和讀取點座標。爲了方便對模型類代碼的理解,這裏列出PointsSet類的API。this
- public PointsSet();
- 用默認的初始容量(10)建立一個對象。
-
- public PointsSet(int initCap);
- 用指定的初始容量(initCap)建立一個對象。
-
- public void addPoint(int x, int y);
- 加入一個新的點到這個集合的末端;若是舊的末端點跟新的點重合,則不重複加入。
-
- public int[][] getPoints();
- 將全部點以一個二維數組(int[2][n])返回。第一行是x座標,第二行是y座標。
-
- public int[][] getPoints(int x, int y);
- 相似上一個方法,只是最後將參數指定的點加在末尾(不管是否跟集合末端的點重合);
- 這個方法只被PolyGon用到。
好了,來看下面代碼中FreeShape對IShape接口的實現。FreeShape有三個屬性變量:color, stroke,和pointsSet。權限設成protected固然是給子類用啦。color就是色彩了,stroke用來指定使用線條的粗細(固然,Stroke類的對象還能夠指定交接點形狀之類的屬性,不過這裏都使用其默認值了),pointsSet固然就是包含了全部控制點(這裏叫控制點彷佛不太恰當,由於其實沒法利用這些點來「控制」的,不過也想不到其餘恰當的名字,就這麼叫吧)集合。值得注意的是構造函數裏面包含了起始點的座標,這個點在函數裏面被加到了控制點集中。spa
這類圖形對鼠標事件的處理很簡單,它只對IShape.CURSOR_DRAGGED類型的事件感興趣,每當發生這類事件的時候,就把鼠標拖拽到的新的點加入到控制點集中。固然了,根據上面看到的PointsSet.addPoint(int,int)這個方法的「個性」,這個點是否真的被加入還要看它是否跟舊的末端點重合。.net
- import java.awt.*;
- import java.awt.event.MouseEvent;
-
- public abstract class FreeShape implements IShape {
-
- protected Color color;
- protected Stroke stroke;
- protected PointsSet pointsSet;
-
- protected FreeShape(Color c, Stroke s, int x, int y) {
- pointsSet = new PointsSet(50);
- color = c;
- stroke = s;
- pointsSet.addPoint(x, y);
- }
-
- public void processCursorEvent(MouseEvent e, int t) {
- if (t != IShape.CURSOR_DRAGGED)
- return;
- pointsSet.addPoint(e.getX(), e.getY());
- }
-
- }
FreeShape類沒有實現IShape接口的draw(Graphics2D)方法,很明顯,這個方法是留給子類來完成的。PolyLine和Eraser繼承了FreeShape,分別表明鉛筆繪出的圖形和橡皮擦。其中PolyLine的構造函數結構跟其父類類似,直接調用父類的super方法來完成;相比之下,Eraser類就有點「叛逆」了,它的參數裏面用一個JComponent替換了Color。Eraser類是經過畫出跟畫圖板背景色彩一致的線條來掩蓋原有圖形而實現橡皮擦的效果的,但因爲畫圖板的背景色是能夠調的(見抓圖的Color Settings部分),直接給Eraser的構造函數一個色彩對象不太合適,因此乾脆將畫圖板本身(JComponent)傳了進來,這樣,每次Eraser設定圖形色彩時,都直接問畫圖板要它的背景色。來看一下PolyLine對draw(Graphics2D)方法的實現:設計
- public void draw(Graphics2D g) {
- g.setColor(color);
- g.setStroke(stroke);
- int[][] points = pointsSet.getPoints();
- int s = points[0].length;
- if (s == 1) {
- int x = points[0][0];
- int y = points[1][0];
- g.drawLine(x, y, x, y);
- } else {
- g.drawPolyline(points[0], points[1], s);
- }
- }
這個方法裏面有一個if-else結構,因爲構造函數裏面已經將起始點加入控制點集中,因此pointsSet.getPoints()會至少返回一個點。利用Graphics.drawPolyline(int[],int[],int)畫圖時,若是隻有一個點,它是不會畫出來東西的,因此檢查一下點數,若是隻有一個,則改用Graphics.drawLine(int,int,int,int)將這個點畫出來。Eraser的draw(Graphics2D)方法跟上面基本上徹底同樣,只是傳給Graphics.setColor(Color)的參數是經過JComponent.getBackground()獲得的。
『TestBoard』
如今就來看一個精簡版的畫圖板類:TestBoard。下面的代碼,是經過代碼註釋進行解釋的。須要注意的是,TestBoard自己還不能直接運行,須要把它放到一個JFrame裏面才行。同時畫圖工具的切換也須要外部的控件來處理。不過這些都比較簡單了,就很少說了。
- import java.awt.*;
- import java.awt.event.*;
- import javax.swing.*;
- import java.util.ArrayList;
-
- public class TestBoard extends JPanel
- implements MouseListener, MouseMotionListener {
-
-
- public static final int TOOL_PENCIL = 1;
- public static final int TOOL_ERASER = 2;
- public static final Stroke STROKE = new BasicStroke(1.0f);
- public static final Stroke ERASER_STROKE = new BasicStroke(15.0f);
-
- private ArrayList shapes;
- private IShape currentShape;
- private int tool;
-
- public TestBoard() {
-
- shapes = new ArrayList();
- tool = TOOL_PENCIL;
- currentShape = null;
-
-
- addMouseListener(this);
- addMouseMotionListener(this);
- }
-
-
- public void setTool(int t) {
- tool = t;
- }
-
-
- protected void paintComponent(Graphics g) {
- super.paintComponent(g);
- int size = shapes.size();
- Graphics2D g2d = (Graphics2D) g;
- for (int i=0; i < size; i++) {
- ((IShape) shapes.get(i)).draw(g2d);
- }
- }
-
- public void mousePressed(MouseEvent e) {
-
- if (e.getButton() == MouseEvent.BUTTON1) {
- switch (tool) {
- case TOOL_PENCIL:
- currentShape = new PolyLine(getForeground(),
- STROKE, e.getX(), e.getY());
- break;
- case TOOL_ERASER:
- currentShape = new Eraser(this, ERASER_STROKE,
- e.getX(), e.getY());
- break;
- }
- shapes.add(currentShape);
- repaint();
-
- } else if (e.getButton() == MouseEvent.BUTTON3 && currentShape != null) {
- currentShape.processCursorEvent(e, IShape.RIGHT_PRESSED);
- repaint();
- }
- }
-
- public void mouseDragged(MouseEvent e) {
-
- if (currentShape != null) {
- currentShape.processCursorEvent(e, IShape.CURSOR_DRAGGED);
- repaint();
- }
- }
-
- public void mouseReleased(MouseEvent e) {
-
- if (e.getButton() == MouseEvent.BUTTON1 && currentShape != null) {
- currentShape.processCursorEvent(e, IShape.LEFT_RELEASED);
- currentShape = null;
- repaint();
- }
- }
-
-
- public void mouseClicked(MouseEvent e) {}
- public void mouseEntered(MouseEvent e) {}
- public void mouseExited(MouseEvent e) {}
- public void mouseMoved(MouseEvent e) {}
-
- }
至此,整個程序的流程就很清楚了,文章開頭部分的問題也被解開了。接下來,就繼續來看其餘的模型類。
『RectBoundedShape』
RectBoundedShape構造函數的結構跟FreeShape同樣,在色彩和線條的運用上也是同樣的,也只對鼠標拖拽事件感興趣。不過,它只有兩個控制點,起始點和結束點,因此,不須要用到PointsSet。原本,RectBoundedShape這個類是比FreeShape簡單的,在處理鼠標拖拽事件時只要將結束點設置到新拖拽到的點就能夠了。不過,這裏咱們多加入一個的功能,就是在shift鍵按下的狀況下,讓圖形的邊界是個正方形(取原邊界中較短的那條邊)。這個功能是由regulateShape(int,int)這個方法來完成的,它的代碼至關簡短,就很少作解釋了 。
- import java.awt.*;
- import java.awt.event.MouseEvent;
-
- public abstract class RectBoundedShape implements IShape {
-
- protected Color color;
- protected Stroke stroke;
-
- protected int startX, startY, endX, endY;
-
- protected RectBoundedShape(Color c, Stroke s, int x, int y) {
- color = c;
- stroke = s;
- startX = endX = x;
- startY = endY = y;
- }
-
- public void processCursorEvent(MouseEvent e, int t) {
- if (t != IShape.CURSOR_DRAGGED)
- return;
- int x = e.getX();
- int y = e.getY();
- if (e.isShiftDown()) {
- regulateShape(x, y);
- } else {
- endX = x;
- endY = y;
- }
- }
-
- protected void regulateShape(int x, int y) {
- int w = x - startX;
- int h = y - startY;
- int s = Math.min(Math.abs(w), Math.abs(h));
- if (s == 0) {
- endX = startX;
- endY = startY;
- } else {
- endX = startX + s * (w / Math.abs(w));
- endY = startY + s * (h / Math.abs(h));
- }
- }
-
- }
有了RectBoundedShape這個父類打下的基礎,它下面的子類所要作的事情就是畫圖啦。全部子類的構造函數跟父類都是同樣的結構,基本上也都是直接調用super的構造函數,只是Diamond這個類爲了提升畫圖效率,「私下」定義了一個數組。RectBoundedShape的子類包括Line, Rect, Oval, 和Diamond。除了Diamond須要根據邊界長方形進行稍微計算求得菱形的四個點外,它們的圖形均可以直接利用Graphics類提供的方法很方便的畫出來,詳情能夠參看源代碼,就很少說了。如今看一下Line這個類。不一樣於其它幾個類,在shift鍵按下的狀況下,根據角度不一樣,咱們想畫出45度線,水平線,或者豎直線。因此,Line這個類不使用其父類定義的processCursorEvent(MouseEvent,int)方法,而是本身定義了一套。父類中regulateShape(int,int)方法的權限設成protected也是爲了給Line用的。代碼以下:
- public void processCursorEvent(MouseEvent e, int t) {
- if (t != IShape.CURSOR_DRAGGED)
- return;
- int x = e.getX();
- int y = e.getY();
- if (e.isShiftDown()) {
-
- if (x - startX == 0) {
- endX = startX;
- endY = y;
- } else {
-
- float slope = Math.abs(((float) (y - startY)) / (x - startX));
-
- if (slope < 0.577) {
- endX = x;
- endY = startY;
-
- } else if (slope < 1.155) {
- regulateShape(x, y);
-
- } else {
- endX = startX;
- endY = y;
- }
- }
-
- } else {
- endX = x;
- endY = y;
- }
- }
『PolyGon』
用戶畫多邊形的步驟是這樣的,先在一點按下鼠標左鍵,定義一個頂點,而後將鼠標拖拽到多邊形的下一個頂點,點鼠標右鍵將這個點記錄,以後重複這個步驟直到全部頂點都記錄,鬆開左鍵,多邊形完成。在多邊形完成前,顯示出來的不是閉合圖形,當左鍵鬆開時,圖形自動閉合。對於最後一個頂點,用戶不用點右鍵也會被自動記錄的。好了,來看一下這個過程是怎麼來完成的。方便起見,直接用註釋在代碼上解釋了。
- import java.awt.*;
- import java.awt.event.MouseEvent;
-
- public class PolyGon implements IShape {
-
-
- private Color color;
- private Stroke stroke;
-
-
- private PointsSet pointsSet;
-
-
- private boolean finalized;
-
-
- private int currX, currY;
-
- public PolyGon(Color c, Stroke s, int x, int y) {
- pointsSet = new PointsSet();
- color = c;
- stroke = s;
- pointsSet.addPoint(x, y);
-
- currX = x;
- currY = y;
- finalized = false;
- }
-
- public void processCursorEvent(MouseEvent e, int t) {
-
- currX = e.getX();
- currY = e.getY();
-
- if (t == IShape.RIGHT_PRESSED) {
- pointsSet.addPoint(currX, currY);
-
- } else if (t == IShape.LEFT_RELEASED) {
- finalized = true;
- pointsSet.addPoint(currX, currY);
- }
-
- }
-
- public void draw(Graphics2D g) {
- g.setColor(color);
- g.setStroke(stroke);
- if (finalized) {
-
- int[][] points = pointsSet.getPoints();
- int s = points[0].length;
-
- if (s == 1) {
- int x = points[0][0];
- int y = points[1][0];
- g.drawLine(x, y, x, y);
- } else {
- g.drawPolygon(points[0], points[1], s);
- }
- } else {
- int[][] points = pointsSet.getPoints(currX, currY);
- g.drawPolyline(points[0], points[1], points[0].length);
- }
- }
-
- }
『其餘』
DrawingBoard(extends JPanel)是附件程序中用的畫圖板類,它是在TestBoard類上的一個擴展,加入了其餘的模型類。另外,它提供了一些方法讓外部控制界面來設置繪圖色,畫圖板背景色,畫圖線條,橡皮擦大小(也是經過改變線條實現的)。這些就再也不一一贅述了。
AppFrame(extends JFrame)用來放畫圖板和控制面板。
此外,在稍微變更代碼的狀況下,還能夠加入新的圖形類,固然這些類要實現IShape接口,好比,直接繼承RectBoundedShape,定義新的圖形顯示代碼。