                        MRE (MOS Resource Editor v2.5)

                            Documentation Francaise
                                 01.01.1997


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

MRE v2.5 est un logiciel d'aide au d‚veloppement sous MOS v2.5.
MRE permet de cr‚‚er toutes sorte de requesters (masques) utilisants les 
objets de MOS v2.5 tels que des boutons, ascensseurs, fenˆtres, etc.

Il vous suffit de positionner … l'‚cran les gadgets d‚sir‚s, et MRE v2.5
cr‚ra 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 unit‚s graphiques de MOS v2.5. Vous devez donc posseder ces 
unit‚s dans le r‚pertoire courant utilis‚ par votre Turbo Pascal pour pouvoir 
compiler les sources cr‚es 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 ex‚cutable
   - 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‚ g‚rant les objets de MOS
   -    MRE_ACTS.PAS                    Unit‚ g‚rant les actions de MOS
   -    MRE_MENU.PAS                    Unit‚ g‚rant les menus de MOS
   - PROJECTS\*.MRE                     Divers fichiers d'exemples

Les sources TP7 de MRE sont fournies de maniŠre … vous permettre ‚ventuellement
de modifier le programme si vous le d‚sirez.


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

MRE permet de cr‚er plusieurs type de sources:
   
   - Des Requesters utilisant une fenˆtre,
   - Des Requesters sur fond d'‚cran, sans fenˆtre,
   - Des Menus.

Les sources g‚n‚r‚es peuvent inclure au choix chacun des type cit‚s 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 cr‚er un requester, vous devez d'abord d‚finir les caract‚ristiques de 
votre fenˆtre. 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 s‚lectionner
le type d'objet que l'on d‚sire utiliser.
   - Les points "BUTTON","CYCLER","RADIO","SLIDER","COMMAND" permettent
     d'utiliser les gadgets d‚finit 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 d‚finits
     tels qu'ils aparaitrons dans le requester r‚el.

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

Pour g‚n‚rer la source TP7 correspondant … votre requester, il vous suffit
de s‚lectionner le point "GENERATE TP7 SOURCE" du menu "FICHIER". Vous donnez
ensuite un nom … votre fichier source, et MRE sauvegardera la source TP7.

Pour d‚finir les options de cr‚ation de la source TP7, reportez-vous au point
de menu "SOURCE PREFS" du menu "PREFERENCES".


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

Grƒce … MRE, vous pouvez au choix cr‚er des requesters en utilisant une 
fenˆtre de fond, ou bien sans fenˆtre support.

Utiliser les options "KILL WINDOW" et "INIT WINDOW" du menu "WINDOW" pour
cr‚er ou supprimer la fenˆtre de base … votre gr‚s, et d‚finissez ensuite
les objets comme vous le souhaitez sans vous pr‚ocuper du support.

Il est cepandant vivement conseill‚ de toujours utiliser une fenˆtre comme
support d'objets (la structure de MOS ayant ‚t‚ pr‚vue pour...).

CONVERSION Fenˆtre / Sans Fenˆtre.
----------------------------------
Vous pouvez ˆtre ammen‚ … transformer un requester qui utilisais une fenˆtre
comme fond en requester sans fenˆtre de fond, ou bien, … cr‚er une fenˆtre
support pour un requester qui n'en avais pas. Pour cela, quand vos objets
sont d‚finis, utilisez … nouveau les options d‚crites plus haut du menu
"WINDOW".

- Si vous creez une fenˆtre, un requester vous infomera qu'il existe d‚ja des
  objets d‚finis auparavant, et vous proposera de les inclure, ou de les
  supprimer avant de cr‚er la nouvelle fenˆtre.

- Si vous supprimez la fenˆtre, un autre requester vous demandera des
  pr‚cisions pour savoir si vous d‚sirez supprimer uniquement les objets,
  l'ensemble fenˆtre+objets, ou bien seulement la fenˆtre, et plaquer les
  objets sur le fond de l'‚cran (requester sans fenˆtre). Choissez cette
  derniŠre option pour faire la conversion.

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

Il y a 7 menus differents:

   - Le menu "FILES" qui permet d'acc‚der aux fichiers, about, et sortie.
   - Le menu "EDIT" regroupant les fonctions d'‚ditions et d'option des objets.
   - Le menu "ITEMS" qui permet de s‚lectionner l'objet actuel … utiliser.
   - Le menu "WINDOW" qui permet de d‚finir et g‚rer la fenˆtre de support.
   - Le menu "MENU" qui permet de d‚finir et g‚rer un menu.
   - Le menu "PREFS" qui d‚finit, 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 r‚initialiser et de cr‚er 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 ultŠrieurement.

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

"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 s‚lectionn‚e, tout nouvel objets cr‚‚s 
                aura pour paramŠtres ceux de l'objet qui le pr‚cŠde dans la
                liste. Par exemple: Un bouton cr‚‚ aura sa position d‚finie 
                par votre soin, mais ses carat‚ristiques telles que la couleur,
                le label, le status, etc qui serons copi‚s du bouton pr‚c‚dent.

"ADJUST POSITION ON GRID"       Permet si cette option est s‚lectionn‚e de      
                r‚ajuster la position de tous les objets (boutons, cadres,
                fenˆtre, etc) en fonction de la grille (si celle-ci … ‚t‚ d‚finie).

"JUSTIFY ITEMS" Si cette option est s‚lectionn‚e, quand la fenˆtre sera
                redimentionn‚e, les objets r‚ajusterons leurs positions et 
                leurs tailles dans la fenˆtre automatiquement.

"DELETE ITEMS"  Permet de suprimer un ou plusieurs type d'objets qui ont
                ‚t‚s pr‚alablements d‚finis.

"GET ITEMS INFO"Donne la quantit‚ de chaque objets qui a ‚t‚ d‚fini.

"UNDO LAST ACTION"      Annule la derniŠre op‚ration effectu‚e. A chaque
                action de votre part, MRE cr‚er 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 d‚sirez utiliser.
Par exemple, pour l'‚dition d'ascenseurs, cliquez sur "SLIDERS", et
cr‚ez ou ‚diter vos objets en utilisant la souris, et les flŠches du clavier.
Pour tester vos cr‚ations, s‚lectionnez "TEST WINDOW".


MENU "WINDOW"
--------------
"EDIT IDCMP"    Permet de modifier les flags IDCMP de la fenˆtre courante.

"EDIT IDRES"    Permet de modifier les flags IDRES de la fenˆtre courante.

"EDIT MISCELLANEOUS"    Permet de modifier divers paramŠtres de la fenˆtre
                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 d‚finir ses valeurs X et Y.
                La grille permet aux objets et fenˆtres d'ˆtre d‚plac‚s
                ou d‚finis selon un pas X ou Y plus ou moins grand.

"INIT WINDOW"   Initialise une fenˆtre au cas ou celle utilis‚e aurait ‚t‚e
                ferm‚e par m‚garde.

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

MENU "MENU"
------------
Permet de cr‚er et d'‚diter les paramŠtres d'un menu.
Quand vous apellez "DEFINE MENU", il apparait une fenŠtre se composant de
deux colones. Celle de gauche permet de d‚finir les titres des menus.
Celle de droite, d‚finit les differents points de chaque menu.
Choisissez les caract‚ristiques de vos points de menus grƒce aux flags
d‚finis en bas de la fenŠtre.

Vous pouvez tester le r‚sultat de votre cr‚ation en cliquant su le bouton
"TEST MENU". Le menu qui s'affiche alors est le menu que vous avez d‚finit.

Si vous choisissez l'option "GENERATE MENU" dans le menu "PREFERENCES/SOURCES",
le menu que vous avez d‚finit sera g‚n‚r‚ lors de la cr‚ation de votre source.

NB: L'‚dition des menus n'est pas encore op‚rationnelle … 100% d'ou un certain
nombre de bugs r‚siduels qui devraient ˆtre supprim‚s lors de la 
prochaine version.

"DEFINE MENU"   Permet de d‚finir les paramŠtres pour la cr‚ation d'un menu.

"TEST MENU"     Permet de tester le menu pr‚alablement d‚finit par 
                l'option pr‚c‚dente "DEFINE MENU".


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

"DEFINE MAIN PREFS"     Permet de d‚finir les pr‚f‚rences g‚n‚rales 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 coordonn‚es: Affiche les coordon‚es de la souris.
                - Show report when save source: Affiche un r‚capitulatif lors
                  de la cr‚ation de la source.

"DEFINE SOURCE PREFS"   Permet de d‚finir les paramŠtres qui influent sur
                la cr‚ation de la source. Notament:
                - Le nom du programme cr‚‚.
                - Le nom de la proc‚dure qui d‚finie le requester.
                - La g‚n‚ration d'un programme entier ou simplement
                        d'une proc‚dure (Generate full program).
                - La g‚n‚ration des commentaires dans la source 
                  (Generate comments).
                - L'optimisation de la source cr‚‚e (Optimize source).
                - La g‚n‚ration 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 ‚t‚s d‚finis
                … l'extŠrieur de la fenˆtre, et ne seraient pas rafraŒchit.
 
"SAVE CONFIGURATION"    Sauvegarde la configuration propre de MRE autre
                que les paramŠtres de gestion de MOS, et notamment, les 
                pr‚f‚rences d‚finies plus haut.


MENU "PROJECTS"
----------------
Ce menu permet de travailler sur plusieurs projets en mˆme temps, de la mˆme
maniŠre que sous WinWord on peut travailler sur plusieurs textes … la fois.

Chaque fois qu'un nouveau projet est ouvert ou cr‚e, il est rajout‚ dans
ce menu. Il suffit ensuite de s‚lectionner le Requesters que vous d‚sirez
utiliser, et il s'affiche instantan‚ment. Quand vous sortez de MRE, vous pouvez
sauvegarder le projet courrant ou bien tous les projets qui ont ‚t‚s modifi‚s.


****************************************
** 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 paramŠtres de l'objet.

        En temps normal, la fenˆtre est en mode "TEST" (Dernier point du menu
"Gadget"), ce qui permet de tester les gadgets de cette fenˆtre, de la
d‚placer, et de modifier ses paramŠtres par l'interm‚diaire des ses boutons.
Si vous s‚lectionnez 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 s‚lectionner le type du gadget
dans le menu pour pouvoir ‚diter ce type. Si vous utilisez la souris pour
s‚lectionner les gadgets, vous pouvez ‚diter n'importe quel gadget. Par contre
si vous vous servez des flŠches du clavier, vous s‚lectionnez successivement
tous les gadgets du mˆme type.

        Pour cr‚er un nouveau bouton, utiliser la souris, et s‚lectionnez
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 d‚finir un nouvel objet.
Aussit“t apparait une fenˆtre qui permet de d‚finir les propri‚t‚s de ce
nouvel ‚l‚ment (selon l'‚l‚ment cr‚‚, les propri‚t‚s peuvent ˆtre diff‚rentes).
Modifiez les propri‚t‚s de votre ‚l‚ment, et cliquez sur le bouton '   OK   '
quand vous avez terminer l'‚dition. Le bouton ainsi d‚finit apparait … l'‚cran.

        Dans le cas de l'‚dition des paramŠtres d'un "Bouton", vous pouvez
d‚finir une action pour ce bouton. Action qui sera effectu‚e quand le bouton
sera enfonc‚. Pour cela, cliquez sur "ACTION" dans la boite d'‚dition des
paramŠtres 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 (s‚lection 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".

S‚lectionnez alors l'option choisie, et cliquez sur OK.

        Vous pouvez red‚finir les paramŠtres du requester standard que vous 
d‚sirez utiliser en cliquant sur "EDIT". Vous ne pouvez utiliser qu'un seul
requester standard pour un type de requester. Par exemple, vous ne pouvez
d‚finir qu'un seul requester de Directory, qu'un seul requester Palette, Etc.
              
        Dans certains requesters qui renvois ‚ventuellement des paramŠtres
comme le File Requester, vous pouvez rediriger l'envois des paramŠtres vers
un gadget Command (par exemple). Exemple: Dans le File Requester, s‚lectionnez
l'option "Send Result to..." et entrez a droite le num‚ro du gadget command
dans lequel vous voulez renvoyer successivement: Le chemin, le nom et la
taille du fichier s‚lectionn‚.

        Pour savoir le nombre de d'objet de diff‚rentes sortes que vous pouvez 
d‚finir, utilisez le point du menu "GET ITEMS INFO" du menu "EDIT" qui donne
la quantit‚ maximum de chaque ‚l‚ment d‚finissable, ainsi que la quantit‚
actuelle d‚finie.

        Quand plusieurs objets on ‚t‚s d‚finis, vous pouvez s‚lectionner
l'objet de votre choix en utilisant les touches flŠch‚es pour vous d‚placer 
dans la liste des objets d'un mˆme type. Les touches '+' et '-' ont la mˆme
action. Vous pouvez aussi tout simplement passer avec la souris sur le gadget 
que vous voulez s‚lectionner, il s'entoure alors d'un cadre.

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

        Le d‚placement d'un objet se fait en se positionnant sur l'objet d‚sir‚        
avec la souris, puis tout en maintenant la touche "SHIFT" enfonc‚e, d‚placez 
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 gŠre pas … 100 % l'interface MOS,
ce qui signifie que certaines des fonctionnalit‚s de MOS ne peuvent pas ˆtre
obtenue par MRE.

Sont d‚critent ci-dessous les fonctions que MRE ne gŠre pas:
   
   - Les groupes de boutons "Check" exclusifs
   - La taille et le style des fontes dans les fenˆtres cr‚‚es.
   - L'appel d'un requester … partir d'un autre requester.
   - La d‚finition des bits des points de menus dans les menus.


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

MRE sera sujet … de nombreuses am‚liorations dans les prochaines versions.
En voici quelques-unes:

- Impl‚mentation de la cr‚ation d'une application en entier (plusieurs
  requesters s'imbriquants les uns dans les autres).
- Sauvegarde dans le ".PAS" de la palette de couleurs d‚finie dans MRE.
- Rajout d'un bouton "TEST" permettant de tester le requester standard cr‚e.

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

                                          
                                          F.Cheveau as ZuuL as BouFFtou
