Basics Home 

Basics
Brief Info
Main Advantages
The PreCompiler
Documentation



Editor-Project-Basics ... Making life (Blitz Basic Programming) a bit easier I made some changes and added some Features: I programmed a PreCompiler which I will explain some lines further down. Duplicated and patched the files Blitz3D.exe and IDE.exe. They are now twice each in the same Folders the "new versions" with new Tasks and are called Blitz3DEdit.exe and IDP.exe that are used in addition to the Originals.



A brief info how it functions:


I want to program in the environment (BlitzEditor) I am used to - but use the Editor to write a slightly different Source-Code. This Code can contain additional Commands that are interpreted by the PreCompiler which then produces the final Blitz-Source.

1. Start of Blitz3DEdit

2. Load *.bbp File or start new *.bbp File (with own Commands like Template, MyLongerWordValue#+=5, etc.)

3. Save the File

4. Clicking the Run-Icon the Precompiler starts and changes all Code to Blitz-Code, produces the Include-File (!!!) with all and only the used Commands of a library and starts Blitz3D.exe (the Original) by calling the new *.bb-file that was produced by the Precompiler

5. Compile that to an exe or Run with debug or without as usual.



Main Advantages:

You have all Functions and Templates in Folders and just use them in your program without declaring them. The Precompiler finds them and produces a file that contains them. No own caring for Includes, Double-Includes and. You have a huge library in one Folder and the Precompiler does all time-consuming jobs for you.



What can the PreCompiler do for you...

The Command MyFuncs! tells it where to put the line Include ProgramPath$+ProgramName$+"Func.bb"
If the Command is missing this will go on top of the Program.

The Command Template TemplateName will be changed to Include ProgramPath$+"TemplateName.bb"
This Command is like Include but you don't have to worry about Paths.

The Command Uses TemplateName will put the Template direct into the bb-File.

You can use the C-Syntax x+=8 x-= x*= x/= instead of x=x+8 etc.

The Folder Funcs and its Subfolders contain all your Functions and Templates. You write them, place them and thats all you ever have to worry about. Next Time you use one of your Functions in your Program - they will be included automatic. That keeps the Exe as compact and as small as possible (would be nice if Blitz could do the same one day).



Documentation of your own Functions:

A very important thing is to document the Functions you have written. Therefore you will soon be able to download a Program, which will patch the original help-files. Its not complete yet - I am working on it. It adds a link to your own Helpfiles which are called My - Category  right below 2D - Category and 3D - Category in the original Help-File.
As I have planned it you can write the Command, the parameters explained, the Text right below each Function (ignored by the Precompiler) and the Program produces the HTML-Sites exactly looking as the Blitz-Help-Files. This will next be added here.