Short:        View and convert C64 KoalaPainter images
Author:       Kim Fastrup Larsen
Uploader:     kimflarsen hotmail com (Kim Fastrup Larsen)
Type:         gfx/show
Version:      1.5
Architecture: m68k-amigaos >= 2.0


New in version 1.5:

- You can now load images by dragging their icons into the
  window.
- Various small improvements, such as asking for confirma-
  tion before saving over existing files.
- Source code has been modularized and made more portable.


KoalaView is a straightforward little application for view-
ing images in the Commodore 64 KoalaPainter format. Images
can be saved back as regular IFF ILBM files. I have tried to
make sure KoalaView complies with the User Interface Style
Guide.

KoalaView uses bright and very authentic looking colors. On
AGA machines (or systems with similar capability) the colors
will be most accurate.

KoalaView requires Kickstart 2 or better.

The screen opened by KoalaView is public. You can see the
public name of the screen by selecting "About..." from the
menus.

On Workbench 2.1 or better you are able to choose your pre-
ferred screen mode.

On Kickstart 3 or better you can use a so-called exclusive
screen, which is like a regular screen except no other
screens will be visible behind it, and it cannot be dragged.
This lets KoalaView center the screen vertically without any
other screens showing behind it.

Also on Kickstart 3 or better, you can have KoalaView open a
window on any public screen rather than open its own screen.

KoalaView supports the following standard arguments, which
can be passed either as command line arguments (when start-
ing KoalaView from the Shell) or tool types (when starting
KoalaView from the Workbench):

 FILE=<filename>
 SETTINGS=<filename>
 PUBSCREEN=<name of screen> (Kickstart 3.0 or newer)

Tool types found in project icons will override those found
in KoalaView's own icon.

FILE specifies a project to load when starting. Note that
when this argument is passed as a tool type in a project
icon, that icon can serve as a shortcut to a file located
elsewhere.

SETTINGS specifies a settings file to load from and save to.
If not specified, KoalaView will look for a settings file
called KoalaView.prefs in the program's own directory, or in
ENV:KoalaView if not found there. It will save to this file
in the program directory if possible, and if not, in
ENVARC:KoalaView and ENV:KoalaView.

PUBSCREEN specifies a public screen to open on. By default,
KoalaView will open its own screen, or use the default pub-
lic screen (usually the Workbench) depending on settings.

Belated thanks go to Stefan Haubenthal for providing the
initial german translation and for giving feedback that al-
lowed me to make the program RTG compatible.

Full source code is included.


History:

1.5 (Apr 8, 2019)

- You can now load images by dragging their icons into the
  window.
- Various small improvements, such as asking for confirma-
  tion before saving over existing files.
- Source code has been modularized and made more portable.

1.4 (Dec 14, 2015):

- KoalaView's screen is now a public screen.
- Can now show images in a window on the Workbench screen or
  any other public screen using shared pens.

1.3 (Nov 19, 2015)

- Speed improvement, especially when saving on classic
  Amigas.
- Fixed: An error while loading a new image could leave the
  current image partially overwritten.

1.2 (Nov 11, 2015)

- Fixed menu shortcut keys missing in German catalog.

1.1 (Nov 3, 2015)

- Now includes Danish and German catalogs.
- Added the ability to localize menu shortcut keys.
- Changed save routine to work with RTG. Unfortunately that
  makes it somewhat slower on classic Amigas.
- Ignore return value from QueryOverscan, as it reportedly
  does not seem to work in MorphOS. It was not vital to
  check this value in any case.

1.0 (Oct 5, 2015)

- Initial release.