Miraplacid Text Driver SDK Installer manual
Contents
Miraplacid Text Driver Installer Component
Miraplacid Text Driver SDK Edition can be installed from special Installer Component.
This is self-extracting DLL file which can be used from external setup utility.
This file is not present in the package; it could be generated with special utility, Setup Maker.
Installer component exposes two kind of interfaces: DLL exported funstions (API) and COM interface.
COM interface allows extenal program to have detailed information about installation process.
COM parameters are: coclass MTDSsetup (Miraplacid.MTDSetup {8BB15E2B-71EC-4c7d-BA6B-3C913DC3E1A7}).
It contains two interfaces: IMTDSetup {CD78360C-D3BA-4b0b-BC53-F008ECBF4F0F}, the main interface, and
connection point interface _IMTDSetupEvents {EA50BBB8-9FF4-4731-A670-28BCBA417BCC} for installation events from Installer component
to external software.
Example of setup utility is located at examples\setupui folder at this package. It is written in VB. Please, read readme.txt in this folder.
Miraplacid Text Driver Installer Component Reference
IMTDSetup interface
| Property |
Type |
Description |
| Installed |
Number |
(Read Only) 1 if Text Driver SE installed, 0 if not installed.
|
| Method |
Parameters |
Description |
| Install |
String |
Installs Text Driver SE to specified location. Some events will be generated during the process.
|
| Uninstall |
None |
Uninstalls Text Driver SE. Some events will be generated during the process.
|
_IMTDSetupEvents interface
| Event |
Parameters |
Description |
| OnProgress |
Number |
This event informs external software about installation/uninstallation progress. Value is in range 0 - 100.
|
| OnWarning |
Number code, String message |
Raises when non-critical event is occured. External software may ignore this event and continue.
|
| OnError |
Number code, String message |
Raises when critical error is happened. Further processing is impossible.
If this occured during installation, rollback will be performed - all installed components will be removed.
During rollback, OnProgress will be called with decreasing value.
Code is internal Miraplacid value; it is provided for informational purposes.
|
Functional interface (API)
| Function |
Parameters |
Description |
| Install |
const wchar * |
Installs Text Driver SE to specified location. There is no way to obtain progress and error information.
|
| Uninstall |
void |
Uninstalls Text Driver SE. There is no way to obtain progress and error information.
|
Setup Maker utility
Setup Maker utility allows you to create your own custom Text Driver SE installation. It will include only components you select.
Besides, it provides you a way to make a partial re-branding of Miraplacid Text Driver.
User interface of this utility consists of the following tabs:
Rendering plug-ins
This page allows you to select rendering plug-ins to be included into installer DLL component.
Transport plug-ins
This page allows you to select transport plug-ins to be included into installer DLL component.
Driver properties
This page allows you give your own names to driver components. Driver name, Driver comments, Print monitor name, Port name, Port comments, Printer name, Print Processor name and Share name
are properties which will be used (and appear) in printer properties window.
Driver files prefix is a prefix before the standard Miraplacid driver filenames.
It is provided to prevent filename collisions between different
products based on Miraplacid Text Driver
and Text Driver itself, bacause some driver files got to be placed to Windows system folder.
Standard Miraplacid Text Driver prefix is "mtd".
User interface
This page provides you a way to choose from 3 options: to keep Miraplacid User Interface component,
include your own UI component, or build installation without UI.
Also, you may specify registry folder which will be used by all Text Driver components for
settings storage.
When you press on OK button, Setup Maker will generate installation package.
It will be named mText Driver.dll and placed into the current folder.
See also:
|
