Quelltext der Seite Lite-C/Workshop2 02 Die OrdnerOrdnung

__TOC__
== OMG Opening ==
[[Datei:Folders_001.png]]

OMG.. Was ist das???? Ein Spiel??? Vielleicht.. Es ist auf jeden Fall undefiniert.

Mit diesen Worten sag ich Hallöle zum Strukturentutorial für angehende Lite-C-ler. Denn nichts ist wichtiger als die Ordnung im Projekt zu bewahren. Deswegen lernt ihr hier heute die Gliederrung und einbindung von Ordnern in euer Projekt.

----


== klare Struktur ==
Ihr wollt also ein Spiel Programmieren. Schön und gut. Doch ein Spiel häuft im Laufe seiner Entwicklung hunderte von Dateien an. Das sind Modelle, Sprites, Sounds, Scripts oder Levels... Sie alle nehmen euch die Übersicht.

Deswegen ist eine klare Struktur in eurem Projekt überlebensnotwendig.

Überlegt euch daher zum Beginn eueres Projekts, welche Dateien ihr verwenden werdet. Am einfachsten ist hierbei die Dateitypen zu unterscheiden.
* Audio
* Grafiken
* Modelle
* Levels
* Scripts

Und genau diese Ordner werdet ihr brauchen.

Hier mal meine Struktur, meines Spiels Ex-Blocks:
[[Datei:Folders 002.png]]

Ich such eine grafik.. geh in den Ordner.. bin happy. Also bitte sorgt für eine klare Übersicht.


----


== Ordner einscripten ==
wenden wir uns dem Scripten zu. Ich bediene mich hier mal wieder dem Grundgerüst, welches wir im Grundlagenkurs schon einmal erstellt haben.
<source lang="c">
//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                 Definitionen und Includings
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
#include <acknex.h>
#include <default.c>

//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                          Panels
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////

//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                         Aktionen
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
action testaktion()
{
}

//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                         Funktionen
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
function test()
{
  beep();
}

//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                             MAIN
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
function main()
{
  video_mode = 6;
  level_load(NULL);
  wait(3);
}
</source>

Die variablen habe ich entfernt, da wir sie hier nichtmehr benötigen.

So. zuerst erstellt ihr mal einen Projektordner.

In diesen erstellt ihr nochmals 3 Ordner, und nennt sie "Audio", "Grafiken" und "Levels".

Diese ordner werden wir nun dem Script hinzufügen. Dazu gehen wir in den Inlcuding Bereich des Scripts ( ganz oben ).
<source lang="c">
//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                 Definitionen und Includings
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
#include <acknex.h>
#include <default.c>
</source>

Hier definieren wir nun einen Pfad, der auf die Ordner verweist:
<source lang="c">
//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                 Definitionen und Includings
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
#include <acknex.h>
#include <default.c>

#define PRAGMA_PATH "Grafiken"
</source>

Dies sagt dem Script nun, dass sich im Ordner "Grafiken" noch Projektdateien befinden, und es darauf zugreifen darf. Erstellt nun Pfade für die anderen 2 Ordner, und ihr habts geschafft.
<source lang="c">
//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                 Definitionen und Includings
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
#include <acknex.h>
#include <default.c>

#define PRAGMA_PATH "Audio"
#define PRAGMA_PATH "Grafiken"
#define PRAGMA_PATH "Levels"
</source>


----


== Ordnerdimensionen erweitern ==
Dies ist ein sehr wichtiger Teil dieses Tutorials.

Was wäre, wenn ihr nun grafiken noch nach Verwendung Ordnen wollt? Also, Grafiken für den Titelbilschirm in einen eigenen Ordner, BGM/BGS/SFX trennen..etc...?

Diese Unterordner lassen sich wie in einem Webbrowser per "/" einfügen. Erstellt einen Ordner namens "Titelbild"  im ordner "Grafiken".

Euer Script müsst ihr nun wie folgt abändern:
<source lang="c">
//==========================================================================================
////////////////////////////////////////////////////////////////////////////////////////////
//                                                                                          
//                                                 Definitionen und Includings
//                                                                                          
////////////////////////////////////////////////////////////////////////////////////////////
#include <acknex.h>
#include <default.c>

#define PRAGMA_PATH "Audio"
#define PRAGMA_PATH "Grafiken/Titelbild"
#define PRAGMA_PATH "Levels"
</source>

Das war´s auch schon. Herzlichen Glückwunsch. Das war euer erster Schritt zu einem geordneten Programmcode.


----


== Syntax dieses Workshops ==

<source lang="c">
#define PRAGMA_PATH "Ordnername"

#define PRAGMA_PATH "Ordnername/Unterordnername"

#define PRAGMA_PATH "Ordnername/Unterordnername/Unterordner..."
</source>
'''Ermöglicht das Einbinden von Ordnern und deren Unterordnern in das Spielscript. Sodass Dateien daraus gelesen und hineingeschrieben werden können.'''






----