Modifying the INI file flags

The Flags key is only for Printer Drivers version 15.26 and older. For newer Printer Drivers, please see the configuration INI file keys on the following page: http://www.blackice.com/private/rtk/Description_of_the_INI_file_values.htm

Any modification to the INI file, after installation, requires to reload the INI file into the printer driver by clicking on the “Restore defaults” option on the bottom of the “Device Settings” Tab. The printer driver reads the INI file only once during installation. Any change to the INI file after installation will have no effect on the printer driver until the system is rebooted or clicked on the “Restore defaults” bottom on the “Device Settings” Tab.

The OEM Printer Driver INI files location:

The INI file for each Black Ice OEM printer driver is located by default in the "\Program Files\Black Ice Software LLC\Black Ice Color Printer Driver\Distribution" folder. (for the color driver for example)  The “Distribution” folder is installed with the Printer Driver.

The INI file name is:

BuCiniNT.ini             - for the Color driver

BuAiniNT.ini             - for the ColorPlus driver

BuEIniNT.ini             - for the EMF (metafile) driver

BuMIniNT.ini            - for the TIFF (monochrome) driver

BuPIniNT.ini             - for the PDF driver

BuCIniTS.ini             - for the Color Terminal Server driver

BuAIniTS.ini             - for the ColorPlus Terminal Server driver

BuEIniTS.ini             - for the EMF Terminal Server driver

BuMIniTS.ini             - for the TIFF Terminal Server driver

BuPIniTS.ini             - for the PDF Terminal Server driver

NOTE: In case of Demo OEM Printer Drivers the INI file names are different. The NT is replaced with ND, and the TS is replaced with TD. For example in case of ColorPlus OEM Demo: BuAiniND.ini for Desktop, and BuAiniTD.ini for Server.

The End User Licensed printer drivers INI files location:

On 32 bit operating system:

C:\Windows\System32\Spool\Drivers\w32x86

C:\Windows\System32\Spool\Drivers\w32x86\3       

On 64 bit operating system:

C:\Windows\System32\spool\drivers\x64

C:\Windows\System32\spool\drivers\x64\3

Note: The Modified INI files must be coped into both location!

Modifying the INI Flags:

Flag description:

For Example:

Certain driver configuration Flags can represent multiple driver configuration definitions. Each driver configuration definition represent a bit position in the Flag. Each bit value defines a feature such as use of the TIFF DLL. The  defines for using the TIFF DLL is “BLF_ENABLETIFFDLL”, and it is specified with HEX value. The Computed HAX value for multiple defines must be converted decimal number. The Flags value is specified in decimal numbers.

If one would like to generate a separate TIFF or JPEG file for every page of the printed document with page numbering,

the value of the “Flags” in the INI file can be calculated in the following way:

(BLF_ENABLETIFFDLL)                0x00004000 +

(BLF_ENABLEJPEGDLL)               0x00008000 +

(BLF_PAGENUMBERING)             0x00000008 +

(BLF_MULTIIMAGE)                      0x00000020 +

_____________________________________

Sum of                                    0x0000C028

The C028 HEX value in decimal is 49192.

You have to write in the INI file:

Flags=49192

When adding the numbers together, either all numbers must be decimal, or all numbers must be hexadecimal. They cannot be mixed. The end result must be written to the INI file as decimal.

Frequently used INI file examples and configurations

The following sections contains examples of how to configure a Black Ice INI file to preconfigure commonly used configurations, such as Merge, Split, Fine Fax Resolution, Standard Fax Resolution.

The examples can be used to easily create CUSTOM INI files for large scale deployments for MSI Installers, and to preconfigure the Black Ice Printer Driver settings right after the installation.

Some of the settings in the default INI file are just examples. If the semicolon ; mark is at the beginning of the line, the printer driver will ignore the line. So if you need to modify the Custom Filename Template for example, you should change it as you can see on the following image (delete the ; mark);

Split multipage documents to separate single page output documents

Find the following line in the INI file:

Flags=-2147424224

Change the line to the following:

Flags=-2147424256

Enable Save As and Disable Group File

If one wanst to use the "Enable Save As Option", and "Disable Group File" the

value of the Flags in the INI file can be calculated as the following:

(BLF_DISABLEGROUPFILE 0x00000800 +

(BLF_ENABLESAVEAS)                   0x80000000

_________________________________________

0x80000800

0x80000800 HEX value in decimal is 2147485696.

One has to write in the INI file:

Flags=2147485696

Merge documents to multipage documents

To enable “Merge document to multipage document” mode, the following options have to modified in the INI file:

[Default Settings] 

Flags=-2146375648

FileNameGenerationFlags=3

FixedFileName=Merged-documents

Enable Merge Window=0

Explanations of the Flags values:

            The flags value consists of the following hexadecimal values added together:

Disable File Format -> Save each page as separate file                     0x00000020

Enable Filename Generation -> Disable Group File                             0x00000800

Disable Start Application -> Disable the Messaging Interface              0x00002000

Enable the use of the TIFF32.dll                                                          0x00004000

Enable the use of the JPEG32.dll                                                        0x00008000

Enable Filename Generation -> Save As Option                                 0x80000000

Added together:                                                                                   0x8000E820        

Converted to decimal:                                                                       -2147424224

The "Enable merge" option also enables the following:

Enable Filename Generation ->

Combine/Merge multiple documents into a single file                   0x00100000

Added together with merge options:                                                    0x8010E820        

Converter to decimal:                                                                       -2146375648

Printing to 204x196 DPI Fine Fax Compatibility

To enable “204x196 DPI Fine Fax Compatibility” mode, the following options have to modified in the INI file:

[Default Settings]

X DPI=200

Y DPI=200

File Format=4

Flags=-2147096542

FileExtension=TIF

PaperWidthInPixels=1700

PaperHeightInPixels=2200

            Explanations of the Flags values:

            The flags value consists of the following hexadecimal values added together:

Disable File Format -> Save each page as separate file                     0x00000020

Enable Filename Generation -> Disable Group File                             0x00000800

Disable Start Application -> Disable the Messaging Interface              0x00002000

Enable the use of the TIFF32.dll                                                          0x00004000

Enable the use of the JPEG32.dll                                                        0x00008000

Enable Filename Generation -> Save As Option                                 0x80000000

Added together:                                                                                   0x8000E820        

Converted to decimal:                                                                       -2147424224

The "Enable faxable image" option also enables the following:

Enable Device Settings -> Rotate Landscape image to Portrait          0x00040000

Enable Device Settings -> Create faxable image                                 0x00010000

204x196 DPI Fine fax Compatibility                                                     0x00000002

Added together with fax options:                                                          0x8005E822        

Converter to decimal:                                                                        -2147096542

Printing to 204x98 DPI Standard Fax Compatibility

To enable “204x98 DPI Standard Fax Compatibility” mode, the following options have to modified in the INI file:

[Default Settings]

X DPI=204

Y DPI=98

File Format=4

Flags=-2147092448

FileExtension=TIF

PaperWidthInPixels=1734

PaperHeightInPixels=1078

Explanations of the Flags values:

            The flags value consists of the following hexadecimal values added together:

Disable File Format -> Save each page as separate file                     0x00000020

Enable Filename Generation -> Disable Group File                             0x00000800

Disable Start Application -> Disable the Messaging Interface              0x00002000

Enable the use of the TIFF32.dll                                                          0x00004000

Enable the use of the JPEG32.dll                                                        0x00008000

Enable Filename Generation -> Save As Option                                 0x80000000

Added together:                                                                                   0x8000E820        

Converted to decimal:                                                                       -2147424224

The "Enable faxable image" option also enables the following:

Enable Device Settings -> Rotate Landscape image to Portrait          0x00040000

Enable Device Settings -> Create faxable image                                 0x00010000

204x98 DPI compatibility mode                                                          0x00001000

Added together with fax options:                                                          0x8005F820        

Converter to decimal:                                                                        -2147092448

Start Application with parameters

LaunchFlags=12

Change the line to the following:

LaunchFlags=13

StartApplicationParameterOrder=12345680

Change the line to the following:

StartApplicationParameterOrder=80000000

ApplicationPath=

Change the line to the following:

ApplicationPath=C:\test\MyApplication.exe

Adding a custom paper size

Under the [Paper Size Definitions] bracket, make sure that the Number of Paper Sizes value is equal with the total number of paper sizes. By default, the printer driver has 177 predefined paper sizes, which means if one adds a custom paper size, the Number of Paper Sizes must be increased with 1:

Under the [Paper Size Definitions] bracket:

Number of Paper Sizes=178

…

Under Paper177 paper definition (or under the last added paper definition), add the following lines:

; Custom paper size definition

; Available must be set to 1 to make the paper size available on the user interface.

Paper178 Available=1

; Title is the displayed name of the paper size on the user interface

Paper178 Title=My Custom Paper Size

; The width and height of the paper size, in the selected units.

Paper178 Width=200

Paper178 Height=800

Paper178 Units=MM

; The WindowsPaperCode is the unique identifier for the paper definition.

; Use this when selecting the default paper size under [Default Settings] Paper Size flag.

Paper178 WindowsPaperCode=336

…

Under the [Default Settings] bracket:

; The following flag sets the default paper size in the Printer Driver.

; Use the PaperXYZ WindowsPaperCode value of the newly added custom paper size

; to configure the paper size as the default.

Paper Size=336