Please note, this document assumes you have read the Noble Ape Manual;
The manual contains additional information on the Noble Ape file format and ApeScript that may be required to understand this document.
The Noble Ape Simulation runs on a number of platforms through a number of different interfaces. The term platform here means major OSes like Windows or Macintosh and the term interfaces means command line interface, Noble Ape's Generic Platform Interface (GPI) or the colour Ocelot interface.
If you are developing with the Noble Ape Simulation on Macintosh or Windows, you will probably want the colour Ocelot interface as your interface to the Simulation. For Macintosh, you will need the following directories;
And for Windows;
The source code will compile through GCC, Project Builder, XCode (PPC and INTEL) and VC++ etc. It is periodically tested with all these compilers. The directories can contain legacy make files. These should always be ignored in favour of 'drag and drop' directory compilation.
sim/noble - The Noble Toolkit
The Noble Toolkit fulfills four functions.
The Toolkit was developed to further modularise some of the Simulation's functionality for porting to Noble Warfare and other third-party applications.
sim/core - The Simulation Core
The Core currently fulfills four functions.
sim/script - The ApeScript Interpreter
The ApeScript Interpreter currently fulfills two functions.
ApeScript allows the user to program the Noble Ape's movements. It was important that ApeScript had a level of control and stability that would allow users to tinker with the code, even create erroneous code, without crashing the Simulation.
sim/gui - The Simulation GUI Interface
The GUI interface also fulfills two functions. It;
sim/win or sim/mac - The Simulation Platform Layer
The final platform (OS) specific code is relatively small versus the substantial platform independent code. This has been achieved over a number of years development. The similarities between platforms allows a minimal translation layer and platform specific code to be the only component of this section.
The Noble Ape Simulation has been developed exclusively in C since 1996. The code base has changed dramatically over this time. With the advent and split of 32-bit and 64-bit machines, the development faces many of the same problems it did through the split of 16-bit and 32-bit machines. The basic types in the Noble Ape Simulation are defined in sim/noble/noble.h as;
n_byte - type-defined as unsigned char (one byte)
The n_int value was introduced as the native mathematical integer type. This avoids a lot of type declarations between short and long etc. n_byte2 is typically used for information that is passed into the low-level file handling. There is no negative number handling in the file information extraction and the current coordinate system is based around n_byte2 values. This could change in the future.
In general function names will start with the file name they exist within. The main two exceptions to this - the platform specific code which has the plat_ abbreviation (purely historically) and the GUI/control which has currently inherited a number of additional functions through the transition to the Noble Toolkit and ApeScript.
Some files contain explicit _init, _cycle and _close functions (the 'life of the Simulation') for handling the initialisation conditions and the delta-time (cycle) functions, and the closing of the Simulation.
All the graphics in the Simulation are generated by the Simulation. The Simulation generates low-level platform dependent set graphics in the Noble Ape Toolkit. The organisation and 'second layer' application of these graphics are defined in GUI/draw and this in turn is driven by GUI/control.
There are two types of window and thus through the single graphics buffer there are two types of window described. The distinction is simply B&W and colour. The colour windows are 8-bit colour and thus a byte is used per pixel. The B&W windows are byte packed and thus there are eight pixels to the byte.
The TIME(/METER) and the BRAIN windows are B&W and the TERRAIN and VIEW(/MAP) windows are colour. The TERRAIN window uses the MAP window's offscreen buffer for generating it's image. Basically it skin stretches the MAP window over the dimensional information of the landscape.
Please don't hesitate to get in contact if you have any questions or comments;
There is also a friendly mailing list for introducing developers to Noble Ape;
Created: 10 November 2004