                           Imagecopy 4.2 Manual Supplement
                           ===============================



Contents
========

 1.  Configuring Imagecopy
     1.1 Upgrading from earlier versions
     1.2 Creating a new configuration

 2.  User interface
     2.1 VA_START
     2.2 Drag and Drop
     2.3 Iconifying windows
     2.4 Autostarting and terminating
     2.5 Keyboard shortcuts
     2.6 Other features

 3.  Custom palettes

 4.  Viewing images
     4.1 Video modes
     4.2 Viewed images
   
 5.  Converting images

 6.  Catalogues
     6.1 Updating catalogues
     6.2 Collecting images
     6.3 Drag and drop
     6.4 Other features

 7.  Page Layouts
     7.1 Drag and drop
     7.2 Printing

 8.  Slide Shows

 9.  Printing
     9.1 Old printers
     9.2 Matching page sizes

 10. Copying images
     10.1 GEM and LineA copying
     10.2 Copying windows
     10.3 Other features
 
 11. INF files

 12. Image formats
     12.1 Huffman-compressed TIFFs
     12.2 IMG files
     12.3 Apex Media blocks
     12.4 XBM images
     12.5 XGA images
     12.6 Bad images

 13. Tricks and tips
 
 14. Additions to the main manual
     14.1 Imgc4.prg
     14.2 View
     14.3 Close windows
     14.4 IMG compression
     14.5 Duplicate
 
 15. Bug fixes


1. Configuring Imagecopy
========================

1.1 Upgrading from earlier versions
-----------------------------------

If you have upgraded from Imagecopy 3.5 or 4.0 you can preserve your
existing preferences by saving them into an INF file (select Global-Save INF 
File) and loading this into the new version (with Load INF File). Select 
Global-Save Defaults to make these the default preferences.

1.2 Creating a new configuration
--------------------------------

If you have not upgraded from a previous version you can take the following 
steps to configure Imagecopy for your system:

1. Use Global-Load INF File to choose a printer INF file from the PRINTERS 
folder. Imagecopy uses generic drivers, so you should choose the one which 
most closely matches your printer (e.g. DESKJET.INF for any Deskjet 
printer). Once you have done this you may also want to change specific 
settings in the Printer dialogs (e.g. to select colour output instead of 
monochrome).

2. You can skip this step if you have a normal Atari system. Otherwise use
Global-Load INF File to choose a system INF file from the SYSTEMS folder: 
(1) ATARI.INF for normal Atari systems, (2) MAGIC.INF if you are running 
MagiC without NVDI, or (3) NONATARI.INF if you are using a non-Atari system 
such as MagiCMac or MagiCPC (or a third-party video board). You may also 
want to change specific settings in the Screen dialogs (e.g. select Crazy 
Dots or Matrix video if you have one of these video boards).

3. Follow the instructions in section 3.3.2 of the manual to ensure that 
images print at the correct horizontal and vertical position (this can also 
prevent images from printing beyond the bottom of the page).

4. Select Global-Save Defaults to make these the default preferences.

5. See the manual for information on other option settings. E.g. select 
Screen or Adaptive Palette in the Screen Display dialog for better-quality 
(but slower) image display in colour video modes; and select Random Dither 
in this dialog for better-quality (but slower) display in monochrome 
resolutions.

[NB IMPORTANT Do *not* save preferences onto your master disk, since this 
will prevent future upgrade patches from working correctly.]


2. User interface
=================

Imagecopy 4.1 takes advantage of system enhancements provided by third-party 
desktops and multitasking OSes.

2.1 VA_START
------------

Imagecopy supports the VA_START protocol, so that if you are running it from 
a desktop which supports this protocol (Ease, Gemini, MagXDesk, Neodesk 4, 
Thing etc.) you can load files into an active version of Imagecopy by 
double-clicking on them or dragging them onto an Imagecopy icon. If you have 
a single-tasking version of TOS this will only work if you are running 
Imagecopy as an accessory (otherwise you don't have access to the desktop 
when Imagecopy is running).

[NB Under Neodesk 4.003 and greater there is an option in Miscellaneous 
Settings which prevents multiple instances of a program being loaded when 
you double-click on a file or drag it onto a program icon. Neodesk should 
also be selected as the AV server (using the same option)]

2.2 Drag and Drop
-----------------

Imagecopy supports the 'Drag and Drop' protocol in MultiTOS-compatible 
systems (MultiTOS, MagiC 4 and greater). This allows images to be loaded by 
dragging them onto an Imagecopy window. Dragging images onto a catalogue or 
page window causes them to be added to the catalogue or page. Dragging them 
onto another window causes the images to be viewed, unless the [Shift] key 
is held down, in which case you have a choice of viewing, printing, or 
converting the images. Dragging a folder onto an Imagecopy window (or 
program icon) causes all the images in that folder to be processed.

[NB Some systems that do not support drag and drop (e.g. Neodesk/Geneva) use 
the VA_START protocol to allow files to be dragged onto program windows. On 
these systems, dragging image files onto a catalogue or page window causes 
the images to be opened in a separate window instead of being added to the 
catalogue or page (the VA_START protocol does not indicate which window the 
file was dragged onto).]

[NB Systems that do not support drag and drop or VA_START (e.g. TOS) allow 
files to be dragged onto program icons if the program is not currently 
running.]

2.3 Iconifying windows
----------------------

Imagecopy can iconify windows under recent versions of GEM (MultiTOS, MagiC 
4 and greater, or Geneva). Control-clicking on the iconify button causes all 
windows to be iconfied into a single application window.
  
If you select 'Thumbnail iconify' in the System Preferences dialog, 
Imagecopy uses scaled-down images (instead of icons) in iconified windows. 
This works best in true-colour video modes, but gives reasonable results in 
256- and 16-colour video modes if the 'Remap palette' option is selected in 
the Colour mapping dialog.

2.4 Autostarting and terminating
--------------------------------

Imagecopy detects when it is started from an autostart folder by MagiC, and 
remains in the background (without drawing its menu window until it is 
selected) if this is the case. A good way to run Imagecopy as a background 
application under MagiC is to copy it to its own folder (D:\IMGCOPY or 
whatever) and copy an alias of the program from here into the autostart or 
accessory folder.

To autostart the program version of Imagecopy under Geneva, add the 
following line to Geneva's GEM.CNF file:

runsleep D:\IMGCOPY\IMGCOPY4.PRG

Change D:\IMGCOPY to wherever Imagecopy is on your system, and change 
IMGCOPY4.PRG to IMGC4CD.PRG if you are using the PhotoCD version.

Imagecopy deinstalls itself cleanly during a resolution change under MagiC 
and Geneva etc.

The accessory version of Imagecopy can be successfully unloaded within MagiC 
and Geneva (by [Control]-clicking on its menu slot).

2.5 Keyboard shortcuts
----------------------

There are some new keyboard shortcuts (these can be changed in the Menu Keys 
dialog):

1. [F1] Hide or show the menu window - this is the same as [#] except that 
   it also works on non-Atari keyboards.
2. [Control-U] Close window - same as [Delete]
3. [Control-Y] Hide window - same as [Shift-Delete]
4. [Control-W] Next window - similar to [Tab] except that it selects any 
   window regardless of whether it is an image window ([Tab] selects the 
   next image window)
5. [Undefined] Previous window - similar to [Shift-Tab]. Use the Menu Keys 
   dialog if you wish to define a shortcut for this option.

2.6 Other features
------------------

If you have a recent version of GEM (i.e MultiTOS, MagiC 4 or greater, or 
Geneva), Imagecopy does not top its windows except in response to a single 
mouse click. This allows you to drag or double-click catalogue images (or 
access pop-up menus by holding down the mouse) when the catalogue window is 
not the top window on screen.

Windows can be closed while images are being loaded or saved (so long as 
they are not being loaded or saved from that window).

The menu window can be minimized using the full button (or [Insert]). This 
toggles between the full size and a minimal size containing just the menu 
bar.

If images are opened from the desktop (by double-clicking on them etc.), 
holding down the [Shift] key displays a dialog which allows the images to be 
printed or converted (instead of viewed).

[NB You may need to press the [Shift] key immediately after double-clicking 
to prevent it from being interpreted by the desktop.]


3. Custom palettes
==================

Custom palettes can be used for viewing and converting images. Select 'save 
palette' from the image pop-up menu to save an image's palette. Select 
(Options-Preferences) Palette to load a palette. Custom palettes can be used 
when remapping images to a lower colour depth, either for display on screen 
or when converting images. To select a custom palette, click on the palette 
pop-up menu in the (Options-Screen) Colour Mapping and (File) Convert dialog 
boxes. You can save a custom palette as the default palette by selecting 
'save' in the Custom Palette dialog, but some 256-colour palettes will give 
poor results if you use them to view images in 16-colour screen modes. The 
following custom palettes are available for use with Imagecopy (in addition 
to any which you save yourself):
 
  Palettes which work with 256 or 16 colours
  
  * ATARI.PAL - the standard Atari (Falcon) palette.
  * MAC.PAL - the standard Mac 16/256-colour palette.
  * WINDOWS.PAL - the standard Windows 16/256-colour palette.
  
  Palettes which only work with 256 colours
   
  * MAC256.PAL - the standard Mac 256-colour palette. This is the same as 
    MAC.PAL but the colours follow the original Mac order.
  * WIND30.PAL - the 30 reserved colours in the Windows 256-colour palette. 
    These are supposed to be standard across all Windows applications.
  * WIND256.PAL - the standard Windows 256-colour palette. This is the same 
    as WINDOWS.PAL but the colours follow the original Windows order. Only 
    the first 30 colours are standard in all Windows applications.
  * WEB216.PAL - the standard 216-colour Web palette. This is identical with 
    the first 216 colours of the Mac palette.
  
[NB MAC.PAL gives better results than the standard Atari palette in most 
cases.]
 
Imagecopy remembers the path from which palette files were last loaded. The 
default path is the 'program path' in the Paths dialog - this directory is 
also used to store other program resources such as fonts.
  

4. Viewing images
=================

4.1 Video modes
---------------

Imagecopy works in 16-colour and 15-bit ('thousands' of colours) video modes 
under MagicMac as well as in monochrome and 256-colour modes. It should also 
work in 4-colour video mode if there is a MagicMac/NVDI driver for this 
mode. Select 'auto-detect' in the (Options-Screen) Screen Display dialog if 
you are running Imagecopy under MagiCMac.

Imagecopy works in 16-bit Crazy Dots video. Previously it worked in 15-bit 
colour but not in 16-bit colour.

Pressing Control-F1 displays information about the current video mode. 
Please report this information if Imagecopy has problems displaying images 
when 'auto-detect' video mode is displayed in the screen display dialog.

4.2 Viewed images
-----------------

[Clr|Home] toggles between displaying an image from the top-left and 
centring the image (similarly [Shift-Clr|Home] and [Control-Clr|Home]).

The Image Information dialog displays the file date of an image.


5. Converting images
====================

The 'remap palette' option in the (File) Convert dialog causes the palette 
of converted images to be replaced irrespective of whether the number of 
colours is reduced (cf. 'remap palette' in the Screen Mapping dialog). This 
replaces the 'match palette' option, which is no longer available for 
converted images (and didn't work properly with custom palettes).


6. Catalogues
=============

6.1 Updating catalogues
-----------------------

The 'update' option in the catalogue submenu reloads any images which have 
been modified (i.e. whose size or date has changed) since the catalogue was 
last saved.
  
[NB Since catalogues did not previously contain file dates, this will cause 
all the images in catalogues created by previous versions of Imagecopy to be 
reloaded]

If you locate an image when updating a catalogue, Imagecopy automatically 
locates any other images which have been moved into the same directory from 
the same original directory.
 
6.2 Collecting images
---------------------

The catalogue menu has a 'collect' option which copies catalogue images into 
a new directory. This can be useful if the catalogue contains images from 
several different directories. Imagecopy displays a file selector so you can 
select the directory into which you wish to copy the images.

6.3 Drag and drop
-----------------

Images can be dragged from catalogue windows onto other catalogue or page 
windows. Dragging images onto any other Imagecopy window causes the image to 
be viewed, unless the [Shift] key is held down, in which case Imagecopy 
offers a choice of viewing, printing or converting the image. [Dragging 
images onto Imagecopy windows works with any version of TOS.]

If your system supports drag and drop (i.e. MultiTOS-compatible systems such 
as MultiTOS or MagiC 4 and greater), dragging image files from the desktop 
onto a catalogue or page window will cause those files to be added to the 
catalogue or page.

Images can also be dragged from catalogue windows onto other application 
windows (so long as your system and the target application support drag and 
drop).

[NB When dragging an image from a catalogue window you need to move the 
mouse soon after pressing the mouse button so Imagecopy knows this is a drag 
operation (otherwise it displays a popup menu).]

6.4 Other features
------------------

Imagecopy no longer resizes a catalogue window whenever images are added to 
it (this could be irritating if the window had been sized to prevent it from 
covering the whole screen). If images are removed it shrinks the window 
without changing its position.

You can create an empty catalogue by cancelling the Catalogue file selector. 
This is useful if you want to create a catalogue by dragging images from 
other catalogue windows or from the desktop.


7. Page Layouts
===============

7.1 Drag and drop
-----------------

If your system supports drag and drop (i.e. MultiTOS-compatible systems such 
as MultiTOS or MagiC 4 and greater), dragging image files from the desktop 
onto a page window will cause those files to be added to the page.

7.2 Printing
------------

When using the print-to-file option, page layout files which contain several 
images are saved into a single PRN file unless the page needs to be fed back 
for adjacent images (in which two or more PRN files are created).
 

8. Slide Shows
==============

Imagecopy frees the current slideshow image if there is not enough memory to 
load the next image while the current image is loaded. This makes it 
possible for the slideshow to display successive large images in limited 
memory. In situations where the current image has been freed, the slideshow 
window will not redraw properly (e.g. if it has been covered by another 
window or resized etc.)


9. Printing
===========

9.1 Old printers
----------------

Imagecopy should work with old (pre-1983) Epson 9-pin printers and 
compatible printers if the EPMX60.INF file is loaded using the 
(Options-Global) Load INF File option.

9.2 Matching page sizes
-----------------------

The 'Adjust page size' option in the Print Layout dialog causes Imagecopy to 
adjust the printer's page size to match Imagecopy's page size. This allows 
you to print to large-format (A3 etc.) printers which set the default page 
length to 12 inches (e.g. bubblejet printers). You should select the page 
size you wish to use in Imagecopy's Page Size dialog. This option is also 
useful for printing to recent Deskjet printers which do not have dip 
switches for setting paper size.


10. Copying images
=================

10.1 GEM and LineA copying
-------------------------

Imagecopy can use GEM routines for drawing to screen when [Alt-Help] is 
pressed. This allows images to be copied on systems which do not provide 
low-level LineA routines (e.g. MagiCMac or MagiC without NVDI). Select 'GEM' 
or 'GEM/LineA' for the 'Alt-Help routines' option in the (Options) Copy 
Settings dialog to do this. The GEM/LineA option uses LineA routines in 
situations where GEM is unavailable, e.g. when a menu or modal dialog is on 
screen. The third option is similar to the second but never uses LineA 
routines - if GEM routines cannot be used this option copies the full screen 
(without any user interaction) and any cropping must be done by loading the 
image back into Imagecopy (this is easy because the View option 
automatically displays the last saved image in the file selector). The 
drawback to using the GEM and GEM/LineA options is that they require 
additional processor time for Imagecopy to detect [Alt-Help] keypresses.
  
[NB. In order to avoid using additional processor time when Imagecopy is 
loaded as an accessory, GEM-copying is not used unless Imagecopy has been 
selected from the Desk menu. You can close Imagecopy's main window when it 
has been selected; Quit returns the program to its original sleeping state.]
  
Imagecopy detects whether LineA routines are available, and makes 
full-screen copies in situations where they are unavailable and it is not 
configured to use GEM routines (see previous item). [Detection doesn't work 
under MagiCMac]

Selecting Copy from the Copy menu always uses GEM-copy routines.

10.2 Copying windows
-------------------
 
In GEM-copy mode, Imagecopy can snapshot the workarea or full area of the 
top window: press [Insert] to toggle between the current copy area, the work 
area of the top window, the full area of the top window, and the screen 
area. Alternatively, you can toggle the size of the copy area by clicking 
the right mouse button (or [Shift] + left mouse button) outside the copy 
area (note: it is no longer necessary to click on one of the corners of the 
copy area to do this).

10.3 Other features
------------------

When copying images, [Shift] + left mouse click can be used instead of right 
mouse clicks (for saving images or toggling the box size).


11. INF files
=============

Imagecopy 4.1 can read and save printer-specific or system-specific INF 
files (using the Save INF File and Load INF File options in the Global 
submenu). These can be loaded without changing other unrelated settings: if 
you have two printers you can switch easily between them by loading the 
appropriate printer INF file.


12. Image formats
=================

12.1 Huffman-compressed TIFFs
-----------------------------

Imagecopy can read and write Huffman (CCITT Group 3) compressed TIFF files. 
This type of compression is only used with monochrome images. Imagecopy now 
reads and writes all baseline TIFF images (this was the previously the only 
baseline TIFF feature that was not supported).
  
[NB LZW compression usually produces higher compression rates, but with some 
types of image (especially line art) Huffman compression gives the best 
compression rates.]
  
If you select 'Huffman/LZW' compression in the Copy Format or Change Format 
dialogs, Imagecopy will use Huffman compression for monochrome images and 
LZW compression for greyscale and colour images.

12.2 IMG files
--------------

Imagecopy can save IMG files with VDI palette order - select 'use VDI 
palette order for IMGs' in the (Options-System) Image Preferences dialog. 
This is useful for creating IMG files for programs that expect colours to be 
arranged in this order (e.g. Thing or True Paint).

12.3 Apex Media blocks
----------------------

Imagecopy can read Apex Media blocks (APX files).

12.4 XBM images
---------------

Imagecopy can read XBM images.

12.5 XGA images
---------------

Imagecopy can read 320x200 XGA images.

12.6 Bad images
---------------

Imagecopy can read some incorrect Degas files which it failed to read 
previously.

Imagecopy can read compressed TGA files from Rainbow. These are incorrectly 
compressed across line boundaries.


13. Tricks and tips
===================

13.1. Set the slideshow interval to 0 if you want slides to remain on screen 
indefinitely until you press [Space].

13.2. Catalogue (CAT) files can be displayed as slideshows by selecting them 
with the slideshow option.

13.3. The images in a catalogue file can be printed or converted by 
selecting the CAT file with the convert or print option.

13.4. If you are printing multiple copies of a large image, it may be faster 
to print the image to disk (select Disk output in the Printer Type dialog), 
and print the resulting PRN file by selecting it with the print option. You 
will probably need to have a few megabytes of free (hard-)disk space.

13.5. Select 'random dithering' in the Screen Mapping dialog for better 
quality (but slower) images on monochrome screens. Select 'screen' or 
'adaptive' palette for better-quality (but slower) images on colour screens.

13.6 To copy part of an image that is larger than the screen, display it in 
full-screen mode and press [C].


14. Additions to the main manual
================================

14.1 Imgc4.prg (1.2.3)

Imgc4.prg will run an accessory version of Imagecopy 4 as a stand-alone 
program if it is unable to locate an active accessory version or PRG file. 
This means you can have a single Imagecopy file with an ACC or ACX extender 
on your boot disk, and imgc4.prg will either call Imagecopy as an accessory 
or run the ACC or ACX file as a stand-alone program if Imagecopy has not 
been loaded as an accessory.

14.2 View (4.3.2.1)

When viewing images in full-screen mode, mouse-scrolling auto-repeats if you 
hold down a [Shift] key while moving the mouse to the edge of the screen.

14.3 Close windows (4.3.3.4.1)

This option closes windows which are currently open on screen. Imagecopy 
allows you to select which types of windows you want to close.

14.4 IMG compression (4.3.3.5.1.0c)

This option configures the pattern length used for RLE compression of IMG 
files. The default option (1-byte) gives the best results in most cases, but 
some dithered images may compress better with 2-byte or 3-byte patterns. In 
general it is best to leave this setting alone unless you need to squeeze 
some extra bytes of compression from a particular image (if it doesn't have 
to be IMG format, you will probably get better compression with LZW TIFF 
compression). This option only affects images with up to 256 colours. 
True-colour IMG files are always compressed with 2-byte, 3-byte, or 4-byte 
patterns according to their colour depth (16-bit, 24-bit, or 32-bit).

[Try changing from 1-byte to 2-byte compression if a particular program is 
unable to load IMG files from Imagecopy - IMG files from other programs 
commonly use 2-byte compression]

14.5 Duplicate (4.3.3c.6)

If you hold down a [Shift] key while selecting this option Imagecopy allows 
you to specify the number of duplicate copies you wish to make. Otherwise it 
creates a single duplicate copy.


15. Bug fixes
=============

1. A layout problem which could cause the first image on a page to be 
positioned incorrectly on dot-matrix and bubblejet printers has been fixed.
  
2. A problem which could cause 4-colour and 16-colour images to print 
incorrrectly from layout pages in landscape mode has been fixed.
  
3. Imagecopy can read Spectrum images which contain more than 256 colours.

4. The number of palette colours is reported correctly in most true-colour 
video modes (although Imagecopy has to guess in some cases: GEM doesn't 
distinguish between >15-bit palette depths).
  
5. 24-bit and 32-bit Crazy Dots true-colour modes are correctly supported 
when Crazy Dots video is selected (they also worked previously with 
Auto-select video).

6. A memory error which occurred when a transparent colour was selected 
(from the Change Format dialog) in 8-bit non-interleaved video mode (e.g. 
Crazy Dots, MagiCMac) has been fixed.
  
7. Problems which occurred with MagiC 'smart redraws' have been fixed.
  
8. A bug which caused the 'select' submenu to disappear while the mouse was 
dragged over its title has been fixed.

9. A problem which caused mouse pointers to be left on screen when dialogs 
are displayed with some video cards has been fixed.
  
10. The built-in 'Atari' palette is now identical with the standard Falcon 
palette (previously some of the colours were too dark).
  
11. A bug which caused Imagecopy to crash if a keyboard shortcut was pressed 
when Imagecopy had no windows open on screen has been fixed.
  
12. A problem which caused some editable text objects to be uneditable with 
Geneva has been fixed.
  
13. A bug which caused Imagecopy to crash while loading large (over 12 MB) 
TIFF files has been fixed. [This problem occurred if the TIFF image had more 
than 2000 strips (1 strip normally = 1 line for large images).]
  
14. Greyscale catalogues display correctly.

15. A bug which caused monochrome GIFs to be saved with a red and white 
palette in colour video modes has been fixed.
  
16. Switching 'Interlace GIF images' off in the Image Preferences dialog 
causes GIFs to be saved in non-interlaced format when they are converted or 
copied from screen. [Interlacing of GIFs which are saved with the Save 
option in the image pop-up menu is controlled by the Image Format dialog 
from the same menu].

17. A bug which caused moderately large monochrome catalogues to be visually 
corrupted when images were added or removed has been fixed.

18. Imagecopy no longer crashes when loading small interlaced GIFs (less 
than 5 pixels high).

19. Imagecopy no longer crashes if a non-existant catalogue file was 
selected from the 'catalogue' option.
  
20. Imagecopy remembers PhotoCD size and block information when printing 
pages which contain PhotoCD images.
  
21. Form feeds are now stored in PRN files.

22. Tabbing to the next or previous window used to crash if no windows were 
open on screen.

23. Partial formfeeds were sometimes inaccurate on Bubblejet printers in IBM 
mode.

24. Imagecopy recognizes lowercase and mixed-case file extensions in 
addition to uppercase extensions (i.e. jpg and Jpg in addition to JPG)
  
25. A memory leak which could occur if Imagecopy was unable to find the 
image file for a catalogue has been fixed.

26. The unflip image option (in the edit submenu of the image menu) works 
reliably for flipped as well as rotated images.
  
27. The 'redraw catalogue' option marks the catalogue has having been 
changed (so you get a warning if you try to close it without saving it).
  
28. A problem with the menu bar sometimes not updating after a progress 
operation under MagiC and MultiTOS has been fixed.

29. True-colour TPI files are read correctly (broken in Imagecopy 4.0)

30. Imagecopy can save page files which do not contain any images 
(previously these could not be read back if they were saved).

31. A bug which prevented Imagecopy from reading large GIFs has been fixed.

32. A problem which could cause the mouse pointer to disappear when 
Imagecopy was used with Stewart (a system appearance utility) has been 
fixed.

33. Imagecopy no longer crashes if it is selected from Appline (a MagiC 
utility) when it doesn't have any open windows.
