sim.graphics

Class STexture

java.lang.Object

sim.graphics.STexture

public class STexture
extends java.lang.Object

La classe STexture représente une texture de couleur. Cette classe permet de mettre en mémoire une image et accéder aux différents pixels de couleur de l'image en coordonnée texture (u,v) tel que u et v est compris entre 0.0 et 1.0. Les formats d'image supportés sont : gif, png, jpeg (jpg), tga

Since:

2015-09-13

Version:

2016-01-08

Author:

Simon Vézina

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_FILE_NAME La constante 'DEFAULT_FILE_NAME' correspond à un nom de fichier pour une texture par défaut ne pouvant être lu.
static int	ORIGIN_UV_BOTTOM_LEFT
static int	ORIGIN_UV_TOP_LEFT
static int	UV_DEFAULT
static java.lang.String[]	UV_FORMAT

Constructor Summary

Constructors

Constructor and Description
STexture(STexture texture) Copie constructeur d'une texture.
STexture(java.lang.String file_name, java.awt.image.BufferedImage image) Constructeur d'une texture de couleur en prenant le coin supérieur gauche d'une image comme origine de la coordonnée uv de texture.
STexture(java.lang.String file_name, java.awt.image.BufferedImage image, int uv_format) Constructeur d'une texture de couleur.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.lang.String	getFileName() Méthode pour obtenir le nom du fichier de la texture.
SColor	getSColor(SVectorUV uv) Méthode pour obtenir la couleur d'une coordonnée uv de la texture.
void	setUVFormat(int uv_format) Méthode pour modifier le format d'interprétation des coordonnées uv de la texture.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UV_FORMAT

public static final java.lang.String[] UV_FORMAT

UV_DEFAULT

public static final int UV_DEFAULT

See Also:

Constant Field Values

ORIGIN_UV_TOP_LEFT

public static final int ORIGIN_UV_TOP_LEFT

See Also:

Constant Field Values

ORIGIN_UV_BOTTOM_LEFT

public static final int ORIGIN_UV_BOTTOM_LEFT

See Also:

Constant Field Values

DEFAULT_FILE_NAME

public static final java.lang.String DEFAULT_FILE_NAME

La constante 'DEFAULT_FILE_NAME' correspond à un nom de fichier pour une texture par défaut ne pouvant être lu. Une texture portant le nom de "none" ne peut pas être chargée en mémoire.

See Also:

Constant Field Values

Constructor Detail

STexture

public STexture(java.lang.String file_name,
                java.awt.image.BufferedImage image)
         throws SConstructorException

Constructeur d'une texture de couleur en prenant le coin supérieur gauche d'une image comme origine de la coordonnée uv de texture.

Parameters:

file_name - - Le nom du fichier.

image - - ...

Throws:

SConstructorException - S'il y a eu une erreur lors de la lecture empêchant la construction de la texture.

STexture

public STexture(java.lang.String file_name,
                java.awt.image.BufferedImage image,
                int uv_format)
         throws SConstructorException

Constructeur d'une texture de couleur.

Parameters:

file_name - - Le nom du fichier.

uv_format - - Le code de référence de l'interprétation des coordonnée uv de texture.

Throws:

SConstructorException - Si le code de référence de l'interprétation des coordonnées uv de texture n'est pas reconnu par le système.

SConstructorException - Si à la construction, on utilise le format 'UV_DEFAULT', car il faut obligatoirement spécifier un format.

STexture

public STexture(STexture texture)

Copie constructeur d'une texture. La copie de cette texture fera une copie de la référence au BufferedImage de la texture à copier. Ainsi, une modification au BufferedImage influencera également l'ensemble des BufferedImage des autres copies.

L'intérêt de cette copie permettra de modifier personnellement le paramètre uv_coordinate_format par la méthode setUVFormat(...) ce qui permettra d'interpréter individuellement les coordonnées des textures pour chaque usage différent d'une même texture.

Parameters:

texture - - La texture à copier.

Method Detail

getFileName

public java.lang.String getFileName()

Méthode pour obtenir le nom du fichier de la texture.

Returns:

Le nom du fichier de la texture.

getSColor

public SColor getSColor(SVectorUV uv)
                 throws SRuntimeException

Méthode pour obtenir la couleur d'une coordonnée uv de la texture.

Parameters:

uv - - La coordonnée uv de la texture.

Returns:

La couleur en coordonnée uv de la texture.

Throws:

SRuntimeException - Si le code d'interprétation de l'origine de la coordonnée de texture uv est mal définie.

setUVFormat

public void setUVFormat(int uv_format)
                 throws SRuntimeException

Méthode pour modifier le format d'interprétation des coordonnées uv de la texture. Si le format utilisé est STexture.UV_DEFAULT, il n'y aura aucun changement, car le format par défaut est celui désigné lors de la construction de la texture.

Parameters:

uv_format - - Le code du format d'interprétation des coordonnées uv de la texture.

Throws:

SRuntimeException - Si le code du format d'interprétation n'est pas reconnu par le système.

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object