GLKamera (bGLOOP Dokumentation)

Object
- bGLOOP.GLKamera

Direct Known Subclasses:

GLSchwenkkamera
```
public class GLKamera
extends Object
```
Klasse, die eine virtuelle Kamera beschreibt, die die 3D-Szene betrachtet. Sie bietet eine Reihe von Diensten zur Manipultion der Kamera (wie etwas Drehen und Verschieben). Eine Kamera öffnet automatisch ein Fenster, in dem dargestellt wird, was die Kamera sieht.

Author:

R. Spillner

Constructor Summary

Constructors
Constructor and Description
`GLKamera()` Erstellt eine bGLOOP-Kamera.
`GLKamera(boolean pVollbild)`
`GLKamera(boolean pVollbild, boolean pKeineDekoration)` Erstellt eine bGLOOP-Kamera mit zusätzlichen Fenster-Parametern.
`GLKamera(int width, int height)` Erstellt eine bGLOOP-Kamera mit vorgegebener Breite und Höhe.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static GLKamera`	`aktiveKamera()` Rückgabe der aktiven Kamera.
`void`	`beleuchtungAktivieren(boolean pBeleuchtungAn)` Aktiviert die Beleuchtung der Szene.
`void`	`bildschirmfoto()` Erstellt ein Bildschirmfoto und speichert es unter dem in der bGLOOP-Konfigurationsdatei festgelegten Standardnamen.
`void`	`bildschirmfoto(String pDateiname)` Erstellt ein Bildschirmfoto und speichert es unter dem übergebenen Dateinamen.
`void`	`drehe(double pWinkel, double pOrtX, double pOrtY, double pOrtZ, double pRichtX, double pRichtY, double pRichtZ)` Dreht die Kamera um eine angegebene Achse im Raum.
`void`	`dreheUmXAchse(double pWinkel)` Dreht die Kamera um den angegebenen Winkel um die x-Achse im Koordinatensystem.
`void`	`dreheUmYAchse(double pWinkel)` Dreht die Kamera um den angegebenen Winkel um die y-Achse im Koordinatensystem.
`double`	`gibBlickpunktX()` Gibt die x-Koordinate des Blickpunkts der Kamera zurück.
`double`	`gibBlickpunktY()` Gibt die y-Koordinate des Blickpunkts der Kamera zurück.
`double`	`gibBlickpunktZ()` Gibt die z-Koordinate des Blickpunkts der Kamera zurück.
`int`	`gibBreite()` Liefert die Breite des Kamerafensters.
`int`	`gibHoehe()` Liefert die Höhe des Kamerafensters.
`GLObjekt`	`gibObjekt(int pFensterX, int pFensterY)` Gibt das `GLObjekt` zurück, was im Kamerafenster an der gegebenen Position ist.
`double`	`gibX()` Gibt die x-Position der Kamera.
`double`	`gibY()` Gibt die y-Position der Kamera.
`double`	`gibZ()` Gibt die z-Position der Kamera.
`boolean`	`istDrahtgittermodell()` Gibt an, ob im Moment die Drahtgitterdarstellung für alle bGLOOP-Objekte gewählt ist.
`static void`	`setzeAktiveKamera(GLKamera activeCamera)` Setzt die momentan aktive Kamera.
`void`	`setzeBlickpunkt(double pX, double pY, double pZ)` Setzt den Blickpunkt der Kamera.
`void`	`setzeGittermodelldarstellung(boolean pZeigeGitter)` Zeigt alle beweglichen bGLOOP-Objekte als Drahtgittermodelle an.
`void`	`setzePosition(double pX, double pY, double pZ)` Setzt die Position der Kamera.
`void`	`setzeStandardOben()` Richtet die Kamera so aus, dass "oben" auf dem Bildschirm der positiven y-Achsen-Richtung entspricht.
`void`	`setzeVollbildmodus(boolean pVollbild)` Aktiviert oder deaktiviert den Vollbildmodus des Anzeigefensters.
`void`	`vor(double pSchrittweite)` Bewegt die Kamera auf ihren Blickpunkt zu.
`void`	`zeigeAchsen(boolean pZeigeAchsen)` Aktiviert oder deaktiviert die Darstellung der Koordinatenachsen.
`void`	`zeigeAchsen(double pAchsenlaenge)` Aktiviert die Darstellung der Koordinatenachsen.
`void`	`zeigeBlickpunkt(boolean pBlickpunktZeichnen)` Zeichnet den Blickpunkt ins Kamerafenster.

Methods inherited from class Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - GLKamera
```
public GLKamera()
```
    Erstellt eine bGLOOP-Kamera. Die Kamera öffnet ein Fenster mit den Abmessungen aus der in der bGLOOP-Konfigurationsdatei eingetragenen Standardgrößen.
  - GLKamera
```
public GLKamera(boolean pVollbild)
```
  - GLKamera
```
public GLKamera(boolean pVollbild,
                boolean pKeineDekoration)
```
    Erstellt eine bGLOOP-Kamera mit zusätzlichen Fenster-Parametern. Das Fenster kann dabei im Vollbildmodus und/oder mit/ohne Fenstermanager- Dekorationen angezeigt werden.
    
    Parameters:
    
    pVollbild - Wenn true, dann wird die Anzeige direkt in den Vollbildmodus geschaltet. Wenn false, dann nicht
    
    pKeineDekoration - Wenn true, dann wird das Anzeigefenster ohne Dekoration des Fenstermanagers gezeichnet, wenn false, dann nicht.
  - GLKamera
```
public GLKamera(int width,
                int height)
```
    Erstellt eine bGLOOP-Kamera mit vorgegebener Breite und Höhe. Das Fenster wird nicht im Vollbild-Modus geöffnet.
    
    Parameters:
    
    width - Die Breite des Anzeigefensters
    
    height - Die Höhe des Anzeigefensters
- Method Detail
  - aktiveKamera
```
public static GLKamera aktiveKamera()
```
    Rückgabe der aktiven Kamera. Die aktive Kamera ist die zuletzt erstellte bzw. mit setzeAktiveKamera(GLKamera) aktiviert Kamera.
    
    Returns:
    
    die aktive Kamera
  - setzeAktiveKamera
```
public static void setzeAktiveKamera(GLKamera activeCamera)
```
    Setzt die momentan aktive Kamera.
    
    Parameters:
    
    activeCamera - Kameraobjekt, das als aktive Kamera gesetzt werden soll.
  - beleuchtungAktivieren
```
public void beleuchtungAktivieren(boolean pBeleuchtungAn)
```
    Aktiviert die Beleuchtung der Szene. Ist dies deaktiviert, werden alle Objekte in einem gleichmäßigen Licht dargestellt, alle vorhandenen Lichtquellen werden also ignoriert.
    
    Parameters:
    
    pBeleuchtungAn - Wenn true, dann wird die Beleuchtung angeschaltet, wenn false, dann wird sie deaktiviert.
  - setzeBlickpunkt
```
public void setzeBlickpunkt(double pX,
                            double pY,
                            double pZ)
```
    Setzt den Blickpunkt der Kamera. Der Blickpunkt ist der Punkt, der in der Mitte des Kamerafensters liegt, auf den die Kamera also zentriert blickt.
    
    Parameters:
    
    pX - x-Koordinate des Blickpunkts
    
    pY - y-Koordinate des Blickpunkts
    
    pZ - z-Koordinate des Blickpunkts
  - setzeStandardOben
```
public void setzeStandardOben()
```
    Richtet die Kamera so aus, dass "oben" auf dem Bildschirm der positiven y-Achsen-Richtung entspricht. Dabei wird außerdem die y-Kameraposition auf die die des Kamera-Blickpunktes gesetzt.
  - setzePosition
```
public void setzePosition(double pX,
                          double pY,
                          double pZ)
```
    Setzt die Position der Kamera.
    
    Parameters:
    
    pX - x-Koordinate der Position
    
    pY - y-Koordinate der Position
    
    pZ - z-Koordinate der Position
  - dreheUmXAchse
```
public void dreheUmXAchse(double pWinkel)
```
    Dreht die Kamera um den angegebenen Winkel um die x-Achse im Koordinatensystem.
    
    Parameters:
    
    pWinkel - Drehwinkel in Grad
  - dreheUmYAchse
```
public void dreheUmYAchse(double pWinkel)
```
    Dreht die Kamera um den angegebenen Winkel um die y-Achse im Koordinatensystem.
    
    Parameters:
    
    pWinkel - Drehwinkel in Grad
  - drehe
```
public void drehe(double pWinkel,
                  double pOrtX,
                  double pOrtY,
                  double pOrtZ,
                  double pRichtX,
                  double pRichtY,
                  double pRichtZ)
           throws IllegalArgumentException
```
    Dreht die Kamera 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
    
    Throws:
    
    IllegalArgumentException
  - setzeVollbildmodus
```
public void setzeVollbildmodus(boolean pVollbild)
```
    Aktiviert oder deaktiviert den Vollbildmodus des Anzeigefensters.
    Mit der Einstellung DEFAULT_WINDOW_MODE=NEWT gibt es einen echten Vollbildmodus. Ist die Einstellung auf AWT gesetzt, so wird das Fenster maximiert angezeigt, aber mit Fensterdekoration des Fenstermanagers. Es bleibt dann verschiebbar.
    
    Parameters:
    
    pVollbild - Wenn true, so wird der Vollbildmodus aktiviert, wenn false, dann wird auf Fenstermodus geschaltet.
  - zeigeAchsen
```
public void zeigeAchsen(double pAchsenlaenge)
```
    Aktiviert die Darstellung der Koordinatenachsen. Die Länge der Achsen kann dabei angegeben werden.
    
    Parameters:
    
    pAchsenlaenge - Länge für die Koordinatenachsen
  - zeigeAchsen
```
public void zeigeAchsen(boolean pZeigeAchsen)
```
    Aktiviert oder deaktiviert die Darstellung der Koordinatenachsen.
    
    Parameters:
    
    pZeigeAchsen - Wenn true, dann wird die Achsendarstellung aktiviert, wenn false, so wird sie deaktiviert.
    
    See Also:
    
    zeigeAchsen(double)
  - zeigeBlickpunkt
```
public void zeigeBlickpunkt(boolean pBlickpunktZeichnen)
```
    Zeichnet den Blickpunkt ins Kamerafenster.
    
    Parameters:
    
    pBlickpunktZeichnen - Wenn true, dann wird der Blickpunkt im Kamerafenster angezeigt, wenn false, dann nicht.
  - setzeGittermodelldarstellung
```
public void setzeGittermodelldarstellung(boolean pZeigeGitter)
```
    Zeigt alle beweglichen bGLOOP-Objekte als Drahtgittermodelle an. Ausgenommen davon sind Himmel und Boden — diese werden im Drahtgittermodus gar nicht dargestellt.
    
    Parameters:
    
    pZeigeGitter - Wenn true, so werden alle beweglichen Objekte als Drahtgittermodell dargestellt, wenn false werden sie gemäß ihrer eigenen Konfiguration dargestellt.
  - istDrahtgittermodell
```
public boolean istDrahtgittermodell()
```
    Gibt an, ob im Moment die Drahtgitterdarstellung für alle bGLOOP-Objekte gewählt ist.
    
    Returns:
    
    true, wenn die Drahtgitterdarstellung für alle Objekte gewählt ist, sonst false.
  - vor
```
public void vor(double pSchrittweite)
```
    Bewegt die Kamera auf ihren Blickpunkt zu.
    
    Parameters:
    
    pSchrittweite - Schrittweite der Bewegung. Die Schrittweite ist in der Maßeinheit des Koordinatensystems der 3D-Welt.
  - gibObjekt
```
public GLObjekt gibObjekt(int pFensterX,
                          int pFensterY)
```
    Gibt das GLObjekt zurück, was im Kamerafenster an der gegebenen Position ist.
    Dabei beziehen sich die Koordinaten der Parameter auf das Kamerafenster — hier hat die linke obere Ecke die Koordinaten (0|0). Maus-Objekte liefern ebenfalls Kamerafenster- Koordinaten mittels der Methoden gibX und gibY zurück, so dass man auf diese Art und Weise einen einfachen Objekt- Selektionsmechanismus mit der Maus realisieren kann:
```
   if(maus.linksklick())
     GLObjekt selectedObject = kamera.gibObjekt(maus.gibX(), maus.gibY());
 
```
    Liegen an der Mausposition mehrere Objekte hintereinander, so wird das vorderste Objekt zurückgegeben. Die Methode liefert null, wenn kein Objekt an der Stelle liegt.
    Parameters:
    
    pFensterX - x-Koordinate, an der nach einem GLObjekt gesucht wird
    
    pFensterY - y-Koordinate, an der nach einem GLObjekt gesucht wird
    
    Returns:
    
    GLObjekt-Objekt oder null
  - gibBlickpunktX
```
public double gibBlickpunktX()
```
    Gibt die x-Koordinate des Blickpunkts der Kamera zurück.
    
    Returns:
    
    x-Koordinate des Blickpunkts
  - gibBlickpunktY
```
public double gibBlickpunktY()
```
    Gibt die y-Koordinate des Blickpunkts der Kamera zurück.
    
    Returns:
    
    y-Koordinate des Blickpunkts
  - gibBlickpunktZ
```
public double gibBlickpunktZ()
```
    Gibt die z-Koordinate des Blickpunkts der Kamera zurück.
    
    Returns:
    
    z-Koordinate des Blickpunkts
  - gibBreite
```
public int gibBreite()
```
    Liefert die Breite des Kamerafensters.
    
    Returns:
    
    Breite des Kamerafensters
  - gibHoehe
```
public int gibHoehe()
```
    Liefert die Höhe des Kamerafensters.
    
    Returns:
    
    Höhe des Kamerafensters
  - gibX
```
public double gibX()
```
    Gibt die x-Position der Kamera.
    
    Returns:
    
    x-Position der Kamera
  - gibY
```
public double gibY()
```
    Gibt die y-Position der Kamera.
    
    Returns:
    
    y-Position der Kamera
  - gibZ
```
public double gibZ()
```
    Gibt die z-Position der Kamera.
    
    Returns:
    
    z-Position der Kamera
  - bildschirmfoto
```
public void bildschirmfoto()
```
    Erstellt ein Bildschirmfoto und speichert es unter dem in der bGLOOP-Konfigurationsdatei festgelegten Standardnamen.
  - bildschirmfoto
```
public void bildschirmfoto(String pDateiname)
```
    Erstellt ein Bildschirmfoto und speichert es unter dem übergebenen Dateinamen.
    
    Parameters:
    
    pDateiname - Dateiname des Screenshots

Class GLKamera

Constructor Summary

Method Summary

Methods inherited from class Object

Constructor Detail

GLKamera

GLKamera

GLKamera

GLKamera

Method Detail

aktiveKamera

setzeAktiveKamera

beleuchtungAktivieren

setzeBlickpunkt

setzeStandardOben

setzePosition

dreheUmXAchse

dreheUmYAchse

drehe

setzeVollbildmodus

zeigeAchsen

zeigeAchsen

zeigeBlickpunkt

setzeGittermodelldarstellung

istDrahtgittermodell

vor

gibObjekt

gibBlickpunktX

gibBlickpunktY

gibBlickpunktZ

gibBreite

gibHoehe

gibX

gibY

gibZ

bildschirmfoto

bildschirmfoto