One-Shot Graphical Customization Processor

GCSINGLE inputfile outputfile [FStemplatefile]

This program processes a single call to the CF8GCOVER or CF8GCVPDF graphical customization DLL. It can be used either for previewing/testing graphical customization or for conversion of faxable TIF files to PDF or supported image formats.

Instead of calling this program from the COPIAFACTS engine, consider using the ConvertFile function from the Application Support DLL, which can perform all the same operations.

The following file types are supported:

For TIF output, the input file type may be:

GCT, GTTAnnotations are applied onto the specified or embedded TIF watermark, and variables may be expanded if an FS file is present
TIFOutput is a copy of the input
ASCIIProvided an ASCII_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document
PDFA simple conversion is done, to TIF, using the internal converter.  QPDF_OPTIONS may be specified using a $var_def command in the template file.

For PNG, GIF, JPG output, the input file type may be:

GCT, GTTAnnotations are applied onto the specified or embedded TIF watermark, and variables may be expanded if an FS file is present.  Then the output is written as one or more image files.
TIFThe output is wriiten as one or more image files.
ASCIIProvided an ASCII_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document.  Then the output is written as one or more image files.

For PDF output, the input file type may be:

GCT, GTTAnnotations are applied onto the specified or embedded TIF watermark, and variables may be expanded if an FS file is present
GPTAnnotations are applied onto the specified PDF watermark, and variables may be expanded if an FS file is present
PDFOutput is a copy of the input
ASCIIProvided an ASCII_PDF_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document

For the majority of input TIF files, the image width will be 1728 pixels.  In this case it is necessary to specify whether the output PDF should be created as A4, US Letter, or US Legal size, because all fit in the 1728-pixel width.  The size of an output PDF document is determined by whether the letters P D and F in the output file extension are in upper or lower case:

pdfUS Letter size (8.5 by 11 inches), unless the image height is over 12 inches, in which case Legal Size (8.5 by 14 inches)
PDFA4 size  (210 by 197mm), unless the image height is over 12 inches, in which case Legal Size (8.5 by 14 inches)
pdFLegal size  (8.5 by 14 inches)
Pdf8.5 inches wide (US Letter), length depends on TIF image height
PDf210mm wide (A4), length depends on TIF image height

A configuration-file or FST variable named GCS_PDFEXT will override the provided extension if its value consists of the three characters 'PDF' in some case-combination. Note that this variable does not affect $email_attach conversions to PDF.

For conversion to PDF of valid faxable TIF formats other than 1728 width with 200 or 204 horizontal resolution, the output PDF size will be determined automatically.  Valid ISO and T.30 combinations of width and height for A4, B4 and A3 faxes are recognized, and produce the corresponding page size in the output file. The use of a .Pdf or .PDf extension will cause the output height to depend on the TIF image height: otherwise the output PDF will be scaled to match the ISO document height.  If the width and resolution are not a valid T.30 combination, the image will be resized to a size determined by the file extension as described above.

If the output file has extension GIF, JPG, JPEG or PNG, then the file is converted to the appropriate image type (with any required customization applied) before transmission. Multi-page files become multiple single-page image files with _01, _02, etc. added to the filename part.

If an FST file is present as the third command-line parameter:

if it contains a $fax_user command, the named user properties' $var_def commands are used to supply values for variables named in annotations.

$var_def commands in it are used to supply variable values for variables named in annotations, overriding any of the same name in the UDR/UJP.

if it contains $pdf_secure and $pdf_sign_keyfile commands, these are used to secure and/or sign the PDF, if specified as output.

In the absence of a third command-line parameter only the following variables are expanded:

FAXFACTS.CFG variables

Do not put variables starting PDF_ in the FAXFACTS.CFG file: several are are used internally in this program for signing PDF files.

standard current date and time variables

variables PARAM_4 to PARAM_9 containing the content of GCSINGLE command-line parameters, if present.

GCSINGLE Error Codes:

Error values returned from CF8GCOVER/CF8GCVPDF when called from GCSINGLE are shown in { } brackets in the CopiaFacts engine error list along with their corresponding run-time error values.

Example:

GCSINGLE MYCOVER.GCT TEST.TIF