'Convert Image To PDF' - How To (Overview)*

Below is a brief overview of 'Convert Image' usage.  To view the complete and up to date on-line help click the link below:

  Full 'Convert Image To PDF' Documentation

Contents
Using the Graphical User Interface
Using the Command-Line Interface
    Setting Up to run from Command-Line
    Command-Line Syntax
 

Find out how to SAVE 10% on Convert Image To PDF!

Using the Graphical User Interface

Back to the Top

Using the Command-Line Interface

You can bypass Convert Image To PDF's user interface by using the command line feature... much like in the good old DOS days.  This can be accessed in several different ways.  Examples:

	Type your command into a Command Prompt window
	Type your command into the Run window (located on the Start menu)
	Call from a batch (*.BAT) file
	Call from a program you wrote (ShellExecuteAny() WIN32 API, or use the COM/ActiveX interface)

There are two techniques for using 'Convert Image To PDF' from the Command-Line: Issue a Conversion Job command, or a Conversion Task command.  Conversion Jobs use *.SII files, which are built with the Graphical User Interface (GUI).  Once saved, they can be invoked from the GUI or from the Command-Line.  Specifying a conversion Tasks require no previous GUI activity, but do require you to specify your conversion in detail.

Back to the Top

Setting up to run Convert Image To PDF from the Command-Line

Do one of the following:

	Set the path in your environment variables to the location of ConvertITP.exe
	Copy ConvertITP.exe to the same folder that it will be invoked from

Otherwise, you'll see the following error:

"'ConvertITP is not recognized as an internal or external command, operable program or batch file."

Back to the Top

Find out how to SAVE 10% on Convert Image To PDF!

Command Line Syntax

The syntax for specifying a 'Conversion Job'  is:

 ConvertITP /J{ConversionJobFile}  [/V] [/L{LogFile}] [/B{LogToJobFile}]

Items above enclosed in square brackets “[ ]” are optional, all other ‘switches’ are required.  Therefore /J should always be specified on the command line.

 Example:

To run the 'Conversion Job' specified by "C:\MyJobs\convert-tiff-to-pdf.SII" type the following in at the 'Command Prompt':

 ConvertITP /J "C:\MyJobsInDetail\convert-a-tiff-to-pdf.SII"

You can include or exclude spaces between switches and parameters.  For example,  "/F6" is the same as "/F  6".  For long file names you may be required to use double quotes.  For example /J "C:\Program Files\MyApp\convert-tiff-to-pdf.SII".
 

Specifying a 'Conversion Task'
The syntax for the command line for specifying a conversion task is:

ConvertITP /S{Original File(s)} /T{Target File(s)} /F#  [/G]  [/V] [/R] [/L{LogFile}] [/B{LogToJobFile}]  [/+] [/A{PDF Author}]  [/O{PDF Creator}]  [/K{PDF Keywords}] [/U{PDF Subject}] [/I{PDF Title}]

Items above enclosed in square brackets “[ ]” are optional, all other ‘switches’ are required.  Therefore /S, /T, /F# should always be specified on the command line.  There is one exception,  however, and that is when /G (Save to original folder) is specified, the /T switch is not necessary.

You can include or exclude spaces between switches and parameters.  For example,  "/F6" is the same as "/F  6".  For long file names you may be required to use double quotes.  For example /S"C:\Program Files\MyApp\MyImage.JPG".

/S{Original File(s)} is used to specify which files to convert. You can specify a single file, or in some cases a whole set of files using the wildcard syntax (i.e. "C:\MyFiles\*.BMP"). /T{Target files} should always be different from /S{Original File(s)}.

 /T{Target File(s)} is used to specify where to save the converted file(s) to.  You can specify a single file, or in some cases a whole set of files using the wildcard syntax (i.e. "C:\MyFiles\*.BMP").   /T{Target files} should always be different from /S{Original File(s)}.

 [/F#] tells ConvertITP what the original file type is.  Remember the original files are specified by the / S{Original File(s)} switch.  See the File Conversion Constants table below.

 [/V] Verbose mode.  Specify this switch to display a message box indicating how the conversion went.  See also /L

 [/G] Save files to their original folders.  Use this instead of /T to place the converted files in the same folder as the original file.  Cannot be used when converting a single, specified file from within a folder.  Use the /T switch instead.

 [/L{LogFile}] Log file path and name (i.e. d:\mylogs\WCE.LOG) If this switch is specified a log file with the given path and name will be created and the results of the conversion will be written to it.  See also /V

 [/R] Seek out and do all files found in the sub-folders specified in the /S switch.  Recursive subdirectories.  You may add this switch if you are processing whole directories of files.  See /S, /T  and /G for more details on selecting whole directories to be converted.

 [/B{LogToJobFile}]   Save the Log file as a 'Conversion Job' ONLY IF ERRORS OCCURRED.  This is useful if the files that had problems can be done at a later time, or with a different method.  /B is different from /L, since the file generated with /B will not include extraneous comments not allowed in a 'Conversion Job' file.  Save as a .SII file type so it can be loaded as a job.

 [/+] Append (concatenate) image to the end of a PDF file.

[/A{PDF Author}]  Specify the Author property of the PDF file.

[/O{PDF Creator}] Specify the Creator property of the PDF file.

[/K{PDF Keywords}] Specify the Keywords property of the PDF file.

[/U{PDF Subject}] Specify the Subject property of the PDF file.

[/I{PDF Title}] Specify the Title property of the PDF file.