FunGEn

A lightweight, cross-platform, OpenGL/GLUT-based game engine. http://joyful.com/fungen

Latest on Hackage:1.0.1

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.

BSD3 licensed by Andre Furtado
Maintained by Simon Michael
/* body { background-color:black; color:white; } */ .a { font-weight:bold; color:red; font-size:200%; } .b { font-weight:normal; /* color:#bbb; */ color:black; font-size:smaller; }


Functional Game Engine

FunGEn (Functional Game Engine) is a BSD-licensed, cross-platform, OpenGL/GLUT-based, non-FRP game engine/framework written in Haskell. Created by Andre Furtado in 2002, it's the oldest Haskell game engine, and with very few dependencies and two example games, it's one of the easiest ways to get started with Haskell game development. It provides:

  • Initialization, updating, removing, rendering and grouping routines for game objects
  • Definition of a game background (or map), including texture-based maps and tile maps
  • Reading and intepretation of the player's keyboard and mouse input
  • Collision detection
  • Time-based functions and pre-defined game actions
  • Loading and displaying of 24-bit bitmap files
  • Some debugging and game performance evaluation facilities

Simon Michael provides basic maintenance for this package. If you'd like to take it over, contact me (sm on the #haskell-game IRC channel).

Home: http://joyful.com/fungen \ Hackage: http://hackage.haskell.org/package/FunGEn \ Code: https://github.com/haskell-game/fungen \ \ Docs:\   Changelog \   API docs \   Andre's original pong tutorial \   Haskell wiki Game_Development \   Haskell wiki OpenGL tutorial \

\ **Community:**\   [#haskell-game](http://ircbrowse.net/day/haskell-game/today/recent) IRC channel ([join](http://webchat.freenode.net/?channels=haskell-game)) \   [FunGEn questions](http://stackoverflow.com/search?tab=newest&q=fungen) on Stack Overflow \   [haskellgamedev](http://www.reddit.com/r/haskellgamedev) reddit \   [haskell-cafe](http://www.haskell.org/haskellwiki/Mailing_lists) mail list \

Getting started

$ cabal update
$ [cabal sandbox init]    # if needed, to avoid dependency problems
$ cabal install FunGEn    # & make sure ~/.cabal/bin or ./.cabal-sandbox/bin or windows equiv. are in your PATH
$ fungen-hello
$ fungen-pong
$ fungen-worms

or

``` $ git clone http://github.com/haskell-game/fungen $ cd fungen $ stack install $ fungen-hello $ fungen-pong $ fungen-worms

``

History

Andre's 2002 site included this Q & A:

What is a game engine?

A game engine can be considered as a library that provides game facilities to a game programmer. When using a game engine, the programmer must specify when the game events happen, rather than how they are implemented. A same functionality may have its implementation varying from platform to platform, in the case the engine is platform-independent. The main advantage of a game engine is that it can be reused to the development of many different kind of games, in an automated way, saving a lot of programming time.

Why Haskell?

We believe that Haskell is a great language to develop games, because of its high level of abstraction and the generation of a more concise, elegant and shorter code. This is great for code maintenance and understanding. Combining the power of Haskell with the facilities provided by game engines seems a promising project. You can find more info on Haskell in its official site.

What is HOpenGL?

HOpenGL stands for Haskell Open Graphics Library. Actually, it is a binding to one of the most famous graphics libraries around the world (OpenGL) and its auxiliary toolkit (GLUT). In other words, it makes possible to call OpenGL/GLUT routines (which were written in the C language) when programming in Haskell. You can find more info on HOpenGL in my HOpenGL Tutorial site, or in its official site.

and this:

Current Status: Some feedback indicated that the first version of FunGEn was not as "functional" as it was desired: some game issues were still being dealt through an imperative fashion. This way, the authors of this project decided to change the game engine philosophy: programmers should describe a game as a set of "specifications" rather than defining its behavior imperatively. One plausible alternative for accomplishing this task is porting the Clean Game Library (CGL) to Haskell, adding some FunGEn specific features. Hence, this is the actual status of the FunGEn project: it is being rebuilt in order to provide game programming mechanisms following the CGL concepts. This really demands some time, but the authors expect a new version to be released soon.

... PLEASE NOTE: this is the very first version of FunGEn, and it was released just to get some feedback from game programmers. You are strongly invited to tell your game programming experiences with FunGEn, helping us to release a definitive, stable version). Ok, after this disclaimer, please fell yourself free to take a quick tour in the site; it contains a lot of useful information for those who are really interested in trying a new game programming experience. Nice coding...

and this todo list:

Here you have a list of some upcoming FunGEn features, and some other desired features (but with no implementation prevision yet).

  • Support map scrolling (coming soon);
  • Support mouse input management (coming soon);
  • Make a polygon map definition avaiable (coming soon);
  • Make sound avaible to non-Win32 platforms;
  • Create, if possible, some operators to avoid the excessive (x <- ...) syntax;
  • Support auto-animated objects;
  • Create a GLUT independent font support (or perhaps extend it);
  • Improve the installation process;
  • Upgrade FunGEn to be both a 2D (bidimensional) and 2D 1/2 (bi and a half dimensional) engine;
  • Create a map editor/generator (possibly in other language, or using the brand new Haskell GUI...);
  • Take courage to start thinking about the 3D world...

Would you like to suggest a feature? Feel free to do it. Would you like to implement a feature? Please do it! Keep in touch.

and these credits:

FunGEn was created by Andre Furtado, Computation Science graduation student at the Informatics Center (CIn) of the Federal University of Pernambuco (UFPE), as part of a Scientific Iniciation (PIBIC/CNPq) research project (Creating a Game Platform Using Haskell), oriented by lecturer Andre Santos (PhD, 1995, University of Glasgow), who was responsible for figuring out a lot of FunGEn implementation details.

I would like to thank also the following people who contributed for the development of FunGEn:

  • Sven Panne
  • Jay Cox
  • Geber Ramalho
  • Carlos Andre Pessoa
  • Charles Madeira
  • Monique Monteiro
  • The people at the Haskell mailing lists

FunGEn can be distributed freely, in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. I would thank you if you cite my name and this site if you are going to use FunGEn for other things besides home programming.

Changes

1.0.1 2016/8/18

* add stack config for GHC 8
* fix building with current stackage/OpenGL/GLUT
* fix examples' wrong dependency

1.0 2015/9/21

* support GHC 7.10
* support stack
* repo moved to haskell-game organisation

0.4.6.1 2014/10/9

* update changelog

0.4.6 2014/10/9

* move to github, enable issue tracker

0.4.5 2014/10/8

* add executables to run examples (fungen-hello, fungen-pong, fungen-worms)

0.4.4 2014/10/7

* add missing files to cabal file (Samuel Gélineau)
* support & require latest OpenGL 2.9
* make IOGame also a Functor and Applicative, for ghc 7.10

0.4.3 2014/4/5

* set upper bound on OpenGL to avoid build failure with OpenGL 2.9

0.4.2 2013/08/07

* add q as quit key to examples
* fix buggy input when holding down keys on windows

0.4.1 2013/08/06

* reorganised and exposed more haddocks

0.4 2013/08/05

* a new hakyll-based website, incorporating the old site
* tested with GHC 7.6
* input handlers now receive mouse position and modifier state
(inspired by Pradeep Kumar). See fungentest.hs for examples.
* more haddocks

0.3 2011/02/13, Simon Michael

* updated for GHC 6.12 & base 4
* module names simplified
* beginning of haddockification
* docs moved into repo
* published to darcsden, hackage, wiki, haskell-cafe, #haskell-game, reddit

0.1-hackage 2008/09/17, Miloslav Raus

* first hackage release
* updated for GHC 6.10
* cabalised
* Tested under Win32 & Linux/Intel. Known glitches: Flickering under linux
(at least on my shitty laptop). Weird pong paddle behavior under Win32.

0.1-ghc6.8 2008/02/26, Simon Michael

* updated for GHC 6.8
* slight tweaks to examples
* public darcs repo

0.1 2002, Andre Furtado

* first public release
Used by 1 package:
comments powered byDisqus