| Drawable.java |
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