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