This is EasyView 1.20
---------------------

Other bits needed to get this program running:

1. The Toolbox modules.
2. SpriteExtend 0.99 or higher, which in turn needs Risc OS 3.50


EasyView is meant to be a small and quick way to browse through pictures.

EasyView will show Sprites, JFIF, and Draw files. It may accept any type of
file, and attempt to make sense out of it. If it thinks the file might be one
of the three abovementioned, it will show it, and optionally set the filetype
as well.

You should be able to figure the rest out for yourself. If all else fails,
there's interactive help on everything. Also read through the changes below
for some hints.

And now: A piece of advice for Risc OS programmers!
Get yourself the User Interface Toolbox. Once familiar with it, it can save
you a _lot_ of time. This program has taken about 5 hours to make from scratch.

This is PD, and you can do what you like with it. But whatever you do, it's
at your own risk and expense! :-)

New versions can be found at http://www.armware.dk/files/

Thomas Olsson, 14 Apr 96
easyview@armware.dk


Things added in version 1.02:
-----------------------------
* Choice of background for JPEG and Sprite as well as Draw.
* Pictures are centered in window.
* Constant window size is now at least the size of the image.
* JPEGs that are 0 DPI are assumed to be 90 DPI.
* Option to treat any filetype as unknown, and look at the contents instead.
* You can scale the image from the menu.


Things added in version 1.04:
-----------------------------
* Sometimes it loaded JPEGs twice, this is now fixed.
* Oops, it didn't pass on unrecognised keys.
* Window depth is preserved when loading new files. It will only go on top
  after having been closed.
* Now centers scrollbars as well as images.
* Background redraw made more efficient.
* New keys:
  Arrows	Scroll 32 OS units
  Shift+arrows	Scroll a page
  Ctrl+arrows	Move to edge
  Space/Return	Display next file
  Backspace	Display previous file
  Delete-Return	Delete file (asks for confirmation)
* Scale to fit the currently visible area
* Click on image will grab input focus.

Things added in version 1.06:
-----------------------------
* Added the option to automatically go forward after a delay.
* Probably changed some minor details, but forgot.

Things added in version 1.08:
-----------------------------
* You can drag directories to it, and it starts displaying the first sprite
  if possible.
* When you reach the end of a directory, going forwards will wrap around to
  the start (and vice versa).

Things added in version 1.10:
-----------------------------
* Now treats the whole disc as one long list of files. This means that going
  forward past the end of a directory, will continue with the first file in
  the next directory, and so on. Going backwards will do the exact opposite.
* The above can take some time if the next viewable file is 'far away' in the
  directory structure. So there is a new 'Max search' setting, that controls
  how many objects will be skipped before giving up (hence how long the
  hourglass can be displayed).

Things added in version 1.12:
-----------------------------
* There was some disagreement between OS_HeapSort and the Territory module,
  as to the current alphabetic order. Now using the territory order always.
* Added the option of using a gamma corrected palette while the picture is
  being displayed. This works in all but 256 colour modes, until I find out
  what exactly happens when RiscOS tries to emulate the old VIDC hardware
  palette.

Things added in version 1.14:
-----------------------------
* Added "Watch" feature, which checks the displayed file repeatedly to see
  if it gets updated, then refreshes the display if it is.

Things added in version 1.16:
-----------------------------
* Added a default box that is displayed if there is an error when rendering
  the file.

Things added in version 1.17:
-----------------------------
* There can now be external filters which are run on the file when typing
  'c'. This is mainly meant for things like jpegtran, which can clean the
  JPEG and reduce progressive ones to normal ones.
  When pressing 'c' on a file of <type>, the command
  "<EasyView$Dir>.!Clean[type] [filename] [tmpname]" will be run.

Things added in version 1.18:
-----------------------------
* Now maximises the window when not in "constant size" mode. You can select
  whether to keep the window centre or the toolbar in the same place.
* Option to run the "cleaner" once if there is an error displaying the image.
  In some cases this can be dangerous if e.g. a Text file is mistakenly typed
  JPEG. Then the cleaner can corrupt the file before giving up. Therefore it's
  safest to use "Don't rely on any filetype" at the same time as this option,
  so the file content is checked first.
  The supplied !CleanC85 script checks the return code of jpegtran to avoid
  this in most cases, but it's still not 100% safe.
* Added back the old "Variable window size" behaviour as another option.

Things added in version 1.19:
-----------------------------
* Added option to keep the close icon in same place.

Things added in version 1.20:
-----------------------------
* Now treats bad sprite modes as a non-sprite file, so they don't generate
  an actual error.

Things added in version 1.21:
-----------------------------
* Gerph found a sprite-scaling bug and fixed it, so the fix is now included.
  I really like that kind of bug reports :-)

Things added in version 1.22:
-----------------------------
* Added the option of closing the window after deleting a file, rather than
  displaying the next file.

Things added in version 1.23:
-----------------------------
* Added basic support for TDraw files (converting them to Draw for display).

Things added in version 1.24:
-----------------------------
* Added the possibility of dragging an archive to the icon, which is
  treated as a directory if something like SparkFS is running (Thanks to
  Bernard Veasey for this).

Things added in version 1.25:
-----------------------------
* Fixed a bug in the JPEG loading, which didn't follow the SWI specs properly.

