TextTool 1.29 (01-Oct-03)

Name:     ArtWorks TextTool module
Purpose:  Enhanced replacement of original ArtWorks TextTool module
Author:   Computer Concepts and Martin Wrthner
Requires: RISC OS 3.5 or higher, ArtWorks 2
Status:    Computer Concepts Ltd.,  2003 Martin Wrthner
WWW:      http://www.mw-software.com/

1) TextTool module changes
--------------------------
This module is the original TextTool module with various enhancements: The
default text style can be configured using the ArtWorks choices interface.
Placing the caret is easier with the new "relaxed placement" feature: If Ctrl
is held down while placing the caret, then it is enough to hit the bounding box
of the text, it is no longer necessary to hit a character. Additionally, there
are the following bug fixes: There is more control when placing of the caret in
overlapping text objects, font colours are correct in ArtWorks EPS output and
rotated text is rendered correctly in ArtWorks EPS output (with 'Convert text
to shapes' off).

Configuration
-------------
This version of the Text Tool allows you to configure the default font name and
size that are given to the first text object that is created after loading
ArtWorks. The default is Homerton.Medium at 32pt, but not everyone likes that,
so you can choose a different default style by clicking on the "Text" panel in
the ArtWorks choices window (choose "Choices..." from the icon bar menu).

Bug fixes
---------
Enhanced caret placement behaviour: When placing the caret in a text object by
clicking on it while the Text Tool is the current tool, only objects in the
currently active layer are taken into account. This makes it easier to place
the caret in overlapping text objects that are in different layers. If you want
all layers to be considered, then hold down Shift while clicking (this was the
behaviour of previous versions of TextTool).

In contrast to earlier versions, version 1.27 now scans the text objects from
top to bottom, so if text objects overlap and you click on them, the caret is
placed in the topmost object (provided you hit a character or hold down Ctrl -
see next paragraph).

Placing the caret is a bit fiddly at times because ArtWorks requires you to hit
a character. If you hold down the Ctrl key, then this restriction is relaxed:
The caret is then placed if you click anywhere inside the bounding box of the
text. Please note that for rotated text, the bounding box (the upgright
enclosing rectangle) can be rather large, which is why this behaviour is not
the default.

ArtWorks EPS fix: Previously, font colours were not correct in ArtWorks EPS
files when rendered using a PostScript engine. The reason was an omission in
the EPS procedure definitions of the TextTool. This has been fixed, so font
colours are rendered correctly.

ArtWorks EPS fix: Previously, transformed text could cause PostScript engines
to abort when rendering ArtWorks EPS exported with the 'Convert text to shapes'
option off. If rendered at all, text positioning was wrong if there was any
kerning in the text. This has been fixed, so the EPS is rendered correctly. It
is still a bit tricky to export EPS with the 'Convert text to shapes' option
off because of the fact that the RISC OS fonts are unlikely to be known by the
importing application under other operating systems. A future version of the
TextTool may address this issue. At the moment, replacing the font names
manually in the EPS helps. If you do not need to edit the text after importing
the EPS into some other package, it is still the best to switch the 'Convert
text to shapes' option on when exporting, because then, the exported text will
render correctly irrespective of which fonts were used.

2) History
----------
Version 1.29 (01-Oct-03)
- choices are saved correctly when "Save choices" is chosen from the ArtWorks
  icon bar menu
- correctly switches back from curve Info Bar to standard Info Bar when the
  text is removed from the curve or when the document is closed and a new one
  is created

Version 1.27 (24-Sep-03)
- font substitution always uses Homerton.Medium instead of the document's
  default font (because the latter may not be available either)
- fixed problems with converting text at a negative X position to shapes (a
  workaround for what seems to be an OS bug)
- pressing Return to create a new text line now takes the style from the text
  line the caret was in
- text objects are considered top to bottom when placing the caret
- holding down Ctrl when placing the caret places it even when not clicking on
  a character, just hitting the bounding box is enough

Version 1.24 (28-Aug-03)
- added text on curve parameters setup (distance and start offset)

Version 1.21 (17-Jun-03)
- added interactive help for tool

Version 1.20 (13-Jun-03)
- added skew support

Version 1.19 (03-Jun-03)
- on the Iyonix, PC style keyboard conventions are used for the Delete (deletes
  to the right), Home (move to start of line) and End (move to end of line) keys

Version 1.18 (23-May-03)
- text to curve fixed

Version 1.17 (04-Apr-03)
- 32-bit compatible for ArtWorks 2

Version 1.16 (28-Mar-02):
- allows Alpha attributes to be applied to text lines and characters (support
  for Crystal module)
- does not include "!TextTool.Mapping" to avoid overwriting your own copy of
  this file which might be modified

Version 1.15 (18-Nov-01):
- made default font system more robust (in case there are no default font
  entries in the messages file)

Version 1.14 (16-Nov-01):
- fixed intermittent bug in font name change (sometimes, font changes were
  ignored completely, sometimes changing the font could lead to a crash)

Version 1.13 (14-Jun-01):
- corrected ArtWorks EPS procedures to correctly render transformed text (Tx
  procedure did not work correctly if Tm was present, even less so if there was
  kerning as well) - requires PathTool 0.08 because aca procedure was modified,
  too, to support this change.

Version 1.12 (22-Mar-01):
- corrected ArtWorks EPS procedures to correctly render text colour

Version 1.11 (19-Mar-01):
- added reading of default values from messages file, the default values for
  the defaults are AvantG.Book at 32pt, as with the original TextTool
- added bug fix for placing caret

Version 1.10b (30-Oct-00):
- changed default style to Trinity.Medium at 12 pt

Version 1.10 (07-Jan-93):
- original version as supplied with ArtWorks 1.5 (and 1.7)


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, TextTool, including all related files is Copyright
1993 Computer Concepts Ltd and partly Copyright 2003 by Martin Wrthner.
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.
