Version bump for 0.7

Fix run-time warning when closing NULL dir

Use depth test for partial tile drawing

If a child tile exists, draw it first and rely on the depth test to
prevent overwriting it with the parent tile.

Fix crash when unloading the root tile

Improve performance of GritsTile

This avoid doing lots of computation in the inner the draw loop by
moving it out to the top-level draw function.

Remove background env tile

because it doesn't do anything..

Fix memory leaks in tile loading

- Splitting a tile could accidentally overwrite a already split tile if
  one (but not all) of the children were garbage collected.

- Garbage collection never actually happened.. because tile always had
  empty children. To fix this a `load' flag was added so that the
  children could be garbage collected as well without having to check
  the data flag which may always be null.

tile->load: set when texture loading has started
tile->data: set when texture loading has finished

Cast function pointers for gluTessCallback

The glu type does not work on Mac OSX, and an un-casted version does not
work in Debian.. Hopefully casting it to GCallback (void-void function)
will work both places..

Reentrant dispose functions for sat and map

Delay load the textures for label markers

This makes the normal constructor thread-safe so they don't need to be
created from a callback, the same should eventually be done for the icon
markers.

Load tiles at a lower resolution

The updated FOV code causes tiles to get loaded sooner than they used to
bee. While this may be "correct" it creates hard-to-read tiles because
they're so small. It also increases memory usage..

Check for split on all child tiles

When tiles split, all the children will be valid so only [0][0] needs to
be checked. However, a child tile may be garbage collected in which case
there may be a NULL child tile.

Fix key-press in GritsTest

Some key events are > 256 which caused an array index out of bounds.

Increase camera angle to 60 degrees

Using the 30 degree viewing angle looks reasonable realistic,
but is difficult to use since it requires much more panning.

Derivation of FOV_DIST for a 1600x1200 monitor
with a vertical viewing angle of 60 degrees:

        ---  +.
         |   | '-.     angle
  height |   |    '-./
  (px)   |   |      /'-.
         |   +------|---+ (o) eye
         |   |      \ .-'
         |   |     .-'
         |   |  .-'
        ---  +-'

             |----------|
               FOV_DIST (px)

  height   = 1200 px
  angle    =   60 deg
  fov_dist = cot(angle/2)*(height/2) = ~1039.23

Derivation of angle for window of a given height:

  angle    = atan((height/2)/FOV_DIST)*2

Update test plugin for level rendering changes

Add ortho flag to GritsMarker

Setting ortho to true causes the marker to be drawn orthographic and
flat against the screen. This is the default and behavior and is markers
have been drawn in the past.

Clearing the flag causes he marker to be drawn using the viewers
perspective projection but scaled to a fixed size.

Support pixmap icons in GritsMarker

This adds a second marker constructor that loads a pixmap from a file
and uses that as the marker.

Rotation angles are also supported so that the marker can be made to
point in a certain direction.

Correct FOV_DIST and MPPX calculations

Derivation of FOV_DIST for a 1600x1200 monitor
with a vertical viewing angle of 30 degrees:

        ---  +._
         |   |  '-._     angle
  height |   |      '-._/
  (px)   |   |         ('-._
        ---  +--------------+ (o) eye

             |--------------|
               FOV_DIST (px)

  height   = 1200 px
  angle    =   30 deg
  fov_dist = cot(angle)*height = 2078.46

Derivation of angle for window of a given height:

  angle    = atan(height/FOV_DIST)

Derivation of resolution in meters per pixel
at a given distance:

        ---  +._
         |   |  '-._
  length |   |      '-._
  (m)    |   |          '-._
        ---  +--------------+ (o) eye

             |--------------|
               dist (m)

  length   = tan(angle) * dist
  mppx     = length / height
           = (tan(atan(height/FOV_DIST)) * dist) / height
           = dist/FOV_DIST

Add grits_viewer_unproject function

This does the opposite of the grits_viewer_project function and can be
used to get the lat-lon-elev point corresponding to a point on the
screen, such as the pointer location. This currently has an undefined
output if the screen coordinates do not map to the location of an object
in the viewer.

This should not be used to determine if an objects has been selected or
clicked on. OpenGL picking should be used for that by connecting to one
of the GritsObject mouse event signals.

Rewrite expose to preserve the depth buffer

Sorted objects are now drawn with depth testing enabled. Unsorted
objects are drawn without depth testing. This mostly affects
GRITS_LEVEL_WORD+n objects.

Objects at other levels such as BACKGROUND, OVERLAY, and HUD should
generally disable sorting so that they are always drawn to the screen.
For those levels, the depth-buffer is set to read-only. This preserves
the depth buffer so  that it can be used later on to get the world-level
depth at a given screen location.

Add rate limit to auto-saving prefs

Fix bugs in GritsTile

- Prevent black spots when tiles are hidden by a thread while they are
  being drawn by the main thread.

- Add hack to draw maps in a lighter color

Improve rendering of non lat-lon tiles

There have been a long standing bugs related to this..
Up until now the solution was to only use tiles that split along
lat-long lines and to also split the geometry (in roam) along the same
lines.

Hopefully this allows tiles to be rendered properly.

See examples/tex.c for details of how this rendering works.

Use multi-texturing for alpha masking in tex.c

Multi-texturing uses two textures for each fragment. The example uses
GL_TEXTURE0 as the regular texture color and a second texture as the
alpha mask. Since there are two textures they can have separate
filtering an wrapping parameters.

The color texture uses GL_MODULATE which combines it with the existing
color. The alpha mask uses GL_REPLACE which causes it to replace the
linearly filtered alpha mask from the color texture with a hard-edged
alpha mask that is clamped to transparent at the border.

This is similar to how drawing is done in NASA World Wind

Use glBlendFuncSeparate for alpha masking in tex.c

The draw happens in two steps:

1. Copy the alpha mask to the framebuffer without changing the color
   channels: glBlendFuncSeparate(GL_ZERO, GL_ONE, GL_ONE, GL_ZERO)

   This uses GL_LINEAR filtering and GL_CLAMP_TO_BORDER to create a
   alpha mask with hard edges as opposed to blurred edges.

2. Copy the texture color to the framebuffer using the alpha mask
   stored in the frame buffer as the mask:
   glBlendFuncSeparate(GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, GL_ZERO, GL_ZERO);

   We can turn on GL_LINEAR filtering and GL_CLAMP here because the
   alpha mask is taken from the framebuffer instead of the filtered
   alpha component of the texture.

This creates a nice looking image without having to do any fancy setup.
The previous version also has issues if the texture is not split in the
middle of the polygon.

Unfortunately glBlendFuncSeparate depends on OpenGL 2.0 and requires
twice as many draws.

Cleanup tex formatting and clear background first

Clearing the entire background lets us add in textures with

  glBlendFunc(GL_ONE, GL_ONE);

without having to determine which texture is drawn first

Switch map plugin to tile map service

Add support for Mercator projections in tiles

This split tiles in the correct

Add Tile Map Service downloading

This uses map tiles directly from openstreetmap.org. The problem with
this is that those tiles are rendered using a Mercator projections which
is non-linear with respect to latitude. Two things must be done to
properly correct for this:

1. Split tiles at the correct location. With the Mercator projection,
   the midpoint of a tile is the midpoint of the longitude but not the
   midpoint of the latitude.

   Correcting this very important because it prevent tiles from being
   drawn in entirely the wrong place.

2. Morph each tile to lat-lon projection when it is drawn. This could
   possibly be done with a OpenGL fragment shader.

   This noticeable when zoomed out so it's not too bad to just ignore
   the issue.. The web based map servers have similar issues with land
   area at high-up zoom levels.

Eventually we'll want to fetch the XML and render the maps locally..

Version bump for 0.6.3

Remove object when test plugin unloads

Fix clipping plane issues

The clipping plane is flat, so the distance between the camera and the
clipping plane varies based on where screen location. I.e. it is closest
in the center and farther at the corners. Add a offset to elev to
account of this. It would be better to use a sin or to calculate
distances directly, but this is easy and appears to work.

Fix test rules

Compute near/far clipping planes

Remove haze over the oceans

The blue haze is nice of there's a white background, but we don't have a
working white background at the moment..

Add GritsLine

GritsLine is similar to GritsPoly, but does not draw a filled polygon.
As such it does not need to do any tessellation.

Currently it draws the points directly instead of using a display list.
This should make it easier to updated the line at runtime without
needing to create a new object.

Move polygon parsing into grits-util

This allows it to be used in other places
e.g. for line parsing

Update plugins folder symlink

Ignore local gen.sh

Move build scripts to separate repository

Improve support for relative search paths

Add support for Mac OS

Cleanup OpenGL example and add Mac OS support

Update windowing system tests

- Add support for Mac OS
- Hopefully make things simpler

Move OpenGL includes to a common place

Apple seems to think the should put GL.h in OpenGL instead of GL..
putting it all gtkgl.h makes it a little easier, but requires gtkgl.h to
be included in the install and by grits.h.

Update teapot example

Version bump for 0.6.2

Fix grits-demo linking on 64-bit

Version bump for 0.6.1

Fix off-by-one error

Fix more warnings

Fix 64-bit warnings

Fix extra mouse-over bug

When selecting one polygon, it sets the line width and makes it appear
that following polygons are also selected.

Make picking 64-bit compatible

Use an array and index into that instead of passing pointers to
glPushName since 64-bit pointers do not fit in the name stack.

Use correct resolution tiles when zooming out

Version bump for 0.6

Fix warning if with non-existent cache paths

Update dolt

Use -no-undefined for win32 builds

This is the libtool flag which is different than the ld flag, and is
needed for building win32 dlls..

Update copyright notices

Update some documentation

Add alert plugin to grits-test

Use rounded corners for GritsPoly

Fix memory leaks

Pass objects to grits_viewer_remove instead of refs

(finally)

Save prefs after changes

Improve performance of GritsPoly

Use separate display lists, and only create them and perform
tessellation when they are actually used.

This is especially useful for large number of polygons which aren't
always displayed (or may never be displayed).

Generating the display lists from the first draw() also avoids a large
number of idle callbacks.

Fix typo

Add clicked signal to GritsObject

Using mouse-down/mouse-up is rather not helpful since GritsViewer does a
lot with mouse drags.

Add mouse-over testing to test plugin

Add mouse, keyboard, and motion events to GritsObject

These work by chaining the event from GritsOpenGL up to each individual
object, which then emits the callback if it is currently selected
(moused over).

Add mouse enter/leave signals to objects

This uses the OpenGL Selection render mode to determine which objects
the mouse is over. It requires fairly tight integration between
GritsOpenGL and GritsObject.

The signal code is handled internally by GritsObject. However, most of
the actual selection matching work is done by GritsOpenGL.

Object types that wish to improve performance can implement the pick()
function in addition to the draw() function. The pick function is used
when performing selection matching. It works similar to draw, but does
not need to do textures/lighting/opacity/etc.

Cleanup GritsPoly

- Add GL points at the corners
- Use polygon offset between fill and border
- Calculate actual center position

Remove excess debug messages

Add string parser to GritsPoly

Add configurable borders to GritsPoly

Fix crash when unable to cache http files

Version bump for 0.5.2

Remove no-undefined-symbols from gen.sh

This should be done properly in the Makefiles now.

Add linker flag for the math library

Fix compiler warning with gluTessCallback

Add glut config check

Version bump for 0.5.1

Fix linker flags

Abort when opengl setup fails

Add timeout for http servers

Keep it low for now because a hung sever blocks tile loading

Switch to higher resolution elevation dataset

- Tweak perspective so we can zoom in farther
- Use less preference for edge faces for better shading

Speed up movement when at low elevation

Update map URL and layers

Server moved to vmap0.tiles.osgeo.org

Added new layers for labels, roads, and a few other things

Add reset locale when formatting certain strings

LC_NUMERIC is used to determine the conversion for "%f" this can result
in errors when formatting strings with expected floating point formats.

Version bump for 0.5

Add GL bindings example program

Basic standalone program that draws a circle using:
  - Cairo
  - GktGLExt
  - GLX (X11)
  - WGL (Win32)
  - CGL (Mac OS, not implemented)

Add some stubbed code for Mac OS support

(This won't compile yet)

Change binaries to shared objects

There's a double load of the GObjects when using static libraries with
plugins. Shared libraries avoid this, I think there are other work
arounds that let static binaries work too, but this should be fine for
now.

Use only shared libs on win32

Version bump to 0.5-p0

Switch from GtkGLExt to internal OpenGL handling

GtkGLExt has many problems:
  - It's code is bloated and convoluted
  - It doesn't work on Win32
  - It doesn't work with gtk+-3.0
  - The last release was in early 2006

Using our own lets us fix these issues and should be easier to maintain
than trying to figure out the GtkGLExt mess, or waiting for someone else
to fix it.

Use -shared for plugins

Misc http fixes

Caching still doesn't work, but it appears to be a server problem.

Switch map and sat plugins to using thread pools

TODO: switch evel as well