Automating the Printing Process with the Script File

Raster Image Printer's advanced automation features allow you to accomplish the following workflow-related tasks:

 

perform thread-safe batch printing and workflow management

change driver settings "on the fly" before any print job

display a custom dialog box at the point of print job submission

collect and pass user data to a back-end process

signal events at critical points during the printing process

call functions in a user DLL at critical points during the printing process

 

Automation with the Raster Image Printer uses a script file named PNRAS11S.INI to control the printer settings. A script file will override any settings chosen in the Printing Preferences tabs.

A sample script file is included the \Setups folder created by the installation folder. If you have installed the driver in the default location, the setup files will be located in the following folder:

C:\Program Files\Raster Image Printer 11.0\Setups\PNRAS11S.INI

 

Important Changes for User Moving from Previous Versions of  Raster Image Printer

The script file section names and values have been modified from what was used in earlier versions of Raster Image Printer. These changes were done to accommodate underlying improvements in the software as well as to make the configuration file easier to read.

New sections have been added, some properties have been renamed, moved between sections or removed completely, and some properties now use different values.The topic Important Configuration File Changes includes a table outlining the changes; the table also applies to the script file as both the configuration file and the script file use the same values.

Most older sections, names and values are backwards compatible but it is highly recommended that you update your script file to use the new section, names and values.

 

The default script file provided lists all the settings that can be changed. Normally, you would write to the script file only the settings you need to change. Go to Editing the Configuration File to see a listing of the values you can set in the script file; the script file uses the same values as the configuration file.

When automating, a script file should be dynamically created on an as-needed basis, and then deleted when you are finished with it. A common use of the script file is to change settings in between prints jobs, for example, to customized the name of the file created.

A pseudo-code outline of the process would look like the following:

1.Collect any needed information and create the script file with the necessary settings

2.Print the required document to the Raster Image Printer

3.Wait for the driver to signal that it has read the script file

4.Delete the script file

5.It is now safe to loop to step 1 and convert another file

 

This is only a very simple example. The above steps work for a single-threaded process but extra care must be taken when printing in multiple threads to share access to the script file. For more details on automation see the Raster Image Printer Support and Documentation page.