Command Line

CVSINGLE [-options] infile outfile [tempfolder|qpdfoptions]

Command-Line Options

Command line options fall into two groups.  Options should always be entered as a single string of letters, preceded by a - sign.

The first group of options select alternate methods of processing specific documents:

Ause Acrobat Professional V6-V10 for XIF and non-faxable TIF
Fuse Firefox/Mozilla for HTML documents
Guse Ghostscript instead of Acrobat for PDF and PostScript
Huse Microsoft Word for local HTML instead of IE
Nuse internal converter for HTML/XML instead of IE
Quse internal converter for PDF instead of Acrobat
Suse Star Office or Open Office 2.x instead of Microsoft Office
Xuse Open Office 3 / LibreOffice 3.5 instead of Microsoft Office
Yuse 'save as PDF' for Office 2007 SP2, 2010 and 2013, then internal PDF Converter

The second group modifies whatever processing has been selected:

Ccheck for "this.print" Javascript in a PDF and remove it
Euse the resolution-conversion print driver
Iignore last modification times (HTTP only)
Kset printer to first page size for Adobe conversions
Uset printer to first slide page size for Powerpoint conversions
Vset printer to first worksheet page size for Excel conversions
Wset printer to first page size for Word conversions

Environment Options

It is important to note that in command-line mode, no FS file is present.  Any variables which are needed to further select options are therefore read as environment variables.  The following environment variables affect conversions in command-line mode:

CVTOPTSContains a string of the above option letters, used in addition to those on the command-line
CVT_GLOBAL_NAMESPACEForces the CVSINGLE FFCVRT communication to use the WIndows Global namespace.
NO_CV_PRINTWhen set to a non-empty value, this variable indicates that no conversions will use the Document Converter printer drivers, so CVSINGLE need not check for the presence of a print driver, nor prepare it for use.  Conversions which do require a print driver will fail.
MAXRES_ACTIONDetermines the action to be taken if the resolution has been set to an invalid value, typically as a result of Excel causing it to change.
STAROFFICEPATHOverrides the location of Star Office determined from the registry
OPENOFFICE3PATHOverrides the location of Open Office or Libre Office determined from the registry
CF_UPDATE_LINKSSets a value for the 'update links' parameter in Excel conversions
CVT_XLS_OPTIONSOptions to control worksheet selection
CVSDELAYOption to delay shutdown to allow conversions to complete.
QPDF_OPTIONSOptions for the internal PDF converter. Can also be specified instead of the temp folder.
DEFAULT_CONVERTER_RESSelects the default printer driver resolution setting for the Document Converter print driver.
DEFAULT_CONVERTER_PAGESelects the default printer driver resolution setting (also affects resolution-conversion printer drivers).

Input File

If the input filename starts file:/// then this prefix is removed.  If it starts with http:// or https:// or www. then it is taken to require a web download.  If it starts with ftp:// then is is taken to be an FTP document requiring download.

Output File

The output file must have extension .TIF or .PDF.  The latter is only valid for Office documents and when Office 2007 SP2 or later is installed.  When called from the command-line, the named output file is always deleted before processing.

If the output will be produced using the Document Converter print drivers, either the output file must be on a local path or a temp folder must be supplied.  CVSINGLE will then move the output file to the real destination after conversion.  If a local temp folder is not supplied on the command-line, the local folder set up at system initialization (using SERCONF) or the folder defined by environment variable GFAX, or the Windows temporary folder, is used.