/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        C A C H E M E N T   D ' U N E   I M A G E   A   T R A V E R S   U N E   A U T R E  :                                       */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Definition :                                                                                                               */
/*                                                                                                                                   */
/*                    Cette commande genere une image                                                                                */
/*                  dont le nom est le premier argument                                                                              */
/*                  d'appel ; elle est le resultat du                                                                                */
/*                  cachement de l'image Argument par                                                                                */
/*                  le Masque.                                                                                                       */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Author of '$xci/cache$K' :                                                                                                 */
/*                                                                                                                                   */
/*                    Jean-Francois COLONNA (LACTAMME, 1989??????????).                                                              */
/*                                                                                                                                   */
/*************************************************************************************************************************************/

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        I N T E R F A C E   ' listG '  :                                                                                           */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        :Debut_listG:                                                                                                              */
/*        :Fin_listG:                                                                                                                */
/*                                                                                                                                   */
/*************************************************************************************************************************************/

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        D I R E C T I V E S   S P E C I F I Q U E S   D E   C O M P I L A T I O N  :                                               */
/*                                                                                                                                   */
/*************************************************************************************************************************************/

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        F I C H I E R S   D ' I N C L U D E S  :                                                                                   */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
#include  INCLUDES_BASE

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        P A R A M E T R E S  :                                                                                                     */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
#define   ANTI_ALIASER                                                                                                                  \
                    FAUX                                                                                                                \
                                        /* Indique si l'on doit "anti-aliaser" le produit ('VRAI') ou pas ('FAUX'), la valeur par    */ \
                                        /* defaut garantissant la compatibilite anterieure. Ceci fut introduit le 20090126111043.    */

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        M A C R O S   U T I L E S  :                                                                                               */
/*                                                                                                                                   */
/*************************************************************************************************************************************/

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        C A C H E M E N T   D ' U N E   I M A G E   A   T R A V E R S   U N E   A U T R E  :                                       */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
BCommande(nombre_d_arguments,arguments)
/*-----------------------------------------------------------------------------------------------------------------------------------*/
     Bblock
     DEFV(CHAR,INIC(POINTERc(nom_imageR),NOM_PIPE));
     DEFV(CHAR,INIC(POINTERc(nom_imageA),NOM_PIPE));
     DEFV(CHAR,INIC(POINTERc(nom_imageM),NOM_PIPE));

     DEFV(Logical,INIT(anti_aliaser,ANTI_ALIASER));
                                        /* Indique si l'on doit "anti-aliaser" le produit ('VRAI') ou pas ('FAUX'), la valeur par    */
                                        /* defaut garantissant la compatibilite anterieure. Ceci fut introduit le 20090126111043.    */
     /*..............................................................................................................................*/
     GET_ARGUMENTSi(nombre_d_arguments
                   ,BLOC(GET_ARGUMENT_C("imageA=""A=""imageA1=""A1=",nom_imageA);
                         GET_ARGUMENT_C("imageM=""M=""imageA2=""A2=",nom_imageM);
                                        /* Les options '"imageA1=""A1="' et '"imageA2=""A2="' ont ete introduites le 20141105101439  */
                                        /* afin de rendre les arguments compatibles, si besoin est, avec, par exemple, ceux de       */
                                        /* 'v $xci/maximum$K .imageA.=..A.=.'...                                                     */
                         GET_ARGUMENT_C("imageR=""R=",nom_imageR);

                         GET_ARGUMENT_L("anti_aliaser=""aa=""anti_aliasing=",anti_aliaser);
                                        /* Option introduite le 20090126111043 et complete le 20090126150437 par "anti_aliasing=".   */
                         )
                    );

     CALi(Inoir(ImageR));
                                        /* Initialisation de l'image Resultat.                                                       */

     Test(PAS_D_ERREUR(CODE_ERROR(Iload_image(ImageA2,nom_imageA))))
                                        /* Chargement de l'image a transformer.                                                      */
          Bblock
          Test(PAS_D_ERREUR(CODE_ERROR(Iload_image(ImageA1,nom_imageM))))
                                        /* Chargement de l'image de definition du masque.                                            */
               Bblock
               Test(IL_NE_FAUT_PAS(anti_aliaser))
                    Bblock
                    CALS(Iproduit_de_masquage(ImageR,ImageA1,ImageA2));
                                        /* Et masquage...                                                                            */
                    Eblock
               ATes
                    Bblock
                    CALS(Iproduit_de_masquage_anti_aliase(ImageR,ImageA1,ImageA2));
                                        /* Et masquage "anti-aliase" (introduit le 20090126111043).                                  */
                    Eblock
               ETes

               CALi(Iupdate_image(nom_imageR,ImageR));
               Eblock
          ATes
               Bblock
               Test__CODE_ERREUR__ERREUR07;
               Eblock
          ETes
          Eblock
     ATes
          Bblock
          Test__CODE_ERREUR__ERREUR07;
          Eblock
     ETes

     RETU_Commande;
     Eblock
ECommande