Blitz3D+ Module sample
======================

Run source_main.bb in Extended mode to compile and execute a source Module.
It also runs in a browser, as web builds compile Modules from source.

To exercise explicit precompilation from a command prompt in this directory:

  mkdir objects\Sample
  blitzcc --mode extended --emit-module -o objects\Sample\Math.b3m math.bb
  blitzcc --mode extended --module-path objects precompiled_main.bb

On a Mac, run the same commands in Terminal with Blitz3D+'s bin/blitzcc,
writing objects/Sample for objects\Sample.

For a portable debug object, add -d to both commands. The object carries its
source/Include closure for debugger source tabs and is stored separately from
Release cache entries.

The .b3m file is platform-specific. Emit it separately with the Win32 and
Win64 compilers, and on a Mac, where one object serves macOS, iOS and the iOS
Simulator. Keep each platform's objects in a folder of their own, such as
objects\win32 and objects\win64, and pass that folder to --module-path. Web
builds cannot use .b3m files at all, so precompiled_main.bb is for Windows,
Mac and iOS builds.

Imported source Modules also use the compiler-managed cache automatically
(except in web builds); add --module-stats to see the cold/warm build counts.