home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / converters / tiffin_1 / !Tiffin / !Help < prev    next >
Text File  |  1995-12-01  |  6KB  |  170 lines
  1. Tiffin
  2. ~~~~~~
  3. Author
  4. ======
  5. Peter Greenham
  6.  
  7. Version
  8. =======
  9. 2.03 (1-Dec-95)
  10.  
  11. Purpose
  12. =======
  13. Converts between RISC OS Sprites and TIFFs.
  14.  
  15. But ChangeFSI does that, doesn't it?
  16.  
  17. Well, yes, most of the time, but ChangeFSI doesn't cope with all TIFFs. In
  18. particular, it doesn't cope with multi-channel TIFFs such as those exported
  19. by PhotoShop 3 on the PowerMac. Tiffin is likely to read just about any valid
  20. TIFF file thrown at it. You can then drag the sprite into ChangeFSI for
  21. scaling or taking down to fewer colours.
  22.  
  23. Specifically, Tiffin should work for all TIFFs following the 5.0 or 6.0 TIFF
  24. spec.
  25.  
  26. In addition, TIFF creation under RISC OS is sometimes unexpectedly traumatic.
  27. Creator does strange things sometimes, and doesn't work at all with 16 or 32
  28. bit sprites, while PhotoDesk does not handle compression. Tiffin can take any
  29. Archimedes sprite and turn it into a TIFF, either 24 or 32 bit, with or
  30. without LZW compression.
  31.  
  32. NB: ChangeFSI doesn't cope with the 32-bit TIFFs Tiffin generates, but is
  33. happy with the 24-bit ones.
  34.  
  35. Use
  36. ===
  37. It's simplicity itself: When run, it installs its icon on the right side of
  38. the icon bar. Drag a TIFF file to it, and after a short delay you will be
  39. presented with a window showing the resulting sprite. Click MENU to obtain
  40. the save box. Note that as this is a 32-bit sprite, it may not look too
  41. brilliant on screen modes without that many colours. Don't worry, the sprite
  42. itself is fine. Switch to 16 million colours to reassure yourself!
  43.  
  44. The reverse conversion is as simple: Drag a sprite file onto the Tiffin icon,
  45. and it will appear in a window. You can then save it out as a TIFF, according
  46. to the options set int the Options dialogue (obtainable from the iconbar
  47. menu).
  48.  
  49. Tiffin can hold multiple images at the same time, up to the limit of your
  50. computer's memory.
  51.  
  52. There is an "Options..." item on the iconbar menu. Select this to change the
  53. settings to be obeyed in future.
  54.  
  55. At the top is the "Interactive" option, which is selected as default. If you
  56. deselect this, sprite or TIFF files dropped on the iconbar will be converted
  57. and written back over the source without asking for confirmation. This is
  58. useful if you have an entire folder full of images you want to convert. MAKE
  59. SURE YOU HAVE A BACKUP OF THE IMAGES FIRST - in case you change your mind. And
  60. be warned that, when converting from TIFFs to Sprites, because there is no
  61. compression in RISC OS sprite files, the resulting files will almost
  62. certainly be larger than the TIFF source files.
  63.  
  64. Another, safer way of performing batch conversions is to drag a directory
  65. holding files to be converted onto the Tiffin icon. You will be shown a save
  66. box allowing you to drag a new directory of the same name somewhere else.
  67. Tiffin will then work recursively down the directory structure converting all
  68. files it sees.
  69.  
  70. Clicking on the iconbar icon will give you an error box showing the version
  71. of LIBTIFF being used. See below.
  72.  
  73. LIBTIFF 3.4beta
  74. ===============
  75. Tiffin uses my own port of the TIFF support library written and placed into
  76. the public domain by Sam Leffler of Silicon Graphics Inc. The latest version
  77. of the library is obtainable from ftp.sgi.com/graphics/tiff, and this Acorn
  78. port is integrated there.
  79.  
  80. In addition, the library, and a pre-made Acorn version, exist on more common
  81. Acorn sites (ftp.sgi.com is VERY slow from here!). I will upload it to Demon
  82. and Hensa. However, this may not always be the most up-to-date version of
  83. LIBTIFF, though every effort will be made.
  84.  
  85. Toolbox
  86. =======
  87. This application uses the new Toolbox modules that come with Acorn C/C++. For
  88. this reason, a copy of !System is supplied with Tiffin for you to integrate
  89. with your own !System in the normal way. You will need to do this before
  90. Tiffin will run.
  91.  
  92. Requirements
  93. ============
  94. Tiffin will only run on RISC OS 3.50 or later. This is because it produces
  95. 32-bit sprites unknown to previous versions of RISC OS, and because it uses
  96. dynamic areas.
  97.  
  98. Rights
  99. ======
  100. This program is copyright © Peter Greenham 1995. It has been released as
  101. FREEWARE. This means you can copy, distribute and make use of it as you see
  102. fit, provided you do not sell it. PD libraries may include it as long as they
  103. do not charge more for disks than is needed to cover costs.
  104.  
  105. I can accept no liability for data loss or other damages arising from the use
  106. of this product.
  107.  
  108. Contact
  109. =======
  110. Peter Greenham
  111.  
  112.     peter@enlarion.demon.co.uk
  113.     User #963 Arcade BBS (0181 654 2212)
  114.  
  115. ChangeLog
  116. =========
  117. 1.21 17-Jul-95
  118. Received OSLib 5.00. Fixed, recompiled and relinked using it. No functional
  119. change at all.
  120.  
  121. 1.22 20-Jul-95
  122. Received new LIBTIFF (3.4beta018). Fixed up and working.
  123. The !RunImage is considerably smaller! :-)
  124. Uses OSLib's low-level file handling functions, rather than the equivalents I
  125. wrote inside LIBTIFF for that distribution.
  126.  
  127. 1.25 01-Aug-95
  128. Design change: Image displays in a window. Save box accessible from there.
  129. Multiple images can be held at once, in separate windows.
  130.  
  131. Also, DrLink now used, so RunImage even smaller!
  132.  
  133. 1.25a 04-Aug-95
  134. Dynamic areas now of the form "Tiffin: <spritefile leafname>"
  135.  
  136. 2.00 16-Oct-95
  137. Finally! Sat down and sorted out converting from *any* Arc sprite to
  138. 32/24-bit TIFFs.
  139.  
  140. Recompiled for LibTiff 3.4beta024
  141.  
  142. 2.01 26-Oct-95
  143. Extended to allow user to drag a directory onto the icon, and drag another
  144. away to perform more normal batch operations (ie: to convert to another
  145. location rather than in situ).
  146.  
  147. Also, it will attempt to load as TIFF files of other types. (Behaviour is
  148. slightly different: If dragged to iconbar will only attempt Data and DOS (as
  149. well as TIFF), whereas in batch operation will try anything not already dealt
  150. with.
  151.  
  152. 2.02 29-Nov-95
  153. Tiffin has been falling foul of the Filecore/Dynamic areas bug, whereby
  154. fwrites from memory locations where the top bit is set can cause crashes.
  155. Fixed by adding fwrite and fread replacements which do the job byte by byte
  156. if the top bit is detected.
  157.  
  158. 2.03 01-Dec-95
  159. Fixed the bug regarding converting 8-bit or less sprites into TIFFs.
  160.  
  161. To Do:
  162.  
  163. I will attempt to make Tiffin produce more rational TIFFs when given shallow
  164. sprites - ie: indexed-colour 8 bit or less rather than taking everything up
  165. to 24-bit data.
  166.  
  167. I may integrate ChangeFSI use, so it can generate the final sprite in
  168. whatever screen mode (and perhaps other options) the user desires. The user
  169. can do this anyway by dragging Tiffin-generated spritefiles onto !ChangeFSI.
  170.