1   package fi.jyu.mit.graphics;
2   
3   import java.awt.*;
4   
5   /**
6    * Rajapinta kaikille piirtokuvioille
7    * @author Markus Kivioja
8    *
9    */
10  public interface Drawable extends Transformable {
11      
12      /**
13       * Piirtää kuvion annetulla Graphics-oliolla ja muunnosmatriisilla
14       * @param g Graphics-olio
15       * @param A muunnosmatriisi
16       */
17      void draw(Graphics g, Matrix A);
18      
19      /**
20       * Asettaa kuvion värin annetuilla punaisen, vihreän ja sinisen arvoilla
21       * ja palauttaa kuvion itsensä
22       * @param r värin punaisen arvo
23       * @param g värin vihreän arvo
24       * @param b värin sinisen arvo
25       * @return kuvio
26       */
27      Drawable setColor(int r, int g, int b);
28      
29      /**
30       * Asettaa kuvion värin annetuksi Color-olioksi ja paluttaa kuvion itsensä
31       * @param c väri Color-oliona
32       * @return kuvio
33       */
34      Drawable setColor(Color c);
35      
36      /**
37       * Palautetaan väri jota käyteään piirtämiseen
38       * @return kuvion väri
39       */
40      public Color getColor();
41  
42      /**
43       * Asettaa kuvion vanhemmat
44       * @param parent joukko kuvion vanhemmista
45       */
46      void setParent(BasicDrawableCollection parent);
47      
48      /**
49       * Piirtää kuvion uudelleen
50       *
51       */
52      void redraw();
53      
54      /**
55       * Muuntaa kuvion muunosmatriisilla m
56       * @param m matriisi jolla olion nykyinen muunnosmatrisi kerrotaan
57       * @return muutettu matriisi
58       */
59      Drawable transform(Matrix m);
60      
61      /**
62       * Asettaa kuvion uudeksi muunnosmatriisiksi annetun matriisin
63       * @param m uusi muunnosmatriisi
64       * @return palauttaa muunnetun olion
65       */
66      Drawable setTransform(Matrix m);
67  
68      /**
69       * Vaihtaa kuvion muunnosmatriisin annetuksi matriisiksi
70       * @param m uusi muunnosmatriisi
71       */
72      void changeTransform(Matrix m);
73  
74      /**
75       * Skaalaa kuvion annettujen kertoimien mukaan
76       * <pre>
77       *      shape.scale(2, 1, 1); venyttää kuviota kaksinkertaiseksi x-suunnassa
78       * </pre>
79       * @param dx kuvion x-suuntainen kerroin
80       * @param dy kuvion y-suuntainen kerroin
81       * @param dz kuvion z-suuntainen kerroin
82       * @return palauttaa muunnetun olion
83       */
84      Drawable scale(double dx, double dy, double dz);
85  
86      /**
87       * Liikuttaa kuviota, esimerkiksi:
88       * <pre>
89       *     shape.move(0, 1.5, -15);
90       * </pre>
91       * @param sx liikutettava matka x-akselin suunnassa
92       * @param sy liikutettava matka y-akselin suunnassa
93       * @param sz liikutettava matka z-akselin suunnassa
94       * @return palauttaa muunnetun olion
95       */
96      Drawable move(double sx, double sy, double sz);
97  
98      /**
99       * Kiertää kuviota annetun akselin ympäri, esimerkiksi:
100      * <pre>
101      *     shape.rotate(Axis.X, 45.2);
102      * </pre>
103      * @param axis akseli jonka ympäri pyöritetään (Axis.X/Axis.Y/Axis.Z)
104      * @param deg kierrettävän kulman suuruus asteina
105      * @return palauttaa muunnetun olion
106      */
107     Drawable rotate(int axis, double deg);
108 
109 }
110