home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / anim / players / amigrasp.zoo / amigrasp.doc < prev   
Text File  |  1991-09-07  |  8KB  |  194 lines
  1.  
  2.  
  3.                      AmiGRASP ver 1.1  DOCUMENTATION
  4.                      -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  5.  
  6.  
  7.                       Copyright © 1991 Koh Kian Beng
  8.  
  9.  
  10.  
  11. INTRODUCTION TO GL FORMAT
  12. -------------------------
  13.  
  14. GL stand for Graphics Library. It is an archive of files use for animation
  15. on the IBM PCs and clones. Files with the extension '.gl' was created by a
  16. software package called GRASP by Microtex Industries. GRASP is a graphics
  17. programming language which can be used to create and run animated graphics
  18. demonstrations, tutorials and presentation. A program called GRASPRT, stand 
  19. for GRASP RunTime, can be used to just play the animation. As it is an archive,
  20. GL file may 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 performed. 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 compatible.
  28.  
  29. GL files are getting very popular and there exists quite a number of X-rated
  30. animation files. As GL files were created on IBM PC, it can only be played on
  31. an IBM PC and compatibles. Of late, there are another three types of systems
  32. which can display GL animation. They are Acorn Archimedes, UNIX's X-Window and
  33. Commodore AMIGA. For X-Window we have XGRASP and XViewGL, and for the AMIGA we
  34. have GL and AmiGRASP. 
  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 file. 
  62.  
  63.  
  64. COLOR
  65. -----
  66.  
  67. The graphics screen supported are CGA hires (640x200) and VGA lores (320 x 200).
  68. VGA 256 colors will be displayed in HAM. Any drawing and text color will use
  69. amiga's basecolor and not HAM to avoid excessive color fringing. Thus it will
  70. choose the nearest basecolor to VGA color. In this situation, the colors will
  71. not be exactly the same, as 1) Amiga color depth (12-bits) is shallower than
  72. VGA's 18 bits and 2) base color depends on the pictures to be displayed. Some
  73. drawing may even disappear due to color chosen is the same as background color.
  74. More emphasize is place on the correctness of the pictures' color, thus the
  75. picture loading is quite slow especially in HAM mode. Due to the nature of HAM
  76. mode, fringing problem is expected. Care is taken to minimize fringing but
  77. there is a compromise between animation speed and fringing problem. Some of the
  78. special effect, especially sparkle fade, will cause excessive fringing in HAM
  79. mode.
  80.  
  81.  
  82. ASSUMPTION
  83. ----------
  84.  
  85. AmiGRASP assumes all .gl files is in proper order. If not, a visit to guru
  86. is more likely. I have found several errors in some of the gl files i have
  87. and has corrected the error since GRASPRT could not display them too.
  88.  
  89.  
  90. GRASPRT COMPATIBILITY
  91. ---------------------
  92.  
  93. It supports 30% of GRASP 4 commands. Any commands it does not support
  94. will be skipped. It support only 27% of fading mode. Any fade it does not
  95. recognize will be defaulted as fade 0.
  96.  
  97. I intent to support most implementable commands in latest GRASP but i have
  98. limited number of .gl files to try it out. I also do not have the latest
  99. GRASP specs. I'm using GL 1.3 program by John Bickers and occasionaly
  100. office's 386 PC clone for cross-checking on the operation. This AmiGRASP
  101. release is known to have no problem with the following gl files:
  102.  
  103. inout.gl             orgasm.gl         mandy-2.gl     doit.gl
  104. ontop.gl             twotimer.gl       vgax0002.gl    jadesuk1.gl
  105. 1on2.gl              angel-3.gl        3in1.gl
  106. vgax0000.gl          mandy-1.gl        want01.gl
  107.  
  108. If you have a .gl file which you think AmiGRASP did not play correctly,
  109. please get in touch with me. Email the gl file to the Internet address
  110. below and i will send the updated version directly to you as soon as
  111. i manage to support it.
  112.  
  113. How do you know any command it does not support exist? At the beginning, you
  114. may notice some message saying certain command not supported.
  115.  
  116.  
  117. CHANGES SINCE VER 1.0d
  118. ----------------------
  119.  
  120. 1. Solved flickering on some animation using PFADE due to color changes.
  121.  
  122. 2. Now no more flicker on FLY command when run in real FAST RAM.
  123.  
  124. 3. Handle termination of the last command in textfile by ctrl-z or real EOF
  125.    correctly.
  126.  
  127. 4. Support fade 13.
  128.  
  129. 5. Picture/font/text name-search now case-insensitive.
  130.  
  131. 6. Text support for video mode L (VGA 256 colors).
  132.  
  133. 7. Pfade small picture correctly.
  134.  
  135. 8. Support FLOAT, TRAN and FSTYLE commands.
  136.  
  137.  
  138. CREDITS
  139. -------
  140.  
  141. Palette size reduction routine adapted from color.c of public domain program
  142. DGIF 1.0 (a gif viewer) by Derek Noonburg (dn0o+@andrew.cmu.edu).
  143.  
  144. GL disecting routine is base on a program posted by cooper@cs.columbia.edu.
  145.  
  146. GRASP format by George Phillips (phillips@cs.bc.ca) and also from GRASP 1.0
  147. manual.
  148.  
  149.  
  150. COPYRIGHT
  151. ---------
  152.  
  153. Copyright 1991 by Koh Kian Beng. I release this program as freeware. Feel
  154. free to send suggestion, comments, bug report, $$$contribution, more GL files
  155. etc to: 
  156.  
  157.    email to kbkoh@a1acc1.intel.com
  158.          or kbkoh%a1acc1@sc.intel.com
  159.  
  160.    smail to Koh Kian Beng
  161.             H-10-2 Taman Bukit Jambul
  162.             11900 Pulau Pinang
  163.             Malaysia
  164.  
  165.  
  166. HISTORY
  167. -------
  168.  
  169. I'm doing the programming during my spare times after work. It is a bit slow.
  170.  
  171. Start programming: February 03, 1991
  172.  
  173. revision history:
  174.  
  175. 030291: 0.0 This version is a stripdown of KPIC v1.0p modified to be able to
  176.             load multiple pictures into memory and display them in sequence
  177.             on keypress. 
  178.         0.1 support bpp=1 and no color map for bpp=1. follows KPIC v1.1
  179.             modification on these bug. 
  180.         0.3 first working structure of a gl player. support all commands
  181.             required to play inout.gl and ontop.gl.
  182.         0.5 support fade 23, fade 4, reference to label at after goto command
  183.             and loading of pictures into same buffer.
  184.         0.6 support cload, color, clearscr, mark, fly, loop commands.
  185. 210791: 0.7 support cfade, palette, fade 20, pfree, cfree and box commands.
  186. 290791: 0.8 support fload and text command.
  187. 300791: 0.9 support ifkey, window, fade 1, and exit.
  188. 030891: 1.0 support fade 19, and  putup. major rework on color scheme.
  189. 220891: 1.1 faster fade 20 for video c, solve software error bug, reduce memory
  190.             leakage problem, flicker-reduced animation, improve textfile
  191.             termination handling, support fade 13, case-insensitive text
  192.             handling, some color selection scheme changes, major rework on
  193.             display buffering. support float, tran and fstyle.
  194.