home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / randjpeg_1 / !Help next >
Text File  |  1996-01-21  |  6KB  |  303 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                      oo  .o                         
  11.                                      88  88[                        
  12.                                      88  Y8`                        
  13.                                      88                             
  14.          ]8[d8   o888,  88o88,    o8888  88  ]8bd8b    o88o    od88o
  15.          ]8888  88888[  888Y88   d88888  88  ]88888[  d8P88[  d88888
  16.          ]88   ]8P ]8[  88  88   88` 88  88  ]8P ]88  88 d8[ ]8P ]8[
  17.          ]8[   88` ]8[  88  88  ]8P  88  88  ]8[  88 ]8888P  88` ]8[
  18.          ]8[   88,.88[  88  88  ]8b d88  88  ]8[ d8[ ]8P"`   88, d8[
  19.          ]8[   Y88888b, 88  88o, 888888o 88  888888`  88oo8  ]88888[
  20.          d8[    Y8P'Y8`.88  '88` '88`Y8P]88  88"8P`   'Y88"   Y88Y8[
  21.                                         ]8[  88                  ]8[
  22.                                         d8[  88               o .88`
  23.                                       888P   88               8888" 
  24.                                       ""`    ""               '""   
  25.  
  26.  
  27.              A FreeWare program to convert JPEGs to RISC O S sprites
  28.  
  29.                         Requires RISC O S 3.60 or later
  30.  
  31.                      By Cy Booker <cy@cheepnis.demon.co.uk>
  32.  
  33.                            Version 1.00 21-Jan-1996
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  =============================================================== randjpeg ==== 
  67.  
  68.  
  69.  
  70.  
  71.      [1]        Synopsis  . . . . . . . . . . . . . . . . . . . . .  1
  72.      [1.1]      License . . . . . . . . . . . . . . . . . . . . . .  1
  73.      [1.2]      Requirements  . . . . . . . . . . . . . . . . . . .  1
  74.      [2]        How to use  . . . . . . . . . . . . . . . . . . . .  2
  75.      [2.1]      Command line parameters . . . . . . . . . . . . . .  2
  76.      [3]        History . . . . . . . . . . . . . . . . . . . . . .  3
  77.      [4]        Future improvements . . . . . . . . . . . . . . . .  3
  78.      [5]        Author  . . . . . . . . . . . . . . . . . . . . . .  3
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  =============================================================== randjpeg ====
  131.  
  132.  
  133.  
  134.  [1] Synopsis
  135.  
  136.  
  137.         randjpeg serves one purpose.  Given:
  138.  
  139.                 a directory containing many JPEG's
  140.  
  141.                 produce a 256 colour RISC O S sprite of
  142.                 one of the JPEG's
  143.  
  144.                 and cycle through all the JPEG's without
  145.                 reptition
  146.  
  147.         Thus it makes a good `random backdrop generator' 
  148.  
  149.  
  150.  
  151.  [1.1] License
  152.  
  153.         This software comes with NO WARANTEE.  It is distributed in
  154.         the hope that it's useful.  The author will not be liable
  155.         for any incurred damages, directly or indirectly due to the
  156.         use or inability to use this software.
  157.  
  158.         It is FreeWare, and remains the copyright of the author.
  159.  
  160.         The code to match a colour to the default wimp palette is
  161.         based on a UseNet article:
  162.  
  163.                 Message-ID: <12463@acorn.co.uk>
  164.                 Date:       30 Jan 92 12:20:23 GMT
  165.                 From:       RWilson@acorn.co.uk
  166.                 Subject:    How to find the closest colour out of
  167.                             the RISC OS 256
  168.  
  169.  
  170.  
  171.  [1.2] Requirements
  172.  
  173.         This software requires the SpriteExtension module supplied
  174.         with RISC O S 3.6.
  175.  
  176.         It does not use ChangeFSI --- it has its' own quantisation
  177.         code.
  178.  
  179.         Everything is RAM based, and it generates an intermediate
  180.         32-bit sprite, so be careful out there.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                   Page   1
  193.  
  194.  =============================================================== randjpeg ====
  195.  
  196.  
  197.  
  198.  [2] How to use
  199.  
  200.  
  201.         Copy the contents of the archive onto a writable media (it
  202.         generates a history file).  Then edit the supplied !Run
  203.         file so that it points to a directory containing some
  204.         JPEG's.
  205.  
  206.         Double-click the !Run file.
  207.  
  208.  
  209.  
  210.  [2.1] Command line parameters
  211.  
  212.  
  213.         The syntax is:
  214.  
  215.                 randjpeg <directory> <history> <sprite>
  216.  
  217.         all parameters are necessary.
  218.  
  219.  
  220.         <directory>
  221.  
  222.                 This directory is scanned recursively for JPEG
  223.                 files each time the program is run.  Thus it is
  224.                 safe to delete/create new sub-directories / JPEG's
  225.                 inbetween runs of the program
  226.  
  227.  
  228.         <history>
  229.  
  230.                 randjpeg creates this text file.  It is a simple
  231.                 database of all the JPEG files processed so far,
  232.                 with one file name per line
  233.  
  234.  
  235.         <sprite>
  236.  
  237.                 This is the name of the sprite file that will be
  238.                 generated.  The file will consist of a single
  239.                 256 colour sprite, no palette, with the sprite
  240.                 named after the (leaf) name of the input JPEG
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                                   Page   2
  257.  
  258.  =============================================================== randjpeg ====
  259.  
  260.  
  261.  
  262.  [3] History
  263.  
  264.         Version 1.00 21-Jan-1996
  265.                 First release
  266.  
  267.  
  268.  
  269.  [4] Future improvements
  270.  
  271.  
  272.         o       Converts GIF's [either internally or via ChangeFSI]
  273.  
  274.         o       Converts Sprites
  275.  
  276.         o       Allow for multiple directories
  277.  
  278.  
  279.         Well, these might get done, but seeing as I'll get the
  280.         usual feedback from users of my stuff (e^(i.pi)+1), not
  281.         likely to be done soon.
  282.  
  283.  
  284.  
  285.  [5] Author
  286.  
  287.        Program and documentation by:
  288.  
  289.  
  290.                                  Cy Booker
  291.                               86 Church View
  292.                                  Main Road
  293.                                 Crockenhill
  294.                                   Swanley
  295.                                    Kent
  296.                                   BR8 8JW
  297.                                    U.K.
  298.                 
  299.                     Internet: cy@cheepnis.demon.co.uk
  300.                 Arcade BBS (Fidonet#2:254/27.0): Cy Booker
  301.                 
  302.               Musical entertainment provided by Frank Zappa
  303.