lib

libtengine

What is libtengine?

libtengine is a library of headers that can be used to easily compile arbitrary code for games that derive from Turok 2's game engine.
Currently the library supports Turok 2 and Turok 3.

How do I use this?

Before you can use this, you first need a few things:

• A C compiler that supports mips3. I personally use gcc-mips 10.2
• libultra. You can get this from the offical SDK, or from a reverse-engineering project like libreultra.

You need to set up the compiler environment so that libultra is in <libultra> (the compiler's search-include path).

After this, you are ready to get started. All you need to do to use this library is:

1. define the game, and release version. Below is a list of the currently supported defines

Game	Releases
GAME_TUROK3	RELEASE_US, RELEASE_EU, RELEASE_N4TKER18, RELEASE_N4TKER15, RELEASE_N4TKER10, RELEASE_N4TKER09
GAME_TUROK2	RELEASE_US, RELEASE_US11, RELEASE_EU, RELEASE_EX, RELEASE_GE, RELEASE_KIOSKUS, RELEASE_KIOSKEU

• Note that if you additionally define LIBTENGINE_INCLUDE_ALL_TYPES, every type will be included, and if you define LIBTENGINE_INCLUDE_ALL, everything will be included.

2. include libtengine.h and any other relevant files. For example, libtengine/lib/CEngineApp.h
3. That's it. Now you can compile code using libtengine.

To compile this example:

#include <tengine.h>
#include <libtengine/lib/COnScreen.h>

void Update(void) {
    COnScreen__DrawText("Hello, world!", 4, 4, 128, 0, 1, 1.0f, 1.0f);

    return;
}

You could evoke gcc as such:

mips64-gcc -G 0 -c -Ofast -fno-reorder-blocks -std=gnu99 -mno-shared -mdivide-breaks -mno-explicit-relocs -mno-memcpy -mno-check-zero-division -march=vr4300 -mabi=32 -mips3 -w main.c -o main.o -DGAME_TUROK3 -DRELEASE_US