This add-on intends to be an advanced version of the default "Save Incremental" feature. With "Advanced Save Incremental" you can save a file with multiple numerical version parts separated by a customizable string.
file name stem - also known as a base name, a part of the file path without its extension and directory path.
filename stem is divided into Prefix, Root, Suffix and Version in this order.
for example, if the file name looks like "John Doe - Project Foobar v3.0.1.blend", its stem can be separated into logical parts like:
- "John Doe" - a name of the author, e.g. when a team has a repository where it's required to separate the ownership
- "Project Foobar" - a name of the project
- "3.0.1" - a numerical version
such a name would be defined in the add-on as a Save Template with the following parameters:
- Prefix = "John Doe - "
- Suffix = " v"
- Version would have own parameters:
- Count = 3
- Separator = "."
Root parameter and Version value will be auto-detected:
- Root = "Project Foobar"
- Version = "3.0.1"
Save Template - is a set of settings for how to save the new file:
- Name (the unlabeled property in the header) - only for logical separation
- Directory - a typical directory path property. see File Paths in the Blender Manual for details
- Use Prefix/Suffix/Version parameters are toggles which control which parts to include in the final result
- Prefix/Suffix - similar to the Current File parameters, these are just simple strings, which can be the same as in the Current File, different or empty
- Version has Count and Separator as described before and a new parameter Width. when Width is larger than 1, version numbers which are composed of more than 1 digit will be prepended with zeroes, e.g. version "3.0.10" with width 3 will become "003.000.010". this schema is often used when you want to have file names ordered correctly by numerical version in primitive file explorers
- Save Copy option makes Save operators behave like native Blender "Save Copy" operator
- Save Overwrite option doesn't warn you about overwriting an existing file
as a bonus, you can also see and open the Directory files directly from the panel
