Difference between revisions of "ReNamer:Pascal Script"

Revision as of 12:27, 13 August 2009

The PascalScript Rule in ReNamer uses Pascal Script component to allow users to program their own renaming rule.

To master Pascal Script, follow these steps:

Learn the basic syntax and concepts of Pascal Script
Understand the specific variables, procedures and functions that are defined within ReNamer
Learn how to use these variables/functions/procedures in scripts

Let us see these steps in more details.

Learn Pascal Script

To learn the basics of Pascal Script, please refer to the Pascal Script Quick Guide.

Types and functions

In this section, we will see all types, procedures and functions which can be used within ReNamer.

Note: Most of these are not part of the "standard" Pascal Script, so you will not find them in other applications.

Script cookbook

In this section, we will see how to write scripts for some common renaming tasks.

They also demonstrate how to use ReNamer's types, procedures and functions.

Scripts at the User Forum

The User Forum contains several ready scripts. Some examples are listed on the Scripts page. Study them and adopt them for your purpose.

Tips

A few quick tips:

In Pascal Script, ReNamer has defined the FileName variable to represent the New Name of the File.
Therefore, in your script, you will have to manipulate this variable to change the filename.
The FilePath constant holds the original path of the file. It allows you to access the file directly.
ReNamer supports UDFs (User-Defined Functions) and also importing of external functions from DLLs.
Try to use WideString type instead of an ordinary String type. This will allow ReNamer to handle Unicode filenames.
(In other words, it will be able to handle non-English scripts, such as Cyrillic, Asian, German, French, etc.)

Warning: Do not override ReNamer's built-in variables, types and functions.

Warning: Some of the functions are able to alter your file system (create new folders, move files, etc.). So use them with caution!
Remember that scripts are executed during Preview (and NOT Rename) operation. So you let the script to alter your system by pressing Preview or having AutoPreview on.

Note: The only product of PascalScript that doesn't affect your files until Rename operation is the content of the FileName variable. "New Name" (and "New Path") fields of filetable are replaced with this variable content. After Preview you may check if you like them and if you do - press Rename. Only then the actual renaming of the files will take place.

External links

RemObjects Pascal Script

Developers of the Pascal Script component.

Delphi Basics

Help and reference for the fundamentals of the Delphi/Pascal language.

@@ Line 57: / Line 57: @@
 <span style="color: red">'''Warning:''' Some of the functions are able to alter your file system (create new folders, move files, etc.). So use them with caution!<br>Remember that scripts are executed during Preview (and NOT Rename) operation. So you let the script to alter your system by pressing Preview or having AutoPreview on.</span>
-<span style="color: red">'''Warning:''' The only product of PascalScript that doesn't affect your files until Rename operation is the content of the FileName variable. "New Name" (and "New Path") fields of filetable are replaced with this variable content. After Preview you may check if you like them and if you do - press Rename. Only then the actual renaming of the files will take place.</span>
+<span style="color: red">Note:</span> The only product of PascalScript that doesn't affect your files until Rename operation is the content of the FileName variable. "New Name" (and "New Path") fields of filetable are replaced with this variable content. After Preview you may check if you like them and if you do - press Rename. Only then the actual renaming of the files will take place.
 == External links ==