# Documentation de la bibliothèque MLV-0.6.716

- Presentation
- Téléchargement
- Installation
- Compilation
- Exemples
- API
- Liste des fonctions
- bogues
- contacts

# advanced/07_transparency.c

Ce programme montre quelques exemples d'utilisation de la transparence.

Nous rapellons que les couleurs sont codées à l'aide de 4 composantes:

- R : rouge (red),
- G : vert (green),
- B : bleu (blue),
- A : transparence (alpha),

codées chacune sur un octet, c'est à dire par un entier comprit entre 0 et 256.

La transparence joue un role lorsque une image est dessinée à l'écran ou sur une autre image. Lorsque l'on copie une image, les pixels du résultat final sont obtenus en faisant le barycentre entre le pixel de l'image source avec celui de l'image destination. Les poids des barycentres sont définis par la composante transparence ( composante alpha ) de l'image source. La transparence de l'image destination reste inchangée.

Cela nous donne les formules suivantes:

    R_dest = (alpha_src/256) * R_src + (1- alpha_src/256) * R_dst
    V_dest = (alpha_src/256) * V_src + (1- alpha_src/256) * V_dst
    B_dest = (alpha_src/256) * B_src + (1- alpha_src/256) * B_dst
    A_dest = A_dest

Ainsi, si l'a composante alpha de l'image source est à 0, alors la source disparait. Si elle à est 256, alors c'est l'image destination qui disparait.

Voici un exiemple avec les couleurs suivantes:

- couleur du pixel source : RGBA( 100,100,100,128 )
- couleur du pixel destination : RGBA( 0,10,20,30 )
- couleur finale apres copie : RGBA( 50,55,65,30 )

Comme la composante alpha est à 128, la couleur finale est donc à moitié celle de l'image source (128/256) et à moitié celle de l'image destination (1-128/256).

    #include <MLV/MLV_all.h>

    //
    // Attention !
    // Pour pouvoir compiler ce programme sous windows et sous macintosh,
    // il faut, pour la déclaration du main, respecter strictement la syntaxe
    // suivante :
    //
    int main( int argc, char *argv[] ){
            int width = 640, height = 480;
            MLV_Image *red_image, *blue_image;

            //
            // Créé et affiche la fenêtre
            //
            MLV_create_window(
                    "advanced - 7 - transparency", "transparency", width, height
            );

            MLV_draw_filled_rectangle( 0, 0, width, height, MLV_COLOR_GREEN );

            //
            // Lit un fichier et charge l'image contenu dans le
            // fichier en mémoire.
            //
            blue_image = MLV_load_image( "blue_image.png" );
            red_image = MLV_load_image( "red_image.png" );

            MLV_draw_adapted_text_box(
                    100, 40, "avec la composante\nalpha d'origine", 4,
                    MLV_COLOR_GREEN,  MLV_COLOR_BLACK, MLV_COLOR_GREEN,
                    MLV_TEXT_CENTER
            );

            //
            // Affiche l'image
            //
            MLV_draw_image( blue_image, 47, 113 );
            MLV_draw_image( red_image, 47, 306 );

            //
            // Affiche l'image
            //
            MLV_draw_image( blue_image, 187, 185 );
            MLV_draw_image( red_image, 187, 234 );

            //
            // Suprime la transparence de l'image et la remplace
            // par une transparence uniforme opaque
            //
            MLV_set_alpha_on_image( MLV_ALPHA_OPAQUE, red_image );
            MLV_set_alpha_on_image( MLV_ALPHA_OPAQUE, blue_image );

            MLV_draw_adapted_text_box(
                    330, 20, "sans la\ncomposante\nalpha", 4,
                    MLV_COLOR_GREEN,  MLV_COLOR_BLACK, MLV_COLOR_GREEN,
                    MLV_TEXT_CENTER
            );

            //
            // Affiche l'image
            //
            MLV_draw_image( blue_image, 328, 113 );
            MLV_draw_image( red_image, 328, 306 );

            //
            // Suprime la transparence de l'image et la remplace
            // par une transparence uniforme
            //
            MLV_set_alpha_on_image( 127, red_image );
            MLV_set_alpha_on_image( 127, blue_image );

            MLV_draw_adapted_text_box(
                    435, 20, "la composante alpha\nest remplacée par une\ncomposante uniforme", 4,
                    MLV_COLOR_GREEN,  MLV_COLOR_BLACK, MLV_COLOR_GREEN,
                    MLV_TEXT_CENTER
            );

            //
            // Affiche l'image
            //
            MLV_draw_image( blue_image, 468, 113 );
            MLV_draw_image( red_image, 468, 306 );

            //
            // Met à jour l'affichage
            //
            MLV_actualise_window();

            //
            // Attend 2 secondes
            //
            MLV_wait_seconds( 20 );

            //
            // Libère l'image qui a été crée
            //
            MLV_free_image( blue_image );
            MLV_free_image( red_image );

            //
            // Ferme la fenêtre
            //
            MLV_free_window();
            return 0;
    }