Overview
The plan is, to supply a tool to the Haskell community, which allows coding 3D Games. But instead of re-inventing the wheel and re-coding all 3D libraries, audio libraries and physics libraries, the goal is, to provide wrappers around existing open source packages. Most of them are written in C++. The approach is, to do this in a manner, which reliefs users from the burdon of getting into the details of C++ to Haskell conversion, Windows dll compatibility issues and other obstacles.

As a start, the 3D games engine OGRE was choosen as a graphics engine, together with the OIS package (with help of OISB) as an input layer. Next steps might be, to add sound libraries or physics libraries. On top of that a Haskell API is being placed.

It is the goal of this project, to provide an easy start to newcomers. Therefore an installer has been provided and first examples, how to use HGamer3D.

Current Status
About more then 2000 methods of the Ogre and OIS libs have been made accessible. Although this sounds like a big number, there is much more to do and a substantial part of the Ogre API has not been wrapped yet. Have a look at the API documentation, to see, what can be done so far. The binding can be used at is, but also a more simple to use interface is planned on top of it. Since some evolution is expected here, I started to name the APIs on top of the bindings with numbers. The first try is named "HGamer3D.APIs.One" and further ones might be named "Two", "Three" and so on.

The "One" Api currently contains methods to create lines, cubes, load meshes, play animations and get keyboard input, as well as place basic lightning and camera. All objects can be moved and they can be combined to groups, to allow movement and rotation of a group. The basic API of the bindings of course contains a lot more functionality. The current wrapper library is still limited in cases, where methods are not wrapped, due to missing data type conversions.

Open Source
The project is place into open source, with an Apache 2.0 license. The source code is available.

Usage Information
Currently the available documentation for HGamer3D is limited. To get start coding your own Haskell programs with 3D support, you could check out the Ogre API documentation and try to transfer the C++ examples into Haskell code with the help of the provided API documentation.