sim.math

Class SVectorUV

java.lang.Object

sim.math.SVectorUV

All Implemented Interfaces:

SVector, SWriteable

public class SVectorUV
extends java.lang.Object
implements SVector

La classe SVectorUV représentante une coordonnée uv associée habituellement à une texture. Ce vecteur possède une composante u et v et sont habituellement situé dans l'intervalle [0.0 , 1.0]. Si ce n'est pas le cas, il est important de les recadrer les coordonnées uv à une valeur dans l'intervalle [0,1].

Pour ce faire, il y a deux algorithmes possibles :

Repeat : Effectue une répétition de la coordonnée de droite à gauche et de bas à haut (si dépassement positif).

Clamp : Coupe la coordonnée après dépassement (u > 1 ==> u = 1, u < 0 ==> u = 0).

Since:

2015-09-15

Version:

2015-10-24

Author:

Simon Vezina

Field Summary

Fields

Modifier and Type	Field and Description
static int	CLAMP La constante 'CLAMP' définit le choix de recadrer une coordonnée uv à l'extérieur de l'intervalle [0,1] à l'aide d'un arrêt des coordonnées uv.
static int	REPEAT La constante 'REPEAT' définit le choix de recadrer une coordonnée uv à l'extérieur de l'intervalle [0,1] à l'aide d'une répétition des coordonnées uv.

Constructor Summary

Constructors

Constructor and Description
SVectorUV() Constructeur représentant une coordonnée uv à l'origine.
SVectorUV(double u, double v) Constructeur d'une coordonnée uv quelconque.
SVectorUV(java.lang.String string) Constructeur d'un vecteur uv en utilisant un string décrivant les paramètres u et v du vecteur uv.

Method Summary

Modifier and Type	Method and Description
SVector	add(SVector v) Méthode permettant d'effectuer l'addition mathématique entre deux vecteurs.
SVectorUV	add(SVectorUV uv) Méthode pour effectuer l'addition avec une coordonnée uv.
boolean	equals(java.lang.Object obj)
SVectorUV	getInBound() Méthode qui permet d'obtenir un vecteur uv cadré dans l'intervalle [0,1] à l'aide de l'algoritme de répétition (REPEAT).
SVectorUV	getInBound(int crop_code) Méthode qui permet d'obtenir un vecteur uv cadré dans l'intervalle [0,1] à l'aide d'un algoritme particulier.
double	getU() Méthode pour obtenir la composante u de la coordonnée uv.
double	getV() Méthode pour obtenir la composante v de la coordonnée uv.
int	hashCode()
boolean	isOutOfBound() Méthode pour déterminer si la coordonnée uv possède une composante dont la valeur est à l'extérieur de l'intervalle [0,1].
SVectorUV	multiply(double cst) Méthode pour effectuer la multiplication par un scalaire d'une constante avec la coordonnée uv lançant l'appel de la méthode.
java.lang.String	toString()
void	write(java.io.BufferedWriter bw) Méthode pour écrire un objet SWriteable dans un fichier txt en utilisant un BufferedWriter.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

REPEAT

public static final int REPEAT

La constante 'REPEAT' définit le choix de recadrer une coordonnée uv à l'extérieur de l'intervalle [0,1] à l'aide d'une répétition des coordonnées uv.

Par exemple :

si u = 1.23, alors la coordonnée recadrée par répétition donnera u = 0.23.

si u = -2.8, alors la coordonnée recadrée par répétition donnera u = 0.2.

See Also:

Constant Field Values

CLAMP

public static final int CLAMP

La constante 'CLAMP' définit le choix de recadrer une coordonnée uv à l'extérieur de l'intervalle [0,1] à l'aide d'un arrêt des coordonnées uv.

Par exemple :

si u = 1.23, alors la coordonnée recadrée par répétition donnera u = 1.0

si u = -2.8, alors la coordonnée recadrée par répétition donnera u = 0.0.

See Also:

Constant Field Values

Constructor Detail

SVectorUV

public SVectorUV()

Constructeur représentant une coordonnée uv à l'origine.

SVectorUV

public SVectorUV(double u,
                 double v)
          throws SConstructorException

Constructeur d'une coordonnée uv quelconque.

Parameters:

u - - La composante u de la coordonnée uv.

v - - La composante v de la coordonnée uv.

Throws:

SConstructorException

SVectorUV

public SVectorUV(java.lang.String string)
          throws SReadingException

Constructeur d'un vecteur uv en utilisant un string décrivant les paramètres u et v du vecteur uv. Une lecture autorisée peut prendre la forme suivante : "double u" "double v" (incluant la notation avec , ( ) [ ] comme délimieur dans l'expression du string comme par exemple (2.3, 4.3) ).

Parameters:

string - - Le string de l'expression du vecteur en paramètres u et v.

Throws:

SReadingException - Si le format de la lecture n'est pas adéquat.

Method Detail

isOutOfBound

public boolean isOutOfBound()

Méthode pour déterminer si la coordonnée uv possède une composante dont la valeur est à l'extérieur de l'intervalle [0,1].

Returns:

true s'il y a une composante à l'extérieur de l'intervalle et false sinon.

getU

public double getU()

Méthode pour obtenir la composante u de la coordonnée uv.

Returns:

La composante u de la coordonnée uv.

getV

public double getV()

Méthode pour obtenir la composante v de la coordonnée uv.

Returns:

La composante v de la coordonnée uv.

getInBound

public SVectorUV getInBound()

Méthode qui permet d'obtenir un vecteur uv cadré dans l'intervalle [0,1] à l'aide de l'algoritme de répétition (REPEAT).

Returns:

Le vecteur uv recadré (si nécessaire) par l'algorithme de répétition.

getInBound

public SVectorUV getInBound(int crop_code)
                     throws SRuntimeException

Méthode qui permet d'obtenir un vecteur uv cadré dans l'intervalle [0,1] à l'aide d'un algoritme particulier.

Parameters:

crop_code - - Le code de l'algorithme

Returns:

Le vecteur uv recadré (si nécessaire).

Throws:

SRuntimeException - Si le code de recadrement n'est pas reconnu par le système.

add

public SVector add(SVector v)
            throws SRuntimeException

Description copied from interface: SVector

Méthode permettant d'effectuer l'addition mathématique entre deux vecteurs.

Specified by:

add in interface SVector

Parameters:

v - - Le vecteur à additionner

Returns:

Le vecteur résultat de l'addition des deux vecteurs.

Throws:

SRuntimeException

add

public SVectorUV add(SVectorUV uv)

Méthode pour effectuer l'addition avec une coordonnée uv.

Parameters:

uv - - La coordonnée uv à additionner.

Returns:

La coordonnée uv résultant de l'addition.

multiply

public SVectorUV multiply(double cst)

Méthode pour effectuer la multiplication par un scalaire d'une constante avec la coordonnée uv lançant l'appel de la méthode.

Specified by:

multiply in interface SVector

Parameters:

cst - - La constante à multiplier.

Returns:

La coordonnée uv résultant de la multiplication par un scalaire.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

write

public void write(java.io.BufferedWriter bw)
           throws java.io.IOException

Description copied from interface: SWriteable

Méthode pour écrire un objet SWriteable dans un fichier txt en utilisant un BufferedWriter.

Specified by:

write in interface SWriteable

Parameters:

bw - - Le buffer pour l'écriture.

Throws:

java.io.IOException - Si une erreur de type I/O a été lancée par l'objet BufferedWriter.

See Also:

BufferedWriter

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object