vcanim.gif (8357 bytes)zRenamer
Home ] Sales ] Products ] Services ] Support ] Downloads ]

 

 


zRenamer

Overview

zRenamer alters filenames with an alphabetic beginning and numeric ending by adding or removing leading zeroes from the numeric part of the filenames. It also adds or removes a period before the numeric portion of the filenames.

This means that it can convert a filename of the form CATS0081.TGA to CATS81.TGA or vice-versa. Specify one of the filenames you want to convert and then change the numeric part of the filename to a * (wildcard character). For example, if you had selected CATS0081.TGA you would edit this to be CATS*.TGA . This would let you change all the CATS picture filenames. You can also tell zRenamer to add a period before the numeric portion of the filename, so that CATS0081.TGA becomes CATS.81.TGA or to remove such a period (if one exists) so that CATS.0081.TGA becomes CATS81.TGA .

Image Filename Pattern
The Image Filename Pattern consists of a filename pattern preceded by a directory path. The directory path specifies where on the disk to look for files which match the pattern you specify. The path must be absolute. The filename pattern is used to match file names within a directory, in regexp syntax. This means that d:/images/mice*9.pic, e:/textures/DOGS*.TGA, and f:/cats/cats01*.tiff are all OK, but ../DOGS*.TGA and ~/cats01*.tiff are not.
Format
Pad Zero and Unpad Zero
Select whether to add leading zeroes to the numeric part of the filename or to remove them. Set Pad Zero to add zeroes or set Unpad Zero to remove them.
Period On
Select whether a period should precede the numeric portion of the file name. Set Period On to convert DOGS0005.TGA to DOGS.0005.TGA or DOGS.0005.TGA to DOGS.5.TGA (provided Unpad Zero is set). Clear Period On to convert CATS.175.PIC to CATS175.TGA, or to convert CATS175.TGA to CATS00175.TGA (provided Pad Zero is on and Number of Numerical Characters is set to 5).
Number of Numerical Characters
This option is only enabled when you are adding leading zeroes. It specifies how many digits the renamed filenames will contain. If you set this to 6 then you will rename CATS345.TGA to CATS000345.TGA and CATS1.TGA to CATS000001.TGA.

Discussion

Suppose that, in the directory d:\imagefiles\dogs, you have a sequence of image files with zero-less filenames, e.g., dogs1.tga through dogs100.tga . If you want to use them with an application that insists on leading-zero filenames containing four numerical characters (e.g., dogs0001.tga through dogs0100.tga), you will need to rename each and every file in the sequence. zRenamer automates this job.

(Note: We will use "4" for the sake of this discussion, but you can of course choose any number of numerical characters).

The above screen shows zRenamer configured to add leading zeros until there are at least 4 numerical characters. So:

dogs1.tga
dogs2.tga
dogs3.tga
.
.
.
dogs100.tga

would become

dogs0001.tga
dogs0002.tga
dogs0003.tga
.
.
.
dogs0100.tga

Of course, names that already have 4 numeric characters, such as:

dogs2345.tga
dogs0035.tga

would remain unchanged.

Additionally, zRenamer does not usually alter files which have more than the specified number of numerical characters, so:

dogs35243.tga

would remain unchanged, since it already contains more than 4 numerical characters.

The exception is that if there are more than 4 numerical characters and they begin with zero(s), zRenamer will strip away leading zeros until it encounters a non-zero integer or there are only 4 numerical characters remaining, whichever occurs first. Thus, zRenamer renames dogs0010345.tga to dogs10345.tga and dogs00000345.tga to dogs0345.tga .

Conversely, with Unpad Zero set, zRenamer simply strips all leading zeroes from filenames that fit the Image Filename Pattern. For example, the two following filenames

dogs00034.tga
dogs034.tga

would both become

dogs34.tga

The above screen shows zRenamer configured to remove leading zeros, and since Period On is not set, to remove the period preceding the numeric portion of the filename. So:

cats.00001.tga
cats.00002.tga
cats.00003.tga
.
.
.
cats.00100.tga

would become

cats1.tga
cats2.tga
cats3.tga
.
.
.
cats100.tga

The above screen shows zRenamer configured to remove leading zeros and to preserve (or create) a period before the numeric portion of the filename. So:

cats.0001.tga
cats.0002.tga
cats.0003.tga
.
.
.
cats.0100.tga

would become

cats.1.tga
cats.2.tga
cats.3.tga
.
.
.
cats.100.tga

For a general discussion of this topic, please see Zeroes in Image File Names.


Vol. 2 Samples ] Vol. 1 Samples ] Texturemations Docs Contents ]

copyright Video-Collage Inc.