sim.geometry.space

Interface SGeometrySpace

All Known Implementing Classes:

SAbstractGeometrySpace, SAbstractVoxelSpace, SLinearSpace, SMultiVoxelSpace, SVoxelSpace

public interface SGeometrySpace

L'interface SGeometrySpace représentant un espace de rengement des géométries. Cet espace permet d'organiser les géométries afin d'effectuer le calculs de l'intersection avec les géométries plus efficacement.

Since:

2015-01-10

Version:

2015-12-29

Author:

Simon Vézina

Method Summary

Modifier and Type	Method and Description
void	addGeometry(java.util.List<SGeometry> list) Méthode qui ajoute une liste de géométries à l'espace.
void	addGeometry(SGeometry geometry) Méthode qui ajoute une géométrie à l'espace.
void	initialize() Méthode pour initialiser l'espace des géométries.
java.util.List<SGeometry>	listInsideGeometry(SVector3d v) Méthode pour obtenir la liste des géométries où la position du vecteur v se retrouve à l'intérieur.
SRay	nearestIntersection(SRay ray, double t_max) Méthode qui évalue l'intersection la plus près entre un rayon et les différentes géométries de l'espace ne dépassant pas un certain temps maximal.
java.util.List<SRay>	nearestOpaqueIntersection(SRay ray, double t_max) Méthode qui évalue l'intersection la plus près entre un rayon et les différentes géométries opaque de l'espace ne dépassant pas un certain temps maximal.

Method Detail

addGeometry

void addGeometry(SGeometry geometry)

Méthode qui ajoute une géométrie à l'espace.

Parameters:

geometry - - La géométrie à ajouter à l'espace.

addGeometry

void addGeometry(java.util.List<SGeometry> list)

Méthode qui ajoute une liste de géométries à l'espace.

Parameters:

list - - La liste de géométries à ajouter à l'espace.

nearestIntersection

SRay nearestIntersection(SRay ray,

                         double t_max)

                  throws SRuntimeException

Méthode qui évalue l'intersection la plus près entre un rayon et les différentes géométries de l'espace ne dépassant pas un certain temps maximal.

Parameters:

ray - - Le rayon à intersecter avec les géométries de l'espace.

t_max - - Le temps maximal.

Returns:

Un nouveau rayon avec les propriétés de l'intersection la plus près ne dépassant pas le temps maximal. Si aucune intersection respectant ces contraintes n'a peut être réalisée, le rayon d'origine sera retourné étant un rayon sans intersection.

Throws:

SRuntimeException - Si le rayon a déjà intersecté une autre géométrie.

SRuntimeException - Si la valeur de t_max est négative.

SRuntimeException - Si l'espace des géométries n'a pas été préalablement initialisé.

nearestOpaqueIntersection

java.util.List<SRay> nearestOpaqueIntersection(SRay ray,

                                               double t_max)

                                        throws SRuntimeException

Méthode qui évalue l'intersection la plus près entre un rayon et les différentes géométries opaque de l'espace ne dépassant pas un certain temps maximal. Une liste des géométries transparentes sera ordonnée en ordre inverse d'apparition (ordre décroissant) et la liste débutera par une géométrie opaque s'il y a eu intersection avec une géométrie opaque.

Parameters:

ray - - Le rayon à intersecter avec les géométries de l'espace.

t_max - - Le temps maximal.

Returns:

Une liste des géométries transparentes intersectées en ordre décroissant débutant par une géométrie opaque s'il y a eu lieu. La liste sera vide s'il n'y a aucune intersection sur le temps maximal.

Throws:

SRuntimeException - Si le rayon a déjà intersecté une autre géométrie.

SRuntimeException - Si la valeur de t_max est négative.

SRuntimeException - Si l'espace des géométries n'a pas été préalablement initialisé.

listInsideGeometry

java.util.List<SGeometry> listInsideGeometry(SVector3d v)

                                      throws SRuntimeException

Méthode pour obtenir la liste des géométries où la position du vecteur v se retrouve à l'intérieur. Si la liste est vide, c'est que le vecteur v se retrouve à l'intérieur d'aucune géométrie.

Parameters:

v - - La position d'un point de l'espace.

Returns:

La liste des géométries où le vecteur v se retrouve à l'intérieur.

Throws:

SRuntimeException - Si l'espace des géométries n'a pas été préalablement initialisé.

initialize

void initialize()

Méthode pour initialiser l'espace des géométries. L'espace ne sera pas opérationnel pour effectuer des tests d'intersection si cette méthode n'est pas activée avant.