Rename
Renames locations in the scene.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
out
The processed output scene.
enabled
The on/off state of the node. When it is off, the node outputs the input scene unchanged.
in
The input scene
filter
The filter used to control which parts of the scene are processed. A Filter node should be connected here.
name
The new name for the location. If this name is non-empty then it takes precedence, and all other renaming operations are ignored.
Tip
The ${scene:path}
context variable contains the
location’s original name, and can be used in a Spreadsheet’s
selector
to allow each row to define the new name for a
particular location.
deletePrefix
A prefix to remove from the start of the original name. Prefixes are removed before the suffixes and before the find and replace operation is performed.
deleteSuffix
A suffix to remove from the start of the original name. Suffixes are removed before the find and replace operation is performed.
find
A string to search for within the original name. All occurrences of this string
will be replaced with the value of replace
. When useRegularExpressions
is on, the search string is treated as a regular expression, with the
following syntax :
Matching
.
: Matches any character.[aef]
: Matches any character in the set.[^aef]
: Matches any character not in the set.[a-z]
: Matches any character in the specified range.[[:digit:]]
: Matches any numeric digit.[[:space:]]
: Matches any whitespace character.
Repetition
*
: Matches the preceding pattern any number of times (including none).+
: Matches the preceding pattern 1 or more times.{N}
: Matches the preceding pattern N times.{M,N}
: Matches the preceding pattern between M and N times.
Alternatives
A|B
: Matches either pattern A or pattern B.
Captures
()
: Captures the subgroup of the pattern within the brackets, allowing it to be referenced by{}
in thereplace
string.
replace
The replacement for strings matched by the find
plug.
When useRegularExpressions
is on, this can refer to
captured patterns using Python’s standard string formatting
syntax :
{0}
: The entire string matched by the regular expresion.{1}
: The 1st subgroup captured within()
brackets by thefind
string.{N}
: The Nth subgroup captured within()
brackets by thefind
string.{1:0>4}
: The 1st subgroup, aligned to the right and padded to width 4.
useRegularExpressions
When on, the find
string is treated as a regular expression,
allowing it to perform complex pattern matching and to capture sections
of the match to be referenced by the replace
string.
addPrefix
A string to add at the start of the name. Prefixes are added last, after the find and replace operation has been performed.
addSuffix
A string to add at the end of the name. Suffixes are added last, after the find and replace operation has been performed.