One-Shot Graphical Customization Processor
CFUTIL GCSINGLE inputfile outputfile [FStemplatefile]
This utility processes a single call to the CF9IMAGE 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, GTT | Annotations are applied onto the specified or embedded TIF watermark, and variables may be expanded if an FS file is present |
| TIF | Output is a copy of the input |
| A simple conversion is done, to TIF, using the internal converter. IMAGE_OPTIONS may be specified using a $var_def command in the template file. |
| ASCII | Provided an ASCII_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document. Any file extension other than those above is assumed to be ASCII. |
For PNG, GIF, JPG output, the input file type may be:
| GCT, GTT | Annotations 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. |
| TIF | The output is written as one or more image files. |
| ASCII | Provided an ASCII_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document. Any file extension other than those above is assumed to be ASCII. Then the output is written as one or more image files. |
For PDF output, the input file type may be:
| GCT, GTT | Annotations are applied onto the specified or embedded TIF watermark, and variables may be expanded if an FS file is present |
| GPT | Annotations are applied onto the specified PDF watermark, and variables may be expanded if an FS file is present |
| Output is a copy of the input, but the options in the template file may specify a signature or password. |
| ASCII | Provided an ASCII_PDF_TEMPLATE file is specified on a FAXFACTS.CFG $var_def command, the text is flowed onto the document. Any file extension other than those above is assumed to be ASCII. |
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:
| US 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) |
| A4 size (210 by 197mm), unless the image height is over 12 inches, in which case Legal Size (8.5 by 14 inches) |
| Legal size (8.5 by 14 inches) |
| 8.5 inches wide (US Letter), length depends on TIF image height |
| 210mm 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.
A configuration-file or FST variable named GCS_PDFPATH will override the provided pathname of the output PDF file.
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 re-sized 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 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 CF9IMAGE when called from GCSINGLE are shown in { } brackets in the CopiaFacts engine error list along with their corresponding run-time error values.
Examples:
Test graphical cover:
CFUTIL GCSINGLE MYCOVER.GCT TEST.TIF
Command-line TIF to PDF
CFUTIL GCSINGLE MYFILE.TIF NEWFILE.PDF
