al_draw_tinted_bitmap - Man Page

Allegro 5 API


#include <allegro5/allegro.h>

void al_draw_tinted_bitmap(ALLEGRO_BITMAP *bitmap, ALLEGRO_COLOR tint,
   float dx, float dy, int flags)


Like al_draw_bitmap(3) but multiplies all colors in the bitmap with the given color. For example:

al_draw_tinted_bitmap(bitmap, al_map_rgba_f(0.5, 0.5, 0.5, 0.5), x, y, 0);

The above will draw the bitmap 50% transparently (r/g/b values need to be pre-multiplied with the alpha component with the default blend mode).

al_draw_tinted_bitmap(bitmap, al_map_rgba_f(1, 0, 0, 1), x, y, 0);

The above will only draw the red component of the bitmap.

See al_draw_bitmap(3) for a note on restrictions on which bitmaps can be drawn where.

See Also


Referenced By

al_draw_tinted_bitmap_region(3), al_draw_tinted_rotated_bitmap(3), al_draw_tinted_scaled_bitmap(3), al_draw_tinted_scaled_rotated_bitmap(3), al_draw_tinted_scaled_rotated_bitmap_region(3), al_set_blender(3).

Allegro reference manual