Pattern Renamer is a mass renaming and renumbering plugin.

Processing order
It is important to note that transformations apply in the same order as the screen: Replacement, croping, insertion (insert/append).

However when renumbering occurs this order is : Replacement, croping, renumbering, insertion.
Keep to mind that "Insert" and "Append" is always last.

Renaming and/or Renumbering
You may just Rename, just Renumber or both Rename and Renumber file names.
Note that renaming/renumbering doesn't necessary means changing string or number values. You can for example use renaming to change extensions to lowercase (i.e JPG to jpg) or renumbering to change a number format (i.e. 06 to 0006).
Although renaming is rather straigh forward, renumbering is more subtil. It is recommended to read the "Renumber" section carefully before using renumbering.

Wizard mode & Error checking
With massive renaming collision names may occur. You may also want to check/modify your settings before renaming.
Pattern Renamer starts with the above Select Form. By clicking "Show details before renaming" the Detail Form (see Detail Form below) is shown before any renaming.
In case of collision between names (file name already existing on the disk) the Detail Form will be prompted automatically.
The Detail Form gives the ability to modify your settings or edit individual file names.
When settings are correct cliking the "Ok" button does the actual renaming.

Simply note that renaming is a 1 or 2 steps process:

• Select - Ok
• Select - Detail - Ok

Selected files | All files Status of files which the plugin should ask from P3dO's current file list.
Filter A user defined filter to apply the renaming to a limited number of matching files.
Any file whose name match the entered text will be processed. Filter can also be a Regular Expression pattern (Read more about Regular Expressions in P3dO's help file "Tips and Tricks" section).
Poser tip: wildcar filters will automatically rename attached .RSR and/or .PNG to a Poser library file (so called associates in P3dO). On the contrary a filter with extension - i.e *.RSR - will have no effect on Poser library parent files. .RSR are considered attached to Poser library files but not the contrary.

Name | Extension | Whole The part of the file name to rename.
nota: Be carefull when renaming an extension. Windows heavily relies on extensions and changing a file extension is generaly a mistake. But changing an extension from i.e. .jpeg to .jpg is not because those two extensions have the same internal file format. The rename extension of Pattern Renamer was designed with this in mind.

Rename
Replace String to be replaced followed by replacing string (with). If the same string is encountered twice in the file name, only the first one is replaced.
The replace with filed can be empty in which case replacement is an erasement.
Loop replacement Replace all occurences of the replace string in file name.
Length options:
   Left Crop Number of characters to remove on the left side of the replaced string.
   Right Crop Number of characters to remove on the right side of the replaced string.
   Truncate Left Remove all characters after the given count, count starts from the end of the string.
   Truncate Right Remove all characters after the given count, count starts at the beginning of the string.
    The length count doesn't take the extension (and dot) into account if the extension is not marked for renaming (i.e "Apply to" is set to "Name").
Insert A string to insert at the beginning of the new file name. Note that when renumbering is applied Insert occurs after renumbering.
Append A string to add at the end of the new file name. Note that when renumbering is applied Append occurs after renumbering.

Renumber
Start from Number of first file. If unchecked the number is supposed to be extracted from the file name itself.
Increment To apply to the above number (first file excluded).
The Increment is applied to the number extracted from the file name or given by "Start from".
Maybe 0 if you just want to reformat a number.
Zero Fill Used to format a number. This is the number of digits which should at least compose any number.
For example Zero Fill: 3, means 1 will look like this: 001 (3 digits).
Note that numbers whose number of digits is greater (1000+ in the example) are not affected by this setting.
Zero Fill is limited to 9 digits.
Where to put the number ?
- Insert before text: initial name is unmodified.
- Append to text: initial name is unmodified.
- Override whole text: initial name is overriden.
- Override leftmost number: initial leftmost number is overriden, text and other numbers are unmodified.
- Override rightmost number: initial leftmost number is overriden, text and other numbers are unmodified.

Reset Restore all settings to default (empties the screen fields).
Show details before renaming Show the Detail Form before actually renaming (see Detail Form below for more).

This is a simple 2 columns grid.
Old Name name to be replaced.
New Name replacing name.

Before any renaming occur it is possible to:
- modify single file names by editing the "New Name" column content.
- click the "Previous" button and go back to the Select Form in order to modify your settings (any edited file name will be lost).

When Pattern Renamer detects a collision between file names (file already existing on the disk) the Detail Form is automatically displayed once the Ok button has been clicked.
Problematic file names are colored in red. As long as those file named have not been corrected, or the settings have not been changed, renaming will not be possible (Clicking the Ok button always steps back to Detail Form).

It is not possible to partially select files among the list. All files displayed in the grid are due to be renamed (Partial selection will be added in Pattern Renamer 2.2).

After renaming, Detail Form is still available for information purpose but is read-only.

Shows a summary of renamed file.
A detailed report is available from the Detail Form, which is now read-only.