Translate 1.06 (18-Jun-03)

Name:     ArtWorks Translate module
Purpose:  ArtWorks module for object translation
Author:   Martin Wrthner
Requires: RISC OS 3.5 or higher, ArtWorks 2
Status:   FreeWare (see [5] for details)
WWW:      http://www.mw-software.com/

This module provides a tool which allows you to translate objects by
specific amounts (e.g. 1cm to the right).


1) The Translate module
=======================
The Translate module displays an additional tool, the Translate tool,
in the ArtWorks tool box. The tool looks like four arrows pointing
to the left, the right, the top and the bottom.

When you select the tool, the info bar displays the fields 'Offset X',
and 'Offset Y' and the action button 'Get Grid'. Also, it displays
the standard ArtWorks 3 by 3 matrix of small buttons (with the
button in the middle missing).

While the tool is selected, you may move the current selection by
the amount specified in the 'Offset X' and 'Offset Y' fields by
either clicking on one of the small buttons in the 3 by 3 matrix
or by using the arrow keys (or Ctrl-Shift-arrow keys). The reason
for allowing the arrow keys with Ctrl-Shift as well is that while
the caret is in one of the writable fields, the cursor keys are
used to move the caret, so you have to use Ctrl-Shift-arrow to move
the selection.

The value in 'Offset X' is taken for horizontal moves, the value in
'Offset Y' is taken for vertical moves. Note that you can move the
selection diagonally if you use the corresponding buttons on the
3 by 3 matrix. To change the offset values, enter a new value in
any unit of measurement allowed by ArtWorks and press Return. The
values are remembered even if you change the tool. Note that after
you entered a new value, the caret is still in the writable field,
so the cursor keys cannot be used to move the selection. Use Ctrl-
Shift-cursor key instead or simply click in the main window to
take the caret away from the input field.

By clicking on 'Get Grid' the current values of the grid are filled
in, e.g. if your current grid is 1cm with 2 subdivisions, the offsets
are both changed to 5mm. This option works independent of the 'Lock
to grid' setting.

Next to each writable fields you find a button showing a division
sign. By clicking on such a button with Select, you can halve the value
in the editable field. This is useful if you quickly want to translate
an object by half the grid size. Simply click on "Get grid", then on
the division button. By clicking with Adjust, you can double the
value in the field. Note that due to the limited accuracy used for
measurements within ArtWorks, after several halving steps followed by
the same number of doubling steps you will not necessarily end up with
the value you started from. :-(

The module fully supports the Undo system of ArtWorks. The name of
the operation is 'translate', so the Menu will show 'Undo translate'
if your last operation was to translate an object or a selection of
objects.

2) Changes
==========
Version 1.06 (18-Jun-03)
- correctly converted to 32-bit

Version 1.05 (06-May-03)
- 32-bit compatible version for ArtWorks 2

Version 1.04b (27-Jul-00):
- documentation update

** Bug fix in version 1.04 **

Removed the irritating bug that the cursor keys shortcuts are
active even after Translate has stopped being the current tool. This
interfered with the Text tool's usage of the cursor keys for moving the
caret.

** New feature of version 1.03 **

Half/Double size buttons next to the writable fields. Clicking with
Select halves the value, clicking with Adjust doubles the value.

** New features of version 1.02 **

The user interface has been modified to fit in better with the rest
of ArtWorks: If you press Return, both offsets are read from their
fields in the info bar (as opposed to only the one in the field the
caret is in as it happened with version 1.01). Pressing any other key
(e.g. up/down arrow) no longer does this.

By popular demand Translate saves the currently used values in the
global ArtWorks !Choices file if you choose "Save choices" from the
ArtWorks info bar menu. These will then be taken as the default
values next time you load ArtWorks.

German messages added.

** New features of version 1.01 **

Version 1.00 of Translate was incompatible with the Precision Tool
(available from CC) because the latter is using some codes which are
in fact allocated to me. As it is improbable that there will be a fix
for the Precision Tool I have applied for some new codes and modified
all my modules to use these. So this module should now work as expected
even if you have got Precision.

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:
-------------
This ArtWorks module including all related files is Copyright 2003,
by Martin Wrthner and is FREEWARE.
This means that you may copy it freely provided that
(a) all files of this application are distributed together without
    modification
(b) this application is not sold for profit without my explicit written
    permission

I retain the copyright on all files.
