Readme for OpenTitus
Git version
http://opentitus.sourceforge.net/

OpenTitus is released under the Gnu GPL version 3 or (at your option) any later version of the license, and it is released "as is"; without any warranty.

The OpenTitus team:
Eirik Stople - Main developer - eirik@pcfood.net
Eitan Tal - Valuable assistant, technical advisor

Thanks to:
Eric Zmiro and his team in Titus Interactive who made the great games Titus the Fox and Moktar!
Jesse, who made a fansite for the original game and an editor and provided me information how the original game files was built up, and assisted me with the makefile and MinGW!
The SDL project (LibSDL, LibSDL_mixer)!
The GNU project (GCC, GDB and GPL)!
MinGW/msys!
Ubuntu (programming environment)!
Linux!
Dosbox!
Dropbox!
GEdit!
Notepad++!
Google search!
Chocolate-Doom's great OPL (adlib) emulator!
Various tutorials/information sources on the net!


Git instructions:
Compile according to COMPILING.
To test out your build, copy it into the game folder and follow the instructions inside bin/README.
Precompiled binaries are available in builds/


You need the original game files to make use of OpenTitus. OpenTitus parses the original files. It works with both Titus the Fox and Moktar.
Place the original game files in the "titus" or "moktar" folder. The files must be placed according to titus.conf.

Runtime dependencies:
SDL runtime library
SDL_mixer runtime library

To run the game, run opentitus (in Linux) or opentitus.exe (windows).

To quickly start up Titus, copy a Titus game directory to the same folder as the opentitus executable, and name the folder "titus".
To quickly start up Moktar, copy a Moktar game directory to the same folder as the opentitus executable, and name the folder "moktar". You can modify titus.conf if you like, or use the preconfigured "titus_moktar.conf" which you need to rename "titus.conf".

The game engine are ported from the original game, and modified to fit OpenTitus' level structure. Movement are equal to the original game.

If you can find some bugs or differences between OpenTitus and the original games, feel free to contact us!

Enjoy!



"Titus the Fox: To Marrakech and Back" (1992) and "Lagaf': Les Aventures de Moktar - Vol 1: La Zoubida" (1991)
was developed by, and is probably copyrighted by Titus Software, which, according to Wikipedia, stopped buisness in 2005.
OpenTitus is not affiliated with Titus Software.

The source code have been developed during several years, and some parts of the code are old. This code doesn't follow the more recent style, such as "unsigned char" instead of "uint8". As the old code still works, it's not that important to fix it.

The configuration information below are old, and there may be faults in this information. The preconfigured config files should work.
The levelviewer and the game is configured by a file in the same directory; "titus.conf". This file is parsed line by line, and lines starting with # will be skipped.
Keywords:
reswidth = Number of pixels wide, default 320 (originally 640, but the "pixels" in the original game was two pixels wide, so 320 should give the correct size)
resheight = Number of pixels height, default 200 (originally 400 (intro) or 384 (in-game), 200 should give the correct size)
bitdepth = Number of bits pr. pixel, default 32 (the game data files have a 16 colour palette, which means 4 bpp, but higher bpp will work as well)
ingamewidth = Numbers og pixels visible in-game, default 320.
ingameheight = Numbers og pixels visible in-game, default 192.
videomode = Video mode; 0 is window mode and 1 is fullscreen, default 0
levelcount = Number of levels, default 15 (15 in Titus the Fox and 16 in Moktar)
level 1-15 (1-16 for Moktar) = Location of the level files for all levels, default LEVELx.SQZ (the order is "0J123456789BCEFG" for Moktar, Titus is equal except it doesn't have level F)
sprites = Location of the sprite file, default SPREXP.SQZ (SPRITES.SQZ in Moktar)
game = The game opentitus will parse; 0 for Titus the Fox and 1 for Moktar. This is necessary because of different sprite sizes, different menus and different level titles.
logo = The company logo file, default TITUS.SQZ
intro = The game intro image file, default TITRE.SQZ
menu = The menu, default MENU.SQZ
finish = The image displayed when game is completed, default LEVELA.SQZ (this doesn't exist in Moktar)
*format = Image format. 0: 16-colour grayscale, 1: 16-colour (ordinary colours), 2: 256 colours + palette. Logo, intro and menu are 256 colour, *EGA files are 16-colour, and LEVELA.SQZ are grayscale
font = Font file, default FONTS.SQZ

Music spesific:
moduleintro = Location of the module (.mod, amiga audio) file containing the intro music
moduleprelevel = Location of the module file containing the pre-level music
modulegameover = Location of the module file containing the game over music
modulelevelfile 1-6 = location of the module files containing the level music (number 6 is the wedding "level" music)
module*loop = Loop information for the modules. Nonnegative values indicates the location to continue playback when the module is played. -1 indicates to play the module only once.
modulelevelfileloop 1-6 = Should be self-explainable
modulelevel 1-15 (1-16 for Moktar): Defines what modulelevelfile to use on each level