                        MRE (MOS Resource Editor v2.5)

                            Documentation Francaise
                                 01.01.1997


******************
** INTRODUCTION **
******************

MRE v2.5 est un logiciel d'aide au dveloppement sous MOS v2.5.
MRE permet de crer toutes sorte de requesters (masques) utilisants les 
objets de MOS v2.5 tels que des boutons, ascensseurs, fentres, etc.

Il vous suffit de positionner  l'cran les gadgets dsirs, et MRE v2.5
crra la source TP7 correspondant au requester que vous avez cr.

MRE v2.5 cr des Sources compilables sous Turbo Pascal v7.0, 
et utilise les units graphiques de MOS v2.5. Vous devez donc posseder ces 
units dans le rpertoire courant utilis par votre Turbo Pascal pour pouvoir 
compiler les sources cres par MRE.

Note: La structure des fichiers "Projets" de MRE v2.5 est differente de celle
des fichiers de la version 1.6, 2.0 et 2.4. Vous ne pourrez probablement pas
charger un fichier "Projet" d'une ancienne version de MRE sous la nouvelle 
version 2.5.


**********************
** ARCHIVE MRE v2.5 **
**********************

L'archive de MRE v2.5 se compose des fichiers suivants:

   - MRE.EXE                            Programme excutable
   - MRE.CFG                            Fichier configuration de MRE
   - MRE.INI                            Fichier Initialisation de MRE
   - MRE.TXT                            La documentation que vous lisez
   - SOURCES\
   -    MRE.PAS                         Source principale de MRE
   -    MRE_ITEM.PAS                    Unit grant les objets de MOS
   -    MRE_ACTS.PAS                    Unit grant les actions de MOS
   -    MRE_MENU.PAS                    Unit grant les menus de MOS
   - PROJECTS\*.MRE                     Divers fichiers d'exemples

Les sources TP7 de MRE sont fournies de manire  vous permettre ventuellement
de modifier le programme si vous le dsirez.


*****************
** GENERALITES **
*****************

MRE permet de crer plusieurs type de sources:
   
   - Des Requesters utilisant une fentre,
   - Des Requesters sur fond d'cran, sans fentre,
   - Des Menus.

Les sources gnres peuvent inclure au choix chacun des type cits ci-dessus.

Vous pouvez utiliser les objets suivants pour composer vos masques:

   - Boutons simples,
   - Boutons cyclers,
   - Boutons Radios et Boutons Checks,
   - Sliders (Ascensseurs),
   - Commands (Gestion de textes),

   - Bevels Boxes (boites simples),
   - String Boxes (boites en relief),
   - Textes standards.


*************************
** CREER UN REEQUESTER **
*************************

Pour crer un requester, vous devez d'abord dfinir les caractristiques de 
votre fentre. Utilisez pour cela les points du menu "WINDOW" suivants:
   - EDIT IDCMP
   - EDIT IDRES
   - EDIT MISCELLANEOUS

Vous devez ensuite utiliser le menu "ITEMS" qui permet de slectionner
le type d'objet que l'on dsire utiliser.
   - Les points "BUTTON","CYCLER","RADIO","SLIDER","COMMAND" permettent
     d'utiliser les gadgets dfinit par MOS.
   - Les points "BEVEL","STRING","TEXT" permettent de tracer des cadres
     de differents types, et d'afficher du texte.
   - Le point "TEST WINDOW" qui permet de tester les gadgets dfinits
     tels qu'ils aparaitrons dans le requester rel.

Vous pouvez sauvegarder et restaurer le projet en cours grce aux options
"LOAD PROJECT" et "SAVE PROJECT" du menu fichier.

Pour gnrer la source TP7 correspondant  votre requester, il vous suffit
de slectionner le point "GENERATE TP7 SOURCE" du menu "FICHIER". Vous donnez
ensuite un nom  votre fichier source, et MRE sauvegardera la source TP7.

Pour dfinir les options de cration de la source TP7, reportez-vous au point
de menu "SOURCE PREFS" du menu "PREFERENCES".


************************************
** REQUESTER AVEC OU SANS FENETRE **
************************************

Grce  MRE, vous pouvez au choix crer des requesters en utilisant une 
fentre de fond, ou bien sans fentre support.

Utiliser les options "KILL WINDOW" et "INIT WINDOW" du menu "WINDOW" pour
crer ou supprimer la fentre de base  votre grs, et dfinissez ensuite
les objets comme vous le souhaitez sans vous procuper du support.

Il est cepandant vivement conseill de toujours utiliser une fentre comme
support d'objets (la structure de MOS ayant t prvue pour...).

CONVERSION Fentre / Sans Fentre.
----------------------------------
Vous pouvez tre ammen  transformer un requester qui utilisais une fentre
comme fond en requester sans fentre de fond, ou bien,  crer une fentre
support pour un requester qui n'en avais pas. Pour cela, quand vos objets
sont dfinis, utilisez  nouveau les options dcrites plus haut du menu
"WINDOW".

- Si vous creez une fentre, un requester vous infomera qu'il existe dja des
  objets dfinis auparavant, et vous proposera de les inclure, ou de les
  supprimer avant de crer la nouvelle fentre.

- Si vous supprimez la fentre, un autre requester vous demandera des
  prcisions pour savoir si vous dsirez supprimer uniquement les objets,
  l'ensemble fentre+objets, ou bien seulement la fentre, et plaquer les
  objets sur le fond de l'cran (requester sans fentre). Choissez cette
  dernire option pour faire la conversion.

                   
**************************
** UTILISATION DES MENU **
**************************

Il y a 7 menus differents:

   - Le menu "FILES" qui permet d'accder aux fichiers, about, et sortie.
   - Le menu "EDIT" regroupant les fonctions d'ditions et d'option des objets.
   - Le menu "ITEMS" qui permet de slectionner l'objet actuel  utiliser.
   - Le menu "WINDOW" qui permet de dfinir et grer la fentre de support.
   - Le menu "MENU" qui permet de dfinir et grer un menu.
   - Le menu "PREFS" qui dfinit, utilise et sauvegarde les prefs de MRE.
   - Le menu "PROJECTS" qui permet de travailler sur plusieurs projets  la fois.

MENU "FILES"
-------------
"NEW PROJECT"   Permet de tout rinitialiser et de crer un nouveau projet.

"LOAD PROJECT"  Permet de charger et de restaurer un projet sauvegard.

"SAVE PROJET"   Permet de sauver le projet en cours pour le restaurer ultrieurement.

"UPDATE PROJET" Sauvegarde automatique du projet en cours sans changement de nom
                ni requester de fichier. Si un nom de projet n'est pas dfinit,
                un requester de fichier vous demandera de dfinir un nouveau nom.
                                       
"GENERATE TP7 SOURCE"   Permet de gnrer la source TP7 pour MOS v2.5
                        correspondant au requester dfinit.

"HELP FOR BEGINNERS"    Permet d'afficher une aide sommaire sur quelques-unes
                        des fonctions de MRE durant son utilisation.

"ABOUT MOS"     Infos sur MOS et la licence Shareware.

"ABOUT MRE EDITOR"      Infos succintes sur MRE.
                          
"DOS SHELL"     Sort temporairement sous DOS en faisant ind DOS Shell,
                vous pouvez revenir sous MRE en tapant EXIT sous DOS.

"QUIT"          Permet de quitter MRE. Si le projet en cours n'est pas
                sauvegarder, MRE vous en avertira et proposera de le sauver.

MENU "EDIT"
------------
"CLONE ITEMS"   Si cette option est slectionne, tout nouvel objets crs 
                aura pour paramtres ceux de l'objet qui le prcde dans la
                liste. Par exemple: Un bouton cr aura sa position dfinie 
                par votre soin, mais ses caratristiques telles que la couleur,
                le label, le status, etc qui serons copis du bouton prcdent.

"ADJUST POSITION ON GRID"       Permet si cette option est slectionne de      
                rajuster la position de tous les objets (boutons, cadres,
                fentre, etc) en fonction de la grille (si celle-ci  t dfinie).

"JUSTIFY ITEMS" Si cette option est slectionne, quand la fentre sera
                redimentionne, les objets rajusterons leurs positions et 
                leurs tailles dans la fentre automatiquement.

"DELETE ITEMS"  Permet de suprimer un ou plusieurs type d'objets qui ont
                ts pralablements dfinis.

"GET ITEMS INFO"Donne la quantit de chaque objets qui a t dfini.

"UNDO LAST ACTION"      Annule la dernire opration effectue. A chaque
                action de votre part, MRE crer un  fichier image de votre
                travail. C'est ce fichier qui est rappel en cas d'erreur.

MENU "ITEMS"
-------------
        Selectionnez le point de menu que vous dsirez utiliser.
Par exemple, pour l'dition d'ascenseurs, cliquez sur "SLIDERS", et
crez ou diter vos objets en utilisant la souris, et les flches du clavier.
Pour tester vos crations, slectionnez "TEST WINDOW".


MENU "WINDOW"
--------------
"EDIT IDCMP"    Permet de modifier les flags IDCMP de la fentre courante.

"EDIT IDRES"    Permet de modifier les flags IDRES de la fentre courante.

"EDIT MISCELLANEOUS"    Permet de modifier divers paramtres de la fentre
                comme par exemples, ses dimentions minimales, maximales,
                son titre, sa couleur de fond etc.

"SET GRID"      Autorise ou non l'action de la grille sur tous les objets
                et permet galement de dfinir ses valeurs X et Y.
                La grille permet aux objets et fentres d'tre dplacs
                ou dfinis selon un pas X ou Y plus ou moins grand.

"INIT WINDOW"   Initialise une fentre au cas ou celle utilise aurait te
                ferme par mgarde.

"DELETE WINDOW" Suprime au choix la fentre courante, les objets contenus
                dans la fentre, ou bien les objets et la fentre.

MENU "MENU"
------------
Permet de crer et d'diter les paramtres d'un menu.
Quand vous apellez "DEFINE MENU", il apparait une fentre se composant de
deux colones. Celle de gauche permet de dfinir les titres des menus.
Celle de droite, dfinit les differents points de chaque menu.
Choisissez les caractristiques de vos points de menus grce aux flags
dfinis en bas de la fentre.

Vous pouvez tester le rsultat de votre cration en cliquant su le bouton
"TEST MENU". Le menu qui s'affiche alors est le menu que vous avez dfinit.

Si vous choisissez l'option "GENERATE MENU" dans le menu "PREFERENCES/SOURCES",
le menu que vous avez dfinit sera gnr lors de la cration de votre source.

NB: L'dition des menus n'est pas encore oprationnelle  100% d'ou un certain
nombre de bugs rsiduels qui devraient tre supprims lors de la 
prochaine version.

"DEFINE MENU"   Permet de dfinir les paramtres pour la cration d'un menu.

"TEST MENU"     Permet de tester le menu pralablement dfinit par 
                l'option prcdente "DEFINE MENU".


MENU "PREFS"
-------------
"DEFINE SYSTEM" Permet de modifier ou configurer le systme MOS, notament
                au niveau de la souris, du clavier, de la gestion de l'cran...
               
"GET MEMORY INFO"       Affiche le status mmoire (requester standard).

"DEFINE MAIN PREFS"     Permet de dfinir les prfrences gnrales de MRE.
                - Beep when select item": Emet un "Beep" durant l'dition des
                  objets lorsque l'on passe dessus avec la souris.
                - Full Simulation when message: 
                - Show mouse coordonnes: Affiche les coordones de la souris.
                - Show report when save source: Affiche un rcapitulatif lors
                  de la cration de la source.

"DEFINE SOURCE PREFS"   Permet de dfinir les paramtres qui influent sur
                la cration de la source. Notament:
                - Le nom du programme cr.
                - Le nom de la procdure qui dfinie le requester.
                - La gnration d'un programme entier ou simplement
                        d'une procdure (Generate full program).
                - La gnration des commentaires dans la source 
                  (Generate comments).
                - L'optimisation de la source cre (Optimize source).
                - La gnration des menus et de leur test (Generate Menus).

"CLEAR SCREEN"  Cette fonction permet de nettoyer le fond
                de l'cran au cas ou certains objets auraient ts dfinis
                 l'extrieur de la fentre, et ne seraient pas rafrachit.
 
"SAVE CONFIGURATION"    Sauvegarde la configuration propre de MRE autre
                que les paramtres de gestion de MOS, et notamment, les 
                prfrences dfinies plus haut.


MENU "PROJECTS"
----------------
Ce menu permet de travailler sur plusieurs projets en mme temps, de la mme
manire que sous WinWord on peut travailler sur plusieurs textes  la fois.

Chaque fois qu'un nouveau projet est ouvert ou cre, il est rajout dans
ce menu. Il suffit ensuite de slectionner le Requesters que vous dsirez
utiliser, et il s'affiche instantanment. Quand vous sortez de MRE, vous pouvez
sauvegarder le projet courrant ou bien tous les projets qui ont ts modifis.


****************************************
** EDITION ET MODIFICATION DES OBJETS **
****************************************

        La gestion des objets peut se faire au clavier ou  la souris.
Quand on a cr un objet (un bouton par exemple), il est naturel de vouloir
le modifier, ne serais-ce que pour ajuster certain paramtres de l'objet.

        En temps normal, la fentre est en mode "TEST" (Dernier point du menu
"Gadget"), ce qui permet de tester les gadgets de cette fentre, de la
dplacer, et de modifier ses paramtres par l'intermdiaire des ses boutons.
Si vous slectionnez alors un autre point du menu "Gadget", comme le point
"Bouton" par exemple, MRE passe en mode Edition/Modification.
A partir de la version 2.5 de MRE, vous pouvez diter n'importe quel gadget
quelquesoit son type. Vous n'tes plus oblig de slectionner le type du gadget
dans le menu pour pouvoir diter ce type. Si vous utilisez la souris pour
slectionner les gadgets, vous pouvez diter n'importe quel gadget. Par contre
si vous vous servez des flches du clavier, vous slectionnez successivement
tous les gadgets du mme type.

        Pour crer un nouveau bouton, utiliser la souris, et slectionnez
une zone cran en maintenant le bouton gauche de la souris enfonc, un rectangle
dessin en pointill apparait, puis relachez le bouton quand la taille du
rectangle vous parait suffisante. Vous venez de dfinir un nouvel objet.
Aussitt apparait une fentre qui permet de dfinir les proprits de ce
nouvel lment (selon l'lment cr, les proprits peuvent tre diffrentes).
Modifiez les proprits de votre lment, et cliquez sur le bouton '   OK   '
quand vous avez terminer l'dition. Le bouton ainsi dfinit apparait  l'cran.

        Dans le cas de l'dition des paramtres d'un "Bouton", vous pouvez
dfinir une action pour ce bouton. Action qui sera effectue quand le bouton
sera enfonc. Pour cela, cliquez sur "ACTION" dans la boite d'dition des
paramtres du bouton, vous avez alors les choix suivants:
        
        - Aucune Action.
        - Sortie du requester courant.
        - Appel d'un autre requester.

        - Appel du requester "Palette".
        - Appel du requester "Memory".
        - Appel du requester "Hardware".
        - Appel du "File" requester (slection d'un fichier).
        - Appel du requester "EZ".
        - Appel du requester "progress".
        - Appel du requester "Font".
        - Appel du requester "Attrib".
        - Appel du requester "System".
        - Appel du requester "Register".
        - Appel du requester "String".
        - Appel du requester "Value".

Slectionnez alors l'option choisie, et cliquez sur OK.

        Vous pouvez redfinir les paramtres du requester standard que vous 
dsirez utiliser en cliquant sur "EDIT". Vous ne pouvez utiliser qu'un seul
requester standard pour un type de requester. Par exemple, vous ne pouvez
dfinir qu'un seul requester de Directory, qu'un seul requester Palette, Etc.
              
        Dans certains requesters qui renvois ventuellement des paramtres
comme le File Requester, vous pouvez rediriger l'envois des paramtres vers
un gadget Command (par exemple). Exemple: Dans le File Requester, slectionnez
l'option "Send Result to..." et entrez a droite le numro du gadget command
dans lequel vous voulez renvoyer successivement: Le chemin, le nom et la
taille du fichier slectionn.

        Pour savoir le nombre de d'objet de diffrentes sortes que vous pouvez 
dfinir, utilisez le point du menu "GET ITEMS INFO" du menu "EDIT" qui donne
la quantit maximum de chaque lment dfinissable, ainsi que la quantit
actuelle dfinie.

        Quand plusieurs objets on ts dfinis, vous pouvez slectionner
l'objet de votre choix en utilisant les touches flches pour vous dplacer 
dans la liste des objets d'un mme type. Les touches '+' et '-' ont la mme
action. Vous pouvez aussi tout simplement passer avec la souris sur le gadget 
que vous voulez slectionner, il s'entoure alors d'un cadre.

        L'dition d'un objet se fait en pressant "ENTER" quand l'objet dsir
est slectionn, ou bien en double-cliquant avec la souris sur l'objet dsir.

        Le dplacement d'un objet se fait en se positionnant sur l'objet dsir        
avec la souris, puis tout en maintenant la touche "SHIFT" enfonce, dplacez 
l'objet en cliquant dessus avec le bouton gauche de la souris.
        

****************************
** CE QUE MRE NE GERE PAS **
****************************

En l'tat actuel des choses, MRE ne gre pas  100 % l'interface MOS,
ce qui signifie que certaines des fonctionnalits de MOS ne peuvent pas tre
obtenue par MRE.

Sont dcritent ci-dessous les fonctions que MRE ne gre pas:
   
   - Les groupes de boutons "Check" exclusifs
   - La taille et le style des fontes dans les fentres cres.
   - L'appel d'un requester  partir d'un autre requester.
   - La dfinition des bits des points de menus dans les menus.


****************************
** QUELQUES AMELIORATIONS **
****************************

MRE sera sujet  de nombreuses amliorations dans les prochaines versions.
En voici quelques-unes:

- Implmentation de la cration d'une application en entier (plusieurs
  requesters s'imbriquants les uns dans les autres).
- Sauvegarde dans le ".PAS" de la palette de couleurs dfinie dans MRE.
- Rajout d'un bouton "TEST" permettant de tester le requester standard cre.

.... Toutes les autres suggestions sont les bienvenues .....

                                          
                                          F.Cheveau as ZuuL as BouFFtou
