Cannonball-Android: A OutRun Engine
C++ Java C
Clone or download
Pull request Compare This branch is 36 commits ahead, 21 commits behind djyt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
android
cmake
docs
external
res
roms
src/main
.gitattributes
.gitignore
README.md
todo.txt

README.md

Cannonball-Android - OutRun Engine

See Reassembler Blog.

Credits

  • Chris White - Project creator.
  • Arun Horne - Cross platform work.
  • Tim Leader - Android port.

Getting Started

Cannonball has been successfully built for Windows, Mac OS X, Linux, Open Pandora, Raspberry Pi and now Android.

  • Install your favourite C++ environment (e.g. GCC, Visual Studio, Xcode, MingGW etc.)

  • Install CMake. This generates your platform and compiler build files.

  • Extract the Boost Library somewhere, for example: c:\coding\lib\boost_1_51_0

  • Extract the SDL Library somewhere, for example: c:\coding\lib\SDL-1.2.15

  • Read the SDL documentation & compile the SDL Library for your system.

  • Windows only, download and install the Direct 8.1 SDK

  • Extract the Cannonball code somewhere, for example: c:\coding\cannonball

  • You may need to create a .cmake file for your system to configure specific options. See the cmake subdirectory for more details. If not, the default.cmake file will be used.

  • Install Android-SDK

  • Install Android-NDK

  • Install Ant

  • Suggest NVPACK

Build

  • Run CMake to generate the relevant build files for your compiler. You can optionally pass -DTARGET=filename to pass a custom .cmake file
  • Compile using your chosen compiler. Further details below.

mkdir build
cd build

Non-IDE (e.g. straight GCC)

cmake -G "Insert Generator Name Here" ../cmake
make

MinGW

cmake -G "MinGW Makefiles" -DTARGET=mingw ../cmake
mingw32-make

Visual Studio 2010

cmake -G "Visual Studio 10" ../cmake
  • Copy SDL.DLL and the roms subdirectory to the build directory.
  • Right click the 'cannonball' project in the IDE and choose 'Set as StartUp project'.
  • You can then compile, debug and run from Visual Studio as expected.

Run

  • Copy the OutRun revision B romset to the roms subdirectory. Rename the files if necessary.
  • Copy or link the roms subdirectory to whereever your executable resides.

ln -s ../roms roms
./outrun

Building SDL-1.2.15

Darwin

./configure --prefix=~/SDL-1.2.15/build --disable-assembly

MinGW

See: Setting up MSYS MinGW build system for compiling SDL OpenGL applications.

Execute the below commands from the msys environment.

./configure --prefix=/mingw --enable-stdio-redirect=no
make
make install

Android Build

cd android
android update project -p .
ndk-build
ant debug

ant installd