User Interface

DocOrigin ConfigEditor provides a Microsoft Windows user interface that lets you create or modify the configuration files for printers or PDF.

The ConfigEditor Main Window

For a new configuration, defaults to the selected printer name, which may be changed.
To select a font for availability in Design and Merge, check the box.
To indicate whether a font's resident in the printer (), right-click on the font name and click Printer Resident Font.
For a configuration, defaults to the selected printer name.
To select an entry, check the box.
To review or modify an entry, double-click the entry, OR click the entry, and click the appropriate Format menu command.
To add a new entry, click the appropriate Insert menu command.
Enter the appropriate values, and check the applicable options.

Setting	Description
Windows printer name	Name of a Windows printer driver resident on the computer, populated when a new configuration file is created. To create a configuration file for a Windows printer driver, click File - New. In the Print dialog, select the appropriate printer, and click OK to populate the Windows printer name. ConfigEditor queries the driver for many of the available values, such as available and/or resident True Type fonts. These values will be used to populate the ConfigEditor user interface.
Configuration file title	Descriptive name for the configuration file.
Fonts	List of all Windows fonts currently installed on the computer. Fonts for use in Design and Merge must be explicitly selected. Fonts can be flagged as "printer resident", which indicates to Merge that the font is available from the printer; therefore, it does not have to be downloaded to the printer or embedded in a PDF file. To select or clear the setting, right-click on the font name and click "Printer Resident Font". When the setting is selected, a printer symbol appears between the check box and font name.
Paper Sizes	Available paper sizes. Settings: ID is an internal code that tells Merge how to request this page size in the printer. Width and Height are the full page paper size; typically, these are not changed. In most cases, the settings are fixed for each unique ID value. Margins specify the non-printable area of the page. Modify the top-left position to move the printed image on the printed page. The top and bottom margins will affect how the Merge pagination logic will split overflowing pages. Printer request sequence, when specified, will override the default paper/page select sequence that is sent to the printer. The default PCL escape sequence is: `\033&1%dA` in which `%d` is replaced by the assigned paper size ID. For standard paper sizes, the automatically supplied IDs correspond to the paper size needed in this PCL request sequence. For custom paper sizes, in PCL, the escape sequence should be `\033&l101A`, since `101` is PCL for "Custom Page Size". Your printer may support other built-in page sizes with assigned IDs. If so, you should use that ID for its paper size definition.
Output Bins	Used for printers with multiple output bin selections. This setting is not used by the PDF driver. Settings: ID is a unique integer, less than 1000. Display name is the output bin name that appears in Design. Printer request sequence, when specified, will override the default select sequence that is sent to the printer. For PCL, the standard output bin selection sequence is `\033&l%dG` where `%d` is replaced by the associated output bin ID.
Input Trays	Printer paper trays from which the paper will feed the printer. Settings: ID must be a unique integer, less than 1000. Display name is the input tray name that appears in Design. Printer request sequence, when specified, will override the default select sequence that is sent to the printer. For PCL, the standard input tray selection sequence is `\033&l%dH` where `%d` is replaced by the associated tray ID.
Paper Types	Weights and types of paper that the printer will handle. For PCL, the standard printer request sequence is `\033&n%dWd%s` where `%s` is the name of the paper type, e.g. Bond, Plain, ..., and the %d is the length of that name plus one.
PrinterID	A unique name for this configuration file. This is the printer name that must be specified in the `_printer` script functions of Merge.
Print Driver	Type of driver; select the appropriate value from the drop-list.
DPI	Applies to printer output only. Specifies the dots-per-inch resolution of the printer. Note that increasing the resolution will increase the amount of data for raster images that is sent to the printer.
Duplex	Indicates whether the device can print on both sides of a page. When checked, enables the form designer to specify duplex printing in Design.
Color	Applies to printer output only. Indicates whether the printer can handle color printing. When not checked, Merge will convert full color images to monochrome prior for printing.
Combine Documents	Merge is capable of processing multiple sets of data and forms in a single run. When checked, the resulting output will be combined into one large multi-document file or print job; when not checked, the output will be broken into individual documents. When this setting is not checked and Merge will produce multiple documents to disk files, set the `OverwriteFile` property to "N" (No). This ensures that each document is written to a separate disk file (an integer sequence number is appended until a unique name is constructed). Click `Format - Advanced Properties` to set the `OverwriteFile` property.
Output Location	Default location where Merge will write the document to be output. This name is a "template". It can have many dynamic substitution elements in it. See File Naming Conventions.

PCL Printer request sequences: It's really best to have printer-specific information if you are doing anything out of the ordinary. Hopefully, such manuals will advise you of the needed request sequences. As a good start, Google "pcl technical reference manual", and that should suffice for most things. Custom Page size setting seems particularly problematic. Check with your printer! A good try would be to compute your page size in decipoints (inches x 72 x 10). Then use \033&fwwwihhhJ\033&l101A. The &f sets the page size (at least on some printers), and the &l101 says it is a custom page size. So even if you had chosen a page size ID of 427, you would still use &l101. The standard page size printer request sequences are handled automatically.

Typeface Substitutions

There may be circumstances where a shared form may require one or more fonts that are not available either on a user's computer or on the target printer. The Typeface Substitutions command in the Format menu enables you to create a list of substitutions that Merge will use in these situations.

Initially, no substitutions are defined.

To add an entry, click Insert or right-mouse click in the dialog and click Insert new Mapping...

Enter the Original typeface and substitution typeface name.

The added entries are added to the list, three typeface substitutions are shown in the sample below.

To delete a substitution, click on the substitution typeface and click Delete.

To delete a typeface and all of its substitutions, click on the substitution typeface and click Delete.

Any number of substitutions may be associated with a typeface, by clicking on the appropriate typeface and adding an entry. Each substitution is placed at the bottom of the list for the typeface. In the event that a substitution typeface is required, the order of precedence is the list order.

Advanced Properties

The Advanced Properties command on the Format menu allows changes to some additional configuration file settings. These settings will rarely require modification.

Note that not all of the following properties are available for every printer ConfigEditor displays only those that are relevant for the current device.

Category	Property and Description
2 of 5 Barcode	Barcode25AddCheckSum indicates whether to automatically add a checksum digit at the end of the barcode. Value: Y or N Barcode25Ratio is the ratio of wide to narrow bars. Value: An integer Barcode25Text indicates whether to display human-readable text below the barcode. Value: Y or N
3 of 9 Barcode	Barcode39Text indicates whether to display human-readable text below the barcode. Value: Y or N Barcode39Ratio is the ratio of wide to narrow bars. Default is 3. Value: An integer
Bolding	SynthBold is the degree of artificial bolding used when bold versions of fonts are defined but are not available in an actual bold font. Merge can bold a regular font by "thickening" the letter in its print drivers.
Check Box	CheckboxShape is the shape of all check boxes on the form. Value: Circle, Square or None CheckboxSize is the size of the check box, in inches. When set to zero or left blank, the size of the check box is the font size specified for the field in Design. Value: A number CheckboxStyle is the appearance of the check box for each state (checked or unchecked). Value: Fill - sets a solid color when checked, and empty when unchecked Check - sets a checkmark when checked, and empty when unchecked xy - a string of 2 characters sets the check box to the first character when checked, and to the second character when unchecked. When only 1 character is specified, set the check box to the character when checked, empty when unchecked.
Font Embedding	EmbedFonts indicates whether a non-printer resident font encountered in the document should be downloaded to a printer or embedded in a PDF. Value: Y or N
Overwrite File	OverwriteFile indicates whether an output file created by Merge (PDF or printing to a file) will be overwritten when a file of the specified name already exists. Value: Y or N When set to "N", the file will be made unique by appending a number to the end of the file name. For example, when "N" is specified, and a file named "myfile.pdf" already exists, Merge will try "myfile_1.pdf", "myfile_2.pdf" and so on, until it finds a file name that doesn't already exist.
PDF Bookmark	Bookmark indicates whether to generate bookmarks in PDF files. Applies only to documents output to PDF files. Value: Y or N
PDF Viewer Preferences	ViewPreferences specifies PDF viewer settings as per the "Interactive Features" section of the PDF Reference manual, version 1.7 which is available online from Adobe (www.adobe.com ) or AIIM (www.aiim.org).
QR Code Barcode	QRCodeCharacterSet is the default character set encoding for QR Code barcodes. Value: Alphanumeric, Numeric, 8Bit or Kanji QRCodeLevel is the default QR Code error correction level. See the QR Code documentation for details. Value: L, M, H or Q QRCodeMode is the default QR Code character mode. See the QR Code documentation for details.
Radio Button	RadioButtonShape is the shape of all radio buttons on the form. Value: Circle or Square RadioButtonSize is the size of the radio button box, in inches. If set to zero or left blank, the size of the radio button is set to the font size specified for the field in Design. Value: A number RadioButtonStyle is the appearance of the radio button for each state (selected or not selected). Value: Fill - sets a solid color when selected, and empty when not selected Check - sets a checkmark when selected, and empty when not selected xy - a string of 2 characters sets the radio button to the first character when selected, and to the second character when not selected. When only 1 character is specified, set the radio button to the character when selected, empty when not selected.
Word-wrap Text	SplitWord is the action to take when a text string (from a label or field) with word-wrapping cannot fit on the line even when split at normal word-break positions. Value: Y - specifies the word will be split, or N - specifies the word will be allowed to overflow to the right

.prt Override

Merge uses a series of command-line options to customize and control its operation. Several of these command-line options will override the equivalent setting in the printer configuration file. For a list of these particular command-line options, see Command Options - Merge, Printer Options.