COURS209.TXT/fr

   ******************************************************************
   *                                                                *
   *             COURS D'ASSEMBLEUR 68000 SUR ATARI ST              *
   *                                                                *
   *                 par Le F�roce Lapin (from 44E)                 *
   *                                                                *
   *                         Seconde s�rie                          *
   *                                                                *
   *                         Cours num�ro 9                         *
   ******************************************************************

   Ce petit cours va �tre un peu sp�cial, car il va fournir des indi-
   cations  sur la fa�on de r�aliser des programmes GEM qui fonction-
   nent correctement.

   Il  y  a  en effet quelques "trucs" � respecter. Sur MAC, les pro-
   grammeurs  ont � leur disposition des bouquins traitant de l'ergo-
   nomie  des  logiciels. Qu'est ce que c'est ? Et bien c'est simple-
   ment  un  ensemble de r�gles � respecter afin que l'utilisateur ne
   soit  pas perdu d'un programme � l'autre. Il faut en effet bien se
   souvenir  que vous �tes programmeur et que votre ouvrage sera uti-
   lis�  par  des  utilisateurs! R�fl�chissons  un peu: qu'est ce que
   l'utilisateur recherche dans un programme de dessin:

   1) avoir  une  sauvegarde  de fichier compress� avec un algorithme
   sp�cial, qui compresse plus que les copains.

   2) avoir  la  possibilit� de r�cup�rer le plus facilement possible
   ces dessins dans d'autres softs.

   Il para�t �vident que c'est la seconde solution qui est la bonne!
   Pourtant  nous  assistons  �  une  prolif�ration de formats de fi-
   chiers, tous  plus d�biles les uns que les autres! Ah bien s�r, le
   fichier  compress�  avec le logiciel de dessin Bidulmuche est plus
   petit que le fichier issu de Degas, mais il n'est reconnu par per-
   sonne! Pourquoi  chercher  �  �pater  la galerie avec des nouveaux
   formats ? Pourquoi ne pas charger et sauver en PI1, PI2, PI3, PC1,
   PC2, PC3 et  c'est  tout  ? Premi�re  r�gle: il faut donc penser �
   l'utilisateur  et ne pas chercher de trucs tordus! Le premier menu
   c'est  celui  du copyright, le second celui des fichiers avec tout
   en  bas l'option Quitter. Quelle merde de devoir chercher l'option
   Quitter tout au bout d'un menu parce que le programmeur a voulu se
   distinguer!

   De  plus, par  convention, les entr�es de menus qui d�bouchent sur
   un dialogue seront suivis de 3 points.

   Pensez  aux  grands  �crans et au TT !!!!! Lorsque vous tapez dans
   des  adresses  syst�me  document�es, pr�voyez  un adressage sur 32
   bits. Par  exemple  $FF8800 marchera  sur ST mais plantera sur TT.
   C'est en effet une adresse invalide si on cherche � s'en servir en
   32 bits  (avec le 68030). Il faut donc utiliser $FFFF8800 qui mar-
   chera sur toutes les machines.

   Ne  testez pas la r�solution avec Xbios4 ! C'est p�rilleux car, en
   cas de grand �cran, vous recevrez n'importe quoi! Pour l'ouverture
   maxi d'un fen�tre, demandez au GEM la taille de la station de tra-
   vail  (voir le source avec la fen�tre). Une copie de blocs � faire
   ? Utilisez  la  fonction  Vro_cpy, mais  si  c'est  une copie avec
   l'�cran, il  y a une solution simple: vous serez obliger de fabri-
   quer  une  structure FDB (Form Definition Block). C'est une struc-
   ture qui indique la largeur de la surface de travail, sa longueur,
   le  nombre  de  plans etc... Au lieu de demander au GEM toutes les
   donn�es, remplissez la  de 0, et le GEM saura de lui m�me que vous
   voulez parler de l'�cran, et se d�brouillera tout seul!

   Pour  vos  accessoires, testez vos ressources en basse r�solution!
   Un  accessoire, comme  son  nom  l'indique  doit  �tre accessoire,
   c'est-�-dire  fonctionner  sans g�ner le reste de la machine : Pe-
   tite taille (un accessoire de formatage de 100Ko hum!!!).

   Un  seul  fichier  ressource. Cela  implique de ne pas utiliser de
   dessins  et  de  construire sa ressource avec l'option SNAP active
   dans  K_Ressource. Cette  option  permet  d'avoir les boutons bien
   plac�s  quelle  que  soit  la  r�solution d'utilisation de la res-
   source. Si  possible placez la ressource � l'int�rieur de l'acces-
   soire  en  la relogeant (voir listing de relocation ci-joint) cela
   �vite d'avoir plusieurs fichiers � manier quand on d�place les ac-
   cessoires.

   N'h�sitez pas � mettre des raccourcis clavier dans vos ressources.
   Si vous utilisez K Ressources vous verrez qu'il y a un acc�s � des
   bits  inutilis�s  pour  les  objets. En  effet, si l'on prend, par
   exemple, les  bits  d�finissant  les  flags de l'objet, on se rend
   compte  que  seul  les  bits 0 � 8 sont utilis�s. Or le codage est
   fait  sur  un  word, il nous reste donc 7 bits de libres. Ces bits
   sont  laiss�s au programmeur pour y stocker ce qu'il veut. A titre
   indicatif voici ce que j'y mets:

   Extended_type    scan code de la touche de raccourci pour
                    cet objet.

   Extended_flag    Touche(s) devant �tre enfonc�e simultan�ment pour
                    rendre ce raccourci valide.
                    Bit 15 -> Alternate
                    Bit 14 -> Control
                    Bit 13 -> Shift gauche
                    Bit 12 -> Shift droit
                    Bit 11 et 10 -> position du soulignement.
                    (0=pas de soulignement, 1=on souligne la premi�re
                    lettre etc...)

   Extended_state   Indication de la musique sur un octet
                    associ� � la s�lection de cet objet
                    0 pas de musique
                    1 clochette
                    2-63 digits
                    64-127 Xbios(32)
                    128-190 son au format Gist
                    191-255 musique format Mad Max ou Musexx

   Tout  ceci  me permet d'avoir des raccourcis clavier inscrits DANS
   la  ressource  ce  qui permet des modifications ultra-rapide. Pour
   les  raccourcis, il  faut  utiliser de pr�f�rence la touche Alter-
   nate, car son utilisation avec un autre touche ne g�n�re aucun ca-
   ract�re.  Cependant,  6 raccourcis claviers utilisent Control. Ils
   sont issus du MAC et ont tendance � se g�n�raliser. Ces raccourcis
   sont  utilis�s  dans  les formulaires avec champs �ditables (entre
   autres choses) afin de faire du couper/coller entre ces champs.

   CONTROL X      | pour couper (place en buffer en l'effa�ant
                  | au pr�alable)

   SHIFT CONTROL X | pour couper (mettre � la suite dans le buffer);

   CONTROL C et   | Comme  avec  X sauf que,  dans le cas de X,  le
   SHIFT CONTRL C | champ �ditable est  effac�, alors qu'avec C, il
                  | conserve son contenu.

   CONTROL V      | colle le contenu du buffer en effa�ant au
                  | pr�alable le champ �ditable.

   SHIFT CONTROL V | idem mais sans effacement du champ �ditable.

   Une  autre  remarque concernant les formulaires avec plusieurs en-
   tr�es  �ditables:  j'ai  remarqu�  que par habitude  l'utilisateur
   tapait  RETURN  quand  il  avait fini de remplir un champ, et que,
   souvent, le  bouton  ANNULER est mis en d�faut: l'appui sur RETURN
   donc, fait sortir du formulaire! 

   J'ai donc d�cid� de supprimer les boutons d�faut lorsqu'il y a des
   entr�es �ditables et de g�rer diff�remment RETURN qui permet alors
   de passer au champ �ditable suivant (comme TAB).

   J'ai �galement rajout� quelques autres touches. Alors qu'avec TAB,
   il  est  possible  de  passer d'un champ �ditable au suivant, j'ai
   ajout�  Shift+TAB  pour  remonter  au  champ  �ditable  pr�c�dent.
   CLR HOME permettant de revenir au premier champ �ditable du formu-
   laire. Il serait possible d'ajouter UNDO.

   R�-�crire  une gestion totale de formulaire (en prenant comme base
   de  d�part un article de ST Mag qui faisait �a en GFA par exemple)
   n'est  pas  tr�s dur. Ce qui est sympa �galement c'est de rajouter
   un petit carr� en haut � droite, afin de d�placer le formulaire.

   Pour  toutes  ces  options, vous  pouvez bien s�r faire �a � votre
   propre  sauce, mais les raccourcis clavier dont je parle sont d�j�
   un   peu  utilis�s.  Autant  continuer  afin  que  le  syst�me  se
   g�n�ralise, plut�t  que  de chercher � se distinguer par des trucs
   mal commodes.

   Je  terminerai ce chapitre sur le GEM en vous invitant � d�couvrir
   le Protocole de Communication GEM. Pour y avoir acc�s, d�compactez
   le fichier PROTOCOL.AR avec ARCHIVE.PRG. Vous placez ce fichier en
   ram_disque  (par  exemple  D). Vous pr�parez une disquette vierge,
   vous  lancez Archive vous choisissez Unpack avec D:\PROTOCOL.AR et
   comme destination A:\*.* et vous attendez.

   Il  y  a  tous les sources, la biblio, la doc, les exemples etc...
   Tous vos softs doivent �tre compatibles avec ce syst�me s'ils veu-
   lent  �tre dans le coup!!! C'est facile et cela permet des d�lires
   assez fabuleux!

   Bons programmes GEM!!!!!

Back to ASM_Tutorial