home *** CD-ROM | disk | FTP | other *** search
/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / applications / _ibrowse / _help < prev    next >
Text File  |  1997-04-13  |  10KB  |  223 lines
  1. ____________________________________________________________________________
  2.  
  3.                           / /)  _  _          _  _
  4.                          / /_) (  (_) (_|_) _)  (/_
  5.  
  6.                  Compact Sprite and JPEG viewer for machines
  7.              equipped with the JPEG-capable SpriteExtend module
  8.  
  9.                           by David Thomas, ⌐ 1996-7
  10.                          version 0.31 (13 Apr 1997)
  11. ____________________________________________________________________________
  12.  
  13.  
  14.  Introduction ______________________________________________________________
  15.  
  16.   IBrowse is a fast and compact Sprite and JPEG image viewer for RISC OS
  17. computers equipped with version 0.99 or later of the SpriteExtend module.
  18. This version of SpriteExtend is built into RISC OS 3.6 and later versions,
  19. and is available as a soft-loadable module for RISC OS 3.5 machines.
  20.  
  21.   IBrowse was created to be quick, convenient and run in as little memory as
  22. possible, for this reason it doesnæt provide some of the more advanced
  23. features of image viewers, such as Éslideshowingæ.  However it does support
  24. app-to-app transfers, view scaling and does run in the tiny wimpslot of 8K -
  25. you can load about forty copies of IBrowse for the same amount of memory
  26. that Paint takes up. :-)
  27.  
  28.   If you have RISC OS 3.5, there are details of how to obtain the
  29. SpriteExtend module later on in this file.  If IBrowse is run without this
  30. version of SpriteExtend available then it will restrict itself to displaying
  31. Sprites only.
  32.  
  33.  
  34.  PseudoMem _________________________________________________________________
  35.  
  36.   This release of IBrowse features support for Gordon Rogersæ most seriously
  37. excellent PseudoMem module, which implements a virtual memory system using
  38. the dynamic area interface.
  39.  
  40.   Once configured, all images are Éloadedæ into a PseudoMem dynamic area and
  41. plotted straight from it, so the speed of display is often slow.  However,
  42. by using this you can view, in just a few Kb, images that previously would
  43. have required many megabytes of memory.
  44.  
  45.   PseudoMem also, very helpfully, fixes the bug in SpriteExtend which stops
  46. small applications from using the JPEG plotting calls.  (This is why IBrowse
  47. always loads the PseudoMem module, even when not configured to utilise it).
  48.  
  49.  
  50.  Usage ____________________________________________________________________
  51.  
  52.   Drag a Sprite or JPEG file to the IBrowse icon bar icon.  A window will
  53. open displaying the file.  Also, double-clicking on a Sprite or JPEG file
  54. when IBrowse is loaded will load it.
  55.  
  56.   In addition to the standard Info and Quit entries on the icon bar menu,
  57. there is also a ÉChoices...æ entry which, when selected will open the
  58. choices window which allows you to set the types of dithering used on the
  59. display.  The options there, are :
  60.  
  61.   Sprite Choices _________________________________________________________
  62.  
  63.     Å ÉSimple ditheringæ - uses a simple patterning technique in most modes
  64.        which helps lessen the banding effect you get when you display deep
  65.        Sprites in paletted modes.  My preference is to leave this option
  66.        off, as it seems to make Sprites look worse in certain cases.
  67.  
  68.       ( Note that the patterning technique will not always appear
  69.         immediately on the display.  Sometimes a change of screen
  70.         mode is needed to Ékickæ it into action. )
  71.  
  72.     Å ÉLoad on double-clickæ - will make IBrowse respond to double-clicks
  73.        on Sprite files, which it will automatically load.  This option is
  74.        off by default as most Sprite files will have more than one Sprite in
  75.        them and IBrowse will only display the first.
  76.  
  77.   JPEG Dithering _________________________________________________________
  78.  
  79.     Å ÉNo ditheringæ - performs no dithering so the image may look Ébandedæ
  80.        in 256 and less colour modes.  However, it is the quickest display
  81.        method.
  82.  
  83.     Å ÉSimple ditheringæ - uses a simple patterning technique in most modes
  84.        which helps lessen the banding effect.
  85.  
  86.     Å ÉError diffusionæ - is the slowest display method but provides a much
  87.        better quality of display.  This method only works for 256 colour
  88.        modes, in other colour depths this is equivalent to ÉSimpleæ.  It is
  89.        the default.
  90.  
  91.     It is worth noting that even with Error diffusion, in paletted modes the
  92.     display quality will never be as good as that produced by ChangeFSI.
  93.     Use ChangeFSI if youære converting a JPEG image permanently to a Sprite.
  94.  
  95.   Memory _________________________________________________________________
  96.  
  97.     Å ÉUse PseudoMemæ - enables support for the PseudoMem module.  Once
  98.        activated all images given to IBrowse for display will be rendered
  99.        straight from disc.  This means that you can view images which are
  100.        bigger than your computeræs free memory, at the expense of speed.
  101.  
  102.  
  103.   At the bottom of the Choices window are two buttons.  ÉSaveæ allows you to
  104. save your choices (which will be stored in the !Boot.Choices directory).
  105. ÉCancelæ restores your most recently saved choices from disc.
  106.  
  107.  
  108.   A menu is available from the display window with the following entries :
  109.  
  110.     Å ÉImageæ - leads to an information box which provides various details
  111.        about the currently loaded image.
  112.  
  113.     Å ÉChoices...æ - opens the choices window, as described above.
  114.  
  115.     Å ÉScaleæ - leads to a small dialogue which allows you to change the
  116.        current view scale.  The scale is specified as a percentage of the
  117.        original imageæs dimensions.  However, note that the value you
  118.        specify works on both the x and y axis, so a É200%æ scaled image is
  119.        in fact four times larger than normal.
  120.  
  121.  
  122.   IBrowse will use a dynamic area for storage of the image.  IBrowse is
  123. compatible with Clareæs Virtualise package, although only when PseudoMem
  124. support is disabled.  (Attempting to Virtualise a PseudoMem area will lead
  125. to serious crashes!).
  126.  
  127.  
  128.  Obtaining The SpriteExtend Module _________________________________________
  129.  
  130.   If you are using RISC OS 3.5 and do not already have it, the SpriteExtend
  131. 0.99 module is available from ftp.acorn.co.uk in the pub/riscos/releases
  132. directory under the name Éspriteextend.arcæ.  It was also present on the
  133. Acorn User CD-ROM 2, in the ÉRESOURCEæ directory under the name
  134. ÉSPRITEXT/SPKæ.
  135.  
  136.   There is a bug in version 0.99 of SpriteExtend which means tiny programs
  137. like IBrowse will not work unless theyære given 24K of memory.  This was a
  138. serious issue with previous versions of IBrowse as they had to be given a
  139. 24K wimpslot.  However if you have the PseudoMem module loaded - as IBrowse
  140. does by default - it automatically handles the bug for us, allowing IBrowse
  141. to run in 8K. :-)
  142.  
  143.   Justin Fletcher has created ÉDummy Dynamic Areasæ (DDA) to enable RISC OS
  144. 3.1 users to use the JPEG-capable SpriteExtend.  You can mail him at
  145. ÉGerph@essex.ac.ukæ for details or preferably see his web pages at
  146. Éhttp://users.essex.ac.uk/users/gerphæ.
  147.  
  148.  
  149.  Credits __________________________________________________________________
  150.  
  151.   Thanks to Gordon Rogers for PseudoMem, which is rather good. :-)  The
  152. documentation for PseudoMem is contained within the IBrowse application
  153. directory.
  154.  
  155.   IBrowse was written in ObjAsm assembler, as Iæd paid a large wodge of cash
  156. for Acorn C/C++ and I had to use it for /something/ didnæt I... ;-)
  157.  
  158.  
  159.  History __________________________________________________________________
  160.  
  161.   0.31 (13 Apr 1997) - Wimp_ProcessKey wasn't being called for unused key
  162.                        events, so F12 didn't work if the caret was in the
  163.                        scale window.
  164.                      - The PaletteChange message wasn't being acted on.
  165.                        (JFletcher)
  166.                      - The info window's style display was giving an
  167.                        incorrect readout.
  168.   0.30 (19 Feb 1997) - Largely restructured and rewritten to alleviate many
  169.                        problems and allow more features.
  170.                      - Scaling.
  171.                      - PseudoMem support is optional.
  172.                      - Choices saving and loading.
  173.                      - Images smaller than the mininum window size now
  174.                        display with the windowæs the background filled
  175.                        black.
  176.                      - Only 12 bytes short of 8K now!
  177.   0.21p(01 Feb 1997) - PseudoMem release.
  178.   0.20 (16 Jan 1997) - First PD release.
  179.                      - Slight modifications here and there.
  180.                      - Will now work on Éplainæ OS 3.5.
  181.   0.15 (03 Jul 1996) - Added Sprite support, with optional dithering.
  182.                      - SpriteExtend 0.99 is now available for RISC OS 3.5
  183.                        machines, so RO 3.5 users can use IBrowse now.
  184.                      - Needs an 8K slot now, rather than 4K as before.
  185.                      - Error diffusion is now the default.
  186.   0.08 (18 Mar 1996) - More error checking.
  187.        (06 Apr 1996) - Docs updated.
  188.        (18 Apr 1996) - Slight change to the templates.
  189.                      - Fixed version of HelpFile.
  190.   0.07 (07 Mar 1996) - Fix of mouse button click on choices window.
  191.   0.06 (02 Mar 1996) - Fixed scrapfile handling to return error.
  192.                      - RISC OS 3.5+ -friendly error routine.
  193.   0.05 (29 Feb 1996) - Added Scrap file handling.
  194.                      - Window close functions.
  195.   0.02 (26 Feb 1996) - Beta test release, only given to a couple of people.
  196.  
  197.  
  198.  Copyright and Contact Addresses ___________________________________________
  199.  
  200.   This software is copyrighted work of David Thomas, it is supplied öas isò;
  201. using it is entirely at your own risk.  I make no warranty as to the fitness
  202. of this software for any purpose.  You are free to distribute this
  203. application to anyone you please, as long as you are not supplying it for
  204. personal gain and it is delivered with all the supplied files unaltered.
  205.  
  206.   If you have any comments, bug reports, suggestions for future versions or
  207. anything else donæt hesitate to contact me at -
  208.  
  209.   Mail:  Mr D.P. Thomas
  210.          20 Rosebery Avenue
  211.          Waterloo
  212.          Liverpool
  213.          L22 2BH
  214.  
  215.   Email: CMSDTHOM@livjm.ac.uk
  216.  
  217.   WWW:   http://java.cms.livjm.ac.uk/cmsdthom/
  218.  
  219.   The latest versions of my applications will be available from my World
  220. Wide Web pages, where term dates allow.
  221. ____________________________________________________________________________
  222.  
  223.