Tutorial 3: Custom Scene Node (Benutzerdefinierter Szeneknoten)
(übersetzt von Ba'el, original eng. von irrlicht.sourceforge.net)
Dieses Tutorial ist für etwas Erfahrenere. Dieses Tutorial behandelt wie man „custom scene node“ herstellt und wie man sie in der engine benutzt. Eine „custom scene node“ wird benötigt um eine Render-Technik zu Implementieren, welche von der Irrlicht-Engine nicht unterstützt wird. Mit erstellten „custom scene nodes“ kannst du einfach die Irrlicht-Engine erweitern und deinen Anforderungen anpassen.

Auf geht's!
Zuerst wird die header file eingebunden, wir benutzen die irr namespace, und linken die .lib file.
Hier kommt nun der anspruchsvollste Teil dieses Tutorials: Die Klasse eurer eigenen „custom scene node“. Halten wir's einfach, eure „scene node“ wird keine “indoor portal renderer” und auch keine “terrain scene node”, sondern ein einfacher Tetraeder, ein 3d Objekt bestehend aus 4 verbundenen Vertikalen, welcher sich nur selbst zeichnet und sonst nix.
Last uns eure „scene node“ in die Irrlicht-Engine scene einfügen, die Klasse die wir erstellen benötigt nur die Herleitung von der „ISceneNode“ Klasse durch überschreiben einiger Methoden.

Als erstes, deklarieren wir einige Membervariabeln, zum speichern der Daten für euren Tetraeder: die Begrenzungsbox (bounding box), 4 Vertikale, und das Material des Tetraeders.Die Parameter der Konstruktionsspezifkationen der “parent” der „scene node“, ein Pointer auf den „scene manager“, und eine id der „scene node“. Im Konstruktor selbst, rufen wir den “parent class Konstruktor” auf, setzen einige Eigenschaften des Materials welches wir zum zeichnen der „scene node“ benötigen und erstellen die 4 Vertikalen des Tetraeders den wir später zeichnen wollen.

Die Irrlicht-Engine braucht noch Infos über die „bounding box“ eurer „scene node“. Es wird genutzt zum automatischen „culling“ und anderen Dingen. Nun brauchen wir eine “bounding box” der 4 Vertikalen. Wenn du keine Box für's automatische “culling“, und/oder keine eigene schreiben willst kannst du auch schreiben
AutomaticCullingEnabled = false;.

Ehe es gezeichnet wird, muss die „OnPreRender()“-Methode jede “scene node“ in der „scene“ durch den „scene manager“ aufrufen. Wird gewünscht das sich die “scene node” selbst zeichnet, muss sie sich selbst beim “scene manager“ zum zeichnen registrieren. Dies ist notwendig um den „scene manager“ mitzuteilen wenn es die „::render“-Methode aufrufen soll. Z.b. Normale “scene nodes” Rendern ihren Inhalt eins nach dem andern, während „stencil buffer shadows“ nach allen anderen „scene nodes“ gezeichnet werden. Und „camera oder light scene nodes“ müssen vor allen anderen „scene nodes“ gerendert werden.
So hier Registrieren wir ganz einfach die „scene node“ um sie normal zu rendern. Wenn wir es wie Kameras oder Licht rendern wollen müssen wir „SceneManager-registerNodeForRendering“(this, SNRT_LIGHT_AND_CAMERA) aufrufen;
Danach rufen wir die „OnPreRender“-Methode der Klasse „ISceneNode“, welche ganz einfach alle „child scene nodes“ dieses „node register“ zulässt.
In der “render()”-Methode spielen sich die meisten der interessanten Dinge: der „scene node render“ selbst. Wir überschreiben diese Methode und zeichnen den Tetraeder.
Wenigstens müssen wir drei kleine Hilfsmethoden. GetBoundingBox() gibt die „bounding box“ dieser „scene node“ zurück, GetMaterialCount() gibt die Anzahl der Materialien in dieser „scene node“ (euer Tetraeder hat nur ein Material) zurück, und getMaterial() gibt das Material durch einen Index zurück. Weil wir nur ein Material haben, können wir auch nur ein Material zurückgeben, so können wir annehmen das niemand getMaterial() mit einem Index größer 0 aufrufen wird.
Das war's, die „scene node“ ist fertig. Nun müssen wir nur noch die Engine starten, erstelle die „scene node“ und eine Kamera, und schau dir das Resultat an .
Erstelle deine „scene node“. Vergesse nicht es zu droppen (->drop()) nachdem du es erstellt hast. Das ist möglich, weil der “scene manager” sich jetzt darum kümmert. Das ist nicht unbedingt nötig es direkt danach zu machen, es kann auch am ende des Programms passieren.
Die Animation besteht zwar nur aus dem Tetraeder, aber wir adden noch einen Animator zur „scene node“, um es wenigstens etwas rotieren zu lassen.
Nun zeichne alles und fertig.
Das war's, Kompiliere alles und probiere etwas rum.

_________________
"Die folgende Aussage ist falsch. Die vorherige Aussage ist richtig."