Short:    PGS3 arexx script - place text around an ellipse
Uploader: Michael.Merkel@gmx.net (Michael Merkel)
Author:   Michael.Merkel@gmx.net (Michael Merkel)
Type:     text/dtp
Replaces: text/dtp/MUItxtRotator.lha
Version:  V4.07 (20. Dec 1998)


ABOUT

This is an ARexx script for use with PageStream3.
With this script it's possible to place a selectable text (or textfile) around
a circle, ellipse or a spiral.

Just select the object and call the script.


DISTRIBUTION

spread it! use it! _write me!_


REQUIREMENTS

- PageStream3 (of course!!!) >= V3.4!
- MUI
- MUIREXX V3.x!! (Aminet: dev/mui/MUIRexx_3_0a.lha)
- rexxmathlib.library (Aminet : util/rexx/RexxMathLib.lha)
- a circle or similar


USAGE

* install it with the installer script
* select "Play Script" in PageStream3
* loooook!!!

**********************************************************
* ATTENTION:                                             *
* ----------                                             *
* The prefs window of MUItxtRotator can be quite large   *
* depending on your MUI font configuration. So be shure  *
* to have a WorkBench/PageStream3 screen which is large  *
* enough! Otherwise it can result in crashes at startup! *
**********************************************************


HISTORY

V1.00 - V2.03 (March - August 1996)
 *  non public versions

V2.04 (03. August 1996)
 * first public release

V2.05 (04. August 1996)
 * fixed a bug in the drawing loop. last character wasn't placed at the
   desired position
 * fixed error in requester. only 10 text gadgets are allowed under PGS3

V3.00 (07. August 1996)
 * some code cleanup
 * added support for spiral text!!

V3.01 (08. August 1996)
 * text for a spiral is now scaled!!
   this looks *much* better
 * added prefs file (all user settings are saved now)

V3.02 (26. August 1996)
 * very very little code cleanup for requester
 * arexxlist was not cleared :-(

V3.03 (25. September 1996)
 *  corrected the gadgets (labels) to the new format introduced with V3.2b6 of PGS

V3.04 (26. September 1996)
 * coordinate handling changed again! (V3.2b8)
   Now txtRotator sets the default measurement system to points during the work!
   After placing the letters the measurement system is set to the one specified in
   the PageStream.prefs file!

V3.05 (12. October 1996)
 * added the possibility to hide the window while setting the text.
   this is *much* faster on slow machines (well, on every machine!)
 * bugfix - will not crash when entering no text
 * nicer looking busy requester :-)

V4.00 (14. June 1998)
 * switched over to MUIRexx for the interface design!
   (gives much more possibilities for requesters and parameters)
 * corrected EMail address
 * added possibility to load the text from an ASCII(!) file.
   Even special characters (unicodes) and be used.
   eg a "\8226" will result in a bullet and a "\0916" in a delta.
   "\\" will result in a backslash.

V4.01 (16. June 1998)
 * the progress gauge in the busy window was not used -> fixed!
 * angles are only from 0 to 360 degrees. If an arc was used an end angle of
   >360 degrees was the result. But it was not used 8-( -> hopefully fixed!
 * added a switch in the busy window to turn off or on the document window.
   (Speed up for the drawing! Like in the old txtRotator.rexx)
 * added a button to show an example arc. So you can check out the angle settings.
   (does this really work??)

V4.02 (19. June 1998)
 * improved the preview of the example arc. Now includes _all_ features as there are
   spiral, surroundings, direction, position!
 * added entry for the quality of the preview!
 * lock bug introduced with the example preview. Canceling while rotating
   was not possible -> fixed!

V4.03 (24. June 1998)
 * "save as" always reacted like "save" -> fixed!

V4.04 (26. June 1998)
 * quick fix! "Save" saves as "MuiFontCatalog.prefs" instead of "MUItxtRotator.prefs"!
   -> fixed! (thanks to Brian Hosty!)

V4.05 (20. October 1998)
 * Thanks to the new PageStream V3.4 it is now possible to show the styletags defined
   in PageStream3. Added this feature.
 * removed the obsolete "SELECTOBJECT NONE" commands (thanks to PageStream V3.4)
 * Thanks to the new GoldED 5 now full tab support in the scripts! 8-)

V4.06 (08. November 1998)
 * Completely reworked the preferences file. It now is a set of ARexx commands.
   If this works the changes will also transfered to my other scripts. The advantage
   of this style is: always by able to use old prefs files in new versions of the
   script! Before, if I changed the prefs structure, the old prefs were useless.

V4.07 (20. December 1998)
 * Ouch! BUGFIX only. V4.06 produced text with a size of 0 points! - FIXED!



AUTHOR

Michael Merkel (MiMe@IRC)
Michael.Merkel@gmx.net (Michael Merkel)
http://home.t-online.de/home/Merkel.Michael/


THANKS TO

SoftLogik for this wonderful program! It's the best on all platforms...