SBlinnMaterial

java.lang.Object
- sim.util.SAbstractReadable
- - sim.util.SAbstractReadableWriteable
  - - sim.graphics.material.SDefaultMaterial
    - - sim.graphics.material.SBlinnMaterial

All Implemented Interfaces:

SMaterial, SReadable, SWriteable

Direct Known Subclasses:

SBlinnTextureMaterial
```
public class SBlinnMaterial
extends SDefaultMaterial
```
La classe SBlinnMaterial représente un matériel ayant une couleur de base et des coefficients de réflexion unique pour l'ensemble des canaux rgb de couleur. Ce matériel possède également des caractéristiques comme le lustrage (shininess), la plasticité, l'indice de réfraction. On y retrouve également un coefficient de réflexion kr et de transmission tr lors de l'usage d'un shader récursif pour une illumination indirecte.

Since:

2015-01-06

Version:

2015-12-05

Author:

Simon Vézina

Field Summary
- Fields inherited from class sim.graphics.material.SDefaultMaterial
  DEFAULT_MATERIAL_NAME

Constructor Summary

Constructors
Constructor and Description
`SBlinnMaterial()` Constructeur d'une matériel avec couleur par défaut.
`SBlinnMaterial(SBufferedReader br)` Constructeur d'un matériel à partir d'information lue dans un fichier de format txt.
`SBlinnMaterial(SColor color)` Constructeur d'un matériel avec une couleur sélectionnée.

Method Summary

All Methods Instance Methods Concrete Methods
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`	`diffuseColor()` Méthode pour obtenir la couleur réfléchie de façon diffuse par la surface 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.
`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.
`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.graphics.material.SDefaultMaterial
ambientColor, asTexture, diffuseColor, equals, getName, isReflective, isTransparent, opacity, specularColor

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

- Constructor Detail
  - SBlinnMaterial
```
public SBlinnMaterial()
```
    Constructeur d'une matériel avec couleur par défaut.
  - SBlinnMaterial
```
public SBlinnMaterial(SColor color)
               throws SConstructorException
```
    Constructeur d'un matériel avec une couleur sélectionnée.
    
    Parameters:
    
    color - - La couleur du matériel.
    
    Throws:
    
    SConstructorException - Si une erreur est survenue lors de la construction.
  - SBlinnMaterial
```
public SBlinnMaterial(SBufferedReader br)
               throws java.io.IOException,
                      SConstructorException
```
    Constructeur d'un matériel à partir d'information lue dans un fichier de format txt.
    
    Parameters:
    
    br - - 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
  - 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
    Specified by:
    
    ambientColor in interface SMaterial
    
    Overrides:
    
    ambientColor in class SDefaultMaterial
    
    Returns:
    
    La couleur de la lumière Sa réfléchie de façon ambiante par la surface.
  - 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
    Specified by:
    
    diffuseColor in interface SMaterial
    
    Overrides:
    
    diffuseColor in class SDefaultMaterial
    
    Returns:
    
    La couleur de la lumière Sd réfléchie de façon diffuse par la surface.
  - 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
    Specified by:
    
    specularColor in interface SMaterial
    
    Overrides:
    
    specularColor in class SDefaultMaterial
    
    Returns:
    
    La couleur de la lumière Ss réfléchie de façon spéculaire par la surface.
  - 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
    
    Overrides:
    
    getShininess in class SDefaultMaterial
    
    Returns:
    
    le niveau de brillance du matériel.
  - 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
    Specified by:
    
    transparencyColor in interface SMaterial
    
    Overrides:
    
    transparencyColor in class SDefaultMaterial
    
    Returns:
    
    La couleur de la lumière St transmise par la surface.
  - 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
    
    Overrides:
    
    reflectivity in class SDefaultMaterial
    
    Returns:
    
    le niveau de réflexion du matériel (0 = 0% réfléchie, 1 = 100% réfléchie).
  - 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
    
    Overrides:
    
    transparency in class SDefaultMaterial
    
    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
    
    Overrides:
    
    refractiveIndex in class SDefaultMaterial
    
    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.
  - 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
    
    Overrides:
    
    write in class SDefaultMaterial
    
    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
  - 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
    
    Overrides:
    
    getReadableName in class SDefaultMaterial
    
    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 SDefaultMaterial
    
    Returns:
    
    Un tableau des mots clés des paramètres.

Class SBlinnMaterial

Field Summary

Fields inherited from class sim.graphics.material.SDefaultMaterial

Constructor Summary

Method Summary

Methods inherited from class sim.graphics.material.SDefaultMaterial

Methods inherited from class sim.util.SAbstractReadableWriteable

Methods inherited from class sim.util.SAbstractReadable

Methods inherited from class java.lang.Object

Constructor Detail

SBlinnMaterial

SBlinnMaterial

SBlinnMaterial

Method Detail

ambientColor

diffuseColor

specularColor

getShininess

transparencyColor

reflectivity

transparency

refractiveIndex

write

getReadableName

getReadableParameterName