mutter/doc/reference
Robert Bragg 5cdc9af18a Removes the COGL_PIXEL_FORMAT_{24,32} defines
Although these are in the public headers we should assume that no one is
using them since they were never documented so no could know what they
are useful for.

If you were to guess you'd be forgiven for thinking they were bitmasks
for checking some flags to see if a format is 24 or 32 bits. If you
looked further you might instead be forgiven for thinking that if you
masked of the least significant nibble of a pixel-format then you could
check the value against these defines. Neither of the previous
operations are reliable ways to check if a format is 24 or 32bit and
instead code must use then internal
_cogl_pixel_format_get_bytes_per_pixel() api if they want to know the
pixel size for a given format which relies on a 16 entry lookup table
using the least significant nibble of a pixel-format.

Reviewed-by: Neil Roberts <neil@linux.intel.com>
2012-02-20 23:12:45 +00:00
..
cogl Removes the COGL_PIXEL_FORMAT_{24,32} defines 2012-02-20 23:12:45 +00:00
cogl-2.0-experimental Removes the COGL_PIXEL_FORMAT_{24,32} defines 2012-02-20 23:12:45 +00:00
Makefile.am Make it clearer that the 2.0 API is experimental 2011-06-14 17:09:55 +01:00