fi.jyu.mit.graphics
Class Matrix

java.lang.Object
  extended by fi.jyu.mit.graphics.Matrix
Direct Known Subclasses:
RotMatrix, ScaleMatrix, TMatrix, TranslateMatrix

public class Matrix
extends Object

Matriisliluokka kuvamuunnoslaskuihin.

Author:
Markus Kivioja, Vesa Lappalainen

Field Summary
protected static int VSIZE
           
 
Constructor Summary
Matrix()
          Luo uuden 4x4 yksikkömatriin
Matrix(Matrix M)
          Luo kopion matriisista M
 
Method Summary
 Vector column(int s)
          Palauttaa matriisin s:n sarakkeen kopion
protected  void ident()
          Muuttaa matriisin yksikkömatriisiksi
 double m(int r, int s)
          Palauttaa matriisin alkion paikassa r,s
 Matrix multiply(Matrix b)
          Kertoo matriisin b matriisilla ja palauttaa uuden matriisin tuloksena
 Matrix multiply(Matrix b, Matrix c)
          Kertoo matriisin b matriisilla ja palauttaa uuden matriisin tuloksena.
 Vector multiply(Vector b)
          Kertoo vektorin tällä matriisilla, luo uuden paluuvektorin
 Vector multiply(Vector b, Vector y)
          Kertoo vektorin tällä matriisilla ja tuloksen vektoriin y
 Matrix multiplyThis(Matrix b)
          Kertoo matriisin b matriisilla ja laittaa tuloksen itseensä
 Vector row(int r)
          Palauttaa matriisin r:n rivin kopion
protected  void set(int r, int s, double d)
          Asettaa matriisin paikassa r,s olevan alkion
 String toString()
          Palauttaa tämän matrisiin merkkijonona
 SPoint transform(double x, double y, double z)
          Muuntaa koordinaatin (x,y,z) näytön pisteeksi.
 SPoint transform(double x, double y, double z, Vector vr, SPoint sp)
          Muuntaa koordinaatin (x,y,z) näytön pisteeksi.
 Vector transform(double x, double y, double z, Vector vr, Vector sp)
          Muuntaa koordinaatin (x,y,z) näytön pisteeksi.
 SPoint transform(RPoint p)
          Muuntaa pisteen p näytön pisteeksi.
 SPoint transform(Vector b, SPoint iy)
          Kertoo vektorin tällä matriisilla ja sijoittaa tuloksen näyttökoordinaattiin iy.
 Vector transform(Vector b, Vector iy)
          Kertoo vektorin tällä matriisilla ja sijoittaa tuloksen näyttökoordinaattiin iy.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

VSIZE

protected static final int VSIZE
See Also:
Constant Field Values
Constructor Detail

Matrix

public Matrix()
Luo uuden 4x4 yksikkömatriin


Matrix

public Matrix(Matrix M)
Luo kopion matriisista M

Parameters:
M - matriisi josta kopio luodaan
Method Detail

ident

protected final void ident()
Muuttaa matriisin yksikkömatriisiksi


row

public Vector row(int r)
Palauttaa matriisin r:n rivin kopion

Parameters:
r - palautettava rivi
Returns:
r:n rivin kopio

column

public Vector column(int s)
Palauttaa matriisin s:n sarakkeen kopion

Parameters:
s - palautettava sarake
Returns:
s:n sarakkeen kopio

m

public double m(int r,
                int s)
Palauttaa matriisin alkion paikassa r,s

Parameters:
r - rivi jolta alkio halutaan
s - sarake jolta alkio halutaan
Returns:
r,s paikassa oleva alkio

set

protected void set(int r,
                   int s,
                   double d)
Asettaa matriisin paikassa r,s olevan alkion

Parameters:
r - rivi jonka alkio asetetaan
s - sarake jonka alkio asetetaan
d - uusi arvo alkiolle

multiply

public Matrix multiply(Matrix b)
Kertoo matriisin b matriisilla ja palauttaa uuden matriisin tuloksena

Parameters:
b - matriisi joka kerrotaan
Returns:
uusi matriisi this * b

multiply

public Matrix multiply(Matrix b,
                       Matrix c)
Kertoo matriisin b matriisilla ja palauttaa uuden matriisin tuloksena. this eikä b ei saa olla c!

Parameters:
b - matriisi joka kerrotaan
c - matriisi johon tulos tulee
Returns:
uusi matriisi this * b

multiplyThis

public Matrix multiplyThis(Matrix b)
Kertoo matriisin b matriisilla ja laittaa tuloksen itseensä

Parameters:
b - matriisi joka kerrotaan
Returns:
this * b

multiply

public Vector multiply(Vector b)
Kertoo vektorin tällä matriisilla, luo uuden paluuvektorin

Parameters:
b - vektori joka kerrotaan
Returns:
this * b

multiply

public Vector multiply(Vector b,
                       Vector y)
Kertoo vektorin tällä matriisilla ja tuloksen vektoriin y

Parameters:
b - vektori joka kerrotaan
y - vektori johon tulos tulee
Returns:
this * b

transform

public SPoint transform(Vector b,
                        SPoint iy)
Kertoo vektorin tällä matriisilla ja sijoittaa tuloksen näyttökoordinaattiin iy. Spesiaalikertominen erityisesti kuvamuunnoksiin, joissa tarvitaan vain 2 ensimmäistä alkiota vektorista iy.

Parameters:
b - vektori joka kerrotaan
iy - vektori johon tulos tulee
Returns:
this * b

transform

public Vector transform(Vector b,
                        Vector iy)
Kertoo vektorin tällä matriisilla ja sijoittaa tuloksen näyttökoordinaattiin iy. Spesiaalikertominen erityisesti kuvamuunnoksiin, joissa tarvitaan vain 2 ensimmäistä alkiota vektorista iy.

Parameters:
b - vektori joka kerrotaan
iy - vektori johon tulos tulee
Returns:
this * b

transform

public SPoint transform(double x,
                        double y,
                        double z)
Muuntaa koordinaatin (x,y,z) näytön pisteeksi.

Parameters:
x -
y -
z -
Returns:
uusi näytön piste joka edustaa (x,y,z)

transform

public SPoint transform(double x,
                        double y,
                        double z,
                        Vector vr,
                        SPoint sp)
Muuntaa koordinaatin (x,y,z) näytön pisteeksi. "Optimoitu" versio, jolle viedään työtilat parametrina.

Parameters:
x -
y -
z -
vr - vektori johon saa sijoittaa väliaikaisesti (x,y,z)
sp - näytön piste johon tuloksen saa sijoittaa.
Returns:
parametrina tuotu näytön piste joka edustaa (x,y,z)

transform

public Vector transform(double x,
                        double y,
                        double z,
                        Vector vr,
                        Vector sp)
Muuntaa koordinaatin (x,y,z) näytön pisteeksi. "Optimoitu" versio, jolle viedään työtilat parametrina.

Parameters:
x -
y -
z -
vr - vektori johon saa sijoittaa väliaikaisesti (x,y,z)
sp - näytön piste johon tuloksen saa sijoittaa.
Returns:
parametrina tuotu näytön piste joka edustaa (x,y,z)

transform

public SPoint transform(RPoint p)
Muuntaa pisteen p näytön pisteeksi.

Parameters:
p - muunettava piste.
Returns:
uusi näytönpiste joka vastaa pistettä p.

toString

public String toString()
Palauttaa tämän matrisiin merkkijonona

Overrides:
toString in class Object
Returns:
tämä matriisi merkkijonona