Provided by: liballegro-doc_4.2.2-3_all bug

NAME

       ex12bit  -  How to fake a 12-bit truecolor mode on an 8-bit card. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       Example ex12bit

DESCRIPTION

       This program sets up a 12-bit mode on any 8-bit card, by setting up a  256-colour  palette
       that  will  fool the eye into grouping two 8-bit pixels into one 12-bit pixel. In order to
       do this, you make your 256-colour palette with all the combinations  of  blue  and  green,
       assuming  green ranges from 0-15 and blue from 0-14. This takes up 16x15=240 colours. This
       leaves 16 colours to use as red (red ranges from 0-15).  Then you put your  green/blue  in
       one  pixel,  and  your red in the pixel next to it. The eye gets fooled into thinking it's
       all one pixel.

       The example starts setting a normal 256 color mode, and construct a  special  palette  for
       it.  But then comes the trick: you need to write to a set of two adjacent pixels to form a
       single 12 bit dot. Two eight bit pixels is the same as one 16 bit pixel, so after  setting
       the video mode you need to hack the screen bitmap about, halving the width and changing it
       to use the 16 bit drawing code. Then, once you have packed a color into the correct format
       (using the makecol12() function below), any of the normal Allegro drawing functions can be
       used with this 12 bit display!

       Things to note:

       The horizontal width is halved, so you get resolutions like 320x480, 400x600, and 512x768.

       Because each dot is spread over two actual pixels, the display will be darker  than  in  a
       normal video mode.

       Any bitmap data will obviously need converting to the correct 12 bit format: regular 15 or
       16 bit images won't display correctly...

       Although this works like a truecolor mode, it is actually using a 256  color  palette,  so
       palette fades are still possible!

       This code only works in linear screen modes (don't try Mode-X).

SEE ALSO

       BITMAP(3alleg),   END_OF_MAIN(3alleg),   MATRIX(3alleg),   PALETTE(3alleg),   RGB(3alleg),
       allegro_error(3alleg),           allegro_init(3alleg),            allegro_message(3alleg),
       apply_matrix(3alleg),       blit(3alleg),       circle(3alleg),      clear_bitmap(3alleg),
       clear_keybuf(3alleg),            clear_to_color(3alleg),            create_bitmap(3alleg),
       create_bitmap_ex(3alleg),  destroy_bitmap(3alleg),  ellipsefill(3alleg), fade_out(3alleg),
       fixcos(3alleg),    fixed(3alleg),    fixsin(3alleg),     fixtoi(3alleg),     font(3alleg),
       get_rotation_matrix(3alleg),  getpixel(3alleg),  install_keyboard(3alleg), itofix(3alleg),
       keypressed(3alleg), line(3alleg), makecol(3alleg), masked_blit(3alleg),  putpixel(3alleg),
       screen(3alleg),     set_clip_rect(3alleg),     set_color(3alleg),    set_gfx_mode(3alleg),
       set_palette(3alleg),   text_height(3alleg),    text_length(3alleg),    textout_ex(3alleg),
       textprintf_ex(3alleg)