README.TEXT - ARexx Support Documentation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The scripts in this directory are simply scripts that will make it easier
to handle ranges of indexed files. Each script perform a task that can be
invoked from Shell/CLI or from programs such as DOpus4 or DOpus5.

None of the scripts uses Image Engineer or any other external software, but
they do use basic DOS commands such as delete, rename, etc.

The new version of the button bank for DOpus5 already have support for the
scripts in this directory. Also, complete settings exists, ready to use, for
DOpus4. Read the ReadMe files for those programs to see how to setup
configurations.


  Included scripts
 ~~~~~~~~~~~~~~~~~~

"REXX:IndexChange.rexx"

Usage: <add/sub_value> <First_file_in_range> <Last_file_in_range>

This script adds or subtracts a given value from each index number for all
files within the set range. If the <add/sub_value> option is positive the
script will add, if it is negative it will subtract.

Example: RX IndexChange 25 Output.0035 Output.0075
 Result: 41 files named Output.0060 to Output.0100



"REXX:IndexClone.rexx"

Usage: <New_basename> <First_file_in_range> <Last_file_in_range>

This script makes copies (clones) of all files within the set range. The new
files will have the same index number as the original file but the base name
of the file will be set to the name specified in the <New_basename> option.

Example: RX IndexClone CloneImage Original.0003 Original.0021
 Result: 19 files named CloneImage.0003 to Original.0021 and, of course,
         the files Original.0003 to Original.0021.


"REXX:IndexMultiply.rexx"

Usage: <Number_of_copies> <Indexed_file_name>

This script makes copies (clones) of one single indexed file. The new
files will have the same base name as the original indexed file but the
index numbers will change. The <Number_of_copies> options sets the number
of copies of the original file. A positive number will make the new files
indexed from the original file and upwards, while a negative value will make
them indexed downwards.

Example: RX IndexMultiply -10 Image.0040
 Result: 11 files named Image.0030 to Image.0040



"REXX:IndexReverse.rexx"

Usage: <First_file_in_range> <Last_file_in_range>

This script reverses the order of all file within the selected range. The
first file is renamed so that it will be the last and vice versa.

Example: RX IndexReverse Nice_Pic.0005 Nice_Pic.0015
 Result: 11 files named Nice_Pic.0005 Nice_Pic.0015


[--------------------------------------------------------------------------]

  All scripts Copyright © 1997
  by Patrik M Nydensten, <ie96_pny@isk.kth.se>
  9/1 1997 Stockholm/Sweden