To set preferences for ActMask Virtual Printer Driver SDK via registry, please see details below.


Registry Key:
Key for personal settings: HKEY_CURRENT_USER\SOFTWARE\%PrinterName%
Key for global settings: HKEY_LOCAL_MACHINE\SOFTWARE\%PrinterName%

ActMask Virtual Printer Driver tries to load personal settings first. If this key does not exist and there's key for global settings under HKEY_LOCAL_MACHINE, global settings will be applied.

In trial version of SDK:
Trial version of SDK installs two printers - "ActMask Virtual Printer" and "ActMask Virtual Printer 1".

Keys for ActMask Virtual Printer:
HKEY_CURRENT_USER\SOFTWARE\ActMask Virtual Printer
HKEY_LOCAL_MACHINE\SOFTWARE\ActMask Virtual Printer

Keys for ActMask Virtual Printer 1:
HKEY_CURRENT_USER\SOFTWARE\ActMask Virtual Printer 1
HKEY_LOCAL_MACHINE\SOFTWARE\ActMask Virtual Printer 1

In customized SDK:
For example, the customized printer name is "ABC TIFF Printer", the keys are listed below:
HKEY_CURRENT_USER\SOFTWARE\ABC TIFF Printer
HKEY_LOCAL_MACHINE\SOFTWARE\ABC TIFF Printer

Registry Values:

-> General Settings
-> Output Formats: PDF, TXT, EMF, JPG, TIF, PNG, BMP, TGA, PCX, SPL

-> PDF Settings | Image Settings | TXT Settings | EMF Setting

-> Remove Pages from print job & Additional User Data
-> Watermark Settings
-> Print Job RedirectionSettings
-> Distribution Settings: Task | Pre-Processing | Pipe | FTP | HTTP | Socks Proxy, etc.

General Settings:
Value Name:
DisPersonalSettings





DebugMode





OutputFolder

OutputFilePrefix

OutputFile


OutputMode



DisableGUI

PlaySound
Data Type:
String





DWORD





String

String

String


DWORD



String

String
Details:
Disable personal settings if this value is set to "1".
Please note the key is HKEY_LOCAL_MACHINE\SOFTWARE\%PrinterName%
SDK only loads global settings under HKEY_LOCAL_MACHINE\SOFTWARE\%PrinterName% and ignores personal settings under HKEY_CURRENT_USER\SOFTWARE\%PrinterName% if this value is set to "1".

Create log file in folder C:\ActMask If this value does not exist, value 0 will be applied.
0 - Do not create log.
1 - Create crash log.
2 - Create log file always.

ActMask Virtual Printer SDK saves file(s) to this folder.

Add prefix specified to output file name if OutputMode equals to 3, 4 or 5.

If you would like to specify file name for output directly, set this setting before printing. and OutputMode should equal to 2.

Specify output mode. If this value does not exist, value 3 will be applied.
2 - Save file with name specified.
3 - Save file to folder specified.

Disable GUI if this value is set to "1".

Disable sound if this value is set to "0".

Output Formats:
Value Name:
OutputFormat

















Data Type:
String

















Details:
Specify output format for file(s) exported from ActMask Virtual Printer Driver.
"PDF" - Export PDF format.
"JPG" - Export JPG format.
"BMP" - Export BMP format.
"GIF" - Export PNG format.
"PNG" - Export PNG format.
"TIF" - Export Multi-Page / single page TIFF format.
"TGA" - Export TGA format.
"PCX" - Export PCX format.
"TXT" - Export TXT format.
"EMF" - Export EMF format.
"SPL" - Export SPL format.


"None" - Export INI file contains printing information only.

For example:
PDF
PDF;TXT;JPG;GIF;PNG;BMP;TIF;TGA;PCX;EMF

Remove Pages from print job, Additional User Data:
Value Name:
OutputRemovePages


UserData

Data Type:
String


String

Details:
Specify the page number or page range should be removed from print job. For example, 3,5,9,13-33,77-99999

It allows you to send additional user data to your application. User data will be stored into "UserData" section of INI file and passed to your application.

PDF Settings:
Value Name:
PDFTitle
PDFSubject
PDFKeywords
PDFAuthor
PDFDocVer



PDFCompression





PDFImageCompression




PDFJPGQuality


PDFEmbedFont



PDFImagePDF



PDFGDIROPMode








PDFPagesPerSheet


PDFColorSpace




PDFEncryption




PDFPassUser


PDFPassOwner


PDFPermPrint


PDFPermCopy


PDFPermEdit


PDFPermAddNotes


PDFPermFillFields


PDFPermCopyAccess


PDFPermPrintFull


PDFPermAssemble

Data Type:
String
String
String
String
String



DWORD





DWORD




DWORD


String



String



DWORD








DWORD


DWORD




String




String / Binary


String / Binary


String


String


String


String


String


String


String


String

Details:
Specify title of PDF document.
Specify subject of PDF document.
Specify key words of PDF document.
Specify author of PDF document.
Specify version of PDF document.
Default value: "1.4".
1.2 - 1.6, PDF/A.

Compress PDF content.
0 - None
1 - Default
2 - Fastest
3 - Max

Specify how to compress images.
0 - Flate
1 - JPEG
2 - JPEG2000

The graphics quality for JPEG output format.
Default value: 70

Compress fonts within PDF document.
"0" - Don't embed fonts.
"1" - Embed fonts.

Specify PDF format.
"0" - Save as searchable PDF. If this entry does not exist, 0 will be applied.
"1" - Save as image PDF.

Specify the rendering mode for GDI ROP codes.
ROP codes: Complex raster mask operations, used by MS PowerPoint frequency.
0 - Don't handle GDI ROP codes.
1 - Rasterize if necessary
2 - Render GDI ROP codes. On WinXP, Windows complex script support is needed. To enable this feature, please open Windows Control Panel -> Regional and language options -> Language tab, enable it.

Specify how many pages of your document to print on one piece of PDF document created.

The device color space used in PDF file
0 - RGB color space
1 - CMYK color space. Reserved.
2 - Gray color space

Apply encryption for PDF document.
"0" - Don't encrypt PDF Document.
"128" - Apply PDFPassUser, PDFPassOwner for PDF document with 128 bit encryption.

User password for PDF document. If you want to hide password in registry, use dll we provided to store password with AES encryption.

Owner password for PDF document. If you want to hide password in registry, use dll we provided to store password with AES encryption.

"0" - Don't allow the user to print the PDF document.
"1" - Allow the user to print the PDF document.

"0" - Don't allow the user to copy text and graphics from the PDF document.
"1" - Allow the user to copy text and graphics from the PDF document.

"0" - Don't allow the user to edit the PDF document.
"1" - Allow the user to edit the PDF document.

"0" - Don't allow the user to add annotations.
"1" - Allow the user to add annotations.

"0" - Don't allow the user to fill in form fields.
"1" - Allow the user to fill in form fields.

"0" - Disable copying for use with accessibility features.
"1" - Enable copying for use with accessibility features.

"0" - Force low-resolution printing of the document only.
"1" - Enable High-Resolution Printing.

"0" - Don't allow the user to assemble the PDF document.
"1" - Allow the user to assemble the PDF document.

Image Settings:
Value Name:
ResizingRate


ResizingWidth


ResizingHeight


ResizingMode




JPEGQuality


TIFMultiPage




TIFBitsPerPixel






TIFEncodingMode








TIFDitheringMode











PNGBitsPerPixel






PNGDitheringMode











BMPBitsPerPixel






BMPDitheringMode










Data Type:
String


DWORD


DWORD


DWORD




DWORD


String




DWORD






DWORD








DWORD











DWORD






DWORD











DWORD






DWORD










Details:
The scaling rate for image output.
Defaulet value: 33

Specify width for image output, in pixels. Set it to 0 to create image(s) with ResizingRate.

Specify length for image output, in pixels. Set it to 0 to create image(s) with ResizingRate.

Specify mode for image scaling.
0 - Create image(s) with Simple Playback mode.
1 - Create image(s) with Nearest Neighbour Playback mode.
2 - Create image(s) with Bilinear Playback mode.

The graphics quality for JPEG output format.
Defaulet value: 85

Specify how to create TIFF file(s).
Defaulet value: "1"
"0" - Create single TIFF file for each page.
"1" - Create multi-page TIFF file contains all pages.

Set color depth for TIFF image. If this value does not exist, 24 Bpp (True color) will be applied.
1 - 2 colors (black and white).
4 - 16 colors.
8 - 256 colors.
24 - True color, 24 bits per pixel.

Set encoding mode for TIFF image. If this value does not exist, 0 will be applied.
0 - Auto.
1 - None.
2 - CCITT3, TIFBitsPerPixel should be set to 1 (1Bpp).
3 - CCITT4, TIFBitsPerPixel should be set to 1 (1Bpp).
4 - RLE, TIFBitsPerPixel should be set to 1 (1Bpp).
5 - LZW.

Set dithering mode for TIFF image. If this value does not exist, 0 will be applied.
0 - None.
1 - Floyd-Steinberg.
2 - Ordered-Dithering (4x4).
3 - Burkes.
4 - Stucki.
5 - Jarvis-Judice-Ninke.
6 - Sierra.
7 - Stevenson-Arce.
8 - Bayer (4x4 ordered dithering).

Set color depth for PNG image. If this value does not exist, 24 Bpp (True color) will be applied.
1 - 2 colors (black and white).
4 - 16 colors.
8 - 256 colors.
24 - True color, 24 bits per pixel.

Set dithering mode for PNG image. If this value does not exist, 0 will be applied.
0 - None.
1 - Floyd-Steinberg.
2 - Ordered-Dithering (4x4).
3 - Burkes.
4 - Stucki.
5 - Jarvis-Judice-Ninke.
6 - Sierra.
7 - Stevenson-Arce.
8 - Bayer (4x4 ordered dithering).

Set color depth for BMP image. If this value does not exist, 24 Bpp (True color) will be applied.
1 - 2 colors (black and white).
4 - 16 colors.
8 - 256 colors.
24 - True color, 24 bits per pixel.

Set dithering mode for BMP image. If this value does not exist, 0 will be applied.
0 - None.
1 - Floyd-Steinberg.
2 - Ordered-Dithering (4x4).
3 - Burkes.
4 - Stucki.
5 - Jarvis-Judice-Ninke.
6 - Sierra.
7 - Stevenson-Arce.
8 - Bayer (4x4 ordered dithering).

TXT Settings:
Value Name:
TXTMultiPage




TXTFormat




TXTKeepFormatting




Data Type:
String




String




String




Details:
Specify how to create TXT file(s).
Default value: "1"
"0" - Create TXT file for each page.
"1" - Create one TXT file contains all pages.

Specify the format for TXT file(s).
Default value: 0
0 - Create TXT file in Unicode format.
1 - Create TXT file in ansi format.

Keep the formatting possible.
Default value: 0
0 - Export characters in print order.
1 - Keep the layout formatting possible. Please note txt file is created in Unicode format.

EMF Setting:
Value Name:
EMFEmbedFont














Data Type:
String














Details:
Just ignore this option if print job is printed from PDF document.
Adobe PDF document may use embedded fonts, to support these fonts, just enable this option.
"0" - Disable this option.
"1" - Support EMF file contains embedded fonts.

Full path of this tool: %Windows%\%PrinterName%\EMFReg.exe, for example, in trial version, the location is C:\Windows\ActMask Virtual Printer\EMFReg.exe

Follow steps to render EMF file:
run EMFReg.exe reg "full path of the first emf file"
wait until EMFReg.exe has terminated.
render EMF files
run EMFReg.exe unreg "full path of the first emf file"

Watermark Settings:
Value Name:
WatermarkEnabled



Watermark0






WatermarkPDFTranslucent



WatermarkOrder
Data Type:
String



String






String



DWORD
Details:
Apply watermark on output file(s).
"0" - Disable watermark.
"1" - Enable watermark.

Watermark settings on output file(s).
Format:
"Text:;HAlign:;VAlign:;Rotation:;Color:;FontName:;FontSize:;"
For example,
"Text:This's Demo;HAlign:0;VAlign:0;Rotation:30;Color:8080ff;
FontName:Verdana;FontSize:0;"

Set watermark on PDF as Translucent.
"0" - Apply solid watermark on PDF.
"1" - Enable translucent watermark on PDF.

Z-order of watermark.

Print Job Redirection Settings:
Value Name:
RedirectPrintJob0
RedirectPrintJob1
RedirectPrintJob2
RedirectPrintJob3
RedirectPrintJob4
RedirectPrintJob5
























Data Type:
String





























Details:
Redirects print job to printer.
Format:
[PrintMode:n;][PrinterName:;][ColorMode:n;][Copies:n;][Order:n;]
[RemoveBlankSpace:n]

ie. PrintMode:2;PrinterName:Canon Bubble-Jet BJC-255SP;ColorMode:0;Copies:0;Order:0;RemoveBlankSpace:0

PrintMode:
0 - Don't redirect print job
1 - Using selected printer's printing preferences
2 - Using print job's original print parameters

ColorMode:
0 - Auto
1 - Print job in Black & White
2 - Print the first page in color, others in Black & White

Copies:
0 - Auto. Sending the print option "copies of document" specified when printing to printer.
1~n - Using selected printer's printing preferences

Order:
0 - Default value. Redirect print job after SDK converts into target format(s)
1 - Redirect print job before SDK converts it into target format(s)

RemoveBlankSpace:
Remove extra blank space at the foot if it sets to 1. This is useful for redirecting print job created by POS software.

Distribution Settings: Task, ZIP, FTP, HTTP, Socks
Value Name:
DispRunTaskMode



DispRunTask







------- ZIP Settings -------
DispZIPCompress



DispZIPPass



---- Distribution Settings ----
DispFiles



DispZIPFiles



DispDelFilesAfterDisp



DispZipDelFilesAfterDisp


------- Pipe Settings -------
DispPipeEnabled




DispPipeName

------- FTP Settings -------
DispFTPEnabled



DispFTPHost
DispFTPPort


DispFTPAccount
DispFTPPass


DispFTPRemoteDir

------- HTTP Settings -------
DispHTTPEnabled














DispHTTPUrl

DispHTTPMode




------- Socks Settings -------
DispSocksProtocol



DispSocksHost
DispSocksPort


DispSocksRequestAuth




DispSocksAccount
DispSocksPass

Data Type:
DWORD



String








String



String / Binary




String



String



String



String



String




String



String



String
DWORD


String
String / Binary


String


String














String

DWORD





String



String
DWORD


String




String
String / Binary

Details:
0 - Don't call Task.
1 - Call Task after creating file(s).
2 - Call Task after distributing file(s).

A null-terminated string that specifies the command line to execute, and you can pass parameter %1, %2 or %3 to the application.
%1 - The name of first file created.
%2 - Number of files.
%3 - The name of ZIP file created.
For example,
"C:\YourApplication.exe %1 %2"
"C:\YourApplication.exe %3"

Create ZIP file for output file(s).
"0" - Don't create ZIP file.
"1" - Created ZIP file.

Create ZIP file with this password you specified.
"" - No password protection.
"Your password" - Created ZIP file with password. To hide password in registry, use dll we provided to store password with AES encryption.

Distribute file(s) created.
"0" - Don't distribute file(s) created.
"1" - Distribute file(s) created.

Distribute ZIP file(s) created.
"0" - Don't distribute file(s) created.
"1" - Distribute file(s) created.

Delete file(s) created after distribution.
"0" - Don't delete file(s) created.
"1" - Delete file(s) created after distribution.

Delete file(s) created after distribution.
"0" - Don't delete ZIP file(s) created.
"1" - Delete ZIP file(s) created after distribution.

Transfer EMF files and DEVMODE through named pipe. In current version, this function only supports EMF format.
"0" - Don't distribute EMF files and DEVMODE information.
"1" - Distribute EMF files and DEVMODE information.

EMF files and DEVMODE information are passed through this named pipe.
For more details, please contact support@all2pdf.com

Upload file(s) created to FTP server.
"0" - Don't upload file(s) created.
"1" - Upload file(s) created to FTP server.

Host name of FTP server.
Port of FTP server.
Default value: 21.

Account name.
Password of account. If you want to hide password in registry, use dll we provided to store password with AES encryption.

Upload file(s) to this directory.


Uploading file(s) created to web site via HTTP. Please note DispFiles should be set to 1 if you would like to upload files via HTTP.
"0" - Don't upload file(s) created.
"1" - Upload file(s) created to web site via HTTP.

PHP file for handling uploaded file, for testing purpose.
<?php
echo "Upload: " . $_FILES["file"]["name"] . "<br />";
echo "Type: " . $_FILES["file"]["type"] . "<br />";
echo "Size: " . ($_FILES["file"]["size"] / 1024) . " Kb<br />";
echo "Stored in: " . $_FILES["file"]["tmp_name"];
//copy uploaded file to other folder
//etc.
?>

The address url which accepts upload file(s).

Specify the HTTP uploading mode should be used.
0 - Post files, in binary mode
1 - Post files but Post ANSI txt files in text mode
2 - Post files but Post ANSI txt files in text mode. HTTP request body only contains text data

Specify if Socks proxy is used.
"" - Don't use proxy.
"Socks4" - Upload file(s) via Socks4 proxy.
"Socks5" - Upload file(s) via Socks5 proxy.

Host name of Socks proxy.
Port of Socks proxy.
Default value: 1080.

Specify if Socks proxy requests account authentication.
"0" - Account authentication is not requested.
"1" - Account authentication is requested.

Account name.
Password of account. If you want to hide password in registry, use dll we provided to store password with AES encryption.