Includes Functions

IncludeFile  "Filename" 
XIncludeFile "Filename" 

IncludeFile will include any named source file, at the current place in the code. XIncludeFile is exactly the same except it avoids having to include the same file many times.

Example:

  XIncludeFile "Sources\myfile.pb" ; This will be inserted.
  XIncludeFile "Sources\myfile.pb" ; This will be ignored along with all subsequent calls.. 

This commands are useful, if you want to split your sourcecode into several files, to be able to reuse parts e.g. in different projects.

IncludeBinary "filename" 

IncludeBinary will include the named file at the current place in the code. Including should be done inside a Data block.

Example:

  DataSection
    MapLabel:
    IncludeBinary "Data\map.data"
  EndDataSection 

This command is especially useful in combination with the Catch-commands (currently there are /CatchImage(), /CatchSound(), /CatchSprite()) to include images, sounds, sprites etc. into the executable.

IncludePath "path" 

IncludePath will specify a default path for all files included after the call of this command. This can be very handy when you include many files which are in the same directory.

Example:

  IncludePath  "Sources\Data"
  IncludeFile  "Sprite.pb"
  XIncludeFile "Music.pb"