al_hold_bitmap

al_hold_bitmap_drawing

Josh Taylor

Member #17,070

April 2019

Well, I'm kind of new around here. First of all, I have to say Allegro 5 is great. I've only messed around a little with 4 in the past until I bit the bullet and tried out 5.

Here's my question:
Does al_hold_bitmap_drawing work with al_draw_bitmap_region? Or does it only apply to sub-bitmaps? I've searched the forums, and all I've concluded was: Maybe.

Here's the code I used it with:

#SelectExpand
 al_hold_bitmap_drawing(true);
 for (int y = sy; y < sy + y_tiles_in_view; y++)
 {
    for (int x = sx; x < sx + x_tiles_in_view; x++)
    {
       if ((x < MAP_WIDTH) && (x > -1) && (y < MAP_HEIGHT) && (y > -1))
       {
          if (m->position[x + y * MAP_WIDTH].empty_tile == false)
          {
             //Draw the tile, subtracting the camera position
             al_draw_bitmap_region(tile_sheet,
                                   convert_index_to_pixel_xy(m->position[x + y * MAP_WIDTH].tile, 16, TILE_SIZE, RETURN_X),
                                   convert_index_to_pixel_xy(m->position[x + y * MAP_WIDTH].tile, 16, TILE_SIZE, RETURN_Y),
                                   TILE_SIZE,
                                   TILE_SIZE,
                                   (x * TILE_SIZE) - c->x,
                                   (y * TILE_SIZE) - c->y,
                                   0);
          }
       }
    }
 }
 al_hold_bitmap_drawing(false);

Edgar Reynaldo

Major Reynaldo

May 2007

al_hold_bitmap_drawing works on any bitmap as long as the src texture is the same.

Eagle and Allegro 5 binaries | Older Allegro 4 and 5 binaries | Allegro 5 compile guide
King Piccolo will make it so Then I could just flip it with some sweet, sweet matrix math. In either case, I’ll ride this wagon until the wheels fall off. Thanks to those that keep it running

Josh Taylor

Member #17,070

April 2019

Thanks, Edgar! That's what I hoped to hear.

Edgar Reynaldo

Major Reynaldo

May 2007

So yes, your example is using al_hold_bitmap_drawing correctly. It's designed to work with atlas's and tile maps.

Things that would make it work less effectively include changing the source texture. So if you tried to draw many small independent bitmaps each with their own texture, the performance gain would be practically nil. Because each time the source texture changes, it has to rebind it with the gpu in order to draw from it.

Also to note, al_hold_bitmap_drawing does not work with primitive drawing. It's for bitmap drawing only.