sim.graphics

Class SViewFrustum

java.lang.Object

sim.graphics.SViewFrustum

public class SViewFrustum

extends java.lang.Object

Classe qui représente la pyramide de vue associé au rendu à générer. L'orientation de la pyramide de vue dépend de la position et l'orientation d'une camera. La géométrie de la pyramide vue est exprimé dans l'espace des primitives de la scène.

Since:

2014-12-28

Version:

2015-07-16

Author:

Simon Vézina

Field Summary

Fields

Modifier and Type	Field and Description
static int	BOTTOM_LEFT_PIXEL
static int	BOTTOM_RIGHT_PIXEL
static int	CENTER_PIXEL
static java.lang.String[]	PIXEL_COORDINATE
static int	RANDOM_PIXEL
static int	TOP_LEFT_PIXEL
static int	TOP_RIGHT_PIXEL

Constructor Summary

Constructors

Constructor and Description
SViewFrustum(SCamera camera, SViewport viewport) Constructeur d'une pyramide de vue.
SViewFrustum(SCamera camera, SViewport viewport, int pixel_coordonate_code) Constructeur d'une pyramide de vue.

Method Summary

Modifier and Type	Method and Description
SVector3d	getCameraPosition() Méthode pour obtenir la position de la camera associée à cette pyramide de vue (view frustum).
int	getPixelInternalCoordinate() Méthode pour obtenir le code associé à la coordonnée interne du pixel qui sera calculé par la pyramide de vue à partir d'une coordonnée pixel de l'écran de vue.
static void	main(java.lang.String[] args)
static void	test1() Test #1 : Test pour vérifier la fonctionnalité du calcul de la position d'un pixel dans l'espace du view frustum.
SVector3d	viewportToViewFrustum(int x, int y) Méthode pour retourner la position d'un pixel de coordonnée xy dans le Viewport dans le référentiel du ViewFrustum en coordonnée xyz.
SVector3d	viewportToViewFrustum(int x, int y, int pixel_code_coordinate) Méthode pour retourner la position d'un pixel de coordonnée xy dans le Viewport dans le référentiel du ViewFrustum en coordonnée xyz.
SVector3d	viewportToViewFrustum(SVectorPixel p) Méthode pour retourner la position d'un pixel du Viewport dans le référentiel du ViewFrustum en coordonnée xyz.

Methods inherited from class java.lang.Object

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

Field Detail

PIXEL_COORDINATE

public static final java.lang.String[] PIXEL_COORDINATE

TOP_LEFT_PIXEL

public static final int TOP_LEFT_PIXEL

See Also:

Constant Field Values

TOP_RIGHT_PIXEL

public static final int TOP_RIGHT_PIXEL

See Also:

Constant Field Values

BOTTOM_LEFT_PIXEL

public static final int BOTTOM_LEFT_PIXEL

See Also:

Constant Field Values

BOTTOM_RIGHT_PIXEL

public static final int BOTTOM_RIGHT_PIXEL

See Also:

Constant Field Values

CENTER_PIXEL

public static final int CENTER_PIXEL

See Also:

Constant Field Values

RANDOM_PIXEL

public static final int RANDOM_PIXEL

See Also:

Constant Field Values

Constructor Detail

SViewFrustum

public SViewFrustum(SCamera camera,

                    SViewport viewport)

             throws SConstructorException

Constructeur d'une pyramide de vue.

Parameters:

camera - - La camera de la scène.

viewport - - Le viewport où sera effectué le rendu de la scène.

Throws:

SConstructorException - S'il y a eu une erreur lors de la construction de la pyramide de vue.

SViewFrustum

public SViewFrustum(SCamera camera,

                    SViewport viewport,

                    int pixel_coordonate_code)

             throws SConstructorException

Constructeur d'une pyramide de vue.

Parameters:

camera - - La camera de la scène.

viewport - - Le viewport où sera effectué le rendu de la scène.

pixel_coordonate_code - - Le code identifiant la coordonnée sélectionnée à l'intérieur d'un pixel.

Throws:

SConstructorException - S'il y a eu une erreur lors de la construction de la pyramide de vue.

Method Detail

getCameraPosition

public SVector3d getCameraPosition()

Méthode pour obtenir la position de la camera associée à cette pyramide de vue (view frustum).

Returns:

la pointe de la pyramide de vue correspondant à la position de la caméra.

getPixelInternalCoordinate

public int getPixelInternalCoordinate()

Méthode pour obtenir le code associé à la coordonnée interne du pixel qui sera calculé par la pyramide de vue à partir d'une coordonnée pixel de l'écran de vue.

Returns:

le code de référence de la coordonée interne d'un pixel.

viewportToViewFrustum

public SVector3d viewportToViewFrustum(SVectorPixel p)

                                throws SRuntimeException

Méthode pour retourner la position d'un pixel du Viewport dans le référentiel du ViewFrustum en coordonnée xyz. Ce pixel sera situé sur le front clipping plane.

Parameters:

p - - La coordonnée du pixel.

Returns:

Le vecteur position du pixel sur le devant de la pyramide de vue.

Throws:

SRuntimeException - Si la caméra n'a pas été initialisée pour la pyramide de vue.

SRuntimeException - Si le viewport n'a pas été initialisé pour la pyramide de vue.

viewportToViewFrustum

public SVector3d viewportToViewFrustum(int x,

                                       int y)

Méthode pour retourner la position d'un pixel de coordonnée xy dans le Viewport dans le référentiel du ViewFrustum en coordonnée xyz. Ce pixel sera situé sur le front clipping plane à la coordonnée déterminé par le code choisi lors de la construction du SViewFrustum.

Parameters:

x - - La coordonnée x du pixel en largeur (width).

y - - La coordonnée y du pixel en hauteur (height).

Returns:

Le vecteur position du pixel sur le devant de la pyramide de vue.

viewportToViewFrustum

public SVector3d viewportToViewFrustum(int x,

                                       int y,

                                       int pixel_code_coordinate)

                                throws SRuntimeException

Méthode pour retourner la position d'un pixel de coordonnée xy dans le Viewport dans le référentiel du ViewFrustum en coordonnée xyz. Ce pixel sera situé sur le front clipping plane à la coordonnée déterminé par le code choisi.

Parameters:

x - - La coordonnée x du pixel en largeur (width).

y - - La coordonnée y du pixel en hauteur (height).

pixel_code_coordinate - - Le code de la coordonnée interne du pixel qui sera calculé.

Returns:

Le vecteur position du pixel sur le devant de la pyramide de vue.

Throws:

SRunTimeException - Si la coordonnée (x,y) est à l'extérieur des limitives du viewport.

SRunTimeException - Si le code de coordonnée interne du pixel est invalide.

SRuntimeException

main

public static void main(java.lang.String[] args)

Parameters:

args -

test1

public static void test1()

Test #1 : Test pour vérifier la fonctionnalité du calcul de la position d'un pixel dans l'espace du view frustum.