Yes things probably are inconsistent in the primitives addon.. Personally I'd like to see them act purely as pixel perfect a4 like routines. If you want anything fancier, use GL or something.

Lets just say I don't agree I don't think the point of allegro was to emulate GL's semantics, but rather to be more sane and easier to grasp.

Okay, I added a section to the documentation explaining how the things work... hopefully it should make things clear for everyone. Here's a preview courtesy of Thomas Fjellstrom: Linky.

I can vouch for that.

Trouble is al_put_pixel is only useful on memory bitmaps. al_draw_pixel is slow too althought I don't know if it is on memory bitmaps.

I don't care much about speed, because the bitmap is only generated once. I want to make sure that the pixel is drawn where I expect it to be.

Right now I'm using (x+0.5,y+0.5), where (x,y) represents an integer coordinate system.

Yes, that's how it works.

Yes, that it does.

Nice illustrations.... which gives me an idea! Let me help by doing illustrations for the manual. Since I can't help much with the actual coding, and I have this constant uncontrollable urge to do graphics for no reason, I'd like to volunteer for that job. Several functions, like the al_draw_arc() function would really benefit with a nice illustration. Another example is the al_draw_font_* and metrics routines.

Most importantly, we should agree to standardize the illustration style. I really like the line weights, proportion to document text size, fonts, and conventions you used (cross hairs, pointer arrow to coordinates, dashed line (not transparent line), Verdana italic for axis, etc). And unless you already have it planned out, we should start with that as a design reference. What program did you use and can you send me the file? I would like to write up an illustration standards in the wiki.

I really believe we should do this. It would be a great key to the appearance, quality, and usability of A5. I can see it and I believe in it.

Totally agree. I'm getting to know the the event system, It's pretty powerful.

You'd be fired for skimming the documentation.

It's annoying, but understandable (I suppose) due to the transformation system. I've just created a few macros to help me remember, e.g.:

#define _algui_draw_hline(x, y, w, c) al_draw_line((x), (y) + 0.5, (x) + (w), (y) + 0.5, c, 1.0)

If the API is well documented and works the same across all platforms, there's really not much to complain about.

Damnit, now I know I was being unreasonable. BAF Agreed with me

Yes. Depends on the multisample settings what exactly happens though.

[edit]

So it depends on how many of those sample points hit the shape. If you use 4x4 samples and one hits the shape, its color will contribute 1/16th to the final color of the pixel.