bGLOOP

Class GLMesh

Object

bGLOOP.GLObjekt

bGLOOP.GLBewegbaresObjekt

bGLOOP.GLMesh

public class GLMesh
extends GLBewegbaresObjekt

Klasse, die ein Mesh im OBJ-Format interpretiert und im bGLOOP-Kontext als Objekt verfügbar macht. Die Klasse unterstützt Mesh-Beschreibungen im Wavefront-OBJ-Format, die von allen gängigen 3D-Modellierungsprogrammen erzeugt werden können.

Zu einer OBJ-Datei gehört häufig auch eine MTL-Datei, die in der OBJ-Datei referenziert wird und Materialbeschreibungen und Texturen enthält. Alle Referenzen, sowohl in der OBJ- als auch in der MTL-Datei, beziehen sich relativ zur Position der jeweiligen Datei. Steht also in foo/material.mtl eine Referenz zu einer Textur images/tex1.jpg, so wird diese unter foo/images/tex1.jpg gesucht.

Eine Reihe von Features des Formats, u.a. Bump-Maps, werden nicht unterstützt.

Author:

R. Spillner

See Also:

Wavefront-OBJ-Format

Nested Class Summary

Nested classes/interfaces inherited from class bGLOOP.GLObjekt

GLObjekt.Darstellungsmodus

Constructor Summary

Constructors

Constructor and Description
GLMesh(String pDateiname) Erstellt ein GLMesh-Objekt.
GLMesh(String pDateiname, double pMeshMaxScale) Erstellt ein GLMesh-Objekt.

Method Summary

Modifier and Type	Method and Description
double	gibDurchmesserX() Gibt die maximale Ausdehnung in x-Richtung des Objekts zurück.
double	gibDurchmesserY() Gibt die maximale Ausdehnung in y-Richtung des Objekts zurück.
double	gibDurchmesserZ() Gibt die maximale Ausdehnung in z-Richtung des Objekts zurück.
GLTextur	gibTextur() Gibt das aktuelle Texturobjekt zurück.
void	loesche() Löscht das Objekt aus der Szene.
void	setzeDurchsichtigkeit(double pAlpha) Setzt den Durchsichtigkeitsfaktor des Objekts.
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.

Methods inherited from class bGLOOP.GLBewegbaresObjekt

drehe, drehe, drehe, dreheDich, dreheDich, gibX, gibY, gibZ, resetSkalierungUndRotation, rotiere, setzeDarstellungsModus, setzePosition, skaliere, skaliere, verschiebe

Methods inherited from class bGLOOP.GLObjekt

gibFarbe, setzeFarbe, setzeGlanz, setzeMaterial, setzeSichtbarkeit

Methods inherited from class Object

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

Constructor Detail

GLMesh

public GLMesh(String pDateiname,
              double pMeshMaxScale)

Erstellt ein GLMesh-Objekt. Dazu wird eine Mesh-Datei im Wavefront-OBJ-Format verwendet.

Abbildung: Ein Beispiel für ein Mesh in bGLOOP mit Anzeige eines das Modell umfassenden Quaders im Linienmodus. Die Abmessungen des Quaders wurden mit den gibDurchmesser?-Befehlen ermittelt (s.u.)

Parameters:

pDateiname - Dateiname der OBJ-Datei. Eventuell weitere benötigte Textur-Dateien werden in einer in der OBJ-Datei referenzierten MTL-Datei beschrieben. Hier sind alle Angaben relativ zum Ort der jeweiligen Datei zu verstehen, in der die Angabe gemacht wird.

pMeshMaxScale - Maximale Ausdehnung des Models in eine der drei Hauptkoordinatenrichtungen

GLMesh

public GLMesh(String pDateiname)

Erstellt ein GLMesh-Objekt. Dazu wird eine Mesh-Datei im Wavefront-OBJ-Format verwendet.

Parameters:

pDateiname - Dateiname der OBJ-Datei. Eventuell weitere benötigte Textur-Dateien werden in einer in der OBJ-Datei referenzierten MTL-Datei beschrieben. Hier sind alle Angaben relativ zum Ort der jeweiligen Datei zu verstehen, in der die Angabe gemacht wird.

Method Detail

gibDurchmesserX

public double gibDurchmesserX()

Gibt die maximale Ausdehnung in x-Richtung des Objekts zurück.

Returns:

Maximale Ausdehnung in x-Richtung

gibDurchmesserY

public double gibDurchmesserY()

Gibt die maximale Ausdehnung in y-Richtung des Objekts zurück.

Returns:

Maximale Ausdehnung in y-Richtung

gibDurchmesserZ

public double gibDurchmesserZ()

Gibt die maximale Ausdehnung in z-Richtung des Objekts zurück.

Returns:

Maximale Ausdehnung in z-Richtung

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

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

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)

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

setzeDurchsichtigkeit

public void setzeDurchsichtigkeit(double pAlpha)

Setzt den Durchsichtigkeitsfaktor des Objekts.

Parameters:

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

loesche

public void loesche()

Description copied from class: GLObjekt

Löscht das Objekt aus der Szene. Es ist danach nicht mehr wiederherstellbar.

Overrides:

loesche in class GLObjekt

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.