/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        P A S S A G E   D E S   V R A I E S   A U X   F A U S S E S   C O U L E U R S   E X A C T E S   E N   ' R V B '  :         */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Definition :                                                                                                               */
/*                                                                                                                                   */
/*                    Cette commande calcule une image                                                                               */
/*                  en fausses couleurs a partir de ses                                                                              */
/*                  trois composantes en utilisant le 'RVB'.                                                                         */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Author of '$xci/faux_RVB.01$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
#include  image_image_QUAD_IMAGE_EXT

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        P A R A M E T R E S  :                                                                                                     */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
#define   PONDERATION_DE_LA_LUMINANCE                                                                                                   \
                    FU                                                                                                                  \
                                        /* Afin de ponderer la luminance par rapport aux niveaux {R,V,B} ; plus cette valeur est     */ \
                                        /* grande, plus la luminance a d'importance (cf. 'MUL2').                                    */
#define   PONDERATION_DES_PONDERATIONS_DES_COULEURS                                                                                     \
                    FU                                                                                                                  \
                                        /* Afin de ponderer les niveaux {R,V,B} entre eux ; plus cette valeur est grande, plus on    */ \
                                        /* privilegie une couleur par rapport aux autres (cf. 'MUL2').                               */

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        M A C R O S   U T I L E S  :                                                                                               */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
#include  xci/luminance.01.I"

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        P A S S A G E   D E S   V R A I E S   A U X   F A U S S E S   C O U L E U R S  :                                           */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
BCommande(nombre_d_arguments,arguments)
/*-----------------------------------------------------------------------------------------------------------------------------------*/
     Bblock
     DEFV(CHAR,INIC(POINTERc(nom_imageR),NOM_PIPE));
                                        /* Nom de l'image a generer.                                                                 */
     DEFV(CHAR,INIC(POINTERc(nom_paletteA),NOM_PIPE));
                                        /* Nom de la palette a utiliser.                                                             */
     DEFV(CHAR,INIC(POINTERc(nom_imageA),NOM_UNDEF));
                                        /* Nom de l'image {ROUGE,VERTE,BLEUE} a utiliser (ce mode "RVB" implicite a ete introduit    */
                                        /* le 20050920154501).                                                                       */
     DEFV(CHAR,INIC(POINTERc(nom_imageAR),NOM_PIPE));
                                        /* Nom de l'image ROUGE a utiliser,                                                          */
     DEFV(CHAR,INIC(POINTERc(nom_imageAV),NOM_PIPE));
                                        /* Nom de l'image VERTE a utiliser,                                                          */
     DEFV(CHAR,INIC(POINTERc(nom_imageAB),NOM_PIPE));
                                        /* Nom de l'image BLEUE a utiliser.                                                          */
     DEFV(Float,INIT(ponderation_de_la_luminance,PONDERATION_DE_LA_LUMINANCE));
                                        /* Afin de ponderer la luminance par rapport aux niveaux {R,V,B} ; plus cette valeur est     */
                                        /* grande, moins la luminance a d'importance (cf. 'DIVI').                                   */
     DEFV(Float,INIT(ponderation_des_ponderations_des_couleurs,PONDERATION_DES_PONDERATIONS_DES_COULEURS));
                                        /* Afin de ponderer les niveaux {R,V,B} entre eux ; plus cette valeur est grande, moins on   */
                                        /* privilegie une couleur par rapport aux autres (cf. 'DIVI').                               */
     /*..............................................................................................................................*/
     GET_ARGUMENTSi(nombre_d_arguments
                   ,BLOC(GET_ARGUMENT_C("imageR=""R=",nom_imageR);
                         GET_ARGUMENT_C("imageA=""A=",nom_imageA);
                         GET_ARGUMENT_C("Rouge=""ROUGE=""AR=",nom_imageAR);
                         GET_ARGUMENT_C("Verte=""VERTE=""AV=",nom_imageAV);
                         GET_ARGUMENT_C("Bleue=""BLEUE=""AB=",nom_imageAB);
                         GET_ARGUMENT_C("paletteA=""palette=""pA=""p=",nom_paletteA);
                         GET_ARGUMENT_F("luminance=""l=""L=",ponderation_de_la_luminance);
                         GET_ARGUMENT_F("couleurs=""c=""C=",ponderation_des_ponderations_des_couleurs);
                         GET_ARGUMENT_I("pc=",pas_COULEURS);
                         )
                    );

     GENERER_LE_NOM_DE_TROIS_COMPOSANTES_CHROMATIQUES_RVB(nom_imageA,nom_imageAR,nom_imageAV,nom_imageAB)
                                        /* Introduit le 20050920154501...                                                            */

     CALS(Iload_palette_de_couleurs(nom_paletteA,ESPACE_DE_COULEURS_RVB));
                                        /* Chargement de la palette de couleurs...                                                   */

     Test(PAS_D_ERREUR(CODE_ERROR(Iload_image(Image_ROUGE,nom_imageAR))))
          Bblock
          Test(PAS_D_ERREUR(CODE_ERROR(Iload_image(Image_VERTE,nom_imageAV))))
               Bblock
               Test(PAS_D_ERREUR(CODE_ERROR(Iload_image(Image_BLEUE,nom_imageAB))))
                    Bblock
                    CALS(Ifausses_couleurs_RVB_exactes(ImageR
                                                      ,Image_ROUGE,Image_VERTE,Image_BLEUE
                                                      ,ponderation_de_la_luminance
                                                      ,ponderation_des_ponderations_des_couleurs
                                                       )
                         );
                                        /* Passage des vraies aux fausses couleurs via la palette courante.                          */
                    CALi(Iupdate_image(nom_imageR,ImageR));
                    Eblock
               ATes
                    Bblock
                    Test__CODE_ERREUR__ERREUR07;
                    Eblock
               ETes
               Eblock
          ATes
               Bblock
               Test__CODE_ERREUR__ERREUR07;
               Eblock
          ETes
          Eblock
     ATes
          Bblock
          Test__CODE_ERREUR__ERREUR07;
          Eblock
     ETes

     RETU_Commande;
     Eblock
ECommande