home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 559a.lha / amigrasp_v1.0d / amigrasp.doc.pp / amigrasp.doc
Encoding:
Text File  |  1991-09-29  |  7.7 KB  |  203 lines
  1.  
  2.  
  3.                      AmiGRASP ver 1.0d  DOCUMENTATION
  4.                      -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  5.  
  6.  
  7.                       Copyright © 1991 Koh Kian Beng
  8.  
  9.  
  10.  
  11. INTRODUCTION TO GL FORMAT
  12. -------------------------
  13.  
  14. GL is a short term for Graphics Library. It is an archive of files use in
  15. animation on the IBM PCs and clones. Files with the extension '.gl' was
  16. created by a software package called GRASP by Microtex Industries. GRASP
  17. is a graphics programming language which can be used to create and run
  18. animated graphics demonstrations, tutorials and presentation. A program
  19. called GRASPRT can be used to play the animation only. As it is an archive,
  20. GL files contains many component files which includes picture files, text
  21. files and font files. Picture files are the graphics that will be used
  22. in the animation. It can be in many formats which includes PCPAINT's Pictor
  23. (PIC and CLP), GIFs and PCX formats. The text files are the most important
  24. of all files as it dictates how the animation should be played. This text
  25. file contains a series of GRASP commands. A GL files can contain a few
  26. text files which can be chosen by the user. Font files is optional and only
  27. used for generating text characters. The fonts are FONTRIX compatibles.
  28.  
  29. GL files are getting very popular and there exists a number of X-rated animation
  30. files. As GL files were created on IBM PC, it can only be played on an IBM PC
  31. and compatibles. However, lately there are another three types of systems which
  32. can display GL animation to date. They are Acorn Archimedes, UNIX's X-Window
  33. and Commodore AMIGA. XGRASP and XViewGL are available for X-Window and GL for
  34. the AMIGA. AmiGRASP is a new addition for the AMIGA. 
  35.  
  36.  
  37. HOW DO I USE AmiGRASP
  38. ---------------------
  39.  
  40. To run the AmiGRASP, enter at the CLI prompt:
  41.  
  42. CLI> AmiGRASP libname.GL [textname.TXT]
  43.  
  44. libname.gl = the gl animation file you want to view.
  45.  
  46. textname.txt  = optional animation scriptfile. if not specified, AmiGRASP
  47.                 use the first text file it found.
  48.  
  49. To exit: press ESC any time.
  50.  
  51.  
  52. MACHINE COMPATIBILITY
  53. ---------------------
  54.  
  55. It need at least 370KB of free Chip and 512KB of free Fast RAM. The more Fast
  56. RAM you have the better, especially if you do not have hard disk. This will
  57. enable you to run very large gl files such as the Mandy series from the RAM
  58. drive. I've tested AmiGRASP only with my A2000 - 2.5MB Fast, 0.5 MB Chip with
  59. 1.2 ROM. GL files can be on any drive. I did not try to optimize fast ram usage,
  60. neither the program codes. so you might have "not enough memory" problem when
  61. running large gl files. Maybe i'll address it in later revision.
  62.  
  63. AmiGRASP work best on stock Amiga 500/2000 without Workbench loaded. If it
  64. was executed from a CLI window in Workbench, there is a high possiblity of
  65. excessive flickering.
  66.  
  67.  
  68. COLOR
  69. -----
  70.  
  71. The graphics screen supported are CGA hires (640x200) and vga lores (320 x 200).
  72. VGA 256 colors will be display in HAM. Any drawing and text color will use
  73. amiga's basecolor and not HAM to avoid excessive color fringing. Thus it will
  74. choose the nearest basecolor to VGA color. In this situation, the colors will
  75. not be exactly the same, as Amiga color depth (12-bits) is shallower than
  76. VGA's 18 bits. Some drawing may even disappear due to color chosen is the same
  77. as background color. More emphasize is place on the correctness of the
  78. pictures' color, thus the picture loading is quite slow especially in HAM mode.
  79. Some of the fading effect, especially sparkle fade, will cause excessive
  80. fringing in HAM mode.
  81.  
  82.  
  83. ASSUMPTION
  84. ----------
  85.  
  86. AmiGRASP assumes all .gl files is in proper order. If not, a visit to guru
  87. is more likely. I have found 2 error in gl files that i have. Orgasm.gl in
  88. dildo.txt contains text string without closing quote. Another error in the
  89. same text, window setting with missing y parameter. I have taken care of the
  90. first error, but the second one need a rework on the gl file as GRASPRT is
  91. also having problem with it.
  92.  
  93.  
  94. GRASPRT COMPATIBILITY
  95. ---------------------
  96.  
  97. It supports 63% of GRASP 1.0 commands. Any commands it does not support
  98. will be skipped. It support only 23% of fading mode. Any fade it does not
  99. recognize will be defaulted as fade 0.
  100.  
  101. I intent to support all commands up to latest GRASP but i have limited
  102. number of .gl files to try it out. I also do not have the latest GRASP
  103. specs. I'm using GL 1.1 program by John Bickers and occasionaly office's 386
  104. PC clone for reference on the correct operation. Up to this release, i have
  105. tested AmiGRASP with:
  106.  
  107. inout.gl             orgasm.gl         mandy-2.gl
  108. ontop.gl             twotimer.gl       
  109. 1on2.gl              angel-3.gl
  110. vgax0000.gl          mandy-1.gl
  111.  
  112. If you have a .gl file which you think AmiGRASP did not play correctly,
  113. please get in touch with me. Email the gl file to the Internet address
  114. below and i will send the updated version directly to you as soon as
  115. i manage to get it corrected.
  116.  
  117. How do you know any command it does not support exist? At the beginning, you
  118. may notice some message saying certain command not supported.
  119.  
  120.  
  121. PARTIAL SUPPORT
  122. ---------------
  123.  
  124. 1. PUTUP does not support transparency.
  125.  
  126. 2. TEXT not supported for video mode L (VGA 256 colors).
  127.  
  128.  
  129. CHANGES IN VER 1.0d
  130. -------------------
  131.  
  132. 1. Improve sparkle fade (fade 20) speed for video mode C from 50sec to 25sec
  133.    (on stock A2000).
  134.  
  135. 2. No more "Software Error" when file not found.
  136.  
  137. 3. Solved memory leakage problem. 
  138.  
  139. 4. Now handle CLOADing of .clp with colormap correctly.
  140.  
  141.  
  142. CREDITS
  143. -------
  144.  
  145. Palette size reduction routine adapted from color.c of public domain program
  146. DGIF 1.0 (a gif viewer) by Derek Noonburg (dn0o+@andrew.cmu.edu).
  147.  
  148. GL disecting routine is base on a program by George Phillips.
  149.  
  150. GRASP format by George Phillips (phillips@cs.bc.ca) and also from GRASP 1.0
  151. manual.
  152.  
  153.  
  154. COPYRIGHT
  155. ---------
  156.  
  157. Copyright 1991 by Koh Kian Beng. I release this program as freeware. Feel
  158. free to send suggestion, comments, bug report, $$$contribution, more GL files
  159. etc to: 
  160.  
  161.    email to kbkoh@a1acc1.intel.com
  162.          or kbkoh%a1acc1@sc.intel.com
  163.  
  164.    smail to Koh Kian Beng
  165.             H-10-2 Taman Bukit Jambul
  166.             11900 Pulau Pinang
  167.             Malaysia
  168.  
  169.  
  170. HISTORY
  171. -------
  172.  
  173. I'm doing the programming during my spare times after work. It is a bit slow.
  174. It was a development from my program KPIC, a .PIC viewer for Amiga. KPIC
  175. itself is an adaptation from my other program KGIF, a .GIF viewer for Amiga
  176. with PAL display. Both programs released as freeware locally in Malaysia.
  177.  
  178. Start programming: February 03, 1991
  179.  
  180. revision history:
  181.  
  182. 030291: 0.0 This version is a stripdown of KPIC v1.0p modified to be able to
  183.             load multiple pictures into memory and display them in sequence
  184.             on keypress. module majorly affected are display.c and main.c.
  185.         0.1 modify loader.c and paint.c to support bpp=1 and no color map for
  186.             bpp=1. follows KPIC v1.1 modification on these bug. 
  187.         0.3 first working structure of a gl player. new are splitgl.c and
  188.             player.c. support all commands required to play inout.gl and
  189.             ontop.gl.
  190.         0.5 support fade 23, fade 4, reference to label at after goto command
  191.             and loading of pictures into same buffer. these features to run
  192.             blind.txt
  193.         0.6 support cload, color, clearscr, mark, fly, loop commands. these
  194.             features to run twotimer.gl.
  195. 210791: 0.7 support cfade, palette, fade 20, pfree, cfree and box commands.
  196.             these features to run angel-3.gl.
  197. 290791: 0.8 support fload and text command. these features to fully support
  198.             1on2.gl. new text.c module to support text capability.
  199. 300791: 0.9 support ifkey, window, fade 1, and exit. these features to run
  200.             dildo.txt of orgasm.gl.
  201. 030891: 1.0 support fade 19, and  putup. these features to run mandy-1.gl
  202.             major rework on color scheme.
  203.