One-Shot Document Conversion
The CVSINGLE program converts any of the supported documents to faxable TIF format. The use of this program avoids the need to create an FS file for processing by FFEXTERN. Because no user profile is available to the conversion process, option settings are made using the command-line options described below.
CVSINGLE requires the Copia Document Converter printer driver to be installed, but if you will only be using it with conversions that do not require the print driver (normally, that would be when used with the internal PDF converter and only for PDF conversion) you can set environment variable NO_CV_PRINT to disable the check.
The output file extension should always be specified as .TIF except as described below.
This program must not be run on the same machine as FFEXTERN and must not be run in a way that could permit multiple instances to be active. For more information, see the description of Document Conversion features.
The command-line options are as follows:
|A||use Acrobat Professional V6/V7/V8 for XIF and non-faxable TIF|
|E||use Resolution Conversion print driver|
|G||use Ghostscript for PDF and PS|
|H||use Microsoft Word for local HTML instead of IE|
|I||use internal PDF converter for images (PNG, JPG, GIF)|
|K||set printer to first page size for Adobe Conversions|
|L||convert attachment from original, not from TIF|
|N||use internal HTML converter instead of IE|
|Q||use internal PDF converter|
|S||use Star Office or Open Office 2.x instead of Microsoft Office|
|U||set printer to first slide page size for Powerpoint conversions|
|V||set printer to first worksheet page size for Excel conversions|
|W||set printer to first page size for Word conversions|
|X||use Open Office 3 / LibreOffice instead of Microsoft Office|
|Y||use intermediate PDF for Office 2007 SP2 and later Office|
When multiple command-line switches are needed, they should be entered as a single string of letters preceded by a '-' sign. CVSINGLE options can also be set using $convert_options, or by placing a string of one or more of the above option letters in environment variable CVTOPTS.
Note that the applicable application must be installed on the machine running CVSINGLE. The tempfolder parameter specifies a temporary local folder into which the printer driver writes its output, before it is copied to the final output file. If not specified, the folder specified at installation as the local copy folder, or that specified by the GFAX environment variable, or the Windows temp folder, is used.
Instead of a temporary folder, you may also specify options for the internal PDF converter, using a string (in double-quotes) starting with QPDF_OPTIONS: and followed by the option keywords. This string, if supplied, overrides other specifications by means of a QPDF_OPTIONS variable. They are ignored unless the -Q or -Y option is also supplied. See the example below.
If Office 2007 (with SP2) or later Office is used for the conversion, the output filename may be specified as .PDF instead of .TIF. This will select the output format as .PDF. Note that if you specify .PDF output for any other conversion type, the conversion will fail.
From release 184.108.40.206 onwards, CVSINGLE returns multiple counts of converted pages on successful conversion, instead of 0. A number such as 100020002 means that 1 .DOC file was produced from a WordMerge save; a 2-page PDF was converted; and a 2-page TIF was created.
Negative values of error levels (-1 to -99) returned by CVSINGLE are now subtracted from 600 to give an outcome code listed in the Fax, Voice and E-Mail Error Codes topic. See also the Document Conversion Errors topic for other conversion errors generated by FFEXTERN.
CVSINGLE "c:\My Documents\Report.doc" @FFBASE\temp\report.tif c:\temp
CVSINGLE -n sample.html sample.tif
CVSINGLE -q sample.pdf sample.tif "QPDF_OPTIONS: edge brightness-10 dither7"
Trace Information When called from FFEXTERN running in Service mode, the CVSINGLE trace lines are written to the FFEXTERN.TRx file and controlled by the FFEXTERN trace settings.