Output Format Prefixes

Output formats supported by TFORMer.

Overview

The term printing is used whenever TFORMer generates output. By default the generated output is sent directly to a printer (hence the name), but the output can also be stored in files or generated as an in-memory stream.

TFORMer supports two methods for selecting the output format:

• If called with a prefix for the output format (see table below), setPrinterName sets type and destination of the output. If the target name is specified without any prefix, TFORMer assumes that the output should be printed directly onto this printer.
• As an alternative to setPrinterName you may use both setPrinterType and setOutputName.

Example

To generate output as a PDF document named out.pdf in some temp directory, do the following:

  // Select PDF output to /temp/out.pdf with the PDFFILE prefix
  printJob.setPrinterName ( "PDFFILE:/temp/out.pdf" );

which is equivalent to:

  // Select PDF output to /temp/out.pdf with setPrinterType and setOutputName
  printJob.setPrinterType ( EPrinterType.PDFFile );
  printJob.setOutputName  ( "/temp/out.pdf" );

By using suitable prefixes (see table below) the output format can be adjusted.

Output Format Prefixes

Output Formats and Devices

Prefix	Example	Description
No Prefix	HP4050PS	Direct printing to the specified printer. Supply a printer name as defined on Windows or Linux/UNIX (CUPS). Use "\\server\printername" for shared network printers, "printername" for local printers or null for the default printer. Please note: On Windows the PrinterType Win32 is used (direct printing via GDI-calls). On Linux/UNIX the PrinterType Cups is used (same as the PostScriptPrinter type).
PDFFile:	PDFFile:C:\Temp\out.pdf	PDF-output is stored in C:\temp\out.pdf
PDF:	PDF:C:\Temp\out.pdf	PDF-output is stored in C:\temp\out.pdf
PDFA:	PDFA:C:\Temp\out.pdf	PDF/A-output is stored in C:\temp\out.pdf
HTML:	HTML:C:\Temp\out.html	HTML-output stored in C:\temp\out.html and automatically named subfolders
PS:	PS:C:\Temp\out.ps	PostScript-output is stored in C:\temp\out.ps
PSPRINTER:	PSPRINTER:HP4050PS	Direct printing to the printer specified. Because the output format is already PostScript a generic ASCII printer driver must be used.
TXT:	TXT:C:\temp\out.txt	Plain text output is stored in C:\temp\out.txt
TXTPRINTER:	TXTPRINTER:ZEBRA4M	Direct printing to the printer specified. Because the output format is plain text which may contain printer control sequences a generic ASCII printer driver must be used.
REPO:	REPO:PrinterName	Direct printing to the printer specified in the Repository.
IMGBMP:	IMGBMP:C:\temp\out.bmp	The BMP image file named out.bmp is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.bmp). As an alternative you can use the # character as placeholder for the page number: e.g. out###.bmp
IMGGIF:	IMGGIF:C:\temp\out.gif	The GIF image file named out.gif is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.gif). As an alternative you can use the # character as placeholder for the page number: e.g. out###.gif
IMGJPG:	IMGJPG:C:\temp\out.jpg	The JPG image file named out.jpg is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.jpg). As an alternative you can use the # character as placeholder for the page number: e.g. out###.jpg
IMGPCX:	IMGPCX:C:\temp\out.pcx	The PCX image file named out.pcx is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.pcx). As an alternative you can use the # character as placeholder for the page number: e.g. out###.pcx
IMGPNG:	IMGPNG:C:\temp\out.png	The PNG image file named out.png is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.png). As an alternative you can use the # character as placeholder for the page number: e.g. out###.png
IMGTGA:	IMGTGA:C:\temp\out.tga	The TGA image file named out.tga is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.tga). As an alternative you can use the # character as placeholder for the page number: e.g. out###.tga
IMGTIF:	IMGTIF:C:\temp\out.tif	The TIF image file named out.tif is stored in C:\temp. If the output consists of multiple pages, multiple output files are generated. In this case the page number is appended to the filename (e.g. out_001.tif). As an alternative you can use the # character as placeholder for the page number: e.g. out###.tif
IMGMULTITIF:	IMGMULTITIF:C:\temp\out.tif	The TIF image file named out.tif is stored in C:\temp. All pages are stored in a single output file.
ZPL:	ZPL:C:\temp\out.zpl	ZPL-II output (suitable for ZEBRA printers) is stored in C:\temp\out.zpl.
ZPLPRINTER:	ZPLPRINTER:ZEBRA4M	Direct printing in ZPL-II format to the operating system printer named ZEBRA4M. Because the output format is already ZPL-II, a generic ASCII printer driver must be used. This output type is supported under Microsoft Windows only.
ZUGFERD:	ZUGFERD:C:\Temp\out.pdf	ZUGFeRD-output is stored in C:\temp\out.pdf. Requires an additional ZUGFeRD-invoice.xml provided either using the SDK-option zugferd-xml (Print Options) or using the report property ZUGFeRD-XML.
SVG:	SVG:C:\Temp\out.svg	SVG-output is stored in C:\temp\out.svg.
SVGZ:	SVG:C:\Temp\out.svgz	SVGZ-output is stored in C:\temp\out.svgz.