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