bGLOOP

Class GLLichtobjekt

Object

bGLOOP.GLLichtobjekt

public class GLLichtobjekt
extends Object

Ein GLLichtobjekt ist ein normales bGLOOP-Objekt, das leuchtet. Dies kann im einzelnen z.B. eine Kugel, ein Zylinder, ein Kegel, ein Kegelstumpf usw. sein. Die Klasse kann dazu verwendet werden, um etwa Kerzenflammen oder Lampen darzustellen.

Das an den Konstruktor übergebene Objekt sollte nicht mehr verwendet werden, d.h. es sollten keine Methoden auf ihm ausgeführt werden. Dies sollte nun auf dem Lichtobjekt passieren.

Beispiel:

   GLLichtobjekt lobj;
   lobj = new GLLichtobjekt(new GLKugel(100, 200, 50, 10));
   lobj.setzeFarbe(.4, .5, .2);
   lobj.skaliere(1.5);
 

In der Implementierung dieser Klasse wird für jedes Objekt eine Lichtquelle erzeugt. Dabei ist zu beachten, dass pro Szene von OpenGL in der Regel nur 8 Lichtquellen unterstützt werden. Werden weitere Lichter benötigt, so sollte die Methode IGLSurface.setzeSelbstleuchten(double, double, double) verwendet werden. Der Nachteil eines lediglich selbstleuchtendes Objekt besteht darin, dass es keine Objekte in seiner Umgebung beleuchten kann und die Szene ohne weitere Lichtquellen dunkel bleibt.

Author:

R. Spillner

Constructor Summary

Constructors

Constructor and Description
GLLichtobjekt(bGLOOP.TransformableSurfaceObject pLichtobjekt) Erstellt ein Lichtobjekt.

Method Summary

Modifier and Type	Method and Description
void	drehe(double pWinkelX, double pWinkelY, double pWinkelZ) Dreht Objekt um seinen Mittelpunkt.
void	drehe(double pWinkelX, double pWinkelY, double pWinkelZ, double pX, double pY, double pZ) Dreht Objekt um die Koordinatenachsen, die in Punkt P(pX, pY, pZ) verschoben wurden.
void	drehe(double pWinkel, double pOrtX, double pOrtY, double pOrtZ, double pRichtX, double pRichtY, double pRichtZ) Dreht Objekt um eine angegebene Achse im Raum.
void	dreheDich(double pWinkelX, double pWinkelY, double pWinkelZ) Deprecated.
void	dreheDich(double pWinkelX, double pWinkelY, double pWinkelZ, double pX, double pY, double pZ) Deprecated.
double[]	gibFarbe() Farbe des Objekts.
GLTextur	gibTextur() Gibt das aktuelle Texturobjekt zurück.
double	gibX() Gibt die x-Koordinate des Objekts zurück.
double	gibY() Gibt die y-Koordinate des Objekts zurück.
double	gibZ() Gibt die z-Koordinate des Objekts zurück.
void	lichtAn(boolean an) Aktiviert oder deaktiviert die Lichtquelle des Leuchtobjekts.
void	resetSkalierungUndRotation() Setzt Skalierungen und Drehungen zurück auf die Standardwerte.
void	rotiere(double pWinkel, double pOrtX, double pOrtY, double pOrtZ, double pRichtX, double pRichtY, double pRichtZ) Deprecated.
void	setzeAbschwaechung(double pKonstant, double pLinear, double pQuadratisch) Legt fest, wie das emittierte Licht abgeschwächt mit zunehmender Entfernung vom Lichtobjekt abgeschwächt wird.
void	setzeAmbientBeleuchtung(double pR, double pG, double pB) Setzt die Farbe des Anteils des vom Lichtobjekt emittierten Streulichts.
void	setzeDarstellungsModus(GLObjekt.Darstellungsmodus dm) Setzt den GLObjekt.Darstellungsmodus des Objekts.
void	setzeDurchsichtigkeit(double pAlpha) Setzt den Durchsichtigkeitsfaktor des Objekts.
void	setzeFarbe(double pR, double pG, double pB) Setzt die Farbe des Objekts.
void	setzeLichtFarbe(double pR, double pG, double pB) Setzt den die Hauptfarbe des vom Lichtobjekt emittierten Lichts.
void	setzePosition(double pX, double pY, double pZ) Verschiebt das Objekts mit seinem Bezugspunkt (meistens der Mittelpunkt) auf den Punkt (pX, pY, pZ).
void	setzeQualitaet(int pUnterteilungen) Anzahl der polygonalen Unterteilungen des Modells.
void	setzeQualitaet(int pBreitengrade, int pLaengengrade) Anzahl der polygonalen Unterteilungen des Modells.
void	setzeSelbstleuchten(double pR, double pG, double pB) Setzt die Farbwerte der Farbe, in der das Objekt "leuchtet".
void	setzeSichtbarkeit(boolean pSichtbar) Stellt ein, ob das Objekt in der Szene sichtbar ist.
void	setzeTextur(GLTextur pTextur) Legt die übergebene Textur auf das Objekt.
void	setzeTextur(String pTexturBilddatei) Legt die übergebene Textur auf das Objekt.
void	skaliere(double pFaktor) Skaliert das Objekt in alle drei Dimensionen mit dem gegebenen Faktor.
void	skaliere(double pFaktorX, double pFaktorY, double pFaktorZ) Verzerrt das Objekt in alle drei Dimensionen mit unterschiedlichen Skalierungsfaktoren.
void	verschiebe(double pX, double pY, double pZ) Verschiebt das Objekt um den Vektor (pX, pY, pZ)

Methods inherited from class Object

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

Constructor Detail

GLLichtobjekt

public GLLichtobjekt(bGLOOP.TransformableSurfaceObject pLichtobjekt)

Erstellt ein Lichtobjekt. Der Übergabeparameter muss eine Kugel-, ein Kegel-, ein Kegelstumpf- oder ein Zylinder-Objekt sein. Dieses wird dann beleuchtet. Alle weiteren Methodenaufrufe müssen anschließend an das neu erstellte Lichtobjekt und nicht mehr an das ursprüngliche Objekt gegeben werden — dieses sollte nach Möglichkeit nicht mehr verwendet werden (s. GLLichtobjekt).

Parameters:

pLichtobjekt - Objekt, welches beleuchtet wird.

Method Detail

drehe

public void drehe(double pWinkelX,
                  double pWinkelY,
                  double pWinkelZ,
                  double pX,
                  double pY,
                  double pZ)

Dreht Objekt um die Koordinatenachsen, die in Punkt P(pX, pY, pZ) verschoben wurden. Dabei wird zuerst um die y-Achse um pWinkelY, danach um die z-Achse um pWinkelZ und schließlich um die y-Achse um pWinkelY gedreht.

Parameters:

pWinkelX - Winkel der Rotation um die x-Achse durch P in Grad

pWinkelY - Winkel der Rotation um die y-Achse durch P in Grad

pWinkelZ - Winkel der Rotation um die z-Achse durch P in Grad

pX - x-Koordinate von P

pY - y-Koordinate von P

pZ - z-Koordinate von P

drehe

public void drehe(double pWinkelX,
                  double pWinkelY,
                  double pWinkelZ)

Dreht Objekt um seinen Mittelpunkt. Dabei wird nacheinander um die in den Mittelpunkt M verschobenen Koordinatenachsen rotiert.
Rotationsreihenfolge: y-Achse, z-Achse, zuletzt x-Achse.

Parameters:

pWinkelX - Winkel der Rotation um die x-Achse durch M in Grad

pWinkelY - Winkel der Rotation um die y-Achse durch M in Grad

pWinkelZ - Winkel der Rotation um die z-Achse durch M in Grad

drehe

public void drehe(double pWinkel,
                  double pOrtX,
                  double pOrtY,
                  double pOrtZ,
                  double pRichtX,
                  double pRichtY,
                  double pRichtZ)

Dreht Objekt um eine angegebene Achse im Raum.

Die Achse wird dabei durch die Vektorgleichung

beschrieben.

Das bedeutet: Stellt man sich eine Linie ausgehend vom Ursprung (0,0,0) zu (pRichtX, pRichtY, pRichtZ) vor, so verläuft die zu beschreibende Rotationsachse parallel zu dieser Strecke durch den Punkt (pOrtX, pOrtY, pOrtZ). (pRichtX, pRichtY, pRichtZ) geben daher lediglich die Richtung der Achse an.

Parameters:

pWinkel - Winkel der Rotation in Grad

pOrtX - x-Koordinate des Ortsvektors pOrt

pOrtY - y-Koordinate des Ortsvektors pOrt

pOrtZ - z-Koordinate des Ortsvektors pOrt

pRichtX - x-Koordinate des Richtungsvektors pRicht

pRichtY - y-Koordinate des Richtungsvektors pRicht

pRichtZ - z-Koordinate des Richtungsvektors pRicht

verschiebe

public void verschiebe(double pX,
                       double pY,
                       double pZ)

Verschiebt das Objekt um den Vektor (pX, pY, pZ)

Parameters:

pX - Objekt wird um pX parallel zur x-Achse verschoben

pY - Objekt wird um pY parallel zur y-Achse verschoben

pZ - Objekt wird um pZ parallel zur z-Achse verschoben

skaliere

public void skaliere(double pFaktorX,
                     double pFaktorY,
                     double pFaktorZ)

Verzerrt das Objekt in alle drei Dimensionen mit unterschiedlichen Skalierungsfaktoren. D.h., dass alle Längen in x-Richtung mit dem Faktor pFaktorX, in y-Richtung mit dem Faktor pFaktorY und in z-Richtung mit dem Faktor pFaktorZ multipliziert werden.

Parameters:

pFaktorX - Skalierungsfaktor in x-Richtung

pFaktorY - Skalierungsfaktor in y-Richtung

pFaktorZ - Skalierungsfaktor in z-Richtung

skaliere

public void skaliere(double pFaktor)

Skaliert das Objekt in alle drei Dimensionen mit dem gegebenen Faktor.

Parameters:

pFaktor - Skalierungsfaktor in x-,y- und z-Richtung

See Also:

skaliere(double, double, double)

setzeDarstellungsModus

public void setzeDarstellungsModus(GLObjekt.Darstellungsmodus dm)

Setzt den GLObjekt.Darstellungsmodus des Objekts.

Parameters:

dm - Darstellungsmodus (PUNKT, LINIE oder GEFUELLT)

setzeQualitaet

public void setzeQualitaet(int pBreitengrade,
                           int pLaengengrade)

Anzahl der polygonalen Unterteilungen des Modells. Jedem Objekt liegt ein Gittermodell zugrundeliegenden. Je größer die Anzahl der Unteilungen, desto feiner sind die Schattierungen auf der Oberfläche. Allerdings führt eine hohe Zahl von Polygonen in einer Szene zu langsamerer Darstellung und fallender Framerate.

Parameters:

pBreitengrade - Anzahl der Unteilungen horizontalen Scheiben

pLaengengrade - Anzahl der Unteilungen vertikalen Scheiben

setzeQualitaet

public void setzeQualitaet(int pUnterteilungen)

Anzahl der polygonalen Unterteilungen des Modells.

Parameters:

pUnterteilungen - Anzahl der horizontalen und vertikalen Scheiben in der Unterteilung

See Also:

setzeQualitaet(int,int)

gibX

public double gibX()

Gibt die x-Koordinate des Objekts zurück.

Returns:

x-Koordinate des Objekts

gibY

public double gibY()

Gibt die y-Koordinate des Objekts zurück.

Returns:

y-Koordinate des Objekts

gibZ

public double gibZ()

Gibt die z-Koordinate des Objekts zurück.

Returns:

z-Koordinate des Objekts

setzeFarbe

public void setzeFarbe(double pR,
                       double pG,
                       double pB)

Setzt die Farbe des Objekts. Die Parameterwerte müssen zwischen 0 und 1 liegen.

Parameters:

pR - Rotanteil, zwischen 0 und 1

pG - Grünanteil, zwischen 0 und 1

pB - Blauanteil, zwischen 0 und 1

gibFarbe

public double[] gibFarbe()

Farbe des Objekts.

Returns:

Dreielementiges Array mit Rot-, Grün und Blauanteilen.

setzeTextur

public void setzeTextur(GLTextur pTextur)

Legt die übergebene Textur auf das Objekt.

Parameters:

pTextur - Ein GLTextur-Objekt

setzeTextur

public void setzeTextur(String pTexturBilddatei)

Legt die übergebene Textur auf das Objekt.

Parameters:

pTexturBilddatei - Ein Dateiname einer Bilddatei (.jpg oder .png)

gibTextur

public GLTextur gibTextur()

Gibt das aktuelle Texturobjekt zurück. Ist keine Textur festgelegt, wird null zurück gegeben.

Returns:

Das aktuelle GLTextur-Objekt

setzeSichtbarkeit

public void setzeSichtbarkeit(boolean pSichtbar)

Stellt ein, ob das Objekt in der Szene sichtbar ist. Ein unsichtbares Objekt wird nicht gerendert, ist aber noch Teil der Szene.

Parameters:

pSichtbar - Wenn true, so wird das Objekt gerendert, wenn false, dann nicht.

lichtAn

public void lichtAn(boolean an)

Aktiviert oder deaktiviert die Lichtquelle des Leuchtobjekts.

Parameters:

an - Wenn true, dann wird die Lichtquelle aktiviert, wenn false, dann wird sie deaktiviert.

setzeAmbientBeleuchtung

public void setzeAmbientBeleuchtung(double pR,
                                    double pG,
                                    double pB)

Setzt die Farbe des Anteils des vom Lichtobjekt emittierten Streulichts. Die Parameterwerte müssen zwischen 0 und 1 liegen.

Parameters:

pR - Rotanteil

pG - Grünanteil

pB - Blauanteil

setzeLichtFarbe

public void setzeLichtFarbe(double pR,
                            double pG,
                            double pB)

Setzt den die Hauptfarbe des vom Lichtobjekt emittierten Lichts. Die Parameterwerte müssen zwischen 0 und 1 liegen.

Parameters:

pR - Rotanteil

pG - Grünanteil

pB - Blauanteil

setzeAbschwaechung

public void setzeAbschwaechung(double pKonstant,
                               double pLinear,
                               double pQuadratisch)

Legt fest, wie das emittierte Licht abgeschwächt mit zunehmender Entfernung vom Lichtobjekt abgeschwächt wird. Dabei werden eine konstante, eine lineare und eine quadratische Komponente unterschieden.

Parameters:

pKonstant - konstanter Faktor. Der Einfluss dieses Parameters ist unabhängig von der Entfernung und gibt somit eine globale (d.h. positionsunabhängige) Abschwächung des Lichts an.

pLinear - linearer Faktor der Abschwächung abhängig von der Entfernung eines Pixels vom Lichtobjekt

pQuadratisch - quadratischer Faktor der Abschwächung abhängig vom Quadrat der Entfernung eines Pixels vom Lichtobjekt.

dreheDich

@Deprecated
public void dreheDich(double pWinkelX,
                                  double pWinkelY,
                                  double pWinkelZ)

Deprecated.

dreheDich

@Deprecated
public void dreheDich(double pWinkelX,
                                  double pWinkelY,
                                  double pWinkelZ,
                                  double pX,
                                  double pY,
                                  double pZ)

Deprecated.

rotiere

@Deprecated
public void rotiere(double pWinkel,
                                double pOrtX,
                                double pOrtY,
                                double pOrtZ,
                                double pRichtX,
                                double pRichtY,
                                double pRichtZ)

Deprecated.

setzePosition

public void setzePosition(double pX,
                          double pY,
                          double pZ)

Verschiebt das Objekts mit seinem Bezugspunkt (meistens der Mittelpunkt) auf den Punkt (pX, pY, pZ).

Parameters:

pX - x-Koordinate des Zielpunkts

pY - y-Koordinate des Zielpunkts

pZ - z-Koordinate des Zielpunkts

resetSkalierungUndRotation

public void resetSkalierungUndRotation()

Setzt Skalierungen und Drehungen zurück auf die Standardwerte. Die bereits vollzogenen Verschiebungen (Translationen) des Objekts bleiben erhalten.

setzeDurchsichtigkeit

public void setzeDurchsichtigkeit(double pAlpha)

Setzt den Durchsichtigkeitsfaktor des Objekts.

Parameters:

pAlpha - Ein Wert zwischen 0 (komplett durchsichtig) und 1 (vollständig opak)

setzeSelbstleuchten

public void setzeSelbstleuchten(double pR,
                                double pG,
                                double pB)

Setzt die Farbwerte der Farbe, in der das Objekt "leuchtet". Ein selbstleuchtendes Objekt wird in einer Szene angezeigt, ohne dass dafür eine weitere Lichtquelle notwendig ist. Das Licht ist jedoch nicht räumlich und kann insbesondere keine weiteren Objekte beleuchten. Wenn ein solches Verhalten gewünscht ist, empfiehlt sich die Benutzung der Klasse GLLichtobjekt. Diese verwendet jedoch eine Lichtquelle, von der in OpenGL in der Regel nur insgesamt 8 pro Szene zur Verfügung stehen.

Parameters:

pR - Rotanteil, zwischen 0 und 1

pG - Grünanteil, zwischen 0 und 1

pB - Blauanteil, zwischen 0 und 1