sim.graphics.material

Class SDefaultMaterial

java.lang.Object

sim.util.SAbstractReadable

sim.util.SAbstractReadableWriteable

sim.graphics.material.SDefaultMaterial

All Implemented Interfaces:

SMaterial, SReadable, SWriteable

Direct Known Subclasses:

SBlinnMaterial, SOpenGLMaterial

public class SDefaultMaterial

extends SAbstractReadableWriteable

implements SMaterial

La classe SDefaultMaterial représente un matériel par défaut. Ce matériel sera blanc, complètement opaque avec des attribues physiques par défaut.

Since:

2015-01-13

Version:

2015-12-14

Author:

Simon Vézina

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_MATERIAL_NAME La constante 'DEFAULT_MATERIAL_NAME' correspond au nom par défaut d'un matériel égal à "none".

Constructor Summary

Constructors

Constructor and Description
SDefaultMaterial() Constructeur d'un matérial par défaut avec un nom par défaut.
SDefaultMaterial(SBufferedReader sbr) Constructeur d'un matériel à partir d'information lue dans un fichier de format txt.
SDefaultMaterial(java.lang.String material_name) Constructeur d'un matériel avec un nom de référence.

Method Summary

Modifier and Type	Method and Description
SColor	ambientColor() Méthode pour obtenir la couleur réfléchie de façon ambiante par la surface du matériel.
SColor	ambientColor(SVectorUV uv) Méthode pour obtenir la couleur réfléchie de façon ambiante par la surface du matériel à partir d'une coordonnée uv d'une texture.
boolean	asTexture() Méthode permettant de préciser si le matétiel contient des textures dans sa définition.
SColor	diffuseColor() Méthode pour obtenir la couleur réfléchie de façon diffuse par la surface du matériel.
SColor	diffuseColor(SVectorUV uv) Méthode pour obtenir la couleur réfléchie de façon diffuse par la surface du matériel à partir d'une coordonnée uv d'une texture.
boolean	equals(java.lang.Object other)
java.lang.String	getName() Méthode pour obtenir le nom du matériel.
java.lang.String	getReadableName() Méthode pour obtenir le nom de l'objet implémentant l'interface SReadable.
java.lang.String[]	getReadableParameterName() Méthode pour obtenir un tableau des mots clés permettant de définir les paramètres de l'objet implémentant l'interface SReadable lors de sa lecture.
double	getShininess() Méthode pour obtenir le niveau de brillance de la surface du matériel.
boolean	isReflective() Méthode qui détermine si le matériel réfléchi la lumière comme un miroir.
boolean	isTransparent() Méthode qui détermine si le matériel est transparent.
double	opacity() Méthode pour obtenir le niveau d'opacité de la surface du matériel.
double	reflectivity() Méthode pour obtenir le niveau de réflexion d'une source de lumière par la surface du matériel.
double	refractiveIndex() Méthode pour obtenir l'indice de réfraction du matériel.
SColor	specularColor() Méthode pour obtenir la couleur réfléchie de façon spéculaire par la surface du matériel.
SColor	specularColor(SVectorUV uv) Méthode pour obtenir la couleur réfléchie de façon spéculaire par la surface du matériel à partir d'une coordonnée uv d'une texture.
double	transparency() Méthode pour obtenir le niveau de transparence de la surface du matériel.
SColor	transparencyColor() Méthode pour obtenir la couleur transmise (filtrée) par la surface du matériel.
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 sim.util.SAbstractReadableWriteable

write

Methods inherited from class sim.util.SAbstractReadable

read

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MATERIAL_NAME

public static final java.lang.String DEFAULT_MATERIAL_NAME

La constante 'DEFAULT_MATERIAL_NAME' correspond au nom par défaut d'un matériel égal à "none".

See Also:

Constant Field Values

Constructor Detail

SDefaultMaterial

public SDefaultMaterial()

Constructeur d'un matérial par défaut avec un nom par défaut.

SDefaultMaterial

public SDefaultMaterial(java.lang.String material_name)

                 throws SConstructorException

Constructeur d'un matériel avec un nom de référence. Ce nom sera utilisé comme référence lors d'une affectation d'un matériel à une primitive.

Parameters:

material_name - - Le nom du matériel.

Throws:

SConstructorException - Si une erreur est survenue lors de la construction.

SDefaultMaterial

public SDefaultMaterial(SBufferedReader sbr)

                 throws java.io.IOException,

                        SConstructorException

Constructeur d'un matériel à partir d'information lue dans un fichier de format txt.

Parameters:

sbr - - Le BufferedReader cherchant l'information dans le fichier txt.

Throws:

java.io.IOException - Si une erreur de l'objet SBufferedWriter est lancée.

SConstructorException - Si une erreur est survenue lors de la construction.

See Also:

SBufferedReader

Method Detail

getName

public java.lang.String getName()

Description copied from interface: SMaterial

Méthode pour obtenir le nom du matériel.

Specified by:

getName in interface SMaterial

Returns:

Le nom du matériel.

ambientColor

public SColor ambientColor()

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon ambiante par la surface du matériel. Cette couleur peut être calculée à partir du produit de la couleur de la surface S avec la constant de réflexion ambiant ka tel que

Sa = ka*S.

Specified by:

ambientColor in interface SMaterial

Returns:

La couleur de la lumière Sa réfléchie de façon ambiante par la surface.

ambientColor

public SColor ambientColor(SVectorUV uv)

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon ambiante par la surface du matériel à partir d'une coordonnée uv d'une texture. S'il n'y a pas de texture en mémoire ou que cette méthode est non définie par le matériel, la couleur retournée sera celle de la méthode ambiantColor().

Specified by:

ambientColor in interface SMaterial

Parameters:

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

Returns:

La couleur de réflexion ambiante de la texture (si elle est disponible).

diffuseColor

public SColor diffuseColor()

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon diffuse par la surface du matériel. Cette couleur peut être calculée à partir du produit de la couleur de la surface S avec la constant de réflexion diffuse kb tel que

Sd = kd*S.

Specified by:

diffuseColor in interface SMaterial

Returns:

La couleur de la lumière Sd réfléchie de façon diffuse par la surface.

diffuseColor

public SColor diffuseColor(SVectorUV uv)

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon diffuse par la surface du matériel à partir d'une coordonnée uv d'une texture. S'il n'y a pas de texture en mémoire ou que cette méthode est non définie par le matériel, la couleur retournée sera celle de la méthode diffuseColor().

Specified by:

diffuseColor in interface SMaterial

Parameters:

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

Returns:

La couleur de réflexion diffuse de la texture (si elle est disponible).

specularColor

public SColor specularColor()

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon spéculaire par la surface du matériel. Cette couleur peut être calculée à partir du produit de la couleur de la surface S avec la constant de réflexion spéculaire ks tel que

Ss = ks*S.

Specified by:

specularColor in interface SMaterial

Returns:

La couleur de la lumière Ss réfléchie de façon spéculaire par la surface.

specularColor

public SColor specularColor(SVectorUV uv)

Description copied from interface: SMaterial

Méthode pour obtenir la couleur réfléchie de façon spéculaire par la surface du matériel à partir d'une coordonnée uv d'une texture. S'il n'y a pas de texture en mémoire ou que cette méthode est non définie par le matériel, la couleur retournée sera celle de la méthode specularColor().

Specified by:

specularColor in interface SMaterial

Parameters:

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

Returns:

La couleur de réflexion speculaire de la texture (si elle est disponible).

transparencyColor

public SColor transparencyColor()

Description copied from interface: SMaterial

Méthode pour obtenir la couleur transmise (filtrée) par la surface du matériel. Elle permet de faire des calculs de filtrage de la lumière.

Par exemple, une couleur de transparence (1,1,1) fait tout traverser, une couleur de transparence (0.8, 0.8, 0.8) fait tout traverser avec atténuation et une couleur de transparence (1,0,0) fait uniquement traverser la couleur rouge.

Cette couleur est calculée à partir du produit de la couleur de la surface S avec la constant de transmission kt tel que

St = kt*S.

Specified by:

transparencyColor in interface SMaterial

Returns:

La couleur de la lumière St transmise par la surface.

isReflective

public boolean isReflective()

Description copied from interface: SMaterial

Méthode qui détermine si le matériel réfléchi la lumière comme un miroir.

Specified by:

isReflective in interface SMaterial

Returns:

true si le matériel est réfléchissant et false sinon.

reflectivity

public double reflectivity()

Description copied from interface: SMaterial

Méthode pour obtenir le niveau de réflexion d'une source de lumière par la surface du matériel.

Specified by:

reflectivity in interface SMaterial

Returns:

le niveau de réflexion du matériel (0 = 0% réfléchie, 1 = 100% réfléchie).

getShininess

public double getShininess()

Description copied from interface: SMaterial

Méthode pour obtenir le niveau de brillance de la surface du matériel.

Specified by:

getShininess in interface SMaterial

Returns:

le niveau de brillance du matériel.

isTransparent

public boolean isTransparent()

Description copied from interface: SMaterial

Méthode qui détermine si le matériel est transparent.

Specified by:

isTransparent in interface SMaterial

Returns:

true si le matériel est transparent et false sinon.

transparency

public double transparency()

Description copied from interface: SMaterial

Méthode pour obtenir le niveau de transparence de la surface du matériel.

Specified by:

transparency in interface SMaterial

Returns:

le niveau de transparence du matériel (0 = 0% transparent, 1 = 100% transparent).

refractiveIndex

public double refractiveIndex()

Description copied from interface: SMaterial

Méthode pour obtenir l'indice de réfraction du matériel.

Specified by:

refractiveIndex in interface SMaterial

Returns:

L'indice de réfraction du matériel. Cependant, si le matériel est opaque, l'indice de réfraction sera automatiquement égale à 1.0.

opacity

public double opacity()

Description copied from interface: SMaterial

Méthode pour obtenir le niveau d'opacité de la surface du matériel. Cette valeur correspond à l'inverse de la transparence. La somme de la transparence kt avec l'opacité ko donne 1 (kt + ko = 1).

Specified by:

opacity in interface SMaterial

Returns:

le niveau d'opacité du matériel (0 = 0% opaque, 1 = 100% opaque).

asTexture

public boolean asTexture()

Description copied from interface: SMaterial

Méthode permettant de préciser si le matétiel contient des textures dans sa définition.

Specified by:

asTexture in interface SMaterial

Returns:

true si le matériel est défini avec des textures et false sinon.

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

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

getReadableName

public java.lang.String getReadableName()

Description copied from interface: SReadable

Méthode pour obtenir le nom de l'objet implémentant l'interface SReadable. Ce nom correspond également au mot clé à rechercher lors d'une lecture avec un SBufferedReader pour en faire la construction de l'objet en question.

Specified by:

getReadableName in interface SReadable

Returns:

Le nom de l'objet lisible.

getReadableParameterName

public java.lang.String[] getReadableParameterName()

Description copied from interface: SReadable

Méthode pour obtenir un tableau des mots clés permettant de définir les paramètres de l'objet implémentant l'interface SReadable lors de sa lecture.

Specified by:

getReadableParameterName in interface SReadable

Overrides:

getReadableParameterName in class SAbstractReadable

Returns:

Un tableau des mots clés des paramètres.