Navigation:  Programs > Command-Line Utilities >

GCSINGLE

Previous pageReturn to chapter overviewNext page

One-Shot Graphical Customisation Processor

GCSINGLE inputfile outputfile


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

The input file can be a .GCT file, a .GTT file, or a .TIF file. In the last case the file is processed as if it were a watermark file in a GCT with no annotations. The output format is determined by the file extension of the output filename.

If the filename specifies a .GCT or .GTT file and the output file has a TIF extension, then the file is converted to TIF (with any required customization applied) before transmission.

If the filename specifies a .TIF, .GCT or .GTT file and the output file has a PDF extension, then the file is converted to PDF (with any required customization applied) before transmission. The temporary PDF file is created in the same place as graphical customization TIF files. The size of the resulting 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, length depends on TIF image height
PDf210mm wide, length depends on TIF image height

If the filename specifies a .TIF, .GCT or .GTT file and 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. The document dimensions are preserved.

Note that NO variables are expanded during GCT or GTT processing, since no context is available from which to expand them.

GCSINGLE Error Codes:

Error values returned from F7GCOVER 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

 


Topic url: http://www.copia.com/support/refmanual/index.html?gcsingle.htm