Re: [AD] ALLEGRO_DISPLAY_OPTIONS documentation

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


On Sat, 2009-02-21 at 08:00 -0700, Trent Gamblin wrote:
> I'm trying to implement the new ALLEGRO_DISPLAY_OPTIONS
> in D3D but I'm having trouble figuring them out. I don't
> know what half of the enum values mean let alone their
> possible values. Could we get some documentation on this
> enum please?

They are the same as in AllegroGL. A few of them should probably be
removed/renamed.

AllegroGL docs are here:
http://allegrogl.sourceforge.net/docs/group__settings.html

So:

   ALLEGRO_RED_SIZE,
   ALLEGRO_GREEN_SIZE,
   ALLEGRO_BLUE_SIZE,
   ALLEGRO_ALPHA_SIZE,
   ALLEGRO_RED_SHIFT,
   ALLEGRO_GREEN_SHIFT,
   ALLEGRO_BLUE_SHIFT,
   ALLEGRO_ALPHA_SHIFT,

The 8 above are identical to selecting the pixel format.

   ALLEGRO_ACC_RED_SIZE,
   ALLEGRO_ACC_GREEN_SIZE,
   ALLEGRO_ACC_BLUE_SIZE,
   ALLEGRO_ACC_ALPHA_SIZE,

Those are the format of the accumulation buffer.

   ALLEGRO_STEREO,

Whether the display uses left/right stereo buffers. Not sure any drivers
supports this :P

   ALLEGRO_AUX_BUFFERS,

Number of auxiliary buffers. Probably not a useful option either.

   ALLEGRO_COLOR_SIZE,
   ALLEGRO_DEPTH_SIZE,
   ALLEGRO_STENCIL_SIZE,

Number of bits in color, depth and stencil buffer.

   ALLEGRO_SAMPLE_BUFFERS,

Whether to use multi-sampling (1) or not (0).

   ALLEGRO_SAMPLES,

How many samples per pixel to use if the above is 1, else 0.

   ALLEGRO_RENDER_METHOD,

This should be renamed or removed, in AllegroGL it was used to force HW
acceleration, but I don't see why you would have to do that. If my
software rendering is fast enough to run the game, why prohibit it?

   ALLEGRO_FLOAT_COLOR,
   ALLEGRO_FLOAT_DEPTH,

Whether to use floating point for the color and depth buffers.

   ALLEGRO_DOUBLEBUFFERED,

This is the same as you can do already with the normal double buffer
flag.

   ALLEGRO_SWAP_METHOD,

Not sure about this one, AllegroGL doesn't seem to have it - probably we
can remove it.

-- 
Elias Pschernig <elias@xxxxxxxxxx>





Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/