ivanperez-keera / gloss-gtk Goto Github PK

This project adds a new backend to gloss that can be used to embed
gloss images/animations/simulations in GTK+ applications. It uses
the gtkglext package available in Hackage.

Current status is: not finished, still under development.  Do not use
(I'm not joking here) in production just yet.

How this works: in the arguments to 'display', use the InWidget
constructor, and pass a Gtk container as first argument. The canvas
will be added to the container using Graphics.UI.Gtk.containerAdd.

QUICK STATUS OVERVIEW

| Feature              | Status                 |
|----------------------+------------------------|
| Animations           | Working                |
| Simulations          | Working                |
| Games                | Working                |
| Mouse interaction    | Working                |
| Fonts                | Working                |
| Keyboard interaction | Not tested, might work |
| Background colours   | Not working            |

The contents of the original README file follows.

-- 8 Coats of GLOSS -----------------------------------------------------------

Gloss hides the pain of drawing simple vector graphics behind a nice
data type and a few display functions. 

EXAMPLE
    Getting something on the screen is as easy as:

      import Graphics.Gloss
      main = display (InWindow "Nice Window" (200, 200) (10, 10)) white (Circle 80)


USAGE
    Once the window is open you can use the following:
      * Quit            - esc-key.
      * Move Viewport   - left-click drag, arrow keys.
      * Rotate Viewport - right-click drag, control-left-click drag, 
                          or home/end-keys.
      * Zoom Viewport   - mouse wheel, or page up/down-keys.

OTHER THINGS
    Animations and simulations can be constructed similarly using the
    'animate' and 'simulate' functions. Games with user input can be
    constructed with the 'play' function.

    See the gloss-examples package for more.

-------------------------------------------------------------------------------
Release Notes:

 For 1.7.0:
   * Tweaked circle level-of-detail reduction code.
   * Increased frame rate cap to 100hz.
   Thanks to Doug Burke
   * Primitives for drawing arcs and sectors.
   Thanks to Thomas DuBuisson
   * IO versions of animate, simplate and play.

 For 1.6.0:
   Thanks to Anthony Cowley
   * Full screen mode display mode.

 For 1.5.0:
   * O(1) Conversion of ForeignPtrs to bitmaps.
   * An extra flag on the Bitmap constructor allows bitmaps to be cached
     in texture memory between frames.

 For 1.4.0:
   * Added texture caching.
   Thanks to Christiaan Baaij: 
   * Refactoring of Gloss internals to support multiple window manager backends.
   * Support for using GLFW as the window library instead of GLUT.
       GLUT is still the default, but to use GLFW install gloss with:
          cabal install gloss --flags=\"GLFW -GLUT\"
    
 For 1.3.0:
   * Various wibbles for GHC 7.1   
   Thanks to Ben Lambert-Smith:
   * New support for displaying bitmap files.

 For 1.2.0:
   * Cleaned up module hierarchy.
   * Added line-line intersection utils.
   * Enabled -Wall and fixed all warnings.
   * Various wibbles for GHC 7.0
   Thanks to Thomas DuBuisson:
   * Fixed a bug causing motion events to give the wrong position.
   Thanks to Stephan Maka:
   * Fixed a space leak in simulate mode when the window was hidden.

 For 1.1.0:
   * Added game mode.
   * Added QuadTree and Extent structures.
   * Added simple ray casting.