7. API change log

7.1 Pending changes

7.2 Changes for 1.5

• The key definitions have changed:
  • K_F10 is now GGI_KEY_F10
  • KT_SPEC is now GGI_KT_SPEC
  • KG_SHIFT is now GGI_KM_SHIFT
  • KTYP and KVAL are now GGI_KTYP and GGI_KVAL
  • KT_LATIN & KT_LETTER were replaced with GGI_KT_LATIN1
  • Syms are not Linux-kludged (xor 0xf000) anymore (was not clearly defined before)
• ggi/libggi.h has been changed to ggi/ggi.h
• ggiSetInfoFlags became ggiSetFlags
• ggiSetPaletteVec and ggiGetPaletteVec became ggiSetPalette and ggiGetPalette
• ggiDrawCircle has been moved to LibGGI2D.
• ggiWaitRayPos, ggiGetRayPos and ggiSetSplitline have been moved to libGGImisc.
• Changes in the definition of ggiInit() and ggiExit allow nesting them.
• ggiPuts behaviour has been defined more clearly.
• The stretching version of ggiCrossBlit has been moved to libggi2d (as ggiStretchBlit), in favour of a ggiCrossBlit which does not do stretching.
• An alpha value has been added to ggi_color (but not used by libggi).
• The graphtype GT_AUTO has been introduced.
• Graphtypes are defined precisely in a non-VGA-centric way.
• Support for multiple frames (doublebuffering) has been defined.
• More get/put buffer properties have been defined.
• The "display-" Target prefix can now be omitted.

7.3 1.3.0 to 1.4.0

• ggiMapColor takes now a pointer to a ggi_color struct as it's second argument instead of the struct itself. This breaks binary compatibility for about every program!
• ggi*Sprite functions, that had never been implemented, are removed.
• The ggi_mode struct members virt and visible now do contain the number of pixels, not dots (which makes a difference for text mode. One character is one pixel but e.g. 9x16 dots). It is unclear what it had to contain before. So it might be a change, it might be a bugfix. According to Brian Julin, the semantics is:

  ---

                                  Before            After
   mode->request.visible.x       dots              pixels
   mode->request.visible.y       dots              pixels
   mode->request.virt.x          dots              pixels
   mode->request.virt.y          dots              pixels
   mode->request.text.x          dots              -- doesn't exist --
   mode->request.text.y          dots              -- doesn't exist --
   mode->request.dpp.x     -- didn't exist --      dots (==1 in graph modes)
   mode->request.dpp.y     -- didn't exist --      dots (==1 in graph modes)
  

  ---