Ich schliesse mich DarthB an. Ich finde das es ein wenig viel verlangt ist das D.S. jetzt am besten für alle Leute die Wünsche intrigieren soll, wie z.B. das abschalten der LOG Funktion, ich bitte doch sehr ein wenig selbst arbeit wäre hier wohl angebracht und wer eine abschaltbare LOG möchte der sollte sich hinsetzen und das selber einbauen, zudem das garnicht mal so schwer ist. SORRY das ist hier nicht persönliches, aber meiner Meinung nach ist es wichtiger das das Thema um das es im Buch und auf dieser Seite geht weiter entwicklet wird. Bugs sind sicher ein Argument, welches hier angebracht ist, bzw. im entsprechenden Forum, weil hier geht es um die Engine Referrenz wie der Titel des Treads auch lautet.
Ich will hier keine Reden Schwingen sondern auch gleich mit guten Beispiel voran gehen , schaut Euch mal das an :
drxGUI (DiReX Grafic User Interface)
Vorwort :
Die DiReX GUI ( drxGUI ) ist die Grafische Benutzer Oberfläche der Engine. Sie ist in verschiedene Bereiche unterteilt. Sie setzt sich aus den folgenden 10 Klassen zusammen :
• drxGUI (Die Hauptklasse)
• drxGUIButton (Die Klasse für Buttons)
• drxGUICheckBox (Die Klasse für die Checkboxen)
• drxGUIElement (Die Klasse für die Oberflächen Elemente)
• drxGUIFrame (Die Klasse für die Rahmen)
• drxGUIImage (Die Klasse für die Bilder)
• drxGUIInput (Die Klasse für die Eingabe)
• drxGUIList (Die Klasse für die Listen)
• drxGUIRadioBox (Die Klasse für die Radioboxen)
• drxGUIText (Die Klasse für die Texte)
Mit Hilfe dieser Klassen werden die Benutzeroberflächen erstellt und behandelt. Die Hauptklasse ist hier die drxGUI , sie ist die Basis der GUI. Die Klasse drxGUIElement kapselt die die zugriffe und die Verwaltung der Elemente. In dieser Klasse sind alle Klassen der GUI als „friend class“ intrigiert. So das die Element Klasse auf die anderen Klassen der GUI zugreifen kann.
Die Klasse drxGUI :
Die drxGUI Klasse enthält die Hauptoberfläche drxGUIVertex , diese beinhaltet die folgende Struktur und den folgenden Aufbau :
|
Quellcode
|
1
2
3
4
5
6
7
8
9
|
// Vertexformat
#define DRX_GUI_FVF (D3DFVF_XYZRHW | D3DFVF_DIFFUSE | D3DFVF_TEX1)
struct DIREX_API drxGUIVertex
{
drxVector3 vPosition; // Positionsangabe
float fRHW; // 1/w
D3DCOLOR Diffuse; // Streufarbe
drxVector2 vTexture; // Texturkoordinaten
};
|
drxVector3 vPosition enthält die Positionsangaben von der drxGUIVertex im Datenformat float , also z.B. im Format drxVector3(0.0f , 0.0f) . float fRHW ist zur Zeit noch nicht geklärt. D3DCOLOR Diffuse legt die Streufarbe fest. Mit drxVector2 vTexture wird die Texture gesetzt.
Aufzählung für Nachrichtentypen :
In der drxGUI gibt es die nachfolgenden Nachrichentypen die in der Aufzählung drxGUIMessageType zusammengefasst sind. Folgende Nachrichten gehören dazu :
|
|
Quellcode
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
// Aufzählung für Nachrichtentypen
enum DIREX_API drxGUIMessageType
{
DRX_GMT_CREATE, // Das Element wurde erstellt.
DRX_GMT_DELETE, // Das Element wird gelöscht.
DRX_GMT_ENTERPAGE, // Betreten einer Seite
DRX_GMT_MOVE, // Das Element soll bewegt werden.
DRX_GMT_RENDER, // Das Element soll gerendert werden.
DRX_GMT_ELEMENTCLICKED, // Ein Element wurde angeklickt.
DRX_GMT_LBUTTONDOWN, // Linker Mausknopf gedrückt
DRX_GMT_LBUTTONUP, // Linker Mausknopf losgelassen
DRX_GMT_RBUTTONDOWN, // Rechter Mausknopf gedrückt
DRX_GMT_RBUTTONUP, // Rechter Mausknopf losgelassen
DRX_GMT_KEYDOWN, // Tastaturtaste gedrückt
DRX_GMT_KEYUP, // Tastaturtaste losgelassen
DRX_GMT_KEYREPEAT, // Wiederholter Knopfdruck (Taste bleibt
gedrückt)
DRX_GMT_SELECTION // Auswahl bei einer Liste wurde geändert
};
|
Je nach Aktion werden die o.g. Nachrichten gesendet.
Die Struktur für eine Nachricht :
Die Struktur ist wie folgt aufgebaut :
|
|
Quellcode
|
1
2
3
4
5
6
7
8
|
// Struktur für eine Nachricht
struct DIREX_API drxGUIMessage
{
drxGUIMessageType Type; // Typ der Nachricht
int aiInt[8]; // 8 Integer
float afFloat[8]; // 8 Fließkommazahlen
void* apPointer[8]; // 8 Zeiger
};
|
Die drxGUIMessageType Type gibt den Typen der Nachricht an (sihe oben und unten). Die drei unteren Variablen enthalten die Daten und Zeiger.
Aufzählung für Oberflächenelementtypen :
Die Oberflächenelementtypen bezeichnen die einzelnen Elemente (wie z.B. die Button , Rahmen , Texte , usw.). Derzeitig gibt es acht Elemente die sich wie folgt zusammen setzen :
• Rahmen
• Knopf
• Text
• Bild
• Radio-Box
• Check-Box
• Eingabefeld
• Liste
Die Aufzählung sieht dann wie folgt aus :
|
|
Quellcode
|
1
2
3
4
5
6
7
8
9
10
11
12
|
// Aufzählung für Oberflächenelementtypen
enum DIREX_API drxGUIElementType
{
DRX_GET_FRAME, // Rahmen
DRX_GET_BUTTON, // Knopf
DRX_GET_TEXT, // Text
DRX_GET_IMAGE, // Bild
DRX_GET_CHECKBOX, // Check-Box
DRX_GET_RADIOBOX, // Radio-Box
DRX_GET_INPUT, // Eingabefeld
DRX_GET_LIST, // Liste
};
|
Das sind die acht Oberflächenelementtypen die es derzeitig in der DiReX Engine ( drxGUI ) gibt.
Die Klasse für ein Oberflächenelement setzt sich wie folgt zusammen :
|
|
Quellcode
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
// Klasse für ein Oberflächenelement
class DIREX_API drxGUIElement
{
friend class drxGUI;
friend class drxGUIFrame;
friend class drxGUIButton;
friend class drxGUIText;
friend class drxGUIImage;
friend class drxGUICheckBox;
friend class drxGUIRadioBox;
friend class drxGUIInput;
friend class drxGUIList;
private:
// Variablen
// ID des Elements
int m_iID;
// Typ des Elements
drxGUIElementType m_Type;
// Auf welcher Seite ist das Element?
int m_iPage;
// Zu welcher Oberfläche das Element gehört
drxGUI* m_pGUI;
// Position der linken oberen Ecke
drxVector2 m_vPosition;
// Breite und Höhe
drxVector2 m_vSize;
// Sichtbar?
BOOL m_bVisible;
// Aktiviert?
BOOL m_bEnabled;
// Wird das Element gerade gedrückt?
BOOL m_bPressed;
public:
// Methoden
// Das Element erhält eine Nachricht.
virtual drxResult ReceiveMessage(const drxGUIMessage* pMsg) = 0;
// Inline-Methoden
inline int GetID()
{return m_iID;}
inline drxGUIElementType GetType()
{return m_Type;}
inline int GetPage()
{return m_iPage;}
inline drxGUI* GetGUI()
{return m_pGUI;}
inline drxVector2 GetPosition()
{return m_vPosition;}
inline drxVector2 GetSize()
{return m_vSize;}
inline BOOL IsVisible()
{return m_bVisible;}
inline BOOL IsEnabled()
{return m_bEnabled;}
inline BOOL IsPressed()
{return m_bPressed;}
inline void SetPage(int iPage)
{m_iPage = iPage;}
inline void SetPosition(drxVector2 vPos)
{m_vPosition = vPos;}
inline void SetSize(drxVector2 vSize)
{m_vSize = vSize;}
inline void Show(BOOL bShow)
{m_bVisible = bShow;}
inline void Enable(BOOL bEnable)
{m_bEnabled = bEnable;}
};
|
Die „friend class(en)“ betiteln die zusätzlich benötigten und zur Verfügung stehenden Klassen aus der GUI ( drxGUI ).
Die privaten Variablen der Klasse drxGUIElement :
Die Variable int m_iID gibt die ID (die Identifizierungsnummer) des Elements an, sie ist wie oben ersichtlich eine Integer Variable. Mit dieser Variable kann auf die einzelnen Elemente mit einigen Methoden (wie z.B. GetID () aus dieser Klasse) zugegriffen werden.
Die Variable drxGUIElementType m_Type gibt den Typen des Elements an , wie z.B. :
• DRX_GET_FRAME, // Rahmen
• DRX_GET_BUTTON, // Knopf
• DRX_GET_TEXT, // Text
• DRX_GET_IMAGE, // Bild
• DRX_GET_CHECKBOX, // Check-Box
• DRX_GET_RADIOBOX, // Radio-Box
• DRX_GET_INPUT, // Eingabefeld
• DRX_GET_LIST, // Liste
Die Variable int m_iPage gibt an auf welche Page (Seite) sich das Element befindet , bzw. auf welcher es erstellt werden soll.
Die Variable drxGUI* m_pGUI gibt an zu welcher Oberfläche das Element gehört, bzw. auf welcher Oberfläche das Element erzeugt werden soll.
Was würdet Ihr von so einer Referrenz halten, oder besser in diese Richtung ?
Nochmal @DarthB
ich habe David diesbezüglich auch meine Hilfe angeboten Ihn bei dieser Arbeit zu unterstützen, was er jedoch ablehnte, mit dem Komentar er würde dies lieber selber in die Hand nehmen. Aber das kann man diskutieren wenn David wider da ist. Ich finde David hat mit seinem Buch , seiner Engine , dieser Seite hier und mit Euch uns allen eine gute Basis geschaffen und deshalb sollte man Ihn auch versuchen zu unterstützen, aber jetzt genug damit das gehört meiner Meinung nach nicht ganz in diesen Tread.[/b]
spieleprogrammierer.de »
Bücher - Support-Foren »
Hilfe zum Buch "3D-Spieleprogrammierung" von David Scherfgen »
Zitat
05.05.2024, 15:56
Zum Seitenanfang
