DPK_rename 1.02		Mar 27, 2003


---------
Contents:
---------
1. Files Included
2. Installation
3. Quick Start
---------



-----------------
1. Files Included

- DPK_rename.mel                          Version: 1.02
- DPK_renPadding.mel                      Version: 1.00
- readme.txt


---------------
2. Installation

Copy the ".mel" file(s) into your scripts directory (e.g.: ../maya/scripts)
and create a shelf button with the command:
    "DPK_rename;"


--------------
3. Quick Start

1. Open the rename window by typing "DPK_rename;", or use your shelf button.

2. Specify the options:
    - "New Name"    will simply rename all selected objects.
    - "Add Prefix"  will add a prefix at the start of the name of each object.
    - "Add Suffix"  will add a suffix to the end of the name of each object.
    - "Replace"     will replace the first instance of the text specified in
                    the "Replace" field with the text in the "with" field. If
                    you enter nothing in the "with" field the text in the
                    "Replace" field will be removed from the objects name.

    - Check "Increment" if you want to add an incrementing number to the
      object's name. The text entered in the "Add before increment" and "Add
      after increment" fields will surround the incrementing number. "Padding"
      defines the length of this number. "Start with" is the start value for
      it. It will be placed as follows:
      - "New Name"      -     [newName][before][number][after]
      - "Add Prefix"    -     [newName][before][number][after][oldName]
      - "Add Suffix"    -     [oldName][newName][before][number][after]
      - "Replace"       -     [startOfOldName][replacingText][before][number]
                              [after][endOfOldName]

      E.g. with the settings:
            Replace:                S.*
            with:                   Ball
            Increment:              checked
            Start with:             3
            Add before increment:   _
            Add after increment:    _small
            Padding:                2
      the objects will be renamed:
            nurbsSphere1    <->    nurbsBall_03_small
            nurbsSphere2    <->    nurbsBall_04_small
            nurbsSphere3    <->    nurbsBall_05_small
            nurbsSphere4    <->    nurbsBall_06_small

      If you are wondering why I wrote "S.*", see the online help of the MEL
      Command "match".


3. Press "Rename" while one or more objects are selected.


--------------
If you have any comments or suggestions, please email me at:
daniel@dpk.stargrav.com

Daniel Pook-Kolb
