home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d903 / mice.lha / MICE / Mice_Doc.Fra < prev    next >
Text File  |  1993-08-26  |  15KB  |  451 lines
  1.  
  2.         ******************************************
  3.         **                    **
  4.         **          MICE            **
  5.         **          V1.3 (04.93)        **
  6.         **      par Pierre-Louis MANGEARD    **
  7.         **                    **
  8.         ******************************************
  9.  
  10.  
  11.  
  12.  
  13.  
  14. MICE signifie :  My Image Code Editor.  C'est un générateur de code source,
  15. Assembleur  et C, à partir d'images IFF, comme des brosses Deluxe Paint par
  16. exemple.
  17.  
  18. MICE  fonctionne  très  bien avec des fichiers IFF standards contenant tous
  19. les  chunks  habituels  conseillés  par  les concepteurs :  'FORM', 'ILBM',
  20. 'BMHD',  'CMAP', CAMG', 'DEST', et 'BODY'.  Mais si tu utilises des formats
  21. javanais avec des chunks exotiques tant pis pour toi.
  22.  
  23. MICE se sert de la REQ.LIBRARY alors tu fais gaffe qu'elle figure bien dans
  24. ton répertoire LIBS.
  25.  
  26. MICE  génère un code source structuré destiné au DEVPAC 2 en assembleur, et
  27. au  LATTICE (ou SAS) en C.  Pour les autres assembleurs ou compilateurs, tu
  28. n'auras qu'à apporter les modifications nécessaires à ton code.
  29.  
  30.  
  31.  
  32. MODE D'EMPLOI :
  33. ---------------
  34.  
  35. Voici  une série de manipulations permettant de faire le tour de toutes les
  36. possibilités de MICE. Je te conseille de les exécuter l'une après l'autre :
  37. il n'y en a pas pour longtemps et comme ça tu comprendras tout.
  38.  
  39. Tu  prendras soin d'abord de charger un éditeur quelconque pourvu qu'il ait
  40. un requester de fichier, pour constater le résultat des opérations.
  41.  
  42. Pour  procéder à  ces  essais,  tu trouveras avec cette Doc un tiroir nommé
  43. 'Brushes' contenant 3 brosses IFF, nommées 'Brol', 'Gazm' et 'Rototo'.
  44.  
  45. Tu lances MICE à partir de son icône ou du Shell pour chacun des tests.  Un
  46. requester  de  fichier  apparaît :  tu iras te placer à chaque fois dans le
  47. tiroir 'Brushes'.
  48.  
  49.  
  50.  
  51. I.- Un seul fichier sélectionné :
  52.     ---------------------------
  53.  
  54. 1 -> Tu  double-clickes  sur  le fichier 'Rototo'.  Le requester disparaît.
  55. Une  fenêtre apparaît, peuplée de gadgets booléens et d'un gadget de chaîne
  56. intitulé 'SOURCE CODE FILENAME'.
  57.  
  58. - 4 gadgets sont préselectionnés  ('ASSEMBLY', 'IMAGE STRUCT', 'IMAGE DATA'
  59. et 'COMMENTS')
  60.  
  61. - un gadget est "ghosted" ('MULTIFILES')
  62.  
  63. - Le gadget de chaîne contient la mention 'RAM:Mice.Code'.
  64.  
  65.  
  66. 2 -> Tu clickes maintenant sur le gadget 'DO & QUIT'.  Tout disparaît.
  67.  
  68. 3 -> A  partir  de ton éditeur,  tu charges à partir de la RAM:  un nouveau
  69. fichier qui vient d'y être créé et qui s'appelle justement 'Mice.Code'.
  70.  
  71.  
  72. Ce  fichier contient la structure 'Image' et les datas d'image de la brosse
  73. 'Rototo',  codés  en assembleur, et agrémentés de commentaires, que tu peux
  74. intégrer directement à un programme destiné à être assemblé avec le DEVPAC.
  75.  
  76. Tu  constates  que  le  code  reprend  le  nom  de la brosse que les labels
  77. 'ImageRototo'  et  'ImageDataRototo'  sont  générés.  Je te laisse imaginer
  78. l'avantage  que  représente ce système qui te permet de nommer pertinemment
  79. tes brosses dès leur génération à partir de ton logiciel de dessin.
  80.  
  81. Donc, pour bénéficier pleinement de l'efficacité de MICE, tu dois respecter
  82. certaines  règles  pour  nommer  tes  brosses  IFF  ;  pour  les connaître,
  83. reporte-toi au paragraphe 'LABELS ET NOMS DE FICHIERS'.
  84.  
  85.  
  86.  
  87. II.- Option 'COMMENTS' :
  88.      -----------------
  89.  
  90. Dans  l'essai précédent, l'option 'COMMENTS' était sélectionnée par défaut.
  91. Voyons maintenant quel a été son rôle en la désélectionnant.
  92.  
  93. 1 -> Tu double-clickes  sur  le  fichier  'Rototo'.
  94.  
  95. 2 -> Tu clickes maintenant sur le gadget 'COMMENTS'. Il se désélectionne.
  96.  
  97. 3 -> Dans  le  gadget  'SOURCE  CODE FILENAME',  tu renommes  le fichier de
  98. sortie en rajoutant un '1', par exemple :  'Mice1.Code'.
  99.  
  100. 4 -> Tu clickes maintenant sur le gadget 'DO & QUIT'. Tout disparaît.
  101.  
  102. 5 -> A partir de ton éditeur,  tu charges,  à la suite du code précédent ou
  103. dans  une  autre  fenêtre  afin de pouvoir les comparer, le nouveau fichier
  104. 'RAM:Mice1.Code'.
  105.  
  106.  
  107. Ce  fichier contient la structure 'Image' et les datas d'image de la brosse
  108. 'Rototo', codés en assembleur, mais SANS les commentaires.
  109.  
  110.  
  111.  
  112. III.- Option 'PALETTE' :
  113.       ----------------
  114.  
  115. Cette  option ajoute  le code  de  la  palette  de la brosse sélectionnée à
  116. partir du requester.
  117.  
  118. Pour  voir  à  quoi  cela  ressemble,  tu peux si tu veux répéter les mêmes
  119. manipulations  que  I  et  II,  mais  en  sélectionnant  en  plus  l'option
  120. 'PALETTE'.
  121.  
  122.  
  123.  
  124. IV.- Option 'C' :
  125.      ----------
  126.  
  127. Cette  option  permet  d'obtenir  le code source en C et non en Assembleur.
  128. Les deux gadgets sont en va-et-vient.
  129.  
  130. Pour  voir  à  quoi  cela  ressemble,  tu peux si tu veux répéter les mêmes
  131. manipulations  que  précédemment, mais en sélectionnant l'option 'C' plutôt
  132. que l'option par défaut 'ASSEMBLY'.
  133.  
  134.  
  135.  
  136. V.- Multi-sélection de fichiers sans l'option 'MULTIFILES' :
  137.     ------------------------------------------------------
  138.  
  139. V.1.- Option 'ASSEMBLY' :
  140.  
  141.  
  142. 1 -> En  maintenant la touche  'SHIFT' enfoncée,  tu clickes successivement
  143. sur  les  trois  fichiers  'Brol',  'Gazm',  et  'Rototo', puis tu relâches
  144. 'SHIFT'.
  145.  
  146. 2 -> Tu clickes sur le bouton 'OK' du requester.
  147.  
  148. 3 -> Tu sélectionnes l'option  'PALETTE'.  Tu remarqueras au passage que le
  149. gadget  'MULTIFILES' n'est plus "ghosted", mais pour l'instant on le laisse
  150. de côté.
  151.  
  152. 4 -> Tu clickes sur 'DO & QUIT'.
  153.  
  154. 5 -> A partir de ton éditeur, tu charges 'RAM:Mice.Code'.
  155.  
  156.  
  157. Le code que tu as obtenu comprend 3 sections :
  158.  
  159. - SECTION Palette,DATA        comprenant la Palette
  160. - SECTION ImageStructure,DATA    comprenant toutes les structures 'Image'
  161. - SECTION ImageData,DATA_C    comprenant tous les datas d'image
  162.  
  163. Cet  agencement  te  permet  de  manipuler  d'un seul coupé-collé des blocs
  164. entiers de data d'un même type.
  165.  
  166. La  palette  n'est  donnée  qu'une seule fois en tête de fichier.  C'est la
  167. palette  du  premier  fichier  sélectionné,  'Brol'.  Si 'Brol' n'avait pas
  168. contenu  de palette ou une palette corrompue, 'Mice.Code' n'aurait pas fait
  169. figurer de SECTION Palette.
  170.  
  171.  
  172. V.2.- Option 'C' :
  173.  
  174.  
  175. Le code généré en C est structuré différemment de celui en assembleur.
  176.  
  177. Pour  voir  à  quoi  cela ressemble, tu répètes les mêmes manipulations que
  178. dans la partie V.1., mais en sélectionnant l'option 'C' plutôt que l'option
  179. par défaut 'ASSEMBLY'.
  180.  
  181. La  palette  est  donnée  en  premier,  mais  les datas d'image ne sont pas
  182. séparés  des  structures 'Image' et les données des 3 images 'Brol', 'Gazm'
  183. et 'Rototo' restent groupées.
  184.  
  185. En  effet,  tu  remarques  que  chaque  chunk 'ImageData' est précédé de la
  186. directive 'USHORT chip' :  ce mot-clef 'chip' garantit que le data qui suit
  187. sera  chargé  en  CHIP MEMORY lorsque tu lanceras ton exécutable.  Il n'est
  188. donc  pas  nécessaire de stocker séparément les datas d'image des structure
  189. 'Image'.
  190.  
  191.  
  192.  
  193. VI.- Multi-sélection avec l'option 'MULTIFILES' et sans 'PALETTE' :
  194.      ------------------------------------------------------------
  195.  
  196. 1 -> En  maintenant la touche  'SHIFT' enfoncée,  tu clickes successivement
  197. sur  les  trois  fichiers  'Brol',  'Gazm',  et  'Rototo', puis tu relâches
  198. 'SHIFT'.
  199.  
  200. 2 -> Tu clickes sur le bouton 'OK' du requester.
  201.  
  202. 3 -> Tu sélectionnes l'option 'MULTIFILES'.  Tu remarques que dès que tu as
  203. clické,  le  gadget  'SOURCE  CODE  FILENAME'  a indiqué 'RAM:' et non plus
  204. 'RAM:Mice.Code'.
  205.  
  206. 4 -> Tu clickes sur le bouton 'DO & QUIT' de la fenêtre.
  207.  
  208. 5 -> Avec le requester  de ton éditeur de fichier, tu constates qu'il y a 3
  209. nouveaux fichiers en RAM:, nommés 'Brol.Code', Gazm.Code' et 'Rototo.Code'.
  210. Si  tu  les  visionnes  l'un après l'autre tu verras que chacun contient la
  211. structure 'Image' et les datas d'images de sa brosse d'origine.
  212.  
  213.  
  214.  
  215. VII.- Multi-sélection avec l'option 'MULTIFILES' et avec 'PALETTE' :
  216.       ------------------------------------------------------------
  217.  
  218. 1 -> En  maintenant la touche  'SHIFT' enfoncée,  tu clickes successivement
  219. sur  les  trois  fichiers  'Brol',  'Gazm',  et  'Rototo', puis tu relâches
  220. 'SHIFT'.
  221.  
  222. 2 -> Tu clickes sur le bouton 'OK' du requester.
  223.  
  224. 3 -> Tu sélectionnes l'option 'PALETTE'.
  225.  
  226. 4 -> Tu sélectionnes l'option 'MULTIFILES'.
  227.  
  228. 5 -> Tu clickes sur le bouton 'DO & QUIT' de la fenêtre.
  229.  
  230. 6 -> La fenêtre disparaît  et laisse place à un requester  qui te demande :
  231. 'Repeat  palette  in  each file ?' ('Dois-je répéter la palette dans chaque
  232. fichier ?').  Tu peux répondre 'Yes' ou 'No' :
  233.  
  234.  
  235. VII.1.- Réponse 'Yes' au requester :
  236.  
  237.  
  238. Avec le requester de ton éditeur de fichier, tu constates qu'il y a en RAM:
  239. les  3  fichiers  'Brol.Code',  Gazm.Code'  et  'Rototo.Code'.   Si  tu les
  240. visionnes  l'un  après  l'autre  tu  verras  qu'ils  contiennent  chacun la
  241. palette,   la   structure  'Image'  et  les  datas  d'image  de  la  brosse
  242. correspondante.   Mais  cette  fois-ci, la palette de chaque fichier a pour
  243. nom, respectivement, 'PaletteBrol', 'PaletteGazm', et 'PaletteRototo'.
  244.  
  245.  
  246. VII.2.- Réponse 'No' au requester :
  247.  
  248.  
  249. Avec le requester de ton éditeur de fichier, tu constates qu'il y a en RAM:
  250. les 3 fichiers 'Brol.Code', Gazm.Code' et 'Rototo.Code' ainsi qu'un nouveau
  251. fichier  nommé 'Palette.Code'.  Si tu le visionnes tu verras qu'il contient
  252. la palette.  Les 3 autres fichiers ne contiennent plus la palette.
  253.  
  254.  
  255.  
  256. VIII.- Multi-sélection de fichiers avec l'option 'PALETTE' seule :
  257.        ---------------------------------------------------------
  258.  
  259. Dans la grande majorité des cas, quand tu veux coder des brosses IFF, elles
  260. appartiennent  toutes  à un même écran et partagent donc la même palette de
  261. couleurs.  C'est pourquoi MICE ne génère qu'une seule palette, sauf dans le
  262. cas décrit en VII.1.
  263.  
  264. Mais  si  tu  ne  sélectionnes  QUE l'option 'PALETTE', MICE comprendra que
  265. c'est  bien  PLUSIEURS  palettes que tu désires et génèrera soit un fichier
  266. unique   avec   les   trois   palettes   'PaletteBrol',  'PaletteGazm',  et
  267. 'PaletteRototo',  soit,  si  tu  as  choisi  l'option  'MULTIFILES',  trois
  268. fichiers  'Brol.Code',  Gazm.Code'  et  'Rototo.Code'  contenant  chacun sa
  269. palette respective.
  270.  
  271.  
  272.  
  273. IX.- Option 'SHOW IFF' :
  274.      -----------------
  275.  
  276. IX.1- Sélection unique :
  277.  
  278.  
  279. 1 -> Tu double-clickes sur le fichier 'Rototo'.
  280.  
  281. 2 -> Sélectionne l'option 'SHOW IFF'.
  282.  
  283. 3 -> Un écran apparaît qui te montre à quoi ressemble la brosse 'Rototo'.
  284.  
  285. 4 -> Tu appuies  sur le bouton gauche  de la souris :  l'écran disparaît et
  286. tu retournes à la fenêtre.
  287.  
  288.  
  289. IX.2- Multi-sélection :
  290.  
  291.  
  292. 1 -> En  maintenant la touche  'SHIFT' enfoncée,  tu clickes successivement
  293. sur  les  trois  fichiers  'Brol',  'Gazm',  et  'Rototo', puis tu relâches
  294. 'SHIFT'.
  295.  
  296. 2 -> Tu clickes sur le bouton 'OK' du requester.
  297.  
  298. 3 -> Tu sélectionnes l'option 'SHOW IFF'.
  299.  
  300. 4 -> Un écran apparaît qui te montre à quoi ressemble la brosse 'Brol'.
  301.  
  302. 5 -> Tu appuies  sur le bouton gauche  de la souris :  l'écran disparaît et
  303. un autre lui succède qui te montre à quoi ressemble la brosse 'Gazm'.
  304.  
  305. 6 -> Tu appuies  sur le bouton gauche  de la souris :  l'écran disparaît et
  306. un autre lui succède qui te montre à quoi ressemble la brosse 'Rototo'.
  307.  
  308. 7 -> Tu appuies  sur le bouton gauche  de la souris :  l'écran disparaît et
  309. tu retournes à la fenêtre.
  310.  
  311.  
  312.  
  313. X.- Options 'DO', 'DO & QUIT', 'CANCEL', QUIT' :
  314.     ------------------------------------------
  315.  
  316. Dans  les  exemples  précédents,  il  était  toujours dit de clicker sur le
  317. bouton 'DO & QUIT' à la fin de chaque manipulation.  Cette option permet de
  318. coder sa ou ses images, puis de quitter MICE directement.
  319.  
  320. L'option  'DO'  permet  de coder sa ou ses images et, dès que le codage est
  321. achevé,  de  revenir  au  requester de fichiers pour éventuellement traiter
  322. d'autres images.
  323.  
  324. L'option  'CANCEL'  permet  de  revenir au requester de fichiers sans avoir
  325. fait quoi que ce soit.
  326.  
  327. L'option  'QUIT'  permet  de quitter MICE sans avoir fait quoi que ce soit,
  328. tout comme le bouton 'Forget it' du requester.
  329.  
  330.  
  331.  
  332. LABELS ET NOMS DE FICHIERS :
  333. ----------------------------
  334.  
  335. MICE  recupère  le  nom  de  ta brosse pour génèrer ses labels.  C'est très
  336. pratique,  car dès que tu as créé ton dessin tu peux le sauvegarder sous le
  337. nom que tu comptes utiliser dans ton programme.
  338.  
  339. MICE  transforme  la  première lettre de ton nom de fichier en majuscule si
  340. elle ne l'est pas déjà.
  341.  
  342. Par  exemple,  à  partir  d'une  brosse  nommée 'rototo', MICE génèrera les
  343. labels  suivants  :   'ImageRototo',  'ImageDataRototo',  et éventuellement
  344. 'PaletteRototo'.
  345.  
  346. Etant  donné  que  le  nom de ton fichier IFF deviendra label, il doit donc
  347. respecter quelques règles :
  348.  
  349. - le nom doit commencer par les caractères a-z, A-Z ou _.
  350.  
  351. - il ne peut contenir d'autres caractères que a-z, A-Z, 0-9 ou _.
  352.  
  353. - il ne doit donc pas contenir d'espace.
  354.  
  355. - il ne doit donc pas contenir de caractères accentués.
  356.  
  357. exemples de noms valides :
  358.  
  359.     Rototo
  360.     veRGlUtoMItrOPhLerCABle
  361.     Ramb0
  362.     R2D2
  363.     Louis_XIV
  364.     _fna
  365.     __vlu
  366.  
  367. exemples de noms invalides :
  368.  
  369.     Starsky&Hutch
  370.     2001_A_Space_Odyssey
  371.     &%$?#(>*
  372.     _make room !
  373.     yékéké
  374.     etc...
  375.  
  376.  
  377. - MICE refuse un fichier dont la première lettre du nom n'est pas correcte.
  378.  
  379. - MICE  accepte  les  fichiers  contenant des caractères illégaux  :  il se
  380. contente  de  garder  ce qui est valide et de supprimer ce qui suit.  Voici
  381. quelques exemples de ce que cela donne :
  382.  
  383.     Starsky&Hutch    donne le label    ImageStarsky
  384.     brush.1           "      "    ImageBrush
  385.     brush.2           "      "    ImageBrush
  386.     brush(!&?<>)       "      "    ImageBrush
  387.     _make room !       "      "    Image_make
  388.     etc...           "      "    ImageEtc
  389.  
  390.  
  391. Tu  feras  donc  attention que les premiers caractères significatifs de tes
  392. noms soient bien différents d'un fichier à l'autre.
  393.  
  394. Dans  le  cas  ci-dessus  des 2 noms de fichiers 'brush.1' et 'brush.2', tu
  395. peux  constater qu'ils donnent le même label, ce qui te vaudrait un message
  396. d'erreur lors de la compilation avec le DEVPAC ou le LATTICE/SAS.
  397.  
  398. Si  tu  as choisi l'option 'MULTIFILES', tu ne verras apparaître qu'un seul
  399. fichier  source,  du  nom de 'Brush.Code', qui contiendra le code source du
  400. dernier  des  deux  fichiers  'brush.1'  et  'brush.2'  à avoir été traité,
  401. celui-ci ayant écrasé le précédent puisqu'il portait le même nom.
  402.  
  403.  
  404. Par  défaut,  MICE génère le fichier 'RAM:Mice.Code', et prend 'RAM:' comme
  405. périphérique de sortie pour l'option 'MULTIFILES'.
  406.  
  407.  
  408.  
  409.  
  410. Chronologie :
  411.  
  412. MICE V1.00 :    octobre 1991
  413. MICE V1.20 :    novembre 1991 (Fish 590)
  414.         Quelques bugs fixés.
  415. MICE V1.30 :    avril 1993
  416.         Optimisations globales et Topaz 8 pour la fonte des gadgets.
  417.  
  418.  
  419.  
  420.  
  421.     ================***************************==================
  422.             *=*=*=*=*=*=*=*=*=*=*=*=*=*
  423.  
  424.  
  425.  
  426. CORRESPONDANCE :
  427. ______________
  428.  
  429.  
  430.  
  431.             Pierre-Louis MANGEARD
  432.             95, chemin Kennedy
  433.             97432 LA RAVINE DES CABRIS
  434.             Ile de la Réunion
  435. ou
  436.             Pierre-Louis MANGEARD
  437.             Médiathèque de Saint-Pierre
  438.             BP 396
  439.             97410 SAINT PIERRE
  440.             Ile de la Réunion
  441. ou
  442.             Pierre-Louis MANGEARD
  443.             15, rue des Cailles
  444.             Plateau Caillou
  445.             97460 SAINT PAUL
  446.             Ile de la Réunion
  447.  
  448.  
  449. tel: 19 ~ 262  57 40 28
  450.  
  451.