ZoomPlus 0.09 (17-Jul-03)

Name:     ArtWorks ZoomPlus module
Purpose:  Enhanced Replacement of the original ArtWorks Viewer module
Author:   Computer Concepts and Martin Wrthner
Requires: RISC OS 3.5 or higher, ArtWorks 2
Status:    2003 Martin Wrthner; all rights reserved; see [4] below
WWW:      http://www.mw-software.com/

Although this tool is called ZoomPlus, it comes as a directory called "!Viewer"
because it is a replacement of the original ArtWorks Viewer module.

This module is ShareWare. If you use it for more than two weeks, you have to
register it (includes registration of QuickCopy and AutoSave). See [6] for
details.

This module provides an enhanced Zoom tool with the following features:
* Zoom history: There are "Undo" and "Redo" buttons in the icon bar that allow
  you to go backwards and forwards in the previous 32 zoom settings; keyboard
  shortcuts: ^I and ^O; this works independently for each window and the
  settings are remembered even if you select other windows inbetween.
* New zoom buttons: "Zoom to drawing" (all visible objects on the page) and
  "Zoom to selection"
* Keyboard shortcut for temporary selection of the zoom tool:
  press Shift + right Alt (NB: press Shift first, then the right Alt key)
* There is a keyboard shortcut for "Previous zoom": ^O
* You can store up to 4 views per document on the preset zoom buttons (labelled
  "1" to "4"): Hold down Shift and click on the button to store the current
  zoom settings on it. Simply click on one of the buttons to recall the
  settings stored on it.
* There are up/down arrows for the scaling factor (steps of 1, or 10 if you
  hold down Shift).
* Having changed the value in the scaling factor input field you can click on
  the Zoom button instead of pressing Return.
* The "Previous zoom" setting in each window is remembered even if you select
  some other window inbetween.


1) The Viewer module
--------------------
The ArtWorks Viewer module provides two tools: The Push tool and the Zoom tool.
These are both explained in the ArtWorks User Manual (pages 17 and 19). This
module provides an enhanced version of the Zoom tool. The Push tool is
unaffected.

The most notable new feature is that the Zoom tool info bar now shows two
buttons that look like the undo and redo buttons further to the right in the
info bar. These new Zoom undo buttons can be used to move through the last
32 zoom settings for this window. As with undo/redo, you can move backwards
and forwards through the settings. The keyboard shortcuts for "Zoom undo"
and "Zoom redo" are ^I and ^O respectively. Note that you can press these at
any time, not only when the Zoom tool is selected. The zoom undo/redo system
works independently for each window, so even if you work in some other window
inbetween and come back to your first window later, the settings will still be
there!

This feature is most useful if you zoom in to some part of the drawing, then
zoom in further to work on some detail, then zoom in further to work on some
smaller detail etc. Using the Zoom undo/redo buttons or the keyboard shortcuts
^I and ^O you may then retrace your steps (at least the last 32). Please note
that all zoom changes are recorded, even those caused by using "Previous zoom"
or the preset zoom buttons (see below).

Unlike the main undo/redo buttons, the Zoom undo/redo buttons are not shaded if
there are no zoom settings to be undone/redone.

The two textual buttons "Zoom to screen" and "Zoom to window" that were present
in the standard version of the Zoom tool have been replaced by four icons. From
left to right, these are: "Zoom to screen", "Zoom to window", "Zoom to drawing"
and "Zoom to selection". "Zoom to screen" and "Zoom to window" have their usual
meaning (the icon for "Zoom to window" shows the document page and the
magnifying glass to remind you of the fact that this buttons zooms the document
in such a way that the complete page is visible in the window). The functions
of the new buttons: "Zoom to drawing" zooms to all visible objects on the page
(NB: this excludes objects in non-visible layers). "Zoom to selection" zooms to
the current selection (if there is one).

There is a keyboard shortcut that allows you to temporarily select the Zoom
tool in the same way as you can select the Select tool (left Alt) and the
Push tool (right Alt). In order to select the Zoom tool, press and hold Shift,
then press the right Alt key. The Push tool will be highlighted in the tool
box, but the info bar and the pointer shape will show you that you are indeed
in Zoom mode. If you release the right Alt key, the previous tool will be
reselected.

There is a keyboard shortcut for "Previous zoom": ^O. You can press this at
any time, not only when the Zoom tool is active. In other applications, this
shortcut is ^R, but unfortunately, this is already used by the Text tool for
"Kern text left".

The input field for the zoom factor has got up/down arrows. Clicking on these
changes the value by +1/-1. If you hold down Shift, the value is changed by
+10/-10. In order to allow you to operate this feature without having to use
the keyboard you can click on the Zoom button instead of having to press Return
for ArtWorks to accept the new value in the input field.

The buttons labelled "1" to "4" are preset zoom buttons. At any time, you can
store the current zoom setting by holding down Shift and clicking on the button
you want to store the setting on. If you click on the button later, the setting
is recalled. The settings are stored separately for each window, so even if
you change document inbetween, your settings are not lost.

Finally, the "Previous zoom" facility has been extended in such a way that the
previous zoom is remembered for each window separately. The original version
of the Zoom tool only rememebered it for the active window, so after working on
some other ArtWorks document inbetween, you could not go back to the window and
use "Previous zoom". This restriction has been removed, so you can now work
on several documents simultaneously and still use "Previous zoom" in each
window.

1.1) Known bugs and deficiencies
--------------------------------
When using the shortcut for temporary selection of the Zoom tool, the tool
highlighted in the Tool Box is not the Zoom tool but the Move tool (the "hand"
icon). This is a result of the trick used to implement this shortcut. The
choice of the key combination Shift + right Alt was also influenced by
technical constraints. Officially, it is not possible for modules to provide
shortcuts for temporary selection of tools.

Please note that this module will cause ArtWorks to consume about 7k more
memory as opposed to using Viewer 0.01.


2) Version history of ZoomPlus
------------------------------
0.09 (17-Jul-03):
- added help messages for the tool

0.08 (07-Apr-03):
- 32-bit compatible version for ArtWorks 2

0.07 (29-Jan-02):
- corrected problems with Zoom tool being current tool on start-up (displayed
  abort on data transfer error message under RISC OS 4)

0.06 (12-Sep-01):
- moved 'Zoom' button to the right of the input field - more ergonomic if you
  use the arrow buttons to adjust the scale
- added German and Dutch messages (thanks to Dick Tanis for the Dutch
  translation)
- minor additions to improve stability on tool startup and closedown

0.05b (27-Jul-00):
- documentation update

0.05 (28-Sep-98):
- "Zoom to drawing" and "Zoom to selection" buttons added

0.04 (10-Feb-98):
- first version released with the QuickCopy Group

0.01 (08-Jan-93):
- version supplied by CC as standard tool with ArtWorks


3) Contacting me
----------------
Martin Wuerthner
Mannheimer Str. 18
67655 Kaiserslautern
Germany

Phone: +49-(0)631-3608205
Fax:   +49-(0)631-3608203

e-mail: martin@mw-software.com
WWW:    http://www.mw-software.com/


4) Copyright
------------
The ArtWorks ZoomPlus/Viewer module, related documentation and files are 
Copyright 1993 by Computer Concepts Ltd. and  Copyright 2003 by Martin
Wuerthner. All rights reserved. The software and documentation may not, in 
whole or part, be copied or transmitted by any means without the explicit
written consent of the copyright owner. Unless you have purchased a site
licence for this  software, it may be used on only one stand-alone
computer system at any time.

In order to use this software, you need a licence from the copyright owner. If
you do not have such a licence, you must delete this software, the Viewer
module and its related files, now.
