From: Andrew Apted <ajapted@netspace.net.au>
  To  : ggi-develop@eskimo.com
  Date: Tue, 25 Aug 1998 14:40:37 +1000

Re: libggi documentation...

Steve writes:

>  Going over the libggi documentation again.
>  
>  1)  I see this under "Color and Palette":
>  
>  # You can not do calculations with <tt/ggi_pixel/ values. Well,
>  # you can, but you should not. The results would be
>  # unpredictable and system dependent.
>  
>  Wrong, right?

Right, it's wrong :).

Also the text about ggiSetMode() is a bit funny (it makes it sound like
a really weird function and people shouldn't use it).

>  2) get rid of:
>  
>  /* Utility functions
>   */
>  
>  ggi_graphtype   ggiBPP2GT(int bpp);
>  int             ggiGT2BPP(ggi_graphtype graphtype);
>  
>  ? since these are superceded by new GT scheme.
>  (not in doc, but ggi/ggi.h)

Yes, these should go.

>  3) int ggiGetc(ggi_visual_t vis):
>  
>  # Gets a character from the keyboard. Blocks if no key is available.
>  # 
>  # Return: a 16-bit Unicode character.
>                     ^^^^^^^
>  If so, it should return wchar_t.  But wchar_t can already be 32-bit.
>  ggi_key_event itself stores the syms as uint32, so should we just say
>  "returns unicode character?" No, wait, unicode is a *character set*, not the
>  encoding (UTF-8, canonical 16-bit, etc.) itself.  So this is really about
>  how we define characters in libggi.

We could leave it open, e.g. normally just return Unicode (UCS-2), but
return UCS-4 values if we ever need to.

>  int ggiGetGammaMap(ggi_visual_t vis,int s,int len,ggi_color *gammamap);
>  int ggiSetGammaMap(ggi_visual_t vis,int s,int len,ggi_color *gammamap);
>  
>  What do these do ? 

Some truecolor modes on some hardware can use the DAC's palette to
lookup the values before sending to the monitor.  Generally this is used
for gamma correction by filling the lookup table with a curve, hence the
name "gamma map" I suppose, but it could be used for other things e.g.
special effects in games.

Cheers,
_____________________________________________  ____
                                               \  /
  Andrew Apted   <andrew@ggi-project.org>       \/