| Window.java |
1 package fi.jyu.mit.graphics;
2
3 import java.awt.*;
4 import java.awt.event.WindowAdapter;
5 import java.awt.event.WindowEvent;
6
7 import javax.swing.JFrame;
8
9 /**
10 * Window-luokka, ikkuna joka näyttää avaruudet.
11 * Ikkunaan voi lisätä kuvioita, esimerkiksi:
12 * esimerkiksi:
13 * <pre>
14 * window.add(new Line(0, 0, 1, 1)).setColor(255, 255, 0);
15 * </pre>
16 * Ikkunaa voi skaalata, kiertää ja liikuttaa, esimerkiksi:
17 * <pre>
18 * window.scale(-2.5, -2.2, 2.1, 2.7);
19 * window.rotate(Axis.X, 45.2);
20 * window.move(0, 1.5, -15);
21 * </pre>
22 * @author Markus Kivioja
23 */
24 public class Window extends JFrame implements Transformable {
25
26 private static final long serialVersionUID = 1L;
27 private SpacePanel panel;
28 private ControllerFrame touchPad, controlButtons;
29
30 /**
31 * Luo uuden ikkunan jonka korkeus on 500 ja leveys 500
32 *
33 */
34 public Window() {
35 this(500, 500);
36 }
37
38 /**
39 * Luo uuden ikkunan
40 * @param width leveys
41 * @param height korkeus
42 */
43 public Window(int width, int height) {
44 super();
45 this.setSize(width, height);
46 initialize();
47 setBackground(Color.WHITE);
48 }
49
50 /**
51 * Alustaa uuden ikkunan asetukset
52 */
53 private void initialize() {
54 Container contentPane = this.getContentPane();
55 contentPane.setLayout(new BorderLayout());
56 panel = new SpacePanel();
57 panel.setSize(getWidth(), getHeight());
58 contentPane.add(panel);
59 addWindowListener(new CloseWindow());
60 }
61
62 /**
63 * Skaalaa ikkunan sisällön annettujen reuna-arvojen mukaisesti,
64 * esimerkiksi:
65 * <pre>
66 * window.scale(-2.5, -2.2, 2.1, 2.7);
67 * </pre>
68 * @param left sisällön x-koordinaatin arvo ikkunan vasemmassa reunassa
69 * @param bottom sisällön y-koordinaatin arvo ikkunan alareunassa
70 * @param right sisällön x-koordinaatin arvo ikkunan oikeassa reunassa
71 * @param top sisällön y-koordinaatin arvo ikkunan yläreunassa
72 */
73 public void scale(double left, double bottom, double right, double top) {
74 panel.scale(left, bottom, right, top);
75 redraw();
76 }
77
78 /**
79 * Kiertää ikkunan sisältöä annetun akselin ympäri, esimerkiksi:
80 * <pre>
81 * window.rotate(Axis.X, 45.2);
82 * </pre>
83 * @param axis akseli jonka ympäri pyöritetään (Axis.X/Axis.Y/Axis.Z)
84 * @param deg kierrettävän kulman suuruus asteina
85 */
86 public void rotate(int axis, double deg) {
87 panel.rotate(axis, deg);
88 }
89
90 /**
91 * Liikuttaa ikkunan sisältöä, esimerkiksi:
92 * <pre>
93 * window.move(0, 1.5, -15);
94 * </pre>
95 * @param dx liikutettava matka x-akselin suunnassa
96 * @param dy liikutettava matka y-akselin suunnassa
97 * @param dz liikutettava matka z-akselin suunnassa
98 */
99 public void move(double dx, double dy, double dz) {
100 panel.move(dx, dy, dz);
101 }
102
103 /**
104 * Skaalaa ikkunan sisällön annettujen kertoimien mukaan
105 * <pre>
106 * window.scale(2, 1, 1); venyttää kuviot kaksinkertaiseksi x-suunnassa
107 * </pre>
108 * @param sx sisällön x-suuntainen kerroin
109 * @param sy sisällön y-suuntainen kerroin
110 * @param sz sisällön z-suuntainen kerroin
111 */
112 public void scale(double sx, double sy, double sz) {
113 panel.scale(sx, sy, sz);
114 }
115
116 public Transformable transform(Matrix m) {
117 panel.transform(m);
118 return this;
119 }
120
121 /**
122 * Asettaa ikkunan uudeksi muunnosmatriisiksi annetun matriisin
123 * @param m uusi muunnosmatriisi
124 */
125 public void setTransform(Matrix m) {
126 panel.setTransform(m);
127 }
128
129 public void setRotator(Matrix m) {
130 panel.setRotator(m);
131 }
132
133 public Matrix getRotator() {
134 return panel.getRotator();
135 }
136
137 /**
138 * Asettaa ikkunan näyttämään annettua avaruutta
139 * @param space näytettävä avaruus
140 */
141 public void setSpace(Space space) {
142 panel.setSpace(space);
143 }
144
145 /**
146 * Lisää ikkunaan kuvion joka on Drawable-olio ja palauttaa sen,
147 * esimerkiksi:
148 * <pre>
149 * window.add(new Line(0, 0, 1, 1)).setColor(255, 255, 0);
150 * </pre>
151 * @param shape lisättävä kuvio
152 * @return lisätty kuvio
153 */
154 public Drawable add(Drawable shape) {
155 return panel.add(shape);
156 }
157
158 /**
159 * Antaa Drawable-olion joka muodostuu kaikista
160 * tämän ikkunan näyttämistä kuvioista
161 * @return kokoelma tämän ikkunan näyttämistä kuvioista
162 */
163 public Drawable getSavedPath() {
164 return panel.getSavedPath();
165 }
166
167 /**
168 * Antaa ikkunan kokonaismuunnosmatriisin
169 * @return ikkunan kokonaismuunnosmatriisi
170 */
171 public Matrix getFullTransform() {
172 return panel.getFullTransform();
173 }
174
175 /**
176 * Poistaa ikkunasta kuvion joka on Drawable-olio
177 * @param shape poistettava kuvio
178 */
179 public void remove(Drawable shape) {
180 panel.remove(shape);
181 }
182
183 /**
184 * Piirtää ikkunan sisällön uudelleen
185 */
186 public void redraw() {
187 repaint();
188 }
189
190 /**
191 * Tuo ikkunan näkyville näyttöön
192 */
193 public void showWindow() {
194 this.setVisible(true);
195 }
196
197 /**
198 * Asettaa isotrooppisuuden päälle/pois
199 * @param isotrophic isotrooppisuus tosi/epätosi
200 */
201 public void setIsotrophic(boolean isotrophic) {
202 panel.setIsotrophic(isotrophic);
203 }
204
205 /**
206 * Lisää ikkunaan ruudun jonka avulla voi pyörittää
207 * ikkunan sisältöä liikuttamalla hiirtä ruudun sisässä
208 * @param touchPadOn ruutu näkyvillä tosi/epätosi
209 * @param move tuleeko hiiren napin olla pohjassa tosi/epätosi
210 */
211 public void setTouchPad(boolean touchPadOn, boolean move) {
212 if (touchPadOn) {
213 if ( touchPad == null )
214 touchPad = new ControllerFrame(new TouchPad(panel, move),0,350,150,150);
215 touchPad.showController();
216 }
217 else {
218 if (touchPad != null) touchPad.hideController();
219 }
220 }
221
222 /**
223 * Lisää ikkunaan ruudun jonka avulla voi pyörittää
224 * ikkunan sisältöä liikuttamalla hiirtä ruudun sisässä
225 * siten, että hiiren nappia ei paineta
226 * @param touchPadOn ruutu näkyvillä tosi/epätosi
227 */
228 public void setTouchPad(boolean touchPadOn) {
229 this.setTouchPad(touchPadOn, false);
230 }
231
232 /**
233 * Lisää ikkunaan jokaiselle akselille kiertopainikkeet joilla
234 * ikkunan sisältöä voi kiertää vastaavien akselien ympäri
235 * @param controlButtonsOn painikkeet näkyvillä tosi/epätosi
236 */
237 public void setControlButtons(boolean controlButtonsOn) {
238 if (controlButtonsOn) {
239 if ( controlButtons == null )
240 controlButtons = new ControllerFrame(new ControlButtons(panel),150,350,150,150);
241 controlButtons.showController();
242 }
243 else {
244 if (controlButtons != null) controlButtons.hideController();
245 }
246 }
247
248 /**
249 * Palauttaa tämän ikkunan sisältämän paneelin johon
250 * kuviot piirretään
251 * @return tämän ikkunan paneeli
252 */
253 public SpacePanel getPanel() {
254 return panel;
255 }
256
257 /**
258 * Luokka ikkunan sulkemiseen
259 */
260 private class CloseWindow extends WindowAdapter {
261
262 /**
263 * Käsittelijä ikkunan sulkemiselle.
264 * @param event ei käytössä
265 */
266 public void windowClosing(WindowEvent event) {
267
268 System.exit(0); // NOPMD EI ole J2EE ohjelma
269 }
270 }
271
272 /**
273 * Vaihtaa ikkunan muunnosmatriisin annetuksi matriisiksi
274 * @param m uusi muunnosmatriisi
275 */
276 // @Override
277 public void changeTransform(Matrix m) {
278 panel.changeTransform(m);
279 }
280
281 /**
282 * Antaa ikkunan muunnosmatriisin
283 * @return ikkunan muunnosmatriisi
284 */
285 // @Override
286 public Matrix getTransform() {
287 return panel.getTransform();
288 }
289 }
290