FreeBASIC and OMA games for Windows CE
======================================

This directory contains my Windows CE ARM and MIPS cross-compiler packages,
plus ready-to-copy Windows CE builds of the OMA games and OpenSlicks.

The two targets are:

    arm        ARMv4T, software floating point
    mips       little-endian MIPS III O32, software floating point

Use the target that matches the device or emulator. An ARM executable will
not run on a MIPS device, and a MIPS executable will not run on an ARM device.


Compiler packages
-----------------

The archives under compiler/ are Linux x86_64 cross-SDKs. They run on a Linux
development computer and produce Windows CE .exe files. They are not Windows
CE programs and there is no on-device compiler in this directory.

Each SDK is supplied as both .tar.xz and .zip. They contain the same files, so
download whichever format is convenient and extract it as one directory.

The ARM SDK needs the CeGCC arm-mingw32ce tools on PATH. The exact toolchain
and reproducible build details are in doc/wince.md inside the archive. Compile
with:

    FreeBASIC-1.20.3-r1-wince-arm-cross-linux-x86_64/bin/fbc-wince-arm \
        hello.bas -x hello.exe

The MIPS SDK includes its MIPS PE binutils. Install Clang on the Linux host,
then compile with:

    sudo apt-get install clang
    FreeBASIC-1.20.3-r1-wince-mips-cross-linux-x86_64/bin/fbc-wince-mips \
        hello.bas -x hello.exe

Copy the resulting .exe and any files used by the program to the matching
Windows CE device. The SDK contains the normal and multithreaded runtime,
gfxlib2, sfxlib, libffi and the FreeBASIC headers. Windows CE graphics use GDI
and sound uses waveOut.


Game packages
-------------

Ready-to-run games are under oma/arm/ and oma/mips/. Download the ZIP for the
right CPU, extract the complete game directory, and copy that directory to the
device. Keep game.exe and all of its data files together. Start game.exe from
File Explorer on Windows CE.

The games are statically linked with the FreeBASIC Windows CE runtime. You do
not need the Linux compiler SDK on the device just to run them.

The OpenSlicks package includes a small original test track. It does not
contain the original Slicks 'n Slide data. Add legally owned .SS or .SZT track
files to its TRACKS directory if you want more courses.


Checksums
---------

SHA256SUMS contains the SHA-256 hash of every package and this README. The
manifest does not hash itself. The compiler directory also contains separate
checksum files for each SDK archive.

end of readme.txt