home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 2002 January / STC_CD_01_2002.iso / APP / TRAIL_PG / GEMJING / GEMJ136.LZH / Develop / Doc / Franz_alt / FGEMJing.u < prev   
Text File  |  1998-05-27  |  12KB  |  341 lines
  1. !language [french]
  2. !use_auto_toptocs [stg,html]
  3. !use_auto_subtocs [stg,win,pch,html]
  4. !use_auto_subsubtocs [stg,win,pch]
  5. !no_effects [asc]
  6. !no_numbers [html]
  7. !docinfo [programimage] box
  8. !html_modern_layout
  9.  
  10. !raw [stg] @options "+z -t4"
  11.  
  12. !docinfo [title] GEMJing-Dokumentation
  13. !docinfo [version] V.1.06
  14. !docinfo [date] 1997-10-15
  15. !docinfo [author] Götz Hoffart
  16. !docinfo [htmltitle] GEMJing-Dokumentation
  17. !raw [stg] @subject "Documentation"
  18.  
  19. ##################################################################
  20. !begin_document
  21. !maketitle
  22. !tableofcontents
  23. ###############################################################
  24. !node Avertissement
  25.  
  26. GEMJing est un shareware mais sans contribution pour l'instant.
  27. Il est interdit de modifier les archives de GEMJing ou d'ajouter GEMJing à
  28. d'autres distributions de programmes, à l'exception de Texel (de Thomas Much), CAB (d'
  29. Alexander Clauss), IPL-Viewer (de Mark Wherry), Schecks (de Christian 
  30. Lehmann) et Fracirc (de Tim Putnam).
  31.  
  32. Quoi que vous fassiez avec GEMJing, c'est à vos risques et périls.
  33.  
  34. Copyright (c) de Götz Hoffart. Tous droits réservés.
  35.  
  36. Auteur: Götz Hoffart, Rheinstetten. (!nl)
  37. MausNet: Götz Hoffart @ FR (!nl)
  38. Internet: hoffart@uni-freiburg.de (!nl)
  39. !ifdest [html]
  40. !raw [html] WWW: <a href="http://members.aol.com/hoffart/index.html">http://members.aol.com/hoffart/index.html</a><br>
  41. !else
  42. WWW: http://members.aol.com/hoffart/index.html
  43. !endif
  44. ###############################################################
  45. !node Utilisation
  46.  
  47. GEMJing joue des échantillons sonores seul ou à partir d'autres
  48. applications. Il supporte les formats WAV, HSN, AVR, SMP, DVS et (prochainement) NeXT/au.
  49.  
  50. GEMJing supporte les équipements suivants:
  51.  
  52. !begin_itemize
  53. !item ST, MegaST
  54. !item STE, MegaSTE, TT
  55. !item Falcon, Apple Macintosh
  56. !item Hades060
  57. !end_itemize
  58.  
  59. Pour interrompre la lecture, presser la touche Control et la touche
  60. Shift (gauche).
  61.  
  62. En cas d'utilisation par d'autres applications, aucun message d'erreur
  63. direct n'est signalé.
  64.  
  65. #####################################################################
  66. !node Guide du programmeur
  67.  
  68. GEMJing a besoin d'au moins 30 Ko de mémoire libre plus la taille
  69. de l'échantillon a jouer.
  70.  
  71. Il existe plusieurs manières de controler GEMJing:
  72.  
  73. !begin_itemize
  74. !item lancement et (!link [utilisation du message VA_START][VA_START])
  75. !item lancement et (!link [utilisation d'un Ligne de commande][Ligne de commande])
  76. !item utilisation d'OLGA
  77. !item lancement et utilisation de GEMScript (OPEN et QUIT sont compris)
  78. !end_itemize
  79.  
  80. !subnode VA_START
  81.  
  82. Lancer GEMJing et effectuer sa recherche avec appl_find. Envoyer un message VA_START
  83. et vous reçevrez les messages AV_STARTED et GEMJING_RETURN.
  84. GEMJing supporte plusieurs options transmises par VA_START. Les passer simplement
  85. devant le nom du fichier a jouer.
  86.  
  87. !begin_xlist [ blaa ]
  88. !item [-q] Quitter. Joue un échantillon et termine le programme.
  89.  
  90. !item [-rx] Répétition. L'échantillon est joué x fois. ""-r1"" signifie
  91. que le fichier sera joué une seule fois, ""-r0"" correspond à l'infini!
  92. Si l'option ""-r"" n'est pas indiquée, cela correspond à ""-r1"". x peut être
  93. n'importe quel integer d'une valeur de 0 (inclus) à 32000 (inclus).
  94.  
  95. !item [-dx] Delai. Fixe un delai de x secondes entre chaque répétition. ""-d0""
  96. correspond à un delai nul. Si l'option ""-d"" n'est pas indiqué, cela correspond à ""-d0"".
  97. x peut être n'importe quel integer d'une valeur de 0 (inclus) à 32000 (inclus).
  98. !end_xlist
  99.  
  100. Si votre programme désire interrompre la lecture, envoyer simplement le signal MiNT
  101. ""SIGUSR1"" à GEMJing.
  102.  
  103. GEMJing ne retourne directement aucun message d'erreur lorsqu'il est controlé par un programme.
  104. Mais vous pouvez observer la valeur du message (!link [GEMJING_RETURN] [message GEMJING_RETURN])
  105. pour obtenir plus d'information.
  106.  
  107. #####################################################################
  108. !subnode Ligne de commande
  109.  
  110. Si une ligne de commande est passée à GEMJing, celui-ci lira l'échantillon
  111. indiqué ou retournera un code d'erreur ( d'une valeur identique au message GEMJING_RETURN ).
  112.  
  113. !begin_xlist [ blaa ]
  114. !item [-q] Quitter. Joue l'échantillon puis termine le programme. Aucune barre de menu
  115. n'est affichée! donc vous pouvez aussi utiliser GEMJing avec des programmes TOS.
  116.  
  117. !item [-rx] Répétition. L'échantillon est joué x fois. ""-r1"" signifie
  118. que celui-ci sera joué une fois, ""-r0"" indique une répétition infinie!
  119. Si l'option ""-r"" n'est pas précisée, cela correspond à ""-r1"". x peut être n'importe
  120. quel integer d'une valeur de 0 (inclus) à 32000 (inclus).
  121.  
  122. !item [-dx] Delai. Fixe un delai de x secondes entre chaque répétition. ""-d0""
  123. correspond à un delai nul. Si l'option ""-d"" n'est pas indiqué, cela correspond à ""-d0"".
  124. x peut être n'importe quel integer d'une valeur de 0 (inclus) à 32000 (inclus).
  125. !end_xlist
  126.  
  127. Si votre programme désire interrompre la lecture, envoyer simplement le signal MiNT
  128. ""SIGUSR1"" à GEMJing.
  129.  
  130. #####################################################################
  131. !subnode message VA_START
  132.  
  133. Un exemple VA_START. Le client reçevra AV_STARTED et
  134. (!link [GEMJING_RETURN] [message GEMJING_RETURN]).
  135.  
  136. !raw [stg] @line 1 70 0 0 7
  137. (!nl)
  138. !begin_verbatim
  139. #define MGLOBAL         0x20
  140. #define VA_START        0x4711
  141. #define AV_STARTED      0x4738
  142. #define GEMJING_RETURN  0x7407
  143. #define MagX_COOKIE     0x4D616758L
  144. #define MiNT_COOKIE     0x4D694E54L
  145.  
  146. BYTE *playbuf;
  147. BOOLEAN MagiC, MultiTOS, MiNT;
  148.  
  149. if (get_cookie(MiNT_COOKIE, &ldum) == TRUE)
  150. {
  151.   MiNT = TRUE;
  152.   if (_GemParBlk.global[1] > 1 || _GemParBlk.global[1] == -1))
  153.       MultiTOS = TRUE;
  154. }
  155. if (get_cookie(MagX_COOKIE, &ldum) == TRUE)
  156.       MagiC = TRUE;
  157.  
  158. [...]
  159.  
  160. /* Alloue de la mémoire globale à la chaîne. Si MiNT ou MagiC est actif,
  161.  * aucun drapeau de protection de mémoire ne doit être activé. (Les
  162.  * programmes TOS on parfois des problèmes avec)
  163.  */
  164. if (MagiC == TRUE || MiNT == TRUE)
  165.   playbuf = (BYTE *) Mxalloc (150, 0 | MGLOBAL);
  166. else
  167.   playbuf = (BYTE *) Malloc (150);
  168.  
  169. /* Remplissage du tableau avec:
  170.  * -q -r3 E:\Sound\BeBack.wav
  171.  * et GEMJing se terminera après trois lectures de l'échantillon.
  172.  */
  173.  
  174. play_sample (playbuf);
  175.  
  176. [...]
  177.  
  178. Mfree (playbuf);
  179.  
  180. VOID play_sample(CONST BYTE *args)
  181. {
  182.   WORD msg[8], i;
  183.  
  184.   if (!args)
  185.     return ;
  186.  
  187.    /* Peut être que GEMJing est déjà present */
  188.    gemjing_id = appl_find("GEMJING ");
  189.    if (gemjing_id < 0)
  190.    {
  191.          PathOfGEMJing = getenv("GEMJINGPATH");        /* ou est GEMJing? */
  192.        if (PathOfGEMJing && strlen(PathOfGEMJing) > 0)
  193.          {
  194.           if (MultiTOS == TRUE)
  195.              shel_write(0, 1, 1, PathOfGEMJing, NULL);
  196.           else if (MagiC == TRUE)
  197.              shel_write(1, 1, 100, PathOfGEMJing, NULL);
  198.       }
  199.    } 
  200.  
  201.   /* Si GEMJing est present */
  202.   if ((i = appl_find ("GEMJING ")) >= 0)
  203.   {
  204.     msg[0] = VA_START;
  205.  
  206.     /* app_id est la valeur retournée par appl_init() */
  207.     msg[1] = app_id;
  208.     msg[2] = 0;
  209.  
  210.     msg[3] = (WORD)(((LONG)args >> 16) & 0x0000ffff);
  211.     msg[4] = (WORD)((LONG)args & 0x0000ffff);
  212.  
  213.     msg[5] = 0;
  214.     msg[6] = 0;
  215.     msg[7] = 0;
  216.  
  217.     appl_write(i, 16, msg);
  218.   }
  219.   return ;
  220. }
  221. !end_verbatim
  222. !raw [stg] @line 1 70 0 0 7
  223. (!nl)
  224. #####################################################################
  225. !subnode message GEMJING_RETURN
  226.  
  227. GEMJing envoi GEMJING_RETURN (0x7407) au client du VA_START.
  228. msg[3] contient une valeur positive non-nulle, le reste du tableau est
  229. à la valeur zéro. Si une erreur s'est produite, GEMJing ne joue pas
  230. l'échantillon!
  231.  
  232. !raw [stg] @line 1 70 0 0 7
  233. (!nl)
  234. !begin_verbatim
  235. /* pas d'erreur, l'échantillon a été joué                                  */
  236. #define RT_OKAY                1
  237.  
  238. /* pas assez de mémoire pour l'entête ou la totalité de l'échantillon      */
  239. #define RT_NO_MEM              117
  240.  
  241. /* fichier non trouvé ou de taille nulle ou erreur de lecture du fichier   */
  242. #define RT_NO_FILE             118
  243.  
  244. /* l'échantillon est compressé (DVS seulement). GEMJing ne le supporte pas */
  245. /* pour l'instant.                                                         */
  246. #define RT_PACKED              119
  247.  
  248. /* l'échantillon (WAV) ne contient pas de donnée sonore                    */
  249. #define RT_WRONG_CHUNK         120
  250.  
  251. /* format de fichier inconnu                                               */
  252. #define RT_WRONG_FILE          121
  253.  
  254. /* format au/NeXT non supporté                                             */
  255. #define RT_UNSUPPORTED_AU_SND  125
  256.  
  257. !end_verbatim
  258.  
  259. #####################################################################
  260. !node Remerciements
  261.  
  262. Merci à:
  263.  
  264. !begin_itemize
  265. !item Thomas Much - pour les beta tests [il n'a jamais de problème :-)]
  266. et suggestions
  267. !item Dirk Haun - programmation de conversion 16 Bit vers 8 Bit
  268. !item Alexander Clauss - suggestions et SND-FAQ
  269. !item Jörg Hahne - auteur du code sonore pour ST
  270. !item Holger Weets, Thomas Künneth, Gerd Hofmann et Alexander Lorenz
  271. pour les beta tests.
  272. !item Sven & Wilfried Behne le réglage du startup code PureC.
  273. !item Katrin Müller pour les très pénibles tests d'écoute
  274. (""we don't need no education""), forcée d'écouter maintes fois les
  275. sons lorsque j'ai commencé à programmer GEMJing :-)
  276. !item Uwe Lehmann (Documentation en anglais), Jo Vandeweghe (Ressource français),
  277. Olivier Booklage (Ressource et documentation en français),
  278. Marion Messerich, Gideon Jacques, Sascha Malatsion, Leona Baba, 
  279. Laisani Petersen, Atilim et Devrim Erkmen, Tiziana Marotta, Basar Alabay, 
  280. Horst Boenisch et Markus Müller.
  281. !item Ulrich Kaiser
  282. !end_itemize
  283. #####################################################################
  284. !node Historique
  285.  
  286. (!B)Version 1.06, 1997-10-15(!b)
  287. !begin_itemize
  288. !item Ressource philipinienne: Christian Marcelo; italienne: Tiziana 
  289. Marotta.
  290. !end_itemize
  291.  
  292. (!B)Version 1.05, 1997-10-04(!b)
  293. !begin_itemize
  294. !item Documentation française par Olivier Booklage, anglais 
  295. par Uwe Lehmann.
  296. !item Ressource française: Jo Vandeweghe; anglais: Uwe Lehmann; 
  297. fidji: Laisani Petersen; esperanto: Sascha Malatsion; espagnol: 
  298. Ursula Hoffart; latin: Marion Messerich; bishlamaro: Gideon Jacques; 
  299. japonais: Leona Baba, turque: Atilim et Devrim Erkmen.
  300. (!nl) Coordination: Markus Müller.
  301. !item Edition Atari-Messe Neuss
  302. !end_itemize
  303.  
  304. (!B)Version 1.04, 1997-08-11(!b)
  305. !begin_itemize
  306. !item GEMJing problème de qualité avec l'option delai. Fixé. Merci à Alexander Clauss et Julian Reschke.
  307. !item Trois nouveaux formats sont reconnus: HSN (CrazySounds), AVR (Michtron),
  308. SMP (Galactic Sound Sampler). GEMJing est quand même réduit de 22 KB à 16 KB.
  309. !item WDIALOG n'est plus indispensable.
  310. !item AV_SENDKEY
  311. !item Version française disponible (merci à Jo Vandeweghe).
  312. !item Supporte GEMScript Rev.0.8, ""OPEN"" et ""QUIT"" inclus.
  313. !item SingleTOS: bug fixé du CLI avec GEMScript dans sa version V.1.03; merci à Peter Melzer.
  314. !item Remarques SCCS
  315. !end_itemize
  316.  
  317. (!B)Version 1.03, 1997-07-15(!b)
  318. !begin_itemize
  319. !item Documentation en anglais disponible
  320. !item sleep() replace evnt_timer() lorsque GEMJing est utilisé comme un programme TOS:
  321. ""-d"" fonctionne même sans initialisation de l'AES.
  322. !item GEMJing devient un serveur OLGA.
  323. !item Commande GEMScript ""OPEN"" est comprise.
  324. !item Correction du GS_COMMAND, merci aux ""GS-Test"" d'Alexander Barton.
  325. !item Méchant bug dans l'initialisation d'OLGA retiré - merci à Olivier Booklage.
  326. !item OLE_EXIT et AP_TERM
  327. !item Quelques améliorations: économie de mémoire (0.5 KB).
  328. !end_itemize
  329.  
  330. (!B)Version 0.71, 1997-03-23(!b)
  331. !begin_itemize
  332. !item Bug dans le code TT retiré.
  333. !item Lecture sur Hades060.
  334. !item Edition CETiK!
  335. !item Première documentation en anglais.
  336. !end_itemize
  337.  
  338.  
  339. #####################################################################
  340. !end_document
  341.