Auto-print C++ Sample

 

Description:

The Auto-print sample provides developers with a framework for creating automated batch printing or document conversion solutions either with or without user interaction. The Auto-print technology can be used with Black Ice printer drivers. Please refer to the Supported Document Type section to see the supported file formats to convert.

 

To see the detailed instructions on how to configure the sample, please see the Configuring the Auto-print C++ Sample. For redistributing the Auto-print sample, please see the necessary files in Redistribution files of the Auto-print C++ Sample section. For more information about how to use and track the processed documents, please refer to the Using the Auto-print C++ Sample section.

 

By using Auto-print technology, an application can automatically print commonly used documents types without any user interaction. The Auto-print sample comes with a simple, effective and easy to use interface to demonstrate the basic features and possibilities.

 

Select printer:

Select the Black Ice Printer Driver to use for converting documents.

Input folder:

Select the input directory which contains the documents need to be converted.

Converted (Output) folder:

Specifies the path of the directory which contains the successfully converted documents. If it’s not configured, the converted documents will be saved into the Printer Driver’s output directory.

Processed folder:

Specifies the path of the directory which contains the original documents, which were successfully processed/converted.

Failed folder:

The files which cannot be converted will be moved into this directory.

Log file:

Specifies the log file’s location and name. The sample logs every printed filename with path, printing date/time, elapsing time and every occurring warnings and errors during the printing.

Profile:

Applies a predefined profile for the document conversion. For more information about the available profiles in the Black Ice Printer Drivers, please see the Predefined Profiles section.

NOTE: 32-bit Auto-print samples cannot load profiles from 64-bit Black Ice Printer Drivers installed on 64-bit operating systems.

 

NOTE: when specifying the Input, Converted, Processed, Failed directories and Log file, environment variables are also can be used.

 

Developers:

The Auto-print samples use the BiAutoPrint.dll or ActiveX control.

 

System Requirements:

Windows 11/10/8/7

Windows 2022/2019/2016/2012 or Citrix Server

 

Save As window, Open Output folder and Group file generation restrictions

The Auto-print samples does not allow Save As window pop up during the conversion, Open Output Feature, and Group file generation even if it’s configured in the Black Ice Printer Driver used for conversion.

 

Advanced error handling and Spooler restart

Auto-print samples are including advanced error handling which attempts to restart the spooler service on the system if it’s stops working during the conversion. In order to use advanced error handling, make sure that the Auto-print sample is running As Administrator.

 

Filename Generation

The Auto-print will save the printed documents in the same name as the source input document. For example, if printing 1.jpg to PDF file format, then the printed document will be named to 1.pdf.

NOTE: If there is already a file named 1.pdf, Auto-print will overwrite the existing file.

 

Sample Source Code Folder Location:

<Auto-print Installation folder>/<Auto-print 32/64 bit>\Samples\Sample Source Codes\AutoPrint C++ Sample

 

Solution files

Compilers

Auto Print C++ Sample_VS2005.sln

Visual Studio 2005

Auto Print C++ Sample_VS2010.sln

Visual Studio 2010

Auto Print C++ Sample_VS2012.sln

Visual Studio 2012

Auto Print C++ Sample_VS2013.sln

Visual Studio 2013

Auto Print C++ Sample_VS2015.sln

Visual Studio 2015