Command line interface

Each tool in the Simple Image Tools suite has a command line interface which you can use to run repetitive tasks unattended. You can then use a scheduling application, e.g. Windows Scheduler, to run the tasks at pre-determined times.

The recommended approach to using the command line interface is as follows:

1.

Use the GUI interface to first select the options you want to use.

2.

Save the options to a file.

3.

Manually adjust the file to fit your requirements where necessary.

The command line interface of each tool requires that you provide it a file containing the settings to use. The easiest way to create this file is to first use the graphical user interface of the relevant tool to set up the settings, then save it to a file. You can then open the file using a text editor, and adjust the settings where necessary.

Once you have set up the settings file, you can use it with the command line interface. The command line interface expects the name of a setting file to be provided as the first parameter. For e.g. to use the command line interface of Image Watermark with a settings file named 'apply_watermarks.txt' stored in the 'g:\settings\' folder, you would enter the following:



You also have the option to log all output from the command line interface to a log file. To do this, use the -L parameter and provide a valid file name. E.g. to log the output from the above process into a file named 'watermark_process.txt' in the 'g:\logs\' folder, you would enter the following:



When the task has completed, the command line interface ends with an exit code. The following are the possible exit codes returned by the command line interface:

Exit code Result Resolution 0 Process ran successfully. N/A. 1 Parameters are incomplete. Provide a settings file name. 2 The entered settings file could not be found. Check that the settings file exists, and that you have access to read it. 3 The settings file is invalid for the current application. Check that the settings file is valid for the current application. Each settings file has a header that tells you which application it was created by. 4 The application encountered errors prior to processing. Load the settings file into the GUI and verify the settings. 5 The application encountered errors during processing. Load the settings file and try running it from within the GUI interface. 6 The log file folder could not be created. Check that you have adequate rights to create the log file folder. 101 The trial period for the application has expired. Purchase a license for the application from http://www.simpleimagetools.com. 102 The application cannot be used with the current license. Use an older version of the application which was released prior to the expiry date of the current license, or purchase a new license from http://www.simpleimagetools.com.