LEAF Project

Features
(Current release 2.1)

Powerful 3D OpenGL Renderer
Scene management using octrees
Cross-plataform window management (See table below)
Sprite engine, with scaling, rotation and alphablending and more.
Integrated resource manager for sound, textures and meshes
Most common file formats supported (See table below)
Material/Geometry shaders, supporting both GLSL and software targets
Supports both skeletal and keyframe animation
Custom static skyboxes
Realtime dynamic skydome, with day-night system
Advanced 3d audio system using OpenAL
Ogg streaming sound using OggVorbis
Extensible scripting language (Pascal based, read manual here)
File Package support (*.LEAF files, editor included)
Data/File Compression support
Complete vector math library
File patching/updates support
Network UDP Client/Server
HTTP Client/Server
SMTP mail support
XML custom loading/saving library
Extensible GUI system (windows, buttons, icons, text)
Basic support for AI (pathfinding, FSMs)
Joystick support (Windows only)
Internal video decoder, with support for custom codecs
Video decoder via DirectShow (Windows only)

Targets supported by LEAF2

Windows	Delphi 7 FPC 2.0.2
Linux	FPC 2.0.2
MacOS	Not supported yet, in progress

File formats supported by LEAF2
Note - Support for custom formats can be added easily

Textures	BMP JPG PNG TGA GIF	4,8, 24 and 32bits 24bits 4,8 and 32bits, transparency 24 and 32bits, transparency 8bits, static and animated
Models	LMX MS3D MD2 3DS OBJ LAX	Skeletal animation Skeletal animation Keyframe animation Static geometry only Static geometry only Animation data only
Sound	WAV OGG MOD	8, 16bits 16bits Not working yet
Media	AVI	All codecs, using DirectShow

Screenshots

FAQ

How to add an icon to my LEAF application?

Create a new text file and write the following:
IDI_MAIN_ICON ICON "LEAF.ico"
Replace LEAF.ico with the desired icon name and save the file as LEAF.rc
Put the file in the same folder as the source code.
Now in you main dpr file, add the following line to the program source.
{$R 'LEAF.RES' 'LEAF.RC'}

My LEAF application is creating a huge log file.
How to disable the log?

The LEAF Log system uses pipes to redirect log output.
To create a pipe you use the LogAddPipe and LogSetDefaultPipe function.
Add the function calls to the program initialization.
Some common usages are:

To disable all OpenGL missing extensions warnings:
LogAddPipe('GL',ltWarning,lpNull);

To disable all warnings:
LogSetDefaultPipe(ltWarning,lpNull);

How to create a LEAF package?

Use the PackageTool to create packages.
Run it in the command line, with the following sintax:
PackageTool <PackageName> <Action> [FileName]

For example, the following command creates a Mesh package, using all files in the C:\Project\Mesh folder.
PackageTool Mesh -n C:\Project\Mesh\*.*

Why LEAF doesnt support file format [insert format here]?

Currently LEAF supports the most common file formats for images, 3d models and sound.
If a file format isn't supported, is because there's some patent issues, or I couldn't found the format specs.

However, LEAF2 is a very customizable engine, and you can add support for any format easily, as long as you can decode the data yourself.
Just take a look at the LEAF_BMP, or LEAF_WAVE, and use these as a template to create your own.

Download

Note - Currently LEAF2 is still under development.
The version avaliable here is a alpha version.
Is fully functional, but may contain some bugs.
Extra features may be added later.
The engine is now only avaliable in source code.

Download LEAF2 source code

Note - The source code include additional libs.
However, these libs are only necessary if you use specific components.
If you have trouble compiling some libs, check the following table for possible alternatives.

Lib	Required by	Alternative
DirectX	Windows only. Required if you're using LEAF_DirectShow for playing media.	The built-in media decoder, LEAF_AVI, is less compatible, but is faster and lightweight. Can also be used with Linux.
PasJPEG	Required if you're using JPG file support.	Use other fileformats, like PNGs, that also support compression, but have bult-in decoders.
ZLIB	Delphi only. Required if you're using PNG file support.	Use other fileformats, like JPG or TGA. You can also try compiling with FPC, that uses the pre-installed zlib.
OGG	DLLs only. Required if you're using OGG file support.	Use other file formats, like WAV.

No documentation is avaliable yet, however these tutorials should be enough for now.
They're compiled and test using all LEAF2 versions, for both supported targets.
At the time of writing, there's still some issues to resolve with Tutorials 3 and 4 for Linux.

Installation

Unrar the compiled units to a folder, called for example LEAF2.
Then you must add the folder to the compiler unit/library path.

Delphi
In the Delphi IDE, you can add the folder to the library path by going to
Tools->Environment Options->Library->Library path

FPC
In the FPC IDE, you can the folder to the unit path by going to
Options->Directories->Unit path
Or, when compiling in the command line, use the -Fu switch to include the path.

LEAF2

Game Engine for Delphi/FreePascal