Description of the INI file values

[Default Settings]

Paper Size=<number>

The Windows operating system has 335 paper size definitions.

The  custom paper size definition starts at 336 for “WindowsPaperCode”; If one adds another custom paper size, the number must be increased; each additional custom paper size is 336, 337,... n
If a new custom paper is added, do not forget to increment the 'Number of Paper Sizes' entry.

Black Ice Software printer driver INI file contain 178 paper size definition in the INI file. Paper1, Paper2, … Paper178.

The first custom paper size definition is “Paper179” prefix. For example, if one adds one more custom paper size, the prefix must be Paper179.

Paper Width=<number>

The length of the paper in tenths of a millimeter. Must be specified if Variable Paper size selected. Value can be between 1 and 65535.

Paper Length=<number>

The length of the paper in tents of millimeter. Must be specified if Variable Paper size selected. Value can be between 1 and 65535.

X DPI =<number>

The horizontal DPI of the image. Can be a value between 1 and 1500.

Y DPI =<number>

The vertical DPI of the image. Can be a value between 1 and 1500.

Rotation=<number>

Sets the angle of page rotation in degrees, counter-clockwise. Only multiples of 90 are supported, and can be one of the following values: 0, 90, 180, 270.

File Format=<number>

The output file format for the printer. For configuring a file format in the Printer Driver INI file, please use the desired file format Value in the Printer Driver INI file for the File Format INI file key.

For example, for the PDF file format:

File Format=36

The value can be one of the following:

The “G4 Multi Page”, “G4 Single Page”, “G3 Multi Page”, “G3 Single Page”, “No Compress Multi Page”, and “No Compress Single Page” options are hidden by default. These file formats can be enabled in the [UI FileFormats] section of the INI file.

Selecting the “G4 Multi Page”, “G3 Multi Page”, or “No Compress Multi Page” file formats automatically turns off the “Save each page as separate file” option to create a multi-page document.

Selecting the “G4 Single Page”, “G3 Single Page”, or “No Compress Single Page” file formats automatically turns on the “Save each page as separate file” option, to create single-page files.

Otherwise the “G4 Multi Page” and “G4 Single Page” formats are the same as the “TIFF Group 4” format, the “G3 Multi Page” and “G3 Single Page” formats are the same as the “TIFF Group 3, 1 Dimension” format, and the “No Compress Multi Page” and “No Compress Single Page” formats are the same as the “TIFF Uncompressed” format.

Orientation=<number>

The orientation of the paper. Set <number> to 1 for portrait or 2 for landscape.

BitsPerPixel=<number>

The values of the BitsPerPixel can be 1, 8, 8gray, or 24

Antialiasing=<number>

Sets the Antialiasing Mode the driver uses for rendering text for image output file formats. Text antialiasing is for Grayscale and Color output formats. For 1-bit black and white documents, the Auto (4) or None (0) options should be used; otherwise, jagged edges will appear on the rendered characters. The following values are available:

0: None - Turns off text antialiasing.

1: Normal - Uses the default antialiasing method. This method is not recommended for 1-bit black and white output formats.

2: ClearType - Uses Microsoft ClearType antialiasing for fonts. This method uses sub-pixel rendering, and it is meant to be used for output images that will be displayed on computer screens at 100% size. This method is not recommended for 1-bit black and white output formats.

3: Legacy - Emulates the behavior of Black Ice Printer Drivers before version 14.99. This method is not recommended for 1-bit black and white output formats.

4: Automatically selects the best antialiasing method based on output format and resolution. Antialiasing is disabled for 1 bit black and white documents. For 8 or 24-bit documents that have a resolution below 150 DPI, ClearType antialiasing is used. For 8 or 24-bit documents that have a resolution of 150 DPI or above, normal antialiasing is used. The printing application can change the antialiasing method on a per-font basis during printing, but antialiasing for 1-bit output formats is not allowed. (default value)

Create Faxable Image=<1 or 0>

Enables or disables the "Create faxable image" option in the Printer Driver on the Device Settings tab.

If enabled, the printer driver forces the fax optimized resolution selected with the "Fax Output Mode" option.

Available for Printers: ColorPlus, TIFF\Monochrome

Available values:

0: Disable the "Create faxable image" option (default)

1: Enable the "Create faxable image" option

Fax Output Mode=<Number>

Selects the fax resolution if the "Create faxable image" option is enabled.

Available for Printers: ColorPlus, TIFF\Monochrome

Available values:

0: "204x196 DPI Fine Fax" option

1: "204x196 DPI Fine Fax Compatibility" option - This resolution is 200 x 200 dpi internally for the printing application, but the image is scaled to 204 x 196 dpi. (default)

2: "204x98 DPI Standard Fax" option

3: "204x98 DPI Standard Fax Compatibility" option - This resolution is 204 x 204 dpi internally for the printing application, but the image is scaled to 204 x 98 dpi.

4: "204x196 DPI Fine Fax Downscaled" option - This resolution is 600 x 600 dpi internally for the printing application, but the image is scaled to 204 x 196 dpi.

Internet TIFF Format=<1 or 0>

Enables or disables the "Internet TIFF Format" option in the Printer Driver on the File Formats tab in "TIFF settings...".

Available for Printers: ColorPlus, TIFF\Monochrome

RFC 2301 File Format for Internet Fax (chapter 3).

Available values:

0: Disable the "Internet TIFF Format" option (default)

1: Enable the "Internet TIFF Format" option

Add Page Numbering Tag to TIFF=<1 or 0>

Enables or disables the "Add Page Numbering Tag" option in the Printer Driver on the File Formats tab in "TIFF settings..." .

If this box is checked, the driver sets the page number tag of every page in the output TIFF file.

Available for Printers: ColorPlus, TIFF\Monochrome

Available values:

0: Disable the "Add Page Numbering Tag" option (default)

1: Enable the "Add Page Numbering Tag" option

Reverse Bit Order in TIFF=<1 or 0>

Enables or disables the "Reverse Bit Order in TIFF" option in the Printer Driver on the File Formats tab in "TIFF settings..." .

If this box is checked, the driver saves TIFF images with reverse bit order and also sets the value of the FILLORDER tag in the image file to Reverse.

Available for Printers: ColorPlus, TIFF\Monochrome

Available values:

0: Disable the "Reverse Bit Order in TIFF" option (default)

1: Enable the "Reverse Bit Order in TIFF" option

Save Each Page as Separate File=<1 or 0>

Enables or disables the "Save each page as separate file" option in the Printer Driver on the File Formats tab.

When the Save each page as a separate file option is selected, the driver saves every page of a multipage document into a separate file.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Save each page as separate file" option (default)

1: Enables the "Save each page as separate file" option

Unicode Support=<1 or 0>

Enables or disables the "Unicode/Eastern Character Support" in the Printer Driver for the OCR. This flag is only used for the OCR feature in 14.56 and in newer versions. For Text Output, please use the Encoding INI file key under [Text Output Settings].

Available for Printers: Color, ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Unicode/Eastern Character Support" (default)

1: Enable the "Unicode/Eastern Character Support"

Disable Output File=<1 or 0>

Enables or disables the "Disable output file" option in the Printer Driver on the File Formats tab.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Enables the Printer Driver output ("Disable output file" option unchecked) (default)

1: Disables the Printer Driver output ("Disable output file" option checked)

Enable Group File=<1 or 0>

Enables or disables the Group File Generation in the Printer Driver. ("Enable Group File" option in the Printing Preferences on the Filename Generation tab.)

Group files contain information about the processed print job, including the name of the generated output file(s), any errors that occurred during printing, and specifics about the print job.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable Group File generation ("Enable Group File" option unchecked) (default)

1: Enable Group File generation ("Enable Group File" option checked)

Write Number of Copies to Group File=<1 or 0>

When enabled, the printer driver writes the "Number of Copies" value that was set in the printing application into the Group File.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not write the "Number of Copies" key into the Group file

1: Write the "Number of Copies" key into the Group file (default)

Enable Messaging Interface=<1 or 0>

Enables or disables the "Disable the Messaging Interface" option in the Printer Driver on the Start Application tab.

If the option is enabled, the printer driver will broadcast messages.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the Messaging Interface ("Enable the Messaging Interface" option checked)

1: Enable the Messaging Interface ("Enable the Messaging Interface" option unchecked) (default)

Enable TIFF DLL=<1 or 0>

Enable or disable the use of the TIFF32.dll.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the use of the TIFF32.dll

1: Enable the use of the TIFF32.dll (default)

Enable JPEG DLL=<1 or 0>

Enable or disables the use of the JPEG32.dll.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the use of the JPEG32.dll

1: Enable the use of the JPEG32.dll (default)

Overwrite Existing Files=<1 or 0>

Enables or disables the "Overwrite Existing Files" option in the Printer Driver on the Filename Generation tab.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Overwrite Existing Files" option (default)

1: Enable the "Overwrite Existing Files" option

Rotate Landscape Image to Portrait=<1 or 0>

Enables or disables the "Rotate Landscape image to Portrait" option in the Printer Driver on the Device Settings tab.

When landscape mode is selected, this rotates the generated landscape image 90 degrees so it can be printed on a portrait page.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Rotate Landscape image to Portrait" option (default)

1: Enable the "Rotate Landscape image to Portrait" option

Merge Multiple Documents=<1 or 0>

Enables or disables the "Combine/Merge multiple documents into a single file" option in the Printer Driver on the Filename Generation tab.

Black Ice Printer Drivers offer a user-friendly way to merge/combine multiple print jobs into a multipage PDF or TIFF file.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Combine/Merge multiple documents into a single file" option (default)

1: Enable the "Combine/Merge multiple documents into a single file" option

Use Custom Extension=<1 or 0>

Enables or disables the "Use custom extension" option in the Printer Driver on the Filename Generation tab when using "Use the prefix and extension".

Changing the extension to another file format does not change the output file format, only the output filename. For example, entering PDF as a custom extension does not create a PDF file; only the filename ends with .PDF.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Use custom extension" option (default)

1: Enable the "Use custom extension" option

Force Paper Size=<1 or 0>

Enables or disables the "Force Printer Size" option in the Printer Driver. When enabled, the documents will always be printed using the paper size and resolution settings specified in the INI file or in the Printing Preferences page of the Printer Driver, regardless of the Paper size and DPI settings of the application. This option is intended to be used with certain applications that ignores the user’s paper settings or if an application unable to print the target paper size. Not recommended for general use.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Force Printer Size" option (default)

1: Enable the "Force Printer Size" option

Force Printer DPI=<1 or 0>

Enables or disables the "Force Printer DPI" option in the Printer Driver on the Device Settings tab. When enabled, the documents will always be printed using the printer's resolution, regardless of the DPI setting stored in the document.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Force Printer DPI" option (default)

1: Enable the "Force Printer DPI" option

Ignore Application Devmode=<1 or 0>

If the value is 0 or missing, the driver will use the devmode provided by the printing application. If the value is set to 1, the settings provided by the printing application will be ignored, and the printing user's settings will be used.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Ignore Application Devmode" option (default)

1: Enable the "Ignore Application Devmode" option

Ignore Application DPI=<1 or 0>

To enable the "Ignore Application DPI" the "Ignore Application Devmode" has to be set too. If this section is not present, or if the value is 0, the driver will use the DPI provided by the printing application. If the value is set to 1, the settings provided by the printing application will be ignored, and the printing user's settings will be used.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Ignore Application DPI" option (default)

1: Enable the "Ignore Application DPI" option

Generate Output in Memory=<1 or 0>

Enables or disables the "Generate output in memory" option in the Printer Driver on the File Format tab. If the Generate Output in Memory is enabled, the driver will generate the output in memory only; the driver will not write an output file.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Generate output in memory" option (default)

1: Enable the "Generate output in memory" option

Print Pages Inverted=<1 or 0>

Enables or disables the "Print page(s) inverted" option in the Printer Driver on the File Formats tab. This feature is not supported when using the PDF, HTML, XML or EMF output file format.

The Print page(s) inverted function inverts each pixel of an image from black to white or from white to black. Only available in 1 bit Color Depth mode.

Available for Printers: ColorPlus

Available values:

0: Disable the "Print page(s) inverted" option (default)

1: Enable the "Print page(s) inverted" option

Flip Pages Horizontally=<1 or 0>

Enables or disables the "Flip page(s) horizontally" option in the Printer Driver on the File Formats tab. This feature is not supported when using the HTML, XML or EMF output file format.

Checking the Flip page(s) horizontally option causes the driver to print documents horizontally flipped.

Available for Printers: ColorPlus

Available values:

0: Disable the "Flip page(s) horizontally" option (default)

1: Enable the "Flip page(s) horizontally" option

Flip Pages Vertically=<1 or 0>

Enables or disables the "Flip page(s) vertically" option in the Printer Driver on the File Formats tab. This feature is not supported when using the HTML, XML or EMF output file format.

Checking the Flip page(s) vertically option causes the driver to print documents vertically flipped.

Available for Printers: ColorPlus

Available values:

0: Disable the "Flip page(s) vertically" option (default)

1: Enable the "Flip page(s) vertically" option

Save As Option=<1 or 0>

Enables or disables the "Save As Option" option in the Printer Driver on the Filename Generation tab.

When the Enable Save As Option is selected in the Printing Preferences or Black Ice Printer Manager, the Save As dialog is displayed each time before printing the file.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Save As Option" option (default)

1: Enable the "Save As Option" option

Brightness=<number>

The brightness value for the image. Can be a value between 1 and 199.

PaperWidthInPixels=<number>

Specify the paper width in pixels when Variable Paper Size In Pixels is set for the paper size. Can be a value between 1 and 65535.

PaperHeightInPixels=<number>

Specify the paper height in pixels when Variable Paper Size In Pixels is set for the paper size. Can be a value between 1 and 65535.

FAXheader=<number>

The size in pixels for the fax header. Can be a value between 0 and 65535.

LossRatio=<number>

The loss ratio setting for the JPEG images. Can be a value between 0 and 100. Used only by the color driver.

Dithering=<number>

Set the dithering method. The value can be:

FileNameGenerationFlags=<number>

Set the file name generation method. The value can be:

NOTE: The INI file location must be configured at the INIFileName INI file flag in the Printer Driver INI file with full path.

The configured INI file for the INIFileName flag must contain the following information:

[Black Ice PDF X1]
OutputDirectory=C:\temp

NOTE: Black Ice PDF X1 must be substituted with the Printer Driver’s name.

Remove Text from Document Name=<string>

Sets a text that will be automatically removed from the document name by the driver when printing. The Printer Driver will remove the given text from the filename of the output document when printing. If the filename does not contain the given text, the filename of the output document remains the original document name. The “Use the document name” file name generation method must be used. The text is case sensitive. The maximum length is 259 characters.

Enable Merge Window=<1 or 0>

Enables or disables the “Merge Documents” window in the Printer Driver. If the “Enable Merge Window” is set to 1, the “Merge Documents” window will appear during printing. To merge documents silently in the background, set the “Merge Multiple Documents” IN file value to 1, and disable the “Merge Documents” window by setting “Enable Merge Window” to 0.

Available values:

0: Disable the Merge Documents window (default)

1: Enable the Merge Documents window

Merge Window Timeout=<number>

Specifies the Merge Window Timeout in minutes.

The merge window timeout is necessary to prevent blocking other users from printing to the printer.

Default value: 10 (10 minutes)

Maximum value: 1440 (24 hours). Printer Drivers version 17.91 and older accept a maximum value of 60 (1 hour).

FileNamePrefix=AAA

Sets the prefix for the generated file. Can be a maximum of 3 characters.

FileExtension=TIF

Sets the extension for the generated file. Can be a maximum of 3 characters.

Uppercase Extensions=<1 or 0>

Since printer driver version 15.80, the printer driver writes lowercase extensions by default. If the “Uppercase Extensions” option is set to 1, the driver will use uppercase extensions.

Available values:

0: Use lowercase extensions (default)

1: Use uppercase extensions

INIFileName=<string>

This will specify the name of the INI file if the File Generation Method is “Prefix and extension from the INI file”, “Exact Filename from INI”, or “Use the document name with the output directory from the INI file”

If the File Generation Method is “Prefix and extension from the Registry” or “Exact Filename from the registry”, this will represent the registry key.

FixedFileName=<string>

This is the name of the file to be generated by the printer driver if the File Generation Method is “Exact filename”

Custom Filename template=<string>

This is the file name template to be used for generating the output filename when the filename generation method is ‘Custom file naming’. The filename template has to be valid.

Read Directory From INI File=<1 or 0>

This option configures the Use output folder from INI file in the Printer Driver Filename Generation tab, under Custom file naming.

Possible values:

1: The Printer Driver will use the output folder from the INI file

0: The Printer Driver will ignore the INI file and use the Output Directory under the Filename Generation tab.

NOTE: The INI file location must be configured at the INIFileName INI file flag in the Printer Driver INI file with full path.

The configured INI file for the INIFileName flag must contain the following information:

[Black Ice PDF X1]
OutputDirectory=C:\temp

NOTE: Black Ice PDF X1 must be substituted with the Printer Driver’s name.

ApplicationPath=<string>

Full path and filename for the start application to be launched by the printer driver. The ApplicationPath parameter can also be configured by using a valid environment variable.

Enable Start Application=<1 or 0>

Enables or disables the "Start Application" option in the Printer Driver.

If enabled, the user can specify an application that the driver should launch.

The application can capture the printed document and parameters passed by the printer driver.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Enable Start Application" option (default)

1: Enable the "Enable Start Application" option

Start Application Mode=<Number>

Configures when the printer driver should start the application during printing.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Start before printing - start the application at the start of the print job

1: Start after printing - start the application after the printer driver finishes the print job (default)

2: Start for messaging - start the application before printing, even earlier than the "Start before printing" option. Some parameters, like the output file name, are not available at this stage, but the application can change the output file naming options using the messaging interface.

Enable Pass Parameters=<1 or 0>

Enables or disables the passing of parameters to the application when the "Start Application" feature is enabled.

If enabled, the user can specify the parameters in the "StartApplicationParameterOrder" key.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Enable Pass Parameters" option

1: Enable the "Enable Pass Parameters" option (default)

Start Application Window Mode=<Number>

Configures the printer driver to start the application normally, minimized, or hidden.

These are standard Windows options when starting an application, and it is up to the application how it handles them.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Start the application in a normal window (default)

1: Start the application minimized

2: Start the application hidden

Start in User Session=<1 or 0>

By disabling the "Start in User Session" option, the Application can be started directly in the spooler's Windows session instead of the user's Windows session that printed the document.

An application started in the spooler's session cannot interact with the user or display any windows.

Available for Printers: Color, ColorPlus, EMF, TIFF\Monochrome, PDF

Available values:

0: Start the application in the spooler's session

1: Start the application in the user's session (default)

UNICODE Group File=<0 or 1>

Set this value to 1 if you want to create a UNICODE group file

OutputDirectory=<string>

The output directory for the printer. The image files will be generated here.

Trim Whitespace Left=<1 or 0>

Trim Whitespace Right=<1 or 0>

Trim Whitespace Top=<1 or 0>

Trim Whitespace Bottom=<1 or 0>

The Trim Whitespace options can be used to automatically cut off the unused margins of the pages.

Available values: 0, 1

0: Do not cut off the whitespace (default)

1: Cut off the whitespace

Trim Whitespace Based on Grayscale Intensity=<1 or 0>

If the "Trim Whitespace Based on Grayscale Intensity" option is turned on, the Printer Driver decides where to cut the document based on the pixel values; otherwise, the Printer Driver uses the EMF data to decide where to cut. If the option is turned on, the "Grayscale Intensity for Trimming" option specifies the Grayscale threshold for cutting.

Available values: 0, 1

0: Cut based on the EMF data (default)

1: Cut based on pixel Grayscale values.

Grayscale Intensity for Trimming=<number>

The "Grayscale Intensity for Trimming" option specifies the Grayscale threshold for trimming the borders if the "Trim Whitespace Based on Grayscale  Intensity" option is turned on.

Available values: 1 to 100, where 1 is the lightest gray (but not white) and 100 is black.

Default value: 1

Crop Page=<1 or 0>

If the "Crop Page" option is set, the driver will cut the specified amount off of each page. Please see the "Crop Mode", "Crop Left", "Crop Top", "Crop Right", and "Crop Bottom" options for more information.

Available values: 0, 1

0: Do not crop the pages. (default)

1: Crop the pages.

Crop Mode=<1 or 0>

The "Crop Mode" option specifies how the "Crop Left", "Crop Top", "Crop Right", and "Crop Bottom" options are interpreted.

Available values: 0, 1

0: The "Crop Left", "Crop Top", "Crop Right", and "Crop Bottom" values specify the width of each border to cut off (default)

1: The "Crop Left", "Crop Top", "Crop Right", and "Crop Bottom" values specify an area, i.e., coordinates relative to the top left corner of the page.

Crop Left=<number>

Crop Top=<number>

Crop Right=<number>

Crop Bottom=<number>

The "Crop Left", "Crop Top", "Crop Right", and "Crop Bottom" options specify borders or an area depending on the "Crop Mode" value.

The values are specified in hundredths of inches.

Default value: 100

Remove Blank Pages=<1 or 0>

If the "Remove Blank Pages" option is turned on, the driver automatically removes the blank pages from the printed document.

Available values: 0, 1

0: Do not remove blank pages. (default)

1: Remove blank pages.

Split Document=<1 or 0>

When printing to a multi-page file format and the “Split Document” option is turned on, the printer driver will start a new file every time the file reaches the specified number of pages. The number of pages can be specified in the “Start New File After Page key”

Available values: 0, 1

0: Do not split the document into multiple files. (default)

1: Split the document into multiple files.

Start New File After Page=100

The "Start New File After Page" key specifies the number of pages where the driver should split the document if the "Split Document" option is turned on.

When printing to a multi-page file format and the “Split Document” option is turned on, the printer driver will start a new file every time the file reaches the specified number of pages.

Default value: 100

AnnotationText=<string>

Specifies a user-definable string that will appear in the annotation text. The default value is the empty string. The annotation text can contain any ASCII characters and field definitions. Fields are marked with the << and >> character pair. The following fields are supported:

The total length of the annotation string (including the length of the fields) can be 128 characters. Longer text will be cut.

Example: to specify the name of the printing user and the IP address of the printing machine, use the following line in the INI file Default Settings section:

AnnotationText=User name is: <<USERNAME>>,  IP Address is: <<IPADDRESS>>.

AnnotationSeparator=<string>

Specifies a character or text that will separate the annotation text, the date, and the time. Default value is the empty string. Maximum number of characters are 128.

Enable Annotation=<1 or 0>

Enables or disables the Annotation feature in the Printer Driver.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the Annotation feature (default)

1: Enable the Annotation feature

Enable Annotation Text=<1 or 0>

When enabled, adds the text specified in the "AnnotationText" key to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add text to the annotation (default)

1: Add text to the annotation

Enable Annotation Date=<1 or 0>

When enabled, adds the date to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add the date to the annotation (default)

1: Add the date to the annotation

Annotation Date Format=<Number>

Sets the date format used in annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Set date format: MM/DD/YYYY (default)

1: Set date format: M/D/YY (no zero padding)

2: Set date format: YYYY/MM/DD

3: Set date format: DD/MM/YYYY (European)

4: Set date format: DD - MON - YYYY

5: Set date format: Julian Date

Enable Annotation Time=<1 or 0>

When enabled, adds the printing time to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add the time to the annotation (default)

1: Add the time to the annotation

Annotation Time Format=<Number>

Sets the time format used in annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Set time format: 12 Hour (default)

1: Set time format: 24 Hour

Enable Annotation Minutes=<1 or 0>

When enabled, and "Enable Annotation Time" is also enabled, adds the minutes to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add the minutes to the annotation

1: Add the minutes to the annotation (default)

Enable Annotation Seconds=<1 or 0>

When enabled, and "Enable Annotation Time" is also enabled, adds the seconds to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add the seconds to the annotation

1: Add the seconds to the annotation (default)

Enable Annotation Time Zone=<1 or 0>

When enabled, and "Enable Annotation Time" is also enabled, adds the Time Zone to the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Do not add the Time Zone to the annotation

1: Add the Time Zone to the annotation (default)

Annotation Background=<1 or 0>

Sets the background for the annotation text.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Draw the annotation text with a transparent background (default)

1: Add a white background to the annotation text

Annotation Position=<Number>

Sets the position of the annotations.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Set position: Top Left

1: Set position: Top Right

2: Set position: Center (default)

3: Set position: Bottom Left

4: Set position: Bottom Right

Annotation Units=<Number>

Sets the units of the AnnotationXOffset and AnnotationYOffset keys.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Set Units: 0.1*mm

1: Set Units: 0.01*inch

2: Set Units: Pixel (default)

AnnotationRotation=<number>

Specifies the number of degrees the text will be rotated. Default value is 0. Value can range from -180 to 180.

AnnotationColor=<number>

Specifies the color of the annotation text as a COLORREF value. Default value is 0.

AnnotationXOffset=<number>

Specifies the horizontal distance of the annotation from the origin point. Default value is 0. A maximum 6-digit number can be defined. The origin point and the unit can be set using Annotation Flags. By default, the origin point is the center, and the unit is measured in pixels.

AnnotationYOffset=<number>

Specifies the vertical distance of the top left corner of the annotation from the origin point. Default value is 0. A maximum 6-digit number can be defined. The origin point and the unit can be set using Annotation Flags. By default, the origin point is the center, and the unit is measured in pixels.

WatermarkDirectory=<string>

Full path for the watermarks of the printer driver. The WatermarkDirectory parameter can also be configured by using a valid environment variable.

Enable Image Watermark=<1 or 0>

Enables or disables the Image Watermark feature in the Printer Driver. The Image Stamp and Image Watermark features share the same settings (configured using the WatermarkXXX keys). The difference is, the image stamp is placed on top of the page content, while the Image Watermark is placed below the page content (in the background layer).

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the Image Watermark feature (default)

1: Enable the Image Watermark feature

Enable Image Stamp=<1 or 0>

Enables or disables the Image Stamp feature in the Printer Driver. The Image Stamp and Image Watermark features share the same settings (configured using the WatermarkXXX keys). The difference is, the image stamp is placed on top of the page content, while the Image Watermark is placed below the page content (in the background layer).

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the Image Stamp feature (default)

1: Enable the Image Stamp feature

Watermark First Page Only=<1 or 0>

Place the Image Watermark or Stamp on the first page of the document only.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Place the Image Watermark/Stamp on every page (default)

1: Place the Image Watermark/Stamp on the first page only

Watermark Portrait Position=<Number>

Sets the position of the Image Watermark or Stamp for Portrait pages.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Position: Stretch to Fit

1: Position: Stretch to Width

2: Position: Center (default)

3: Position: Tile

4: Position: Bottom

5: Position: Fit to With - Bottom

6: Position: Top

7: Position: Fit to With – Top

8: Position: Top Left

9: Position: Top Right

10: Position: Bottom Left

11: Position: Bottom Right

Watermark Landscape Position=<Number>

Sets the position of the Image Watermark or Stamp for Landscape pages.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Position: Stretch to Fit

1: Position: Stretch to Width

2: Position: Center (default)

3: Position: Tile

4: Position: Bottom

5: Position: Fit to With - Bottom

6: Position: Top

7: Position: Fit to With - Top

8: Position: Top Left

9: Position: Top Right

10: Position: Bottom Left

11: Position: Bottom Right

First Watermark Portrait Position=<Number>

Sets the position of the Image Watermark or Stamp on the first page, for Portrait pages. To use this key, the "Unique Watermark On First Page" key must be set to 1.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Position: Stretch to Fit

1: Position: Stretch to Width

2: Position: Center (default)

3: Position: Tile

4: Position: Bottom

5: Position: Fit to With - Bottom

6: Position: Top

7: Position: Fit to With - Top

8: Position: Top Left

9: Position: Top Right

10: Position: Bottom Left

11: Position: Bottom Right

First Watermark Landscape Position=<Number>

Sets the position of the Image Watermark or Stamp on the first page, for Landscape pages. To use this key, the "Unique Watermark On First Page" key must be set to 1.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Position: Stretch to Fit

1: Position: Stretch to Width

2: Position: Center (default)

3: Position: Tile

4: Position: Bottom

5: Position: Fit to With - Bottom

6: Position: Top

7: Position: Fit to With - Top

8: Position: Top Left

9: Position: Top Right

10: Position: Bottom Left

11: Position: Bottom Right

Watermark Portrait Visibility=<Number>

Sets the visibility of the Image Watermark or Stamp for Portrait pages.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values: Any number between 10 and 100. A lower number means the Watermark or Stamp is less visible, a higher number means the Watermark or Stamp is more visible, with 100 being 100% visible.

Default value: 60

Watermark Landscape Visibility=<Number>

Sets the visibility of the Image Watermark or Stamp for Landscape pages.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values: Any number between 10 and 100. A lower number means the Watermark or Stamp is less visible, a higher number means the Watermark or Stamp is more visible, with 100 being 100% visible.

Default value: 60

First Watermark Portrait Visibility=<Number>

Sets the visibility of the Image Watermark or Stamp on the first page, for Portrait pages. To use this key, the "Unique Watermark On First Page" key must be set to 1.

Available for Printers: Color, ColorPlus, TIFF\Monochrome, PDF

Available values: Any number between 10 and 100. A lower number means the Watermark or Stamp is less visible, a higher number means the Watermark or Stamp is more visible, with 100 being 100% visible.

Default value: 60

First Watermark Landscape Visibility=<Number>

Sets the visibility of the Image Watermark or Stamp on the first page, for Landscape pages. To use this key, the "Unique Watermark On First Page" key must be set to 1.

Available for Printers: Color, ColorPlus, TIFF\Monochrome, PDF

Available values: Any number between 10 and 100. A lower number means the Watermark or Stamp is less visible, a higher number means the Watermark or Stamp is more visible, with 100 being 100% visible.

Default value: 60

Unique Watermark On First Page=<1 or 0>

Place a different Image Watermark or Stamp on the first page than on the rest of the pages.

Available for Printers: Color, ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Use the same Watermark on every page (default)

1: Unique Watermark on the first page

WatermarkFilePortrait=<string>

Full path for the watermarks when printing documents to portrait orientation. The WatermarkFilePortrait parameter can also be configured by using a valid environment variable.

WatermarkFileLandscape=<string>

Full path for the watermarks when printing documents in landscape orientation. The WatermarkFileLandscape parameter can also be configured by using a valid environment variable.

FirstWatermarkFilePortrait=<string>

Full path for the watermarks printing on the first page only in portrait orientation. The FirstWatermarkFilePortrait parameter can also be configured by using a valid environment variable.

FirstWatermarkFileLandscape=<string>

Full path for the watermarks printing on the first page only in landscape orientation. The FirstWatermarkFileLandscape parameter can also be configured by using a valid environment variable.

Show Compatibility Warning=<0 or 1>

If this value is set to 1 and the Printer Driver detects an application that is incompatible with the driver, it will show a warning message with a possible workaround and abort the print job.

Set this value to 0 if you do not want to receive compatibility warnings and do not want the print job to be aborted (please note this may result in an application or printer driver crash). The default value is 1.

Disable Output Directory Access Check=<0 or 1>

0: The printer driver checks the directory access during printing, and if the directory is not accessible during printing, a warning message will appear, and then the Save As dialog will be shown. (default)

1: The printer driver will not check the directory access during printing and will not throw any warning messages or Save As dialogs during printing, even if the output folder is incorrect. This option can be useful since the access check is not completely accurate due to the technical limitations of the Windows printer driver architecture, and in some cases, when the driver is automated, the message boxes or dialogs are not allowed.

NOTE: The option does not affect the checks and messages when saving settings in the Printing Preferences dialog. This option only affects the behavior during printing.

Disable Output File Access Check=<number>

When an existing file is selected for appending a document and OK is pressed on the Save as dialog, the Printer Driver tries to open the file to check if it has sufficient access rights to append to the selected file and there is no other applications that use the file. If it cannot open the file, it will not let the user proceed. This check can be undesirable if one wants to quickly print multiple documents and merge them into a single file using a single printer, because if the check is enabled, it forces the user to wait for each print job to finish printing before appending the next document to the file. If only a single non-parallel printer is used to append documents, the print jobs are queued in the Windows Spooler, so the access check can be safely disabled, and the user does not have to wait for each print job to finish printing before clicking OK on the Save As dialog of the next print job.

Available values: 0-1

0: Check file access when OK is pressed on the Save As dialog

1: Do not check the file access when OK is pressed on the Save As dialog.

Default value: 0

Monochrome Mode=<0 or 1>

Changes how the Printer Driver reports the Monochrome/Color capability to applications when 1-bit or 8-bit grayscale color depth is selected.

Available values: 0, 1

0: Report Color capability to applications to make sure color conversion and dithering are done in the Printer Driver and not in the Application or in GDI.

1: Only report Color capability if 24-bit or 8-bit (non-grayscale) color is selected in the Printer Driver.

Default value: 0

Duplex Capability=<0 or 1>

Changes how the Printer Driver reports the double-sided printing capability to applications. The Black Ice Printers, being Virtual Printers, do not support double-sided printing; however, this option is added for certain applications that might process the generated output documents differently, depending on the option.

Available values: 0, 1

0: Do not report duplex (double-sided printing) capability (default).

1: Report duplex (double-sided printing) capability to applications. When this option is set to 1 and the “Start Application” option is also turned on, the printer will pass an additional command line parameter to the application, based on what the user selected on the Print page in MS Office or in Adobe Reader, etc. (single-sided, long edge, or short edge). The added parameter is one of the following:

-singlesided

-longedge

-shortedge

Set Filename in Print Processor=<0 or 1>

Sets how the "Print to file" option behaves on the Windows print dialog.

It also changes the behavior of some applications that try to set the output of the print processor.

Available values: 0, 1

0: The "Print to file" option on the Windows print dialog will set the output of the print processor, and the output file will contain the RAW data of the printer driver. (default for OEM printer drivers)

1: The "Print to file" option on the Windows print dialog will set the final output file of the port monitor, writing a proper PDF/TIFF/etc. file. (default for End User Licensed printer drivers)

Print Queue Workaround=<number>

The "Print Queue Workaround" option enables a workaround for a compatibility issue with the new Windows 11 Print Queue app.

If the workaround is disabled and the Print Queue app is opened, the printer may print empty pages or truncated documents.

If the workaround is enabled, the "Keep Printed Documents" option will be turned on in the Printer Properties, but the Printer Driver will delete the print jobs after they are printed.

Available values:

0: Disable the workaround.

1: Automatically enable the workaround for the affected systems (Windows 11 24H2 or newer). (default)

2: Force enable the workaround for all systems.

Write Output in a Single Step=<1 or 0>

Enables or disables the “Write Output in a Single Step” option.

If the Write Output in a Single Step option is enabled, the printer driver generates the output file in memory first, then writes the output file in one step, so applications that monitor the output folder will not open an incomplete file.

Available values:

0: Write the output file sequentially. (default)

1: Generate the output in memory first, then write the output file in a single step.

[Text Watermark Stamp Settings]

Text Stamp Enable=

Text Watermark Enable=

Text=

Position=

Font Height=

Font Width=

Font Escapement=

Font Orientation=

Font Weight=

Font Italic=

Font Underline=

Font Strikeout=

Font Charset=

Font Outprecisions=

Font Clipprecisions=

Font Quality=

Font PinchAndFamily=

Font Facename=

Color=

Background Mode=

Offset X=

Offset Y=

Offset Units=

Rotation=

Visibility=

First Page Only=

Text Stamp Enable=<number>

This value enables or disables Text Stamp printing. The Text Watermark and Text Stamp cannot be enabled at the same time. The Text Watermark and Text Stamp features share the same settings. The INI file keys in the [Text Watermark Stamp Settings] section can be used to change the settings of both the Text Watermark and Text Stamp features.

Available values:

0: Disables Text Stamp printing

1: Enables Text Stamp printing

Default value: 0 (Disables Text Stamp printing)

Text Watermark Enable=<number>

This value enables or disables Text Watermark printing. The Text Watermark and Text Stamp cannot be enabled at the same time. The Text Watermark and Text Stamp features share the same settings. The INI file keys in the [Text Watermark Stamp Settings] section can be used to change the settings of both the Text Watermark and Text Stamp features.

Available values:

0: Disables Text Watermark printing

1: Enables Text Watermark printing

Default value: 0 (Disables Text Watermark printing)

Text=<string>

This value specifies the Text Stamp or Text Watermark text.

Position=<number>

This value specifies the position of the Text Stamp or Text Watermark.

Available values:

0: top left

1: top right

2: center

3: bottom left

4: bottom right

Default value: 0 (top left)

Font Height=0

Font Width=0

Font Escapement=0

Font Orientation=0

Font Weight=0

Font Italic=0

Font Underline=0

Font Strikeout=0

Font Charset=0

Font Outprecisions=0

Font Clipprecisions=0

Font Quality=0

Font PinchAndFamily=0

Font Facename=

These values specify the font information of the Text Stamp or Text Watermark.

For the description of the font properties, please see the following Microsoft page: https://docs.microsoft.com/en-us/windows/desktop/api/wingdi/ns-wingdi-taglogfontw

Color=

Default value: 0 (black)

Specifies the color of the Text Stamp or Text Watermark as a COLORREF value.

For more information please see the following Microsoft page: https://docs.microsoft.com/en-us/windows/desktop/gdi/colorref

Background Mode=

Available values: 0, 1.

0: The Text Stamp or Text Watermark is printed with a white background. (default)

1: The Text Stamp or Text Watermark is printed with no background.

Offset X=<number>

Specifies the horizontal offset of the Text Stamp or Text Watermark. The units are specified in the “Offset Units” key

Default value: 0

Offset Y=<number>

Specifies the vertical offset of the Text Stamp or Text Watermark. The units are specified in the “Offset Units” key

Default value: 0

Offset Units=<number>

Specifies the unit of the “Offset X” and “Offset Y” keys.

0: 0.1 mm

1: 0.01 inch

2: pixel (default value)

Rotation=<number>

Specifies the rotation of the Text Stamp or Text Watermark in degrees. (counterclockwise)

Default value: 0

Visibility=<number>

Specifies the opacity of the Text Stamp or Text Watermark between 10 and 100. An opacity value of 10 means the Text Stamp or Text Watermark is faintly visible, a value of 100 means the Text Stamp or Text Watermark is completely visible.

Default value: 100

First Page Only=<0 or 1>

Deprecated – Use the “Add to Pages” key instead.

Specifies whether to add the Text Watermark or Text Stamp to only the first page of the document, or to every page.

Available values: 0, 1.

0: Add the text to every page. (default)

1: Add the text to the first page only.

Add to Pages=<string>

Specifies the pages the Text Stamp/Watermark appears on. The string should contain the pages and page ranges separated by commas the same way it is entered on the user interface. E.g.: “1-3,5,6”. An empty string means the Text Stamp/Watermark appears on all pages.

Default value: empty (All pages)

[Text Watermark Stamp <number>]

Name=

Layer=

Text=

Add to Pages=

Position=

Font Height=

Font Width=

Font Escapement=

Font Orientation=

Font Weight=

Font Italic=

Font Underline=

Font Strikeout=

Font Charset=

Font Outprecisions=

Font Clipprecisions=

Font Quality=

Font PinchAndFamily=

Font Facename=

Color=

Background Mode=

Offset X=

Offset Y=

Rotation=

Visibility=

Offset Units=

First Page Only=

Using the [Text Watermark Stamp <number>] sections, multiple Text Stamps/Watermarks can be specified. The specified Stamps/Watermarks will appear in the list on the Printing Preferences and on the Save As dialog.

The numbering of the sections starts with 1.

E.g.: the [Text Watermark Stamp 1] section contains the settings of the first stamp. On the user interface, the stamps appear in alphabetical order based on the Name key.

For the description of the keys in the [Text Watermark Stamp <number>] section, see the description of the [Text Watermark Stamp Settings] section. Additionally, the following keys must be specified:

Name=<string>

The name of the Watermark/Stamp as it appears on the user interface.

Layer=<number>

Specifies the layer the text appears on the printed page.

Available values:

0: The text appears on top of the page content as a Stamp. (default)

1: The text appears behind the page content as a Watermark.

[UI Tabs Settings]

Display File Format Tab=<0 or 1>

Display Filename Generation Tab=<0 or 1>

Display Start Application Tab=<0 or 1>

Display Watermark Tab=<0 or 1>

Display Annotation Tab=<0 or 1>

Display Profile Manager Tab=<0 or 1>

Display Bates Tab=<0 or 1>

Display Redirect Printing Tab=<0 or 1>

Display Barcode Tab=<0 or 1>

Display OCR Tab=<0 or 1>

Display Text Output Tab=<0 or 1>

Display FTP =<0 or 1>

Display Email =<0 or 1>

Display SharePoint =<0 or 1>

Display Tooltips=<0 or 1>

Display N-Up=<0 or 1>

Display Cover Page Filler=<0 or 1>

Display HTTP=<0 or 1>

Display Database=<0 or 1>

Using these values, you can display or hide individual tabs on the printer driver User Interface. The default values are 1; the values can be 0 or 1:

The “Device settings” tab cannot be hidden and will always be displayed.

Display Cover Page Filler=<0 or 1>

Shows or hides the “Cover Page Filler” feature on the Printer Driver’s user interface.

Available values: 0, 1

0: Hide the Cover Page Filler

1: Show the Cover Page Filler

Default value: 1

Display HTTP=<0 or 1>

Shows or hides the “Upload document to Web” feature on the Printer Driver’s user interface.

Available values: 0, 1

0: Hide the “Upload document to Web” option

1: Show the “Upload document to Web” option

Default value: 1

Display Database=<0 or 1>

Shows or hides the “Upload document to Database” feature on the Printer Driver’s user interface.

Available values: 0, 1

0: Hide the “Upload document to Database” option

1: Show the “Upload document to Database” option

Default value: 1

Display FTP =<0 or 1>

When set to 0, the printer driver will hide the FTP options from the Printing Preferences dialog.

0: Disable the FTP options

1: Enable the FTP options (default)

Display Email =<0 or 1>

When set to 0, the printer driver will hide the Email sending options from the Printing Preferences dialog.

0: Disable the Email sending options

1: Enable the Email sending options (default)

Display SharePoint =<0 or 1>

When set to 0, the printer driver will hide the SharePoint options from the Printing Preferences dialog.

0: Disable the SharePoint options

1: Enable the SharePoint options (default)

Display Tooltips =<0 or 1>

This option hides or shows the tooltip icons and descriptions on the Printer Driver user interface.

0: Hide the Tooltips on the user interface

1: Show the Tooltips on the user interface (default)

Display N-Up=<0 or 1>

Shows or hides “Pages Per Sheet (N-Up)” settings on the Printer Driver’s user interface.

Available values: 0, 1

0: Hide the N-Up settings

1: Show the N-Up settings

Default value: 1

StartApplicationParameterOrder=<string>

Specifies which parameters are passed to the application launched by the printer, and in what order. Each character (number or letter) represents a parameter; see the values in the list below.

Values of each parameter:

Specify the parameter order by specifying which parameter you would like to have in which position, without spaces between. For example, the value 123456789ABCD means pass all parameters (the first parameter is the document name, etc.).

The default parameter list is 1234568000000 (Document Name, Group Filename, Printer Name, Number of Pages, Multipage, Orientation, and Output Filename are passed.)
To specify the parameter list in reverse order, enter StartApplicationParameterOrder=DCBA987654321 in the INI file.
To pass the printer name and the group file name only, enter StartApplicationParameterOrder=3200000000000 into the INI file specifying 0 for the unused parameters.

In order to pass only the group file name as a parameter, enter the following line in the INI file: StartApplicationParameterOrder=2000000000000

CustomStartApplicationParameter=<string>

Custom parameter for the application launched by the printer.

Start Application Timeout=<number>

Start Application Timeout=5000

If the start before print option is enabled, the printer driver will wait for the specified time for the application to be launched by Windows before every print job. The “Start Application Timeout” does not wait until the application starts processing messages. The value is specified in milliseconds, and it is read at the beginning of each print job, so changes take effect immediately, without restoring the default printer settings. The default value is 5 seconds.

Messaging Timeout=<number>

Messaging Timeout=10000

If the “Start for Messaging” option is enabled, the printer driver will wait for the specified time for the application to start listening or processing the first messages. The value is specified in milliseconds, and it is read at the beginning of each print job, so changes take effect immediately, without restoring the default printer settings. The default value is 10 seconds. The -1 value is infinite waiting. The Messaging Timeout affects only when the “Start for Messaging” option is enabled.

This key sets the timeout value for each Message Capture read or write operation. This timeout value affects the Change Devmode message; the rest of the messages are asynchronous. If the value is set to 10 seconds, the application has 10 seconds to receive and reply to the Change Devmode message. This timeout value affects all message capture applications that use the messaging interface. This timeout value is used if the Messaging Interface is enabled, whether the Start Application is enabled or not. The default value is 10 seconds.

Messaging Timeout 2=<number>
Messaging Timeout 2=10000

This key sets the timeout value for each Message Capture read or write operation. This timeout value affects the Change Devmode message; the rest of the messages are asynchronous. If the value is set to 10 seconds, the application has 10 seconds to receive and reply to the Change Devmode message. This timeout value affects all message capture applications that use the messaging interface. This timeout value is used if the Messaging Interface is enabled, whether the Strat Application is enabled or not. The default value is 10 seconds.

StartDoc Delay=<number>

StartDoc Delay=0

For compatibility with applications started by the driver. This value sets the waiting time before the printer driver raises the StartDoc event. It is specified in milliseconds, and it is read at the beginning of each print job.

EndPage Delay=<number>

EndPage Delay=0

This value sets the waiting time before the printer driver raises the EndPage event. It is specified in milliseconds, and it is read at the beginning of each print job.

EndDoc Delay=<number>

EndDoc Delay=0

This value sets the waiting time before the printer driver raises the EndDoc event. It is specified in milliseconds, and it is read at the beginning of each print job.

PDF Flags:

Enter the following into the INI file:

PDFFlags=

Value can be any of the following:

Important! Make sure that the color depth matches the compression, such as  BLF_PDF_FILTER_DCT_JPEG_DECODE can be used only for 24-bit images, BLF_PDF_FILTER_CCITT_FAX_DECODE can be used only for 1-bit images.

Print Selected Pages Only=<1 or 0>

When enabled, only the pages specified in the “Selected Pages” key are printed.

Available values:

0: Print all pages (default)

1: Print only the pages specified in the “Selected Pages” key

Selected Pages=<string>

Specifies the pages to print when the “Print Selected Pages Only” key is set to 1.

Type page numbers and/or page ranges separated by commas counting from the start of the document.

For example: 1,2,5-12

[UI FileFormats]

The keys of the [UI FileFormats] section allow one to hide particular file formats from the printer driver’s user interface.

Available values:

0: hide the file format

1: show the file format (default)

PDF (*.pdf)=<1 or 0>

Compact PDF (*.pdf)=<1 or 0>

PDF/A (*.pdf)= <1 or 0>

PDF Image (*.pdf)=<1 or 0>

JPEG (*.jpg)=<1 or 0>

JPEG LAB (*.jpg)=<1 or 0>

PNG (*.png)=<1 or 0>

GIF (*.gif)=<1 or 0>

TIFF JPEG (*.tif)=<1 or 0>

TIFF Group 4 (*.tif)=<1 or 0>

TIFF Group 3, 1 Dimension (*.tif)=<1 or 0>

TIFF Group 3, 1 Dimension, with Fillbits (*.tif)=<1 or 0>

TIFF Group 3, 2 Dimension (*.tif)=<1 or 0>

TIFF Packed (*.tif)=<1 or 0>

TIFF Lempel-Ziv & Welch (*.tif)=<1 or 0>

TIFF Uncompressed (*.tif)=<1 or 0>

TIFF for CISCO (*.tif)=<1 or 0>

TIFF for Dialogic boards (*.tif)=<1 or 0>

TIFF for NMS boards (*.tif)=<1 or 0>

TIFF for Gammalink boards (*.tif)=<1 or 0>

HTML - editable (*.htm)=<1 or 0>

HTML with GIF (*.htm)=<1 or 0>

HTML with PNG (*.htm)=<1 or 0>

HTML with JPEG (*.htm)=<1 or 0>

HTML with BMP (*.htm)=<1 or 0>

XML - editable (*.xml)=<1 or 0>

XML with GIF (*.xml)=<1 or 0>

XML with PNG (*.xml)=<1 or 0>

XML with JPEG (*.xml)=<1 or 0>

XML with BMP (*.xml)=<1 or 0>

XML with PDF Image (*.xml)=<1 or 0>

Microsoft Bitmap (*.bmp)=<1 or 0>

PCX (*.pcx)=<1 or 0>

INTEL DCX (*.dcx)=<1 or 0>

Enhanced Metafile (*.emf)=<1 or 0>

IBM MMR IOCA (*.mca)=<1 or 0>

CALS (*.cg4)=<1 or 0>

Raw CCITT (no header) Group 3, 1 Dimension (*.raw)=<1 or 0>

Raw CCITT (no header) Group 3, 1 Dimension, with Fillbits (*.raw)=<1 or 0>

Raw CCITT (no header) Group 3, 2 Dimension (*.raw)=<1 or 0>

Raw CCITT (no header) Group 4 (*.raw)=<1 or 0>

G4 Multi Page=<1 or 0>

G4 Single Page=<1 or 0>

G3 Multi Page=<1 or 0>

G3 Single Page=<1 or 0>

No Compress Multi Page=<1 or 0>

No Compress Single Page=<1 or 0>

[Redirect Printing]

Enable Redirect Printing=<1 or 0>

Enables or disables the "Enable Redirect printing" option in the Printer Driver on the Redirect Printing tab.

Available for Printers:  Color, ColorPlus, EMF,  TIFF\Monochrome, PDF

Available values:

0: Disable the "Enable Redirect printing" option (default)

1: Enable the "Enable Redirect printing" option

Prompt the User to Select the Printer=<1 or 0>

Enables or disables the "Prompt the user to select the printer during printing" option in the Printer Driver on the Redirect Printing tab. When the option is enabled, a window is shown for the user during printing, where the printer can be selected.

Available values:

0: Do not show printer selection window, redirect to the printer specified in the Printer1, Printer2, etc. keys. (default)

1: Show the printer selection window during printing.

Number of printers=<number>

This value specifies the number of printers to redirect printing jobs. If this value is zero the redirect printing feature is disabled. If this value is greater than zero you have to specify the printer names in the INI file. For example:

[Redirect Printing]

Number of printers=2

Printer1=Printer_name_1

Printer2=Printer_name_2

Scaling Mode=<number>

Specifies the scaling mode for the redirect printing option. The currently available settings are the following:

0: Scale to printable area - scales the printed page down by the size of the physical margin of the target printer, so content very close to the edge of the page can still be printed and nothing will be cut off. This is the default setting.

1: Scale to physical page size - scales the printed page to the physical size of the page, ignoring the target printer’s physical margins. This means the output will be the exact same as when printing to a file. Content outside the physical margins of the target printer is cut off.

[Redirect Printing]

Scaling Mode=0

Redirect Printing Log File=<string>

Full path for the Log File of the redirect printing. The Redirect Printing Log File parameter can also be configured by using a valid environment variable.

Use number of copies=<string>

Override the Number of copies and Collate settings coming from the application and use the settings defined in the Printing Preferences (set in the INI file) instead. This setting does not affect the normal output, only the “Redirect printing” feature.

Available values: Yes, No

Default value: No

Number of copies=<number>

Set the number of copies to print. If this value is set to 1, the value is taken from the printing application. This setting does not affect the normal output, only the “Redirect printing” feature. The “Use number of copies” value must be set to “Yes”.

Available values: 1-999

Default value: 1

Collate pages=<string>

Collated printing will print page documents after each other in proper order, while uncollated printing will print the first page copies, then the second page copies, and so on, as on the explanation diagram below.

Available values: Yes, No

Default value: Yes

This setting does not affect the normal output, only the “Redirect printing” feature. The “Use number of copies” value must be set to “Yes”.

Print as Bitmap=<string>

Available values: Yes, No

Default value: No

Converts the page content to a bitmap before redirecting to the printers. It can correct some graphical glitches that may occur with some printers or documents.

[UI FileName Generation Methods]

The available filename generation methods can be specified in the UI FileName Generation Methods INI file section. By default all filename generation methods are enabled at the Filename Generationtab of the printing preferences. If you set a filename generation method to 0 in the INI file the specified method will not be displayed among the filename generation methods and can’t be used. See the following example:

[UI FileName Generation Methods]

Use this prefix and extension=0

Prefix and extension from the registry=0

Prefix and extension from the INI file=0

Exact filename=1

Exact filename from the registry=0

Exact filename from the INI file=0

Use the document name=1

Custom file naming=0

Use filename from page content=0

In this case only the Use document name and Exact filename can be used at the Filename Generation tab.

Note: At least one filename generation method must be enabled.

[PDF Settings]

Document Title=

Document Subject=

Document Author=

Document Keywords=

Document User Password=

Document Owner Password=

Prompt User for Password=

Document Encryption=

Document Security Flag=

JPEG Quality=

Color Image Compression=

Mono Image Compression=

Stream Compression=

Embed all fonts=

Create subset=

Embed licensed fonts=

Embed Adobe fonts=

Embed Windows fonts=

Linearized=

Transparency=

URL Parsing=

Resampling Method=

Resampling Rate=

Color Patterns=

Open Page Layout=0

Open Page View=0

Open Magnification=0

Open At Page=1

Open Zoom=100

Open Hide Menubar=0

Open Hide Toolbar=0

Open Hide Controls=0

Open Fit To Window=0

Open Center Window=0

Open Show Title=0

Document Title=<string>

This value specifies the title of the PDF documents.

Document Subject=<string>

This value specifies the subject of the PDF documents.

Document Author=<string>

This value specifies the author of the PDF documents.

Document Keywords=<string>

This value specifies the keywords of the PDF documents.

Document User Password=<string>

This value specifies the user password of the PDF documents. Also known as the View Password.

To specify what operations are allowed when the PDF is opened with the User Password, see the Document Security Flag value. The maximum number of characters is 32.

Document Owner Password=<string>

This value specifies the owner password of the PDF documents. Also known as the Edit Password.

When the PDF file is opened with the Owner Password, all operations are allowed. The maximum number of characters is 32.

Prompt User for Password=<number>

When turned on, the printer driver shows a dialog during printing where the password can be specified for encrypting the document.

Available values:   

0: Do not show the dialog

1: Show the dialog.

Default value: 0

Document Encryption=<number>

This value specifies the encryption of the PDF documents.

Available values:    

0: No encryption

1: 40-bit RC4 encryption, compatible with Acrobat 3.0 or later.

2: 28-bit RC4 encryption, compatible with Acrobat 5.0 or later.

3: 256-bit AES encryption, compatible with Acrobat 9.0 or later.

4: 256-bit AES encryption, compatible with Acrobat X or later. Uses a more secure algorithm than the Acrobat 9.0 compatible version.

Default value: 0 (no encryption)

Document Security Flag=<number>

This value specifies what operations are allowed when the PDF file is opened with the User password (A.k.a. View password). If the PDF is opened with the Owner password (A.k.a. Edit password), all operations are allowed regardless of the flags.

Available values:

0: no flag set

1: allow printing

2: allow copying

4: allow commenting

8: allow editing

More flags can be specified by adding the values together. E.g.: To allow printing and copying, set the value to 3 (1+2).

Default value: 5 (allow printing and commenting)

Stream Compression=<number>

This value specifies the stream compression of the PDF documents.

Available values:

0: no stream compression

104: LZW compression

105: flate compression

Default value: 105 (flate compression)

Mono Image Compression=<number>

This value specifies the compression of the monochrome images in the PDF documents.

Available values:

0: no compression

304: LZW compression

305: flate compression

306: Runlength

307: CCITT Fax

Default value: 307 (CCITT Fax compression)

Color Image Compression=<number>

This value specifies the compression of the color images in the PDF documents.

Available values:

0: no compression

204: LZW compression

205: flate compression

206: Runlength

207: JPEG compression

Default value: 207 (JPEG compression)

Resampling Method=<number>

This value specifies, by using which method should be the resampling done on the images (to reduce the resulting file size).

Available values:      

0: no resampling applied to the images

1: Bilinear interpolation

2: Cubic spline interpolation

Default value: 0

Resampling Rate=<number>

This value specifies, how the height and the width of the images should change after resampling (expressed as a percentage).

Available values: Positive integer value between 1 and 200.

Default value: 100

Color Patterns=<number>

This value specifies if color patterns should be used for the stroking and filling colors in the resulting PDF document or a threshold should be applied for them.

Available values:

0: color patterns disabled, threshold will be applied for the colors

1: patterns will be generated for the stroking and filling colors for better visual accuracy

Default value: 0

Jpeg quality=<number>

This value specifies the quality of JPEG compressed images in the PDF documents.

Available values: Positive integer value between 1 and 100.

Default value: 85

Open Page Layout=<number>

Specifies how the pages of the printed multipage PDF will be displayed in the PDF viewer.

Available values:

0: Use the viewer’s settings (Default) – The printed PDF will use the PDF viewer’s settings by default.

1: Single Page View – The PDF viewer application displays only one page at the time on the screen. 

2: Two Page View (Left) – The PDF viewer application displays two pages next to each other at the time, and the odd pages are positioned to the left. 

3: Two Page View (Right) - The PDF viewer displays two pages next to each other at the time, and the odd pages are positioned to the right.

4: Single Page Continuous – The PDF viewer displays the pages in one column.

5: Two Page Continuous (Left) – The PDF viewer displays the pages in two columns and the odd pages are positioned to the left. 

6: Two Page Continuous (Right) – The PDF viewer displays the pages in two columns and the odd pages are positioned to the right.

Open Page View=<number>

Specifies whether the PDF viewer displays thumbnails, bookmarks or only pages.

Available values:

0: Pages only (Default) – Displays only pages in the PDF viewer

1: Pages and Thumbnails – Displays the pages and thumbnails in the PDF viewer

2: Pages and Bookmarks – Displays the pages and bookmarks in the PDF viewer

3: Full Screen – Opens the PDF viewer in full screen

Open Magnification=<number>

Specifies the zoom settings of the printed PDF.

Available values:

0: Default option uses the PDF viewer’s default zoom settings.

1: Fit to Width option scales the PDF to fit to the width of the viewing window.

2: Fit to Height option scales the PDF to fit to the height of the viewing window.

3: Fit to Window option scales the PDF to fit to the height and width of the viewing window.

4: Custom option specifies the custom zoom percentage of the opened PDF in the PDF viewer.

Open At Page=<number>

Specifies the first page to open in the PDF viewer.

Open Zoom=<number>

Specifies the zoom percentage of the PDF document when the Open Magnification is set to Custom

Open Hide Menubar=<number>

Available values: 0, 1. (default value is 0)

1: Hides the viewer application’s menu bar when the document is opened.

0: Shows the viewer application’s menu bar when the document is opened.

Open Hide Toolbar=<number>

Available values: 0, 1. (default value is 0)

1: Hides the viewer application’s toolbar when the document is opened.

0: Shows the viewer application’s toolbar when the document is opened.

Open Hide Controls=<number>

Available values: 0, 1. (default value is 0)

1: Hides the user interface elements in the document’s window (for example: scroll bars and navigation controls), and leaves only the document’s content displayed.

0: Shows the user interface elements in the document’s window (for example: scroll bars and navigation controls), and leaves only the document’s content displayed.

Open Fit To Window=<number>

Available values: 0, 1. (default value is 0)

1: Resizes the document’s window to fit the size of the first displayed page.

Open Center Window=<number>

Available values: 0, 1. (default value is 0)

1: Position the document’s window in the center of the screen.

Open Show Title=<number>

Available values: 0, 1. (default value is 0)

1: Displays the Document Title specified in the document’s properties (In the Black Ice Printer Driver Printing Preferences > File Formats > Select PDF or PDF/A file format > PDF Settings > Description Tab) in the window’s title bar.

Embed all fonts=<number>

The Embed all fonts entry specifies the default font embedding mode. It can be the following:

0: disable default embedding. Only the forced fonts will be embedded.

1 (default): enables default embedding. All fonts will be embedded, except the forbidden ones.

The Create subset entry specifies the font subsetting. It can be the following:

0: disable font subsetting. The fonts will be embedded in their original form.

1 (default): enables font subsetting for TrueType/OpenType fonts.

Embed licensed fonts=<number>

If this value is 1 the licensed fonts will be embedded into the PDF documents. This value can be 1 if the ‘Embed all Fonts’ is 1 also.

Available values: 0, 1

Default value: 0

Embed Adobe fonts=<number>

If this value is 1 the Adobe standard fonts will be embedded into the PDF documents. This value can be 1 if the ‘Embed all Fonts’ is 1 also.

Available values: 0, 1

Default value: 0

Embed Windows fonts=<number>

If this value is 1 the Windows standard fonts will be embedded into the PDF documents. This value can be 1 if the ‘Embed all Fonts’ is 1 also.

Available values: 0, 1

Default value: 0

Embed CID fonts only=<1 or 0>

Changes what type of font encoding is used in the generated PDF documents.

Available values:

0: The Printer Driver embeds fonts with ANSI encoding, and if the document contains Unicode characters or glyph indexes, the Printer Driver will also embed “Identity” encoded CID fonts. (default)

1: The Printer Driver will only embed “Identity” encoded CID fonts. ANSI text is converted to a series of glyph indexes in the PDF. This option is useful when printing the PDF files with certain industrial printers that cannot handle multiple font objects that refer to the same physical font. Selecting this option may increase the size of the generated PDF documents.

Linearized=<number>

If this value is 1, a linearized PDF is generated.

Available values: 0, 1

Default value: 0

Transparency=<number>

If this value is 1 the transparency option is turned on.

Available values: 0, 1

Default value: 0

URL Parsing=<number>

If this value is 1 URLs in the PDF document are turned into clickable links.

Available values: 0, 1

Default value: 0

Bitmap Merging Mode=<number>

For internal use only. The Bitmap Merging Mode value changes how multiple bitmaps are combined into a single bitmap in the PDF document.

Available values: 0, 1

0: Default mode

1: Legacy mode (same as Printer Driver version 15.11 and earlier)

[PDF Force Font Settings]

Count=

Font 1=

This section specifies the ‘Force to embed’ fonts in PDF documents.

Count=<number>

Number of the specified fonts.

Font 1, Font2, …=<string>

Name of the font to force to embed.

[PDF Forbidden Font Settings]

Count=

Font 1=

This section specifies the ‘Forbidden to embed’ fonts in PDF documents.

Count=<number>

Number of the specified fonts.

Font 1, Font2, …=<string>

Name of the font to forbidden to embed.

[PDFA Settings]

Document Title=

Document Subject=

Document Author=

Document Keywords=

Stream Compression=

Color Image Compression=

Mono Image Compression=

JPEG Quality=

Transparency=

URL Parsing=

Resampling Method=

Resampling Rate=

Color Patterns=

Open Page Layout=0

Open Page View=0

Open Magnification=0

Open At Page=1

Open Zoom=100

Open Hide Menubar=0

Open Hide Toolbar=0

Open Hide Controls=0

Open Fit To Window=0

Open Center Window=0

Open Show Title=0

This section contains the settings of the PDF/A output format.

Document Title=<string>

This value specifies the title of the PDF/A documents.

Document Subject=<string>

This value specifies the subject of the PDF/A documents.

Document Author=<string>

This value specifies the author of the PDF/A documents.

Document Keywords=<string>

This value specifies the keywords of the PDF/A documents.

Stream Compression=<number>

This value specifies the stream compression of the PDF/A documents.

Available values:      

0: no stream compression

105: flate compression

Default value: 105 (flate compression)

Mono Image Compression=<number>

This value specifies the compression of the monochrome images in the PDF/A documents.

Available values:      

0: no compression

305: flate compression

306: Runlength

307: CCITT Fax

Default value: 307 (CCITT Fax compression)

Color Image Compression=<number>

This value specifies the compression of the color images in the PDF/A documents.

Available values:      

0: no compression

205: flate compression

206: Runlength

207: JPEG compression

Default value: 207 (JPEG compression)

Jpeg quality=<number>

This value specifies the quality of JPEG compressed images in the PDF/A documents.

Available values: Positive integer value between 1 and 100.

Default value: 85

Transparency=<number>

If this value is 1 the transparency option is turned on.

Available values: 0, 1

Default value: 0

URL Parsing=<number>

If this value is 1 URLs in the PDF document are turned into clickable links.

Available values: 0, 1

Default value: 0

Resampling Method=<number>

This value specifies, by using which method should be the resampling done on the images (to reduce the resulting file size)

Available values:      

0: no resampling applied to the images

1: Bilinear interpolation

2: Cubic spline interpolation

Default value: 0

Resampling Rate=<number>

This value specifies, how the height and the width of the images should change after resampling (expressed as a percentage)

Available values: Positive integer value between 1 and 200.

Default value: 100

Color Patterns=<number>

This value specifies if color patterns should be used for the stroking and filling colors in the resulting PDF/A document or a threshold should be applied for them.

Available values:      

0: color patterns disabled, threshold will be applied for the colors

1: patterns will be generated for the stroking and filling colors for better visual accuracy

Default value: 0

Open Page Layout=<number>

Specifies how the pages of the printed multipage PDF will be displayed in the PDF viewer.

Available values:

0: Use the viewer’s settings (Default) – The printed PDF will use the PDF viewer’s settings by default.

1: Single Page View – The PDF viewer application displays only one page at the time on the screen. 

2: Two Page View (Left) – The PDF viewer application displays two pages next to each other at the time, and the odd pages are positioned to the left. 

3: Two Page View (Right) – The PDF viewer displays two pages next to each other at the time, and the odd pages are positioned to the right.

4: Single Page Continuous – The PDF viewer displays the pages in one column.

5: Two Page Continuous (Left) – The PDF viewer displays the pages in two columns and the odd pages are positioned to the left. 

6: Two Page Continuous (Right) – The PDF viewer displays the pages in two columns and the odd pages are positioned to the right.

Open Page View=<number>

Specifies whether the PDF viewer displays thumbnails, bookmarks or only pages.

Available values:

0: Pages only (Default) – Displays only pages in the PDF viewer

1: Pages and Thumbnails – Displays the pages and thumbnails in the PDF viewer

2: Pages and Bookmarks – Displays the pages and bookmarks in the PDF viewer

3: Full Screen – Opens the PDF viewer in full screen

Open Magnification=<number>

Specifies the zoom settings of the printed PDF.

 Available values:

0: Default option uses the PDF viewer’s default zoom settings.

1: Fit to Width option scales the PDF to fit to the width of the viewing window.

2: Fit to Height option scales the PDF to fit to the height of the viewing window.

3: Fit to Window option scales the PDF to fit to the height and width of the viewing window.

4: Custom option specifies the custom zoom percentage of the opened PDF in the PDF viewer.

Open At Page=<number>

Specifies the first page to open in the PDF viewer.

Open Zoom=<number>

Specifies the zoom percentage of the PDF document when the Open Magnification is set to Custom

Open Hide Menubar=<number>

Available values: 0, 1. (default value is 0)

1: Hides the viewer application’s menu bar when the document is opened.

0: Shows the viewer application’s menu bar when the document is opened.

Open Hide Toolbar=<number>

Available values: 0, 1. (default value is 0)

1: Hides the viewer application’s toolbar when the document is opened.

0: Shows the viewer application’s toolbar when the document is opened.

Open Hide Controls=<number>

Available values: 0, 1. (default value is 0)

1: Hides the user interface elements in the document’s window (for example: scroll bars and navigation controls), and leaves only the document’s content displayed.

0: Shows the user interface elements in the document’s window (for example: scroll bars and navigation controls), and leaves only the document’s content displayed.

Open Fit To Window=<number>

Available values: 0, 1. (default value is 0)

1: Resizes the document’s window to fit the size of the first displayed page.

Open Center Window=<number>

Available values: 0, 1. (default value is 0)

1: Position the document’s window in the center of the screen.

Open Show Title=<number>

Available values: 0, 1. (default value is 0)

1: Displays the Document Title specified in the document’s properties (In the Black Ice Printer Driver Printing Preferences > File Formats > Select PDF or PDF/A file format > PDF Settings > Description Tab) in the window’s title bar.

[HTML Settings]

Html content output directory=C:\HTML

CSS settings=0

Page size setting=0

Vector graphics display mode=0

Embed all fonts=

Create subset=

Separate pages=

Embed Licensed fonts=

The HTML Settings section defines the default values of the HTML settings.

Html content output directory=<string>

The Html content output directory entry specifies the full path of the contents directory of the HTML file format.

Page size setting=<number>

The Page size setting entry specifies the page size settings. It can be the followings:

0 (default): page size based on page width

1: page size based on page height

2: page size based on the specified paper size

CSS settings=<number>

The CSS settings entry specifies the CSS settings. It can be the followings:

0 (default): Only one CSS file will be generated for all printed pages.

1: Every printed pages have own CSS file separated from the HTML.

2: Every printed pages have own CSS file embedded in the HTML.

Vector graphics display mode=<number>

The Vector graphics display mode entry specifies the vector graphics display mode. It can be the followings:

0: disable vector graphics

1 (default): display as PNG image

Embed all fonts=<number>

The Embed all fonts entry specifies the default font embedding mode. It can be the followings:

0: disable default embedding. Only the forced fonts will be embedded.

1 (default): enables default embedding. All fonts will be embedded, except the forbidden ones.

Create subset=<number>

The Create subset entry specifies the font subsetting. It can be the followings:

0: disable font subsetting. The fonts will be embedded in original form.

1 (default): enables font subsetting for TrueType/OpenType fonts.

Separate pages=<number>

The Separate pages entry specifies page processing. It can be the followings:

0 (default): disable page separation. The document will be saved to one HTML file.

1: enables page separation. The document pages will be saved to different HTML files.

Embed Licensed fonts=<number>

If this value is 1 the licensed fonts will be embed into the HTML document.

Available values: 0, 1

Default value: 0

[XML Settings]

XML content output directory=

Include Text=

Include Images=

Include Path=

Include DTD=

Image Format=

This section contains the settings of the editable XML output format.

XML content output directory=<string>

The XML content output directory entry specifies the full path of the contents directory of the XML file format.

Include Text=<number>

Enables or disables the use of text tags in the XML output.

0: disable text tags.

1 (default): enable text tags.

Include Images=<number>

Enables or disables the use of image tags in the XML output.

0: disable image tags.

1 (default): enable image tags.

Include Path=<number>

Enables or disables the use of path tags in the XML output.

0: disable path tags.

1 (default): enable path tags.

Include DTD=<number>

Enables or disables the inclusion of the DTD chunk in the XML output.

0: disable DTD chunk.

1 (default): enable DTD chunk.

Image Format=<number>

This value specifies the image format used in the XML output.

Available values:

0: PNG

1: JPEG

2: GIF

3: BMP

Default value: 0 (PNG)

[HTML Force Font Settings]

Count=

Font 1=

This section specifies the ‘Force to embed’ fonts in HTML documents.

Count=<number>

Number of the specified fonts.

Font 1, Font2, …=<string>

Name of the font to force to embed.

[HTML Forbidden Font Settings]

Count=

Font 1=

This section specifies the ‘Forbidden to embed’ fonts in HTML documents.

Count=<number>

Number of the specified fonts.

Font 1, Font2, …=<string>

Name of the font to forbidden to embed.

[Bates Numbering]

Number of Formats=1

Selected Bates Format=1

Bates Numbering Enabled=0

Number of Formats=<number>

The number of Bates formats is defined in the INI file. For example, if this value is 2, “Bates Number 1” and “Bates Number 2” sections have to be defined in the INI file.

Selected Bates Format=<number>

This value specifies the selected Bates format. If this value is 1 values of the “Bates Number 1” section will be selected in the printing preferences.

Bates Numbering Enabled=<number>

If this value is zero, the Bates numbering feature is disabled; if this value is 1, the Bates numbering is enabled, and the “Enable Bates Numbering” checkbox is checked in the printing preferences.

Bates numbering is not supported when using the EMF output file format.

[Bates Number 1]

Name=Default Bates Format

Use prefix=1

Prefix=Case number

Start with=1

Transparent=0

X Offset=0

Y Offset=0

Offset unit=1

Rotation=0

Color=4145215

Position=2

Font Height=-16

Font Width=0

Font Escapement=0

Font Orientation=0

Font Weight=400

Font Italic=255

Font Underline=0

Font Strikeout=0

Font Charset=1

Font Outprecisions=3

Font Quality=1

Font Clipprecisions=2

Font PinchAndFamily=34

Font Facename=Verdana

Bates Number Length=0

Bates Padding Character=

Reset bates number at every printing=

Reset bates number=

Name=<string>

Name of the bates numbering format

Use prefix=<number>

Available values: 0, 1.

0: Use prefix checkbox is unchecked in the printing preferences.

1: Use prefix checkbox is checked in the printing preferences.

Prefix=<string>

Specifies the prefix text. The maximum number of characters is 29.

Start with=<number>

Specifies the starting bates number. The default value is 1.

Transparent=<number>

Available values: 0, 1.

0: The Bates Number is opaque on the printed page.

1: The Bates Number is transparent on the printed document.

X Offset, Y Offset=<number>

Specifies the offset values of the Bates Number position.

Offset unit=<number>

Specifies the unit of the offset. Available values:

0: 0.1 mm

1: 0.01 inch

2: pixel

Rotation=<number>

Specifies the rotation value in degrees 0-360.

Color=<number>

Specifies the color of the Bates Number as COLORREF value.

Position=<number>

Specifies the bates numbering position on the page. Available values:

0: Top left

1: Top right

2: Center

3: Bottom left

4: Bottom right

Font Height=<number>

Font Width=<number>

Font Escapement=<number>

Font Orientation=<number>

Font Weight=<number>

Font Italic=<number>

Font Underline=<number>

Font Strikeout=<number>

Font Charset=<number>

Font Outprecisions=<number>

Font Quality=<number>

Font Clipprecisions=<number>

Font PinchAndFamily=<number>

Font Facename=<string>

These values specify the font information of the Bates Number.

Bates Number Length=<number>

Number of characters of the Bates number (excluding prefix text). This value can be an integer value between 0 and 16. This value specifies the length of the Bates number. If the length of the Bates number is less than this value, a padding character will be added; otherwise, no padding characters will be inserted. If you are using “Bates Number 1” and the Bates number is 12588, the printed document will contain 00012588 as the Bates number. If “Bates Number 2” is selected, the created Bates number will be 12588 (No padding character will be added.).

Bates Padding Character=<character>

This value specifies the padding character. This value can be only one ANSI character. For example, the Bates number is 1258, the Bates Number length is 5, and you are using * as the Bates Padding Character, the generated text will be *1258 on the printed document.

Reset bates number at every printing=<number>

Available values:0, 1

0: The “Reset Bates Number at every printing” feature is disabled.

1: The “Reset Bates Number at every printing” feature is enabled.

Reset bates number=<number>

If the “Reset Bates Number at every printing” is enabled, this value specifies the starting Bates Number. For example, if this value is 3, the Bates number will start from 3 on every printed document.

[Post Print Options]

View in default viewer=

Send in email=

Email sending program 32bit=

Email sending program 64bit=

Open output folder=

SharePoint Upload=

SharePoint Server=

SharePoint Directory=

SharePoint User=

SharePoint Pass=

SharePoint Silent=

SharePoint Logfile=

SharePoint utility=

SharePoint HTTPS=

SharePoint Delete=

View in default viewer=<string>

If this value is ‘Yes’ every printed document will be opened in the default viewer.

Available values: Yes, No

Default value: No

Open Tiff Viewer=<string>

If this value is ‘Yes’,  printed TIFF and PDF documents will be opened in the Black Ice IceViewer (formerly TIFF Viewer).

Black Ice IceViewer version 13.97 or later must be installed on the system.

To pass the document to the Black Ice IceViewer through memory without writing the file to disk, set the “Generate Output in Memory” option to 1.

Available values: Yes, No

Default value: No

Send in email=<string>

If this value is ‘Yes’, every printed document will be sent after printing automatically using the email sending utility.

Available values: Yes, No

Default value: No

Open output folder=<string>

If this value is ‘Yes’the output directory will be opened after every printing.

Available values: Yes, No

Default value: No

SharePoint upload=<number>

If this value is 1 the SharePoint^® uploading will be enabled.

Available values:0, 1

Default value: 0

SharePoint Server=<string>

Name of the SharePoint^® server.

SharePoint Directory=<string>

Name of the SharePoint^® repository. Use ‘/’ character instead of ‘\’ in the path specification.

SharePoint User=<string>

This value is the SharePoint^® user.

SharePoint Pass=<string>

This value is the SharePoint^® password.

SharePoint Logfile=<string>

This value is the path and name of the log file where the SharePoint utility writes logging information to. The SharePoint Logfile parameter can also be configured by using a valid environment variable.

SharePoint Silent=<number>

If this value is 1 the SharePoint^® utility will upload the documents silently without user interaction. In this case the logging feature can be used for getting information about the uploading.

Available values:0, 1

Default value: 0

SharePoint HTTPS=<number>

If this value is 1 the HTTPS encryption will be enabled for the SharePoint^® uploading.

Available values:0, 1

Default value: 0

SharePoint Delete=<number>

If this value is 1 the Printer Driver deletes the printed documents after successfully uploaded to SharePoint.

Available values:0, 1

Default value: 0

[Email Settings]

Sender Client=

SMTP Server=

SMTP Port=

SMTP Sender Email=

SMTP UserName=

SMTP Password=

SMTP Enable SSL=

Ask For Address=

Email Send Silently=

Email Sender=

Email To=

Email Cc=

Email Bcc=

Email Subject=

Email Body=

Logging Enabled=

Logging Directory=

Audit Logging Enabled=

Audit Logging Directory=

Delete Files After Sending=

Disable About Box Links=

Disable Email Settings=

Content Based Email=

Simple Content Based Email=

Display Email Sent Successfully Message=

Display Error Message=

This section defines the default settings of the email settings utility. These settings can be reached at Email Settings dialog in the Printing Preferences.

Sender Client=<number>

Available values: 0, 1

Default value: 0

0: Use default mail client

1: Use SMTP client

SMTP Server=<string>

Name of the SMTP server. Maximum length is 127 characters. This value only has to be specified when the selected Sender Client is 1.

SMTP Port=<number>

Port of the SMTP server. Maximum length is 3 characters. This value only has to be specified when the selected Sender Client is 1.

SMTP Sender Email=<string>

Email address of the sender. Maximum length is 64 characters. This value only has to be specified when the selected Sender Client is 1.

SMTP UserName=<string>

SMTP user name (usually with domain). Maximum length is 64 characters. This value only has to be specified when the selected Sender Client is 1.

SMTP Password=<string>

SMTP password. Maximum length is 31 characters. This value only has to be specified when the selected Sender Client is 1.

SMTP Enable SSL=<string>

If this value is ‘Yes’ the printer driver uses SSL to connect to the specified SMTP server. This value only has to be specified when the selected Sender Client is 1.

Available values: No, Yes

Default value: No

Ask For Address=<string>

Prompt the user only for the email address. If set to Yes, the Printer Driver will show a window at every email sending where the recipients can be specified, but will not show the complete email sending window.

Available values: No, Yes

Default value: No

Email Send Silently=<string>

If this value is ‘Yes’ the printer driver will send the printer documents to the predefined email addresses without user interaction.

Available values: No, Yes

Default value: No

Email Sender=<string>

Name of the email sender. Maximum length is 127 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Email To=<string>

To recipients. More email addresses can be specified using the “;” character. Maximum length is 127 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Email Cc=<string>

Cc recipients. More email addresses can be specified using the “;” character. Maximum length is 127 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Email Bcc=<string>

Bcc recipients. More email addresses can be specified using the “;” character. Maximum length is 127 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Email Subject=<string>

Subject of the email. Maximum length is 63 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Email Body=<string>

Body of the email. Maximum length is 515 characters. This value is only used when the silent mail sending or “Prompt the user only for the email address” is enabled.

Logging Enabled=<string>

If this value is ‘Yes’, the printer driver will generate log files about email sending.

Available values: No, Yes

Default value: No

Logging Directory=<string>

Full path of the log directory. Maximum length is 260 characters. This value is only used when the email logging is enabled. The Logging Directory parameter can also be configured by using a valid environment variable.

Audit Logging Enabled=<string>

If this value is ‘Yes’ the printer driver will generate CSV format audit log files about email sending.

Available values: No, Yes

Default value: No

Audit Logging Directory=<string>

Full path of the log directory. Maximum length is 260 characters. This value is only used when the email audit logging is enabled. The Audit Logging Directory parameter can also be configured by using a valid environment variable.

Delete Files After Sending=<string>

If this value is ‘Yes’ the printer driver will delete all files, including attachments, after the email is sent.

Available values: No, Yes

Default value: No

Disable About Box Links=<string>

If this value is ‘Yes’, the links on the About Box, on the SMTP email sending window are disabled.

Available values: No, Yes

Default value: No

Disable Email Settings=<string>

If this value is ‘Yes’, the File/Settings menu item on the SMTP email sending window is disabled.

Available values: No, Yes

Default value: No

Content Based Email=<string>

Enables content-based email sending. The content based email sending feature can be used to set the recipients, subject and body text of emails, and passwords of PDF output files by embedding special character sequences into the printed documents (for example: ##~~EmailTo=recipient@domain.com~~).

Available values: No, Yes

Default value: No

Simple Content Based Email=<string>

If this option is turned on, the first email address from the first page of the printed document is extracted and used as the recipient when sending emails.

Available values: No, Yes

Default value: No

Display Email Sent Successfully Message=<string>

If this option is turned on, the Printer Driver will show a message box with the “Email sent successfully.” Text after the email has been sent. The option is turned off automatically if the “Email Send Silently” option is set to “Yes”.

Available values: No, Yes

Default value: No

Display Error Message=<string>

If this option is turned on, the Printer Driver will show a message box with the error message if there is a problem during sending the email. The option is turned off automatically if the “Email Send Silently” option is set to “Yes”.

Available values: No, Yes

Default value: Yes

[Text Output Settings]

Filter Junk Characters=0

Glyph Conversion Method=0

No Page Headers=0

Use Legacy Coordinates=0

Add Space=

Line Breaks=

Separate Text Output Directory=

Text Output Directory=

Action on Existing Files=

Formatting Style=

Encoding=

This section defines the settings of the printer driver text output.

Generate Text Output=<1 or 0>

Enables or disables the "Generate text output" option in the Printer Driver on the Text Output tab.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Generate text output" option

1: Enable the "Generate text output" option

Mail Merge=<1 or 0>

Enables or disables the "Mail Merge" option in the Printer Driver on the Text Output tab.

When the Mail Merge option is checked, the driver recognizes special character sequences in the printed text to extract information into an MRG file.

Available for Printers: ColorPlus, TIFF\Monochrome, PDF

Available values:

0: Disable the "Mail Merge" option

1: Enable the "Mail Merge" option

Filter Junk Characters=<number>

Some text is passed by the printing application to the printer driver as a series of glyph indexes of a font instead of regular characters. If this value is set to 0, the printer driver tries to convert these indexes to characters using the method defined by the “Glyph Conversion Method” value, but this is not guaranteed to work every time and may result in Junk characters appearing in the text output. Setting this value to 1 will filter glyph indexes from the text output.

Available values: 0, 1

Default value: 0

Glyph Conversion Method=<number>

Method for converting glyph indexes to text. Try to change this if you get junk characters. Default value is 0.

Available values: 

0: Try to guess the best method (default) – This option tries to determine the appropriate method for converting glyph characters to text. This method does not depend on the Character Set setting of the printer driver; it is usable for any language.

1: Use glyph table from the font file

2: Shift values (mainly for printing from Adobe Reader)

3: Legacy automatic - The automatic glyph conversion method has changed with Printer Driver version 14.56. This option uses the glyph conversion method from Printer Driver version 14.55 and earlier, and could be useful to achieve the same text output as with version 14.55 and earlier. This method is usable for languages that primarily use the English alphabet. The method depends on the Character Set setting of the printer driver. It is recommended to use the ANSI Character Set in the Text Output configuration. If the Character Set is not set to ANSI, this method is the same as the "Shift values" method.

No Page Headers=<number>

If set to 0, the a page header (“Page X” text) is inserted before the content of each page in the text output.

Available values: 0, 1

Default value: 0

Use Legacy Coordinates=<number>

Use the old text coordinate calculations, like in version 14.35 and older Printer Drivers.

Available values: 0, 1

Default value: 0

Add Space=<number>

The Detect space in text feature automatically detects the space characters between the EMF records from the input document, and inserts the spaces between the appropriate words in the text output.

Available values:

0: Never add space

1: Always add space

2: Automatic

Default value: 2

Line Breaks=<number>

Line Break format specifies the format of the line breaks in the generated text output.

Available values:

1: Windows <CR><LF>

2: UNIX/Mac <LF>

3: Mac OS 9 or older <CR>

Default value: 1

Separate Text Output Directory=<number>

When the Separate Text Output Directory option is disabled, the printer driver will use the same output directory for the Text Output as the normal output. If it is enabled, the text output directory can be specified using the Text Output Directory ini file value.

Available values:

0: Disable

1: Enable

Default value: 0

Text Output Directory=<string>

Full path of the text output directory. Maximum length is 260 characters. This value is only used when the Separate Text Output Directory is enabled.

Action on Existing Files=<number>

Possible actions if the text output file already exists

Available values:

0: Append to the existing file

1: Overwrite the existing file

2: Rename the new file

Default value: 0

Formatting Style=<number>

Formatting style defines whether to generate plain text from the printed document, or to add font information, position and style for the generated text. Adding position, style and font information could be useful if one intend to convert the text back to formatted document.

Available values:

0: Pain text

1: Add font information, position and style

2: Text with layout

Default value: 0

Encoding=<number>

By default, the text file is generated as ANSI text, however, UNICODE text is also supported. In order to turn on the UNICODE text support, select an UNICODE option from the Character Set dropdown list.

Available values:

0: Ansi

1: Unicode UTF-8

2: Unicode UTF-16

3: Unicode UTF-16 Big Endian

Default value: 0

Generate In Memory=<string>

If this value is set to “Yes”, the Text is output is generated in memory and passed using Message Capture.

Available values: Yes, No

Default value: No

Line Adjustment=<number>

Adjusts the minimum line height when converting formatted documents to text using the "Text with layout" option (expressed as a percentage).

Available values: Positive integer value between 1 and 1000.

Default value: 100

[Barcode Settings]

Enable=

Type=

Value Source=

Value=

Value File=

RegExp File=

RegExp Format File=

First Page Only=

Transparency=

Align=

Vertical Align=

X Offset=

Y Offset=

Orientation=

Unit=

1D Subtype=

1D Write Text=

1D Minimal Bar Width=

1D Minimal Space Width=

1D Ratio=

1D Quiet Zone=

QR EC Level=

QR Module Size=

QR Quiet Zone=

DM Module Size=

DM Quiet Zone=

DM Append=

DM Append Index=

DM Append Total=

DM Append Chain ID=

P417 Truncated=

P417 EC Level=

P417 Quiet Zone=

P417 Columns=

P417 Rows=

P417 Column Width=

P417 Column Height=