al_map_rgba_f(3)

NAME

al_map_rgba_f - Allegro 5 API

SYNOPSIS

    #include <allegro5/allegro.h>
    ALLEGRO_COLOR al_map_rgba_f(float r, float g, float b, float a)

DESCRIPTION

Convert r, g, b, a (ranging from 0.0f-1.0f) into an ALLEGRO_COLOR(3).

By default Allegro uses pre-multiplied alpha for transparent blending of bitmaps and primitives (see al_load_bitmap_flags(3) for a discussion of that feature). This means that if you want to tint a bitmap or primitive to be transparent you need to multiply the color components by the alpha components when you pass them to this function. For example:

    float r = 1;
    float g = 0;
    float b = 0;
    float a = 0.5;
    ALLEGRO_COLOR c = al_map_rgba_f(r * a, g * a, b * a, a);
    /* Draw the bitmap tinted red and half-transparent. */
    al_draw_tinted_bitmap(bmp, c, 0, 0, 0);

SEE ALSO

al_map_rgba(3), al_map_rgb(3), al_map_rgb_f(3)