Selector 0.11 (15-Apr-2003)

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

1) Changes
----------
This module is the original Selector tool with three enhancements:

Force marquee drag
------------------
In previous versions of Selector, dragging on top of an object always selected
and moved it. This meant that you could only start a marquee drag (dragging a
box to select enclosed objects) if you found an empty spot on the page to start
from. This new version of Selector allows you to press Alt while starting a
drag to force a marquee drag operation even if the starting point is on top of
some other object. This new feature makes it much easier to select a group of
objects that have many other objects underneath and around.

This feature is only available if the Selector tool has been selected by
clicking on its icon in the Tool Box. It is not available when the Selector
tool has been selected temporarily by holding down Alt (for obvious reasons,
because in this case, the Alt key is always pressed, so this would prevent you
from dragging objects while in temporary Selector mode).

Suppress auto-scroll
--------------------
When using the cursor keys (plus optionally Shift) to nudge objects, ArtWorks
usually scrolls the window in the direction of the scroll if the selection
would be moved (partly) outside the visible area of the window. This is not
always desirable, e.g., if you nudge a large object to the right but you want
to see its left edge because you want to align its left edge with something
else. Therefore, if you hold down Ctrl while nudging, the automatic scrolling
is disabled. So, to nudge without scrolling use Ctrl-cursor key (normal nudge)
or Shift-Ctrl-cursor key (5 times the configured nudging distance).

Draw-like marquee drag
----------------------
If Ctrl is held down during a marquee selection drag, then the Draw logic is
used instead of the ArtWorks logic: All objects whose bounding boxes intersect
with the selection box are selected.

2) History
----------
Version 0.11
- Draw-like marquee drag added

Version 0.10
- 32-bit safe
- added support for Method_ModuleInfo

Version 0.05
- switched off "force marquee drag" feature in temporary Selector mode

Version 0.04b
- corrected sprites

Version 0.04
- chose Alt instead of Ctrl for marquee drag - I often drag with Ctrl pressed
  to use the constrain feature - Alt was not taken before
- added auto-scroll suppression by holding down Shift

Version 0.03
- always start marquee drag if Ctrl is pressed
- added German messages (thanks to Detlef Thielsch)

Version 0.02
- original version as supplied by CC

3) Installation
---------------
Make a backup copy of the directory !ArtWorks.Auto.!Selector. This is the
original version of the Selector module as supplied with your copy of ArtWorks.
Do not place the backup inside !ArtWorks.Auto. Should you ever want to
deinstall Selector 0.04 you can replace it with this backup. The original
version of Selector as supplied with ArtWorks is 0.02.

You can find the !ArtWorks.Auto directory by holding down the Shift key while
double clicking on the !ArtWorks icon, then double-click on the Auto directoy
icon.

Copy this updated !Selector module into !ArtWorks.Auto.

If you are not using the 'Quick start' feature of ArtWorks, then this is it
already. Otherwise (this is recognized by the fact the ArtWorks only displays
one icon 'Quick start' when starting up) you have to go on:

If the 'Quick start' option is selected in the ArtWorks choices window you have
to perform the following steps in order for ArtWorks to recognize the new
module:

* Load ArtWorks
* Open the ArtWorks choices window (icon bar menu 'Choices...', then click on
  the ArtWorks icon in the ArtWorks global choices window)
* Deselect 'Quick start' and click on 'Save'
* Quit ArtWorks
* Reload ArtWorks - while loading ArtWorks shows every module it loads, this
  should include the Selector module. If ArtWorks displays an error message
  like "Due to lack of memory one or more modules could not be loaded ..."
  something has gone wrong and you should check whether you have correctly
  installed the module.
* Open the ArtWorks choices window
* Select 'Quick start' and click on 'Save'

If you ever should want to deinstall the module, remove the !Selector
directory from the !ArtWorks.Auto directory and install your backup copy of
!Selector in its stead. Then, if you are using the 'Quick start' option,
you must repeat the steps detailed above.


4) 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/


5) Copyright
------------
This ArtWorks module, Selector, including all related files is Copyright 1993
by Computer Concepts Ltd. and Copyright 2002 by Martin Wrthner. All rights
reserved.

This update may be distributed freely to owners of a valid ArtWorks licence.
