| SpacePanel.java |
1 package fi.jyu.mit.graphics;
2
3 import java.awt.*;
4 import java.awt.event.ComponentAdapter;
5 import java.awt.event.ComponentEvent;
6
7
8 /**
9 * Ikkunoissa näytettävä paneeli johon kuviot piirretään
10 * @author Markus Kivioja
11 * @author Vesa Lappalainen
12 *
13 */
14 public class SpacePanel extends Component implements SpaceParent {
15
16 private static final long serialVersionUID = 1L;
17 private Matrix sm; // Perusskaalaus kuva ikkunaan
18 private Matrix a; // Muunnokset taman paalle
19 private Matrix tm; // Kokonaismuunnos tm = sm * a;
20 private Matrix rotator;
21 private boolean isotrophic;
22 private boolean allowRescale = true;
23 private Space space;
24 private RRect rRect = null;
25
26 /**
27 * Luo uuden paneelin jonka taustaväri on valkoinen
28 */
29 public SpacePanel() {
30 super();
31 initialize(); // NOPMD
32 setBackground(Color.WHITE);
33 // setOpaque(false);
34 setBackground(Color.WHITE);
35 }
36
37 /**
38 * Alustaa paneelin asetuksen, kertoo näyttämälleen avaruudelle,
39 * että tämä paneeli näyttää sitä
40 */
41 private final void initialize() {
42 this.space = new Space();
43 this.space.registerWindow(this);
44 this.sm = new TMatrix();
45 this.a = new TMatrix();
46 this.tm = new TMatrix();
47 this.rotator = new TMatrix();
48 // this.height = getHeight();
49 this.isotrophic = true;
50 addComponentListener(new ComponentAdapter() {
51 public void componentResized(ComponentEvent e) {
52 if ( allowRescale ) reScale(); // NOPMD
53 }
54 });
55 }
56
57 /**
58 * Skaalaa paneelin sisällön annettujen reuna-arvojen mukaisesti,
59 * esimerkiksi:
60 * <pre>
61 * panel.scale(-2.5, -2.2, 2.1, 2.7);
62 * </pre>
63 * @param left sisällön x-koordinaatin arvo paneelin vasemmassa reunassa
64 * @param bottom sisällön y-koordinaatin arvo paneelin alareunassa
65 * @param right sisällön x-koordinaatin arvo paneelin oikeassa reunassa
66 * @param top sisällön y-koordinaatin arvo paneelin yläreunassa
67 */
68 public void scale(double left, double bottom, double right, double top) {
69 rRect = new RRect(left, top, right, bottom);
70 reScale();
71 }
72
73 /**
74 * Skaalaa paneelin sisällön oikean kokoiseksi jos paneelin kokoa muutetaan
75 */
76 public final void reScale() {
77 if ( rRect == null ) return;
78 SRect sRect = new SRect(0, 0, getWidth(), getHeight());
79 this.sm = new TMatrix(rRect, sRect, isotrophic);
80 redraw();
81 }
82
83 /**
84 * Pyrittää paneelin sisältöä annetun akselin ympäri, esimerkiksi:
85 * <pre>
86 * panel.rotate(Axis.X, 45.2);
87 * </pre>
88 * @param axis akseli jonka ympäri pyöritetään (Axis.X/Axis.Y/Axis.Z)
89 * @param deg pyöritettävän kulman suuruus asteina
90 */
91 public void rotate(int axis, double deg) {
92 transform(new RotMatrix(axis, deg));
93 }
94
95 /**
96 * Liikuttaa paneelin sisältöä, esimerkiksi:
97 * <pre>
98 * panel.move(0, 1.5, -15);
99 * </pre>
100 * @param dx liikutettava matka x-akselin suunnassa
101 * @param dy liikutettava matka y-akselin suunnassa
102 * @param dz liikutettava matka z-akselin suunnassa
103 */
104 public void move(double dx, double dy, double dz) {
105 transform(new TranslateMatrix(dx,dy,dz));
106 }
107
108 /**
109 * Skaalaa paneelin sisällön annettujen kertoimien mukaan
110 * <pre>
111 * panel.scale(2, 1, 1); venyttää kuviot kaksinkertaiseksi x-suunnassa
112 * </pre>
113 * @param sx sisällön x-suuntainen kerroin
114 * @param sy sisällön y-suuntainen kerroin
115 * @param sz sisällön z-suuntainen kerroin
116 */
117 public void scale(double sx, double sy, double sz) {
118 transform(new ScaleMatrix(sx,sy,sz));
119 }
120
121 /**
122 * @see fi.jyu.mit.graphics.Transformable#transform(fi.jyu.mit.graphics.Matrix)
123 */
124 public Transformable transform(Matrix m) {
125 if ( m == null ) return this;
126 this.a.multiplyThis(m);
127 redraw();
128 return this;
129 }
130
131 /**
132 * Asetetaan kirtomatriisi
133 * @param m
134 */
135 public void setTransform(Matrix m) {
136 this.a = m;
137 redraw();
138 }
139
140 /**
141 * @see fi.jyu.mit.graphics.Transformable#changeTransform(fi.jyu.mit.graphics.Matrix)
142 */
143 public void changeTransform(Matrix m) {
144 setTransform(m);
145 }
146
147 /**
148 * @see fi.jyu.mit.graphics.Transformable#setRotator(fi.jyu.mit.graphics.Matrix)
149 */
150 public void setRotator(Matrix m) {
151 this.rotator = m;
152 redraw();
153 }
154
155 /**
156 * @see fi.jyu.mit.graphics.Transformable#getRotator()
157 */
158 public Matrix getRotator() {
159 return this.rotator;
160 }
161
162 /**
163 * Asettaa paneelin näyttämään annettua avaruutta
164 * @param space avaruus jota näytetään
165 */
166 public void setSpace(Space space) {
167 this.space = space;
168 this.space.registerWindow(this);
169 }
170
171 /**
172 * Lisää paneeliin kuvion joka on Drawable-olio ja palauttaa sen,
173 * esimerkiksi:
174 * <pre>
175 * panel.add(new Line(0, 0, 1, 1).setColor(255, 255, 0));
176 * </pre>
177 * @param shape lisättävä kuvio
178 * @return lisätty kuvio
179 */
180 public Drawable add(Drawable shape) {
181 return this.space.add(shape);
182 }
183
184 /**
185 * Antaa Drawable-olion joka muodostuu kaikista
186 * tämän paneelin näyttämistä kuvioista
187 * @return kokoelma tämän paneelin näyttämistä kuvioista
188 */
189 public Drawable getSavedPath() {
190 return this.space.getSavedPath();
191 }
192
193 /**
194 * Poistaa paneelista kuvion joka on Drawable-olio
195 * @param shape poistettava kuvio
196 */
197 public void remove(Drawable shape) {
198 this.space.remove(shape);
199 }
200
201 /**
202 * Piirtää paneelin sisällön uudelleen
203 */
204 public void redraw() {
205 repaint(1000L);
206 }
207
208 /**
209 * Antaa paneelin kokonaismuunnosmatriisin
210 * @return paneelin kokonaismuunnosmatriisi
211 */
212 public Matrix getFullTransform() {
213 return tm;
214 }
215
216 /**
217 * Piirtää paneelin sisällön omalla värillään ja muunnosmatriiseillaan
218 * @param g grafiikka johon piirretään
219 */
220 public void paint(Graphics g) {
221 g.setColor(getBackground());
222 g.fillRect(0,0,getWidth(),getHeight());
223 if ( space == null ) return;
224 sm.multiply(a,tm);
225 tm.multiplyThis(rotator);
226 this.space.draw(g, tm);
227 }
228
229 /**
230 * Asettaa paneelin näkyväksi
231 */
232 public void showWindow() {
233 this.setVisible(true);
234 }
235
236 /**
237 * Asettaa isotrooppisuuden päälle/pois
238 * @param isotrophic isotrooppisuus tosi/epätosi
239 */
240 public void setIsotrophic(boolean isotrophic) {
241 this.isotrophic = isotrophic;
242 }
243
244 /**
245 * Asettaa uudelleenskaalauksen kun paneelin kokoa muutetaan päälle/pois
246 * @param allowRescale uudelleenskaalaus tosi/epätosi
247 */
248 public void setAllowRescale(boolean allowRescale) {
249 this.allowRescale = allowRescale;
250 if ( allowRescale ) reScale();
251 }
252
253 /**
254 * Antaa paneelin muunnosmatriisin
255 * @return paneelin muunnosmatriisi
256 */
257 public Matrix getTransform() {
258 return a;
259 }
260
261 }
262