/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        R E C H E R C H E   D E S   N I V E A U X   M I N I M U M   E T   M A X I M U M                                            */
/*        P A R   R A P P O R T   A   L A   L U M I N A N C E  :                                                                     */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Definition :                                                                                                               */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*                    Cette commande prend une palette                                                                               */
/*                  et recherche les niveaux qui donnent                                                                             */
/*                  respectivement la plus basse et la plus                                                                          */
/*                  fort luminance.                                                                                                  */
/*                                                                                                                                   */
/*                                                                                                                                   */
/*        Author of '$xciP/MIN_MAX$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   NIVEAU_DE_DEPART                                                                                                              \
                    NOIR
#define   NIVEAU_D_ARRIVEE                                                                                                              \
                    BLANC
#define   RECHERCHE_DU_MINIMUM                                                                                                          \
                    VRAI
#define   RECHERCHE_DU_MAXIMUM                                                                                                          \
                    VRAI

#define   AJOUTER_UN_K_LF_A_LA_FIN_DE_L_EDITION                                                                                         \
                    FAUX                                                                                                                \
                                        /* Parametre ajoute le 20080314174739 par symetrie avec '$xciP/G_NIVEAU$K 20080313113656'.   */

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

/*===================================================================================================================================*/
/*************************************************************************************************************************************/
/*                                                                                                                                   */
/*        R E C H E R C H E   D E S   N I V E A U X   M I N I M U M   E T   M A X I M U M                                            */
/*        P A R   R A P P O R T   A   L A   L U M I N A N C E  :                                                                     */
/*                                                                                                                                   */
/*************************************************************************************************************************************/
BCommande(nombre_d_arguments,arguments)
/*-----------------------------------------------------------------------------------------------------------------------------------*/
     Bblock
     DEFV(CHAR,INIC(POINTERc(nom_paletteA),NOM_PIPE));
                                        /* Nom de la palette Argument a utiliser.                                                    */

     DEFV(genere_p,INIT(niveau_de_depart,NIVEAU_DE_DEPART));
     DEFV(genere_p,INIT(niveau_d_arrivee,NIVEAU_D_ARRIVEE));
                                        /* Niveaux de depart et d'arrivee pour l'interpolation.                                      */
     DEFV(genere_p,INIT(premier_niveau_minimum,NIVEAU_UNDEF));
     DEFV(genere_p,INIT(dernier_niveau_maximum,NIVEAU_UNDEF));
                                        /* Niveaux correspondant respectivement a la premiere occurence de la plus faible luminance. */
                                        /* et a la derniere occurence de la plus forte luminance.                                    */
     DEFV(Logical,INIT(recherche_du_minimum,RECHERCHE_DU_MINIMUM));
     DEFV(Logical,INIT(recherche_du_maximum,RECHERCHE_DU_MAXIMUM));
                                        /* Inidicateur definissant l'extremum (ou les) a rechercher.                                 */

     DEFV(Logical,INIT(ajouter_un_K_LF_a_la_fin_de_l_edition,AJOUTER_UN_K_LF_A_LA_FIN_DE_L_EDITION));
                                        /* Parametre ajoute le 20080314174739 par symetrie avec '$xciP/G_NIVEAU$K 20080313113656'.   */

     DEFV(Float,INIT(luminance_du_niveau_courant,FLOT__UNDEF));
                                        /* Definition de la luminance du niveau courant.                                             */
     DEFV(Float,INIT(minimum_de_la_luminance,F_INFINI));
                                        /* Definition de la premiere occurence de la plus faible luminance.                          */
     DEFV(Float,INIT(maximum_de_la_luminance,F_MOINS_L_INFINI));
                                        /* Definition de la derniere occurence de la plus forte luminance.                           */
     /*..............................................................................................................................*/
     GET_ARGUMENTSf(nombre_d_arguments
                   ,BLOC(GET_ARGUMENT_C("paletteA=""palette=""pA=""p=",nom_paletteA);

                         GET_ARGUMENT_L("COMP1=""ROUGE=""TEINT=",files_____manipuler_la_composante_COMP1_d_une_palette_de_couleurs);
                         GET_ARGUMENT_L("COMP2=""VERTE=""LUMIN=",files_____manipuler_la_composante_COMP2_d_une_palette_de_couleurs);
                         GET_ARGUMENT_L("COMP3=""BLEUE=""SATUR=",files_____manipuler_la_composante_COMP3_d_une_palette_de_couleurs);

                         GET_ARGUMENT_P("nD=",niveau_de_depart);
                         GET_ARGUMENT_P("nA=",niveau_d_arrivee);

                         GET_ARGUMENT_L("minimum=""m=",recherche_du_minimum);
                         GET_ARGUMENT_L("maximum=""M=",recherche_du_maximum);

                         GET_ARGUMENT_L("LF=""K_LF=",ajouter_un_K_LF_a_la_fin_de_l_edition);
                         )
                    );

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

     BoIn(niveau_courant,niveau_de_depart,niveau_d_arrivee,PAS_COULEURS)
          Bblock
          EGAL(luminance_du_niveau_courant
              ,CALCUL_DE_LA_LUMINANCE(ACCES_listes_de_substitution(L_SUBSTITUTION_ROUGE,niveau_courant)
                                     ,ACCES_listes_de_substitution(L_SUBSTITUTION_VERTE,niveau_courant)
                                     ,ACCES_listes_de_substitution(L_SUBSTITUTION_BLEUE,niveau_courant)
                                      )
               );
                                        /* Calcul de la luminance de chacun des 'COULEURS' points de l'espace 'RVB'.                 */

          Test(IFLT(luminance_du_niveau_courant,minimum_de_la_luminance))
               Bblock
               EGAL(minimum_de_la_luminance,luminance_du_niveau_courant);
               EGAL(premier_niveau_minimum,niveau_courant);
                                        /* On memorise la premiere occurence (voir le 'IFLT') de la plus basse luminance.            */
               Eblock
          ATes
               Bblock
               Eblock
          ETes

          Test(IFGE(luminance_du_niveau_courant,maximum_de_la_luminance))
               Bblock
               EGAL(maximum_de_la_luminance,luminance_du_niveau_courant);
               EGAL(dernier_niveau_maximum,niveau_courant);
                                        /* On memorise la derniere occurence (voir le 'IFGE') de la plus haute luminance.            */
               Eblock
          ATes
               Bblock
               Eblock
          ETes
          Eblock
     EBoI

     Test(IL_FAUT(recherche_du_minimum))
          Bblock
          CAL3(Prme1("%d ",premier_niveau_minimum));
          Eblock
     ATes
          Bblock
          Eblock
     ETes

     Test(IL_FAUT(recherche_du_maximum))
          Bblock
          CAL3(Prme1("%d ",dernier_niveau_maximum));
          Eblock
     ATes
          Bblock
          Eblock
     ETes

     Test(IL_FAUT(ajouter_un_K_LF_a_la_fin_de_l_edition))
          Bblock
          CAL2(Prin0("\n"));
                                        /* Possibilite ajoutee le 20080314174739...                                                  */
          Eblock
     ATes
          Bblock
          Eblock
     ETes

     RETU_Commande;
     Eblock
ECommande