home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / maj / 2134 / palette.doc < prev    next >
Text File  |  1992-08-29  |  16KB  |  421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.          ██████─┐ ██████─┐ ██─┐     ██████─┐ ██████─┐ ██████─┐ ██████─┐
  17.          ██████ │ ██████ │ ██ │     ██████ │ ██████ │ ██████ │ ██████ │
  18.          ██ ┌██ │ ██ ┌██ │ ██ │     ██ ┌───┘   ██ ┌─┘   ██ ┌─┘ ██ ┌───┘
  19.          ██ │██ │ ██ │██ │ ██ │     ██ │       ██ │     ██ │   ██ │
  20.          ██████ │ ██████ │ ██ │     ████─┐     ██ │     ██ │   ████─┐
  21.          ██████ │ ██████ │ ██ │     ████ │     ██ │     ██ │   ████ │
  22.          ██ ┌───┘ ██ ┌██ │ ██ │     ██ ┌─┘     ██ │     ██ │   ██ ┌─┘
  23.          ██ │     ██ │██ │ ██ │     ██ │       ██ │     ██ │   ██ │
  24.          ██ │     ██ │██ │ ██████─┐ ██████─┐   ██ │     ██ │   ██████─┐
  25.          ██ │     ██ │██ │ ██████ │ ██████ │   ██ │     ██ │   ██████ │
  26.           └─┘      └─┘ └─┘  └─────┘  └─────┘    └─┘      └─┘    └─────┘
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                  Version 1.21
  33.  
  34.                               (c) RAMASOFT 1992
  35.  
  36.                              Tous droits réservés
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                                        
  61.  
  62.      Cet utilitaire  sert  à  créer un jeu de palettes de couleurs pour les
  63.      logiciels  RAMASOFT  travaillant  en mode EGA/VGA 16 couleurs texte ou
  64.      graphique.
  65.  
  66.      En fait, il peut être utilisé avec n'importe quel logiciel:
  67.  
  68.      - En VGA:  il  peut  verrouiller  les  couleurs  créées  et  donc être
  69.        utilisé  pour  modifier  les  couleurs  de  tous programme sauf ceux
  70.        travaillant  avec  plus  de  16 couleurs et ceux qui n'utilisent pas
  71.        les  fonctions standards du BIOS VGA: il s'agit surtout de logiciels
  72.        de jeu.
  73.  
  74.      - En EGA:  il  n'est  pas  possible de verrouiller la palette et seuls
  75.        les logiciels  n'initialisant  pas  leur mode vidéo (plutôt rare) ou
  76.        ceux permettent  une  sortie  au  DOS  pour lancer PALETTE, pourront
  77.        l'utiliser.
  78.  
  79.  
  80.  
  81. I) GENERALITES:
  82. ───────────────
  83.  
  84.      Tant  qu'on  ne  modifie pas les registres de palette, il n'y a aucune
  85.      différence  entre les cartes EGA/VGA et les cartes CGA du point de vue
  86.      des  couleurs disponibles. Ceci est dû au fait que lors de l'initiali-
  87.      sation d'un mode vidéo, les registres de palette sont chargés avec les
  88.      valeurs correspondant aux couleurs de la carte CGA.
  89.  
  90.      Rappelons que sur la carte CGA, les couleurs ne sont pas modifiables.
  91.  
  92.      La carte EGA permet de coder 64 couleurs alors que la carte VGA permet
  93.      le nombre astronomique de 262144 couleurs différentes.
  94.      Il est bien  évident  que  toutes  ces  couleurs  ne  peuvent pas être
  95.      affichées simultanément.
  96.  
  97.      Par exemple, en mode texte comme dans les principaux modes graphiques,
  98.      le  programmeur a  le choix  entre 16  couleurs  simultanées  qui sont
  99.      choisie  parmi  celles  disponibles:  ces  16 couleurs constituent une
  100.      palette.
  101.  
  102.      La gestion  des  couleurs est totalement différente selon que l'on est
  103.      en EGA ou en VGA:
  104.  
  105.      - En  EGA:  on ne peut que choisir la couleur parmi les 64 disponibles
  106.  
  107.      - En  VGA:  chaque couleur résulte du dosage de ses composantes: Rouge
  108.        Vert  et  Bleu.  Chaque composante étant codée sur 6 bits, elle peut
  109.        prendre  64  valeurs  différentes,  si  bien  que  nous  avons  donc
  110.        63 puissance 3 = 262144 couleurs théoriquement disponibles.
  111.  
  112.      Selon que le type de la carte écran, PALETTE proposera donc un mode de
  113.      sélection différent des couleurs.
  114.  
  115.  
  116.  
  117.  
  118.  
  119. ────────────────────────────────────────────────────────────────────────────────
  120. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 1 
  121.  
  122.      PALETTE peut être utilisé pour:
  123.  
  124.      - Créer  ou  modifier  une  palette  de couleur: appel de PALETTE sans
  125.        paramètres.
  126.      - Initialiser l'écran avec une palette de couleurs
  127.      - Verrouiller ou  dé-verrouiller la palette active
  128.      - Rétablir les couleurs par défaut
  129.  
  130.     Pour cela, il peut être appelé avec ou sans paramètres de lancement.
  131.     Lors  de  l'appel  sans paramètres (tapez simplement PALETTE sous DOS),
  132.     il permettra de créer ou de modifier une palette.
  133.     Les paramètres d'appel sont décrits plus loin.
  134.  
  135.  
  136.  
  137.  
  138. II) CREATION ET MODIFICATION DES COULEURS:
  139. ─────────────────────────────────────────
  140.  
  141.      Lancez PALETTE en tapant simplement son nom au prompt du DOS.
  142.      Selon la  carte  écran  principale  qui  aura  été  détectée, il va se
  143.      configurer automatiquement en mode EGA ou VGA.
  144.  
  145.      Notez  qu'il est possible le forcer en EGA avec une carte VGA: voir le
  146.      chapitre des paramètres de lancement.
  147.  
  148.      La présentation  de  l'écran de modification est légèrement différente
  149.      dans les deux modes: ce mode est indiqué sur la ligne de copyright.
  150.  
  151.      L'écran n'est pas effacé et PALETTE s'affiche en surimpression: ce qui
  152.      permet, lors du lancement de PALETTE à partir d'un logiciel, de garder
  153.      l'écran de ce logiciel pour pouvoir juger immédiatement de l'effet des
  154.      modifications de couleurs. Malheureusement, ceci n'est valable qu'avec
  155.      les logiciels  RAMASOFT  qui  ont  une  option  spéciale  de menu pour
  156.      appeler PALETTE.
  157.  
  158.      Avec  les autres logiciels, l'écran est souvent effacé lors de l'appel
  159.      du DOS.  Ce  qui  vous obligera à faire plusieurs aller-retours au DOS
  160.      pour juger des modifications de couleurs apportées.
  161.  
  162.      En fait, la méthode a adopter est la suivante:
  163.      - repérez une couleur dans l'écran du logiciel.
  164.      - appelez PALETTE pour la modifier.
  165.      - revenez au logiciel pour voir ce que cela donne.
  166.      - recommencez pour chaque couleur à modifier.
  167.  
  168.      En ne modifiant qu'une couleur à la fois, vous gagnerez du temps.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179. ────────────────────────────────────────────────────────────────────────────────
  180. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 2 
  181.      1°) Utilisation de PALETTE en EGA:
  182.      ─────────────────────────────────
  183.  
  184.      Les 16 couleurs de la palette sont affichées avec un numéro de 0 à 15.
  185.      Si un fichier  PALEGA.DEF  se  trouve  dans  le  même  répertoire, les
  186.      couleurs  définies dans ce fichier seront affichées, sinon ce sont les
  187.      couleurs CGA par défaut.
  188.  
  189.      Les flèches droites et gauche permettent de se déplacer sur la couleur
  190.      à modifier.
  191.      Les  flèches haut et bas permettent d'augmenter ou de diminuer de 1 la
  192.      valeur de la couleur.
  193.      Cette  valeur (de 0 à 63) est indiquée sous le curseur pour la couleur
  194.      pointée.
  195.  
  196.      Quand  la  palette a été modifiée, F5 permet de la sauvegarder dans le
  197.      fichier PALEGA.DEF.
  198.      F2 restaure les valeurs CGA par défaut pour toute la palette.
  199.      F3 restaure uniquement la couleur pointée par le curseur.
  200.      F6 permet  de  quitter  sans  sauvegarder.
  201.  
  202.      Notez que  lors  du  retour  au  DOS, les couleurs modifiées resteront
  203.      actives tant qu'un nouveau mode d'écran n'aura pas été sélectionné.
  204.      Vous pouvez restaurer les couleurs d'origine par la commande DOS:
  205.      MODE 80
  206.  
  207.  
  208.  
  209.  
  210.      2°) Utilisation de PALETTE en VGA:
  211.      ─────────────────────────────────
  212.  
  213.      Les  16 couleurs de la palette sont affichées de la même manière qu'en
  214.      EGA.  Comme  précédemment,  les  flèches  horizontales  permettent  de
  215.      choisir la couleur à modifier en déplaçant le pointeur dessus.
  216.  
  217.      Les valeurs de Rouge Vert et bleu de la couleur pointée sont indiquées
  218.      dans le bas du cadre.
  219.      Les touches  R,V  et  B  choisissent  la  couleur  primitive: celle-ci
  220.      apparaît alors en inversion.
  221.  
  222.      Les  flèches verticales augmentent ou diminuent la quantité de couleur
  223.      de base dans la couleur pointée.
  224.  
  225.      Les autres commandes sont identiques à celles du mode EGA:
  226.  
  227.      F2 Restaure la palette entière avec les couleurs CGA par défaut
  228.      F3 Restaure la couleur pointée
  229.      F5 Sauvegarde la palette dans le fichier PALVGA.DEF
  230.      F6 Quitte sans sauvegarder: les couleurs modifiées restant actives
  231.      tant qu'un autre mode vidéo n'aura pas été activé (mêmes remarques
  232.      qu'en EGA).
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239. ────────────────────────────────────────────────────────────────────────────────
  240. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 3 
  241.      3°) Utilisation des fichiers DEF:
  242.      ────────────────────────────────
  243.  
  244.      Une remarque  importante:  les  fichiers .DEF sont sauvegardés dans le
  245.      répertoire d'où PALETTE est appelé.
  246.      Par exemple:  si  PALETTE.EXE  se trouve dans le lecteur A et que vous
  247.      l'appelez  depuis  le  disque  C en tapant A:PALETTE , le fichier .DEF
  248.      sera créé dans le répertoire racine du disque C.
  249.      De même  si  PALETTE.EXE  est  dans C:\DOS et que ce répertoire figure
  250.      dans  le PATH de l'autoexec.bat (en termes clairs: s'il est accessible
  251.      depuis tout  le  disque),  l'appel  de  PALETTE  depuis  le répertoire
  252.      C:\TEXTE va créer un fichier .DEF dans C:\TEXTE.
  253.      Cela signifie  simplement  que  vous  pouvez  créer  un  fichier  .DEF
  254.      différent pour chaque application.
  255.      PALETTE.EXE  doit  donc être installé dans un répertoire accessible de
  256.      tous le disque (déclaré dans le PATH de l'AUTOEXEC.BAT).
  257.  
  258.      Dans  les nouvelles versions des logiciels RAMASOFT une option de menu
  259.      existe pour utiliser PALETTE comme s'il faisait partie du logiciel.
  260.  
  261.      Dans  les autres logiciels, pour pouvoir changer les couleurs, il faut
  262.      que  le  logiciel ait une fonction permettant une sortie temporaire au
  263.      DOS pour pouvoir appeler PALETTE, du moins en EGA.
  264.  
  265.      En  VGA, PALETTE a la possibilité de verrouiller les couleurs choisies
  266.      de manière  qu'elles  ne puissent plus être changées lors d'un change-
  267.      ment de  mode  vidéo.  Si  bien que vous pourrez utiliser vos couleurs
  268.      personnelles avec tous les logiciels ...
  269.      Sauf  avec certains jeux qui n'utilisent pas les fonctions standard du
  270.      BIOS  VGA  pour accéder à la vidéo (ils sont plus nombreux qu'on ne le
  271.      croit !)
  272.  
  273.  
  274.      Vous avez plusieurs possibilités:
  275.  
  276.      * Utiliser  les mêmes couleurs dans tous les logiciels en ajoutant une
  277.        ligne  qui initialisera les couleurs en verrouillant la palette dans
  278.        votre autoexec.bat: PALETTE /I/V
  279.        Dans  ce cas, le fichier .DEF doit être dans le répertoire racine du
  280.        disque ou dans un répertoire accessible par le PATH.
  281.  
  282.      * Utiliser  des couleurs différentes en appelant PALETTE /I/V avant de
  283.        lancer le logiciel, et PALETTE /O/D après retour au DOS.
  284.        Le premier  appel  va  initialiser les couleurs (paramètre /I) et va
  285.        verrouiller la palette (paramètre /V).
  286.        Le deuxième  appel  va  restaurer  les  couleurs  d'origine  (/O) et
  287.        dé-verrouiller la palette (/D) pour revenir à l'état initial.
  288.  
  289.        Si vous utilisez le gestionnaire d'environnement GENVI (même auteur)
  290.        vous pourrez  placez  ces  commandes  de configuration dans la fiche
  291.        d'installation du logiciel à lancer pour réaliser automatiquement la
  292.        sélection des couleurs.
  293.  
  294.        Un fichier  .DEF  contenant  les  couleurs souhaitées doit être créé
  295.        dans  le  répertoire de tous les logiciels dont vous voulez modifier
  296.        les couleurs.
  297.  
  298.  
  299. ────────────────────────────────────────────────────────────────────────────────
  300. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 4 
  301.      * Appeler  PALETTE  par  une  option  de sortie au DOS (si elle existe
  302.        dans le logiciel) comme en EGA.
  303.  
  304.  
  305.      ATTENTION: ne pas appeler PALETTE quand l'écran est en mode graphique.
  306.  
  307.  
  308.      Note: si  le  fichier .DEF correspondant à votre  écran (PALEGA.DEF ou
  309.            PALVGA.DEF)  n'est  pas  trouvé,  PALETTE utilisera les couleurs
  310.            CGA par défaut.
  311.  
  312.  
  313.  
  314.  
  315.  
  316. III) PARAMETRES D'APPEL
  317. ───────────────────────
  318.  
  319.      Quand  PALETTE est appelé sans paramètres, il vous présente l'écran de
  320.      modification des couleurs correspondant à votre carte graphique.
  321.  
  322.      Pour être  utilisé  dans  des  fichiers  batch,  conjointement  à  des
  323.      logiciels non RAMASOFT, il supporte les paramètres suivants:
  324.  
  325.  
  326.      /EGA          Force PALETTE à travailler en EGA même avec une carte
  327.                    VGA. Ceci peut être utile si vous préférez la méthode
  328.                    de choix des couleurs EGA (qui est plus simple).
  329.  
  330.      /I            Initialise l'écran avec les définitions de couleur du
  331.                    fichier .DEF trouvé dans le répertoire d'appel.
  332.  
  333.      /O            Restaure les couleurs d'origine du mode CGA.
  334.                    Il dé-verrouille automatiquement la palette en revenant
  335.                    ainsi à l'état d'origine.
  336.  
  337.  
  338.      /V            Verrouille la palette de couleur qui vient d'être
  339.                    initialisée.
  340.                    Ce paramètre ne peut s'utiliser qu'avec /I
  341.                    employé seul, il est ignoré.
  342.  
  343.      /D            Dé-verrouille la palette de couleur sans la supprimer.
  344.                    Les couleurs actives resteront valables tant qu'un
  345.                    nouveau mode vidéo n'aura pas été initialisé.
  346.                    Une fois la palette dé-verrouillée, la commande DOS
  347.                    MODE 80 restaure un écran texte de 80 colonnes avec les
  348.                    couleurs CGA par défaut.
  349.                    Ce paramètre ne peut s'employer qu'avec /I et sera ignoré
  350.                    s'il est utilisé seul.
  351.                    Notez que /O dé-verrouille aussi la palette après avoir
  352.                    rétabli les couleurs d'origine.
  353.  
  354.      /?            Affiche un écran d'aide résumant les options d'appel.
  355.  
  356.  
  357.  
  358.  
  359. ────────────────────────────────────────────────────────────────────────────────
  360. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 5 
  361. IV) DISTRIBUTION:
  362. ────────────────
  363.  
  364.      Ce  petit utilitaire est désormais livré avec les principaux logiciels
  365.      RAMASOFT.
  366.      Son utilisation est totalement gratuite: c'est un FREEWARE.
  367.  
  368.      Attention quand même:
  369.  
  370.      - PALETTE.EXE  est  protégé  contre  les  modifications  de  son  code
  371.        (comme  tous  les  logiciels RAMASOFT) qui pourraient être produites
  372.        par des virus ou tout simplement par des "bidouilleurs".
  373.        La protection utilisée n'empêche absolument pas la copie du logiciel
  374.        mais  elle  n'est là que pour protéger l'intégrité de son code et de
  375.        son copyright.
  376.  
  377.      - Son  utilisation dans un contexte commercial est soumise à autorisa-
  378.        tion de l'auteur: comme les autres logiciels RAMASOFT ...
  379.        bien que ... enfin passons !
  380.  
  381.      - Il  ne  peut  en aucun cas servir de support ou être diffusé avec un
  382.        autre shareware sans mon autorisation.
  383.  
  384.      - Par  contre  vous  pouvez l'utiliser pour gérer les couleurs dans un
  385.        programme de votre cru sans arrière pensée.
  386.  
  387.  
  388.      - La copie  de  ce  logiciel  est  absolument AUTORISEE de même que sa
  389.        diffusion  à  des serveurs ou à des distributeurs de shareware, dans
  390.        la mesure où:
  391.  
  392.        Vous  ne  percevez aucune rémunération hormis un éventuel rembourse-
  393.        ment des frais de port (limité à 20 F).
  394.  
  395.        Le logiciel est copié INTEGRALEMENT: y compris sa documentation.
  396.  
  397.  
  398.  
  399.      Si  vous avez des questions ou des suggestions, vous pouvez me joindre
  400.  
  401.                            UNIQUEMENT PAR COURRIER
  402.  
  403.            en joignant une enveloppe self-adressée et affranchie ...
  404.                                pour la réponse
  405.                              à l'adresse suivante
  406.  
  407.                                Patrick RAMADIER
  408.                               19 rue Victor Hugo
  409.                                 36110  LEVROUX
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419. ────────────────────────────────────────────────────────────────────────────────
  420. Documentation PALETTE Version 1.21   (c) RAMASOFT 1992                Page 6 
  421.