How to Debug a Filter Script

Video Transcript

Welcome to the video tutorial on how to debug a filter script. In this tutorial, we'll be going over how to place your filter script in debug mode, so you can determine precisely what your filter script is doing, and potentially modify its behavior.

The first step in placing the filter in debug mode is to set the Debug tag to True. Open the XML file for your script and set: True.

Next, you'll need to rename the batch file you're using to put it into 'verbose' mode. If you're using preproc.bat, rename it to preprocv.bat. If you're using pstproc.bat, rename it to pstprocv.bat. The "v" in the file name stands for Verbose.

Setting Debug to True and renaming the batch file appropriately puts the script in to debugging mode. The final step is to be sure that PageGate is running as an application, rather than a system service. This allows PageGate's processes to interact with the Windows desktop and display necessary debugging information.

To switch PageGate's run style, right click on the shortcut for PG Admin and select 'Run as Administrator'. Then go to Program – Settings and select Application, then click Apply.

When in debugging mode, the script will display a command window that shows the result of every operation of your filter script. Be sure to take the filter script out of debug mode before using it in a production environment.

This concludes the video tutorial on how to debug your filter script.