home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / graphics / progress / !Progress / !Help < prev    next >
Encoding:
Text File  |  1997-08-02  |  5.2 KB  |  156 lines
  1. Progress 
  2. ========
  3.  
  4. Version 0.50
  5. ============
  6. Progress was writen as graphics helper for Webite, the Web browser for
  7. Termite Internet, but it can also be used as a command line utility. (it
  8. maybe possible to use it with other browsers but it has not been tested.)
  9.  
  10. It was written to speed up Jpeg decompression and to give limited support
  11. for the Progressive Jpegs that have now begun to appear on the WWW. It will
  12. also process PNG files if Creator (version 3.20) has been seen by the filing
  13. system. (it uses djeg written by the Independent JPEG Group -- See
  14. Copyright.)
  15.  
  16. This version also has limited support for convertting a draw file in to
  17. sprite format.
  18.  
  19. Installation
  20. ============
  21.  
  22. Termite Internet
  23. ----------------
  24.   1. Copy the !Progress application in side of the !Termite directory,
  25.      (Hold Shift down, double-click Select on the !Termite application
  26.      to open it)
  27.   
  28.   2. Load !Termite and open the icon bar menu. Click on 'Style
  29.      editor...' and the 'Edit style' window will open.
  30.   
  31.   3. Chose style 'Internet' from the pop up menu at the top of the
  32.      page to the right of 'Style name'.
  33.   
  34.   4. Scroll the window down to the bottom and click on WWW.
  35.   
  36.   5. In the Image helper writable icon.
  37.      (you may need to scroll the window down) type in;
  38.   
  39.             Run <Termite$Dir>.!Progress %0 %1 %2 -c -d -q3
  40.   
  41.   6. And click on 'Save'
  42.   
  43.   7. Open up the off line Web browser and drag a JPEG file in to the
  44.      window and it should become visable. If you don't see the
  45.      picture (a small ? file icon appears read though these instruction
  46.      and try again.
  47.  
  48. ImageMap
  49. ========
  50. This only relates to versions of ImageMap above and including 1.30
  51.  
  52.   1. Load ImageMap and open the choices display by selecting Choices
  53.      from the icon bar menu.
  54.   
  55.   2. Select the 'Image helper' button on the left hand side of the
  56.      window.
  57.  
  58.   3. Make sure that the 'Always use ChangeFSI' option is unselected.
  59.  
  60.   4. Enter '*Progress %0 %1 %2 -c -d' in to the top icon and
  61.      'Progress$ReturnCode' in the bottom icon and click on save.
  62.  
  63. You will need to make sure that Progress has been seen by the RISC OS
  64. filing system before trying to import file that are unknoen to ImageMap.
  65.  
  66. Commands
  67. ========
  68. When called Progress requires at least an input file name and output file
  69. name, which must be different. Ypu can also define the mode that Progress
  70. should use if no mode is defined then it will just use the current one.
  71.  
  72.    *Progress <in file> <out file> <mode> <flags>
  73.  
  74. You can also control Progress using the flag settings.
  75.  
  76.         -c      Use ChangeFSI on unknown filetypes.
  77.  
  78.         -d      Process Drawfiles if they get sent to Progress.
  79.  
  80.         -q1     With the quick Jpeg decompression this sets the
  81.                 quality level to the lowest. It is the fastest
  82.                 in terms of speed.
  83.  
  84.         -q1     With the quick Jpeg decompression this sets the
  85.                 quality level to the a comprise between speed and
  86.                 quality.
  87.  
  88.         -q3     With the quick Jpeg decompression this sets the
  89.                 quality level to the highest. It is the slowest
  90.                 in terms of speed.
  91.  
  92. The <mode> value is only used when Progress calls ChangeFSI. This can be
  93. when it processes a Progressive Jpeg or when it gets sent a unknown graphics
  94. type. If no mode value is sent then the mode is defaulted to 28 (256
  95. colours, hires).
  96.  
  97. Examples
  98. ========
  99.  
  100. *Progress RAM:$.in Ram:$.out 28 -c
  101.  
  102.         Will send any files, that are not Jpegs to ChangeFSI, and will
  103.         output a mode 28 sprite if it is. Will not touch any Drawfiles
  104.         sent.
  105.  
  106. *Progress RAM:$.in Ram:$.out 28 -c -d
  107.  
  108.         Same as above except it will convert Drawfiles.
  109.  
  110. Problems, bugs and things that should not happen
  111. ================================================
  112. Currently when a Drawfile is processed, the sprite created ends up with
  113. a big white background. In a future version this will not happen the
  114. sprite will be created with a mask and the background will be created
  115. as such.
  116.  
  117. When creating sprites in a mode different to the current mode sometimes the
  118. colour matching goes a bit strange this is a bug in Risc OS.
  119.  
  120. PNGs are also created without a mask but a blank back ground. This is a
  121. problem with png2clr not Progress.
  122.  
  123. Copyright
  124. =========
  125. The djpeg code is copyright the Independent JPEG Group.
  126.  
  127. 'This software is based in part on the work of the Independent JPEG Group'
  128.  
  129. The PNG compression code is covered by the copyright restrictions of
  130. Creator. Processing code is in C. Acknowledgements :
  131.     - Compiled with GCC for RISC OS release 1.0.7, (c) 1996 Nick Burrett.
  132.     - Linked with UnixLib 3.7b, maintained by Simon Callan.
  133.     - Uses libpng 1.0 beta 3 0.89, (c) 1995-1996 Guy Eric Schalnat.
  134.     - Uses zlib 1.0.4, (c) 1995-1996 Jean-loup Gailly and Mark Adler.
  135.  
  136. Many thanx to John Kortink for allowing png2clr to distrubuted seperately :)
  137.  
  138. Disclamer
  139. =========
  140. The author is not to blame if anything go wrong.
  141.  
  142. Contact
  143. =======
  144. I can be contacted by any of the means below if you have a problem with
  145. Progress or find any graphics that it will not decode.
  146.  
  147. E-mail : david@rylands.demon.co.uk
  148.  
  149. WWW    : http://www.atlantic.oaktree.co.uk/
  150.  
  151. Snail  : David McCormack
  152.          2 Cornwall Avenue
  153.          Beeston Rylands
  154.          Nottingham
  155.          NG9 1NL
  156.