Konvertieren von C-Skript-Code nach lite-C

lite-C ist der Syntax von C/C++ sehr viel ähnlicher als C-Skript. Während der Code selbst weitgehend unverändert bleiben kann, sind einige subtile Änderungen in Definitionen und Angaben nötig. Hier finden Sie alle notwendigen Schritte zum Konvertieren Ihres C-Skript-Codes in C .

Bevor Sie anfangen - bereinigen Sie Ihren Code

Um das Ganze einfacher zu gestalten, können Sie mit Textumwandlungs-Software arbeiten. ReplaceEm (z. B. unter http://www.freeware-archiv.de/BKReplaceEm-Dateien.htm) ist ein kostenloses Werkzeug, welches sich zum fast automatischen Aufräumen Ihres C-Skript-Codes und anschließenden Konvertieren in lite-C verwenden läßt. Hier finden Sie zwei Austauschtabellen für dieses Tool: wdl_to_wdl.txt bereinigt schlampigen Code in Ihrer C-Skript-Datei und wdl_to_c.txt konvertiert ihn anschließend in lite-C. In vielen Fällen wird das Konvertieren dennoch etwas Handarbeit (s. u.) brauchen, die beiden automatischen Austauschoperationen sollten 70% der Aufgabe übernehmen.

Vergewissern Sie sich auch, daß Ihr Code mathematisch korrekt ist. Fehler - z. B. das Vergleichen nicht ganzzahliger Wert mit '==' or '!=' - können in C-Skript und in lite-C zu verschiedenen Ergebnissen führen.

Nehmen Sie '.wdl' oder '#define PRAGMA_' für Projekt-Vorgaben

In einem Projekt mit lite-C dienen .wdl-Dateien nun lediglich zum Definieren von Pfaden, Resourcen, Ordnern und dem StartUp-Fenster. Für Code, Variablen, Includes etc. lassen sie sich nicht verwenden. Wenn sie denselben Namen wie die .c-Datei hat, wird eine.wdl-Datei beim Hochfahren automatisch gelesen. Hat Ihr Projekt z.B. den Namen "test.c", geben Sie Ihre Satements PATH, RESOURCE, SAVEDIR, PLUGINDIR, WINDOW etc. in der "test.wdl" an. Alternativ benutzen Sie #define PRAGMA_..-Statements für Projekteinstellungen.

Namen: beachten Sie die Schreibweise

# Praeprozessor-Definitionen

#include "material.c"	 // C-Script: include <material.wdl>;  
#define MYNUMBER 17    // C-Script: define MYNUMBER,17;
#ifdef MYDEF           // C-Script: ifdef MYDEF;
...
#else                  // C-Script: ifelse;
...
#endif                 // C-Script: endif;

#define MYNUMBER  (17+15)
#define NEGATIVE(x)  (-x)

Organisieren Sie Ihre Skripte

Ersetzen Sie <> durch""

Verwenden Sie Funktions-Prototypen

function particle_explosion(PARTICLE* p); // function prototype
...
particle_explosion(p); // function call
...
function particle_explosion(PARTICLE* p) // function definition
{
  ...
}

Verwenden Sie stets Pointer

Initialisieren Sie stets die Variablen

VECTOR speed;

vec_zero(speed);	// initializes the VECTOR "speed" to x=0,y=0,z=0

Zum Umstellen und Testen kann lite-C mit der Definition PRAGMA_ZERO automatisch alle globalen und lokalen Variablen auf Null initialisieren. Dazu fügen Sie folgendes hinzu:

#define PRAGMA_ZERO   // initialize variables

Am Anfang Ihres Skriptes werden sämtliche nicht-initialisierte globale und lokale Variablen auf Null gesetzt. Dies verlangsamt ein wenig die Funktionsaufrufe und daher ist es vorzuziehen, PRAGMA_ZERO nicht in Ihrer Endversion zu benutzen. Globale Variablen und Structs werden in lite-C immer och automatisch auf Null initialisiert, dennoch sollten Sie es sich zur Gevohnheit machen, ihre Initialwerte anzugeben.

Prüfen Sie Vektoren und Arrays

var vSpeed[3] = 10,20,30; // C-Script
var vSpeed[3] = { 10,20,30 }; // lite-C - address with [0], [1], [2]
VECTOR* vSpeed = {x=10;y=20;z=30;} // lite-C - address with .x, .y, .z

 !!  Ein falsches Anwenden von Arrays kann zu Ärger beim Konvertieren eines Skripts führen. In C-Skript entsprach der Name eines Arrays seinem ersten Element. In C ist er die Adresse des Arras. Der folgende Code nun ist in seiner Syntax korrekt, führt jedoch in C-Skript und lite-C zu unterschiedlichen Ergebnissen.

var my_vector[3];
...
var x = my_vector;    // C-Script: x is set to the first array element
var x = my_vector;    // lite-C - wrong: x is set to the array pointer!
var x = my_vector[0]; // lite-C - correct: x is set to the first array element

Das Verwenden von Funktionen, Starter-Funktionen und DLL-Funktionen

In lite-C läuft die main-Funktion vor dem ersten Frame und ermöglicht so Videoeinstellungen bevor die Video-Hardware initialisiert wird. Das bedeutet, dass Sie einen Frame warten müssen - wait(1) - ehe Sie Funktionen, wie beispielsweise video_switch() oder video_set() aufrufen, die auf die Video-Hardware zugreifen.

Setzen Sie Engine-Variablen oder Events in Funktionen

function ie_startup() 
{ 

  d3d_autotransparency = ON;


	on_f2 = ie_save;
	on_f3 = ie_load;
	on_f5 = ie_video;
	on_f6 = ie_shot;
	on_f10 = ie_exit;
}

Setzen, Zurücksetzen oder Umschalten von Flags

mypanel.flags |= SHOW;  // C-Script: mypanel.SHOW = ON;
mypanel.flags &= ~SHOW; // C-Script: mypanel.SHOW = OFF; 

#define set(obj,flag) obj.flags |= (flag)
#define reset(obj,flag) obj.flags &= ~(flag)
#define toggle(obj,flag) obj.flags ^= (flag)
#define is(obj,flag) (obj.flags & (flag))
...
set(mypanel,SHOW);
reset(mypanel,SHOW);
toggle(mypanel,SHOW);
if is(mypanel,SHOW) { ... }

mypanel.flags |= (SHOW|LIGHT|TRANSLUCENT);
set(mypanel,SHOW|LIGHT|TRANSLUCENT);

 !!  Bitte beachten Sie: der alte Flag TRANSPARENT wurde in TRANSLUCENT umbenannt (denn TRANSPARENT wird bereits vom Windows-GDI-Header benutzt). Achten Sie ausserdem darauf, den richtigen flags-Parameter zu setzten, denn Entities haben mehr als einen: Es gibt auch eflags, emask, smask, und flags2 -Parameter, die nicht von Makros begleitet werden (obgleich Sie einige definieren könnten):

ENTITY* eSky = { type = "clouds+2.tga"; flags2 = SKY | DOME | SHOW; }

Speichern und Laden

Execute

TEXT* def_ctxt = { string = "Enter var or STRING","#80"; layer = 999; }

void def_console() // Tab
{
  def_ctxt.pos_x = 2;
  def_ctxt.pos_y = screen_size.y-30;
  toggle(def_ctxt,SHOW);
  while is(def_ctxt,SHOW) {
    beep();
    inkey((def_ctxt.string)[1]);
    if (13 == result)
      var_for_name((def_ctxt.string)[1]);
    else
      reset(def_ctxt,SHOW);
  }
}

Proc_late

sleep(x)

Trigonometrische Funktionen

x = sinv(45.0);	// C-Script: x = sin(45.0);

var_info, var_nsave

Skills

Arrays

var test[3] = { 1,2,3 };	// C-Script: var test[3] = 1,2,3;

STRING

//STRING* str; // this would be just an empty pointer in C
//STRING* str[80]; // this would be just an array of empty pointers in C
STRING* str = "Now this is \n a string!"; // Allocate a string
STRING* str = ""; // Allocate an empty string
STRING* str = "#1000";	// Allocate a 1000 characters string filled with spaces;

 !!  Konstante Schriftzeichen, die Sie (wie "Hier sind ein paar Schriftzeichen") zwischen Anführungszeichen setzen, haben in C den Typus char[], in C-Skript aber STRING*. Da fast alle Engine-Funktionen sowohl char[] als auch STRING* als Argumente annehmen können, brauchen Sie sich in der Regel also gar nicht um diesen Unterschied zu kümmern. Einige Anwender-DLL-Funktionen allerdings könnten explizit einen STRING* erwarten. Um solchen Funktionen Argumente zu übergeben, müssen Sie demzufolge Strings definieren.

TEXT-Strings

//str_cpy(mytext.string,"Test!"); // C-Script style
str_cpy((mytext.pstring)[0],"Test!"); // C style 

FONT

//FONT imgfont = "fontimage.pcx", 7,12; // C-Script style
FONT* myfont = "fontimage.pcx"; // C style
//FONT ttffont = "Arial",1,10; // C-Script style
FONT* ttffont = "Arial #10b"; // C style, size 10, bold 

ENTITY, SKY

ENTITY* eSky = { type = "blood_gorge+6.tga"; flags2 = SKY|CUBE|SHOW; }

PARTICLE

function particle_effect (PARTICLE *p)
{
   p.size = 50;
   ...
}}

my, you

Debugging

-Setzen Sie, indem sie den Kommentar-Tag '//!' ans Ende der Zeile stellen, einen Breakpoint in den Code. Breakpoints können nur in reinen lite-C-Programmen (mit einer main() -Funktion, nicht mit WinMain()) gesetzt werden und dies auch nur in der Haupt-Datei (main), nicht in einer eingefügten (include). Sie funktionieren nur nach dem ersten Frame, wenn Sie sie also in die Main-Funktion setzen, fügen Sie davor ein wait(1) ein.
- Starten Sie die Engine im Fenstermodus und mit der Kommandozeilenoption -debug.

Sobald der Breakpoint getroffen wird, hält die Engine an und es wird die gegenwärtige Quellzeile im Titelbalken angezeigt. [Esc] bricht das Debuggen ab, [F10] geht zur nächsten Anweisung und [Shift-F10] geht über Funktionsaufrufe hinweg und [Ctrl-F10] läuft zum nächsten Breakpoint. Globale Variable können in einem Panel oder einem SED-Watch beobachtet werden. Lokale Variable lassen sich überprüfen, indem man sie vorübergehend durch globale ersetzt.

-d Kommandozeilenoptionen

var Test1 = 0;	// is set to 1 by "-d Test1" 
var Test2 = 77;	// is set to 78 by "-d Test2,78" 
STRING* sTest3 = "old";	// is set to "new" by "-d sTest3,new" 

Siehe auch:

► Aktuelle Version Online