IrrlichtWrapper Library

Online Portal


Overview

The first thing I must do is acknowledge the fantastic work that has been carried out by the many different authors whos amazing work makes it possible for this package to enable FreeBASIC programmers to build rich and immersive 3D applications and games. You can find a list of acknowledgements at the end of this document.

This wrapper library provides a simple and partial gateway from non object-oriented languages like FreeBasic into the object oriented 3D graphics Engine Irrlicht. Although the wrapper only exposes part of the functionality of Irrlicht it endevours to expose the most important parts to give you access to Irrlichts powerful features. It does not directly expose the Irrlicht commands but provides a seperate syntax to encapsulate the engine.

In total it provides well over 300 commands that cover Bitmaps, 3D models, Maps, Terrains, Cameras, Lights and more. 


This document serves as an introduction into the wrapper, from here I suggest you follow the installation instructions below and then try out the examples, these practical demonstrations provide an excellent way to learn how the wrapper functions. If you need specific information your first port of call will be the reference manual and your last port of call the IrrlichtWrapper.bi which hopefully you will not need.

Download

By clicking the banner below you will download the latest version of the IrrlichtWrapper library for Windows, compatible Irrlicht Library, example FreeBasic programs and media files by various artists. A version for Linux Fedora 11 is also available for download at the moment there is no specialist support for this package.

Screenshots




Documents

Lighting

A discussion on Lighting in a real time environment, discusses common lighting techniques, lighting problems and shadowing.

Collision

A discussion on Collision in a real time environment, discusses common collision detection techniques, collision problems and collision physics engines.

Game Design

An analysis of one approach to Game Design for a simple application through a game design example..


Media

Space Pack 1

A small working selectin of Stars, Planets, Moons, Nebula and Spacecraft that give you a head start in experimenting with a space scene.

Water Pack 1

A small working selection of textures that can be used for experimenting in and animating water surfaces.

Architecture Pack 1

A small working selection of Buildings and textures that can be used for experimenting on working with building layouts and building interiors.


License

The IrrlichtWrapper is supplied under the same license as the Irrlicht Engine which is itself based in part on the work of the Independent JPEG Group and the zlib. Please refer to the Irrlicht documentation and license agreements for further information.

This software is provided 'as-is', without any express or implied warranty. In no event will the author be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.


Acknowledgements

I wish to express my gratitude  to the following people that have helped with contributions to the wrapper or with technical assistance for various features and problems.
Irrlicht http://irrlicht.sourceforge.net/author.html
FreeBasic http://www.freebasic.net/index.php/about?section=credits
Simple Terrain Spattering With invaluable help from the OpenGL Splat tutorial by Jarno van der Linden (http://www.cs.auckland.ac.nz/~jvan006/multitex/multitex.html)
Grass SceneNode Released under the Irrlicht License by G Davidson
Clouds SceneNode Released under the Irrlicht License by G Davidson
Lens Flare Scene Node Placed into the public domain by Paulo Oliveira
6DOF Camera With lots of help from Colin MacDonald and theoretical advice from Aleofjax
Color and Spline particle affectors Released under the Irrlicht License by Dark Kilauea
Newton Physics Engine support Developed by SiskinEDGE and the library provided by the Newton Game Dynamics team
Open Dynamics Engine Physics support Bindings developed by D.J Peters and the library provided by the Open Dynamics Engine team.
Many Irrilicht commands and support Provided by Agamemnus and The Car
FreeType truetype font support Provided by the FreeType team (www.freetype.org)
Batching Meshes Provided by Gaz Davidson (Bitplane) 
XEffects - Reloaded Provided by Blindside
Many thanks for the development tools Code::Blocks (www.codeblocks.org); GCC Compiler (gcc.gnu.org); FBIde (www.freebasic.net); FBEdit (fbedit.freebasic.net); NVu
Lots of thanks for help in the Forums Eponasoft; Daiwa; Crocodudule, John K, AlecZ, Alvaro Victor; thebignic and everyone that has offered their support. Thanks.
And many thanks to the thousands of mails posts, examples, replies and comments scattered across the Internet that provided insights into many of the questions that needed to be solved in creating this library.

Contact

If you have any problems or suggestions I would be happy to receive them. Although I can not promise any action or an individual response I do try to help where possible and to look after my babies even when I release them into the wild. You can contact me on the IrrlichtWrapper freebasic website or by e-mail: frankdodd at ukonline.co.uk