fi.jyu.mit.graphics

Class Matrix

java.lang.Object

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

Fields

Modifier and Type	Field and Description
protected static int	VSIZE

Constructor Summary

Constructors

Constructor and Description
Matrix() Luo uuden 4x4 yksikkömatriin
Matrix(Matrix M) Luo kopion matriisista M

Method Summary

Methods

Modifier and Type	Method and Description
Vector	column(int s) Palauttaa matriisin s:n sarakkeen kopion
Matrix	getInversion() Laskee tämän matriisin käänteismatriisin Gaussin eliminointimenetelmällä ja palauttaa sen.
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ä
Matrix	multiplyThis(Matrix b, double[] row) 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
void	setColumn(int s, Vector v) Asettaa tämän matriisin annetuksi sarakkeeksi annetun vektorin
void	setRow(int r, Vector v) Asettaa tämän matriisin annetuksi riviksi annetun vektorin
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.
RPoint	transform(Vector b, RPoint iy) Kertoo vektorin tällä matriisilla ja sijoittaa tuloksen näyttökoordinaattiin iy.
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.
RPoint	transformR(RPoint p) Muuntaa pisteen p näytön pisteeksi.

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

setRow

public void setRow(int r,
          Vector v)

Asettaa tämän matriisin annetuksi riviksi annetun vektorin

Parameters:

r - muutettava rivi

v - vektori joka asetetaan tämän matriisin riviksi

setColumn

public void setColumn(int s,
             Vector v)

Asettaa tämän matriisin annetuksi sarakkeeksi annetun vektorin

Parameters:

s - muutettava sarake

v - vektori joka asetetaan tämän matriisin sarakkeeksi

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

multiplyThis

public Matrix multiplyThis(Matrix b,
                  double[] row)

Kertoo matriisin b matriisilla ja laittaa tuloksen itseensä

Parameters:

b - matriisi joka kerrotaan

row - lakun avuksi tuotava 4 paikkainen taulukko

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 RPoint transform(Vector b,
               RPoint 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.

transformR

public RPoint transformR(RPoint p)

Muuntaa pisteen p näytön pisteeksi.

Parameters:

p - muunettava piste.

Returns:

uusi näytönpiste joka vastaa pistettä p.

getInversion

public Matrix getInversion()

Laskee tämän matriisin käänteismatriisin Gaussin eliminointimenetelmällä ja palauttaa sen. (Menetelmä on hidas suurilla VSIZE-muuttujan arvoilla)

Returns:

inversion, tämän matriisin käänteismatriisi

toString

public String toString()

Palauttaa tämän matrisiin merkkijonona

Overrides:

toString in class Object

Returns:

tämä matriisi merkkijonona