Plugins » Pattern Renamer 2.3.3
Only compatible with P3dO 2.2 and above
Purpose
Pattern Renamer is a mass renaming and renumbering plugin.
How it works
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
(pro) Renaming files in subdirectories
Pattern Renamer renames files that are displayed by P3dO. Thus when you click on "Explore
Subfolders" in P3dO, P3dO will display the whole files within that directory structure. Then
call Pattern Renamer to make any renaming you wish. This is the way Pattern Renamer is able to work
on subfolders.
Select Form
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).
Detail Form
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.
Finish Form
Shows a summary of renamed file.
A detailed report is available from the Detail Form, which is now read-only.
|