123 lines
5.1 KiB
Plaintext
123 lines
5.1 KiB
Plaintext
03/15/94
|
||
|
||
|
||
|
||
Notes on how to use the Type 1 Installer under Win32.
|
||
-----------------------------------------------------
|
||
|
||
|
||
|
||
|
||
INTRODUCTION
|
||
|
||
The Type 1 Installer exists in many different forms. This text
|
||
describes the use of it as a Win32 DLL. The DLL acts as a compiler
|
||
that parses an Adobe type 1 font format file and a metrics file (PFB
|
||
+ PFM), and then produces a TrueType font file.
|
||
|
||
The DLL will interact with the event log and the registry, under
|
||
certain conditions. The registry is always queried at the start of
|
||
the conversion to verify if the copyright holder has agreed to have
|
||
their font converted. The event log is used if an error occurs and if
|
||
the "Log events" entry in the registry is not zero. The required
|
||
entries in the registry is described in "t1instal.ini". Use
|
||
regini.exe to load these settings.
|
||
|
||
|
||
|
||
|
||
USING THE DLL
|
||
|
||
There are two functions in the interface of the DLL. Use
|
||
"t1instal.h" to get the prototypes for these functions, and to get
|
||
the definitions of the values they return.
|
||
|
||
|
||
IsType1A
|
||
This function determines if a file is a valid Printer Font
|
||
Metrics files (pfm), and returns the face name of the font. This
|
||
function will only return TRUE if there is a valid PFB file in
|
||
the same directory or in the parent directory.
|
||
|
||
|
||
ConvertTypefaceA
|
||
This function takes the name of a PFM, a PFB and a TTF file as
|
||
parameters, that are used in the conversion.
|
||
|
||
This function will call a supplied callback function during the
|
||
conversion. The caller may thus display messages to the user
|
||
about the progress of the conversion. This function is called
|
||
with an integer that indicates the rate of the progress
|
||
(typically in the range 0-100), and a caller supplied argument.
|
||
|
||
|
||
|
||
BUILDING THE DLL
|
||
|
||
The DLL can be compiled with a number of features turned on or off.
|
||
Define or undefine the following symbols when compiling the code to
|
||
get the desired result:
|
||
|
||
|
||
|
||
name Usage
|
||
---- -----
|
||
DOT Replaces the period character in the converted
|
||
font. Used to tag converted fonts such that
|
||
they can be distinguished from the original
|
||
fonts.
|
||
|
||
NOMSGBOX Causes the DLL to use stdio to report errors.
|
||
|
||
NOCOPYRIGHTS Disables the copyright checking.
|
||
|
||
SHOWCOPYRIGHT This casues the converter to store the
|
||
encrypted copyright strings in the event log,
|
||
without converting the font. Put this string
|
||
in the appropriate place in the registry to
|
||
enable the conversion of fonts from the
|
||
fonts vendor of that font.
|
||
|
||
RELATIVESTEMS Enables a hint conversion features. Must be
|
||
turned on.
|
||
|
||
SYMETRICS_REDUCTION Enables a hint conversion feature. Should not
|
||
be turned on.
|
||
|
||
NOANSIWINMAC Causes glyhs that are not part of the Windows
|
||
ANSI and MacIntosh character set to be
|
||
filterd out. Turn this on if the OS is not
|
||
supporting UNICODE, to get smaller fonts.
|
||
|
||
|
||
By default, only the RELATIVESTEMS should be defined.
|
||
|
||
|
||
SETTING UP THE REGISTRY
|
||
|
||
Remove the comments from the t1instal.ini file and use regini utility
|
||
to place new keys in registry for use.
|
||
|
||
regini t1instal.ini
|
||
|
||
|
||
|
||
|
||
|
||
---------------------------------------------------------------------- -------------------------------------------------
|
||
The message logging mechanism in the Type 1 Installer.
|
||
|
||
|
||
Messages are recorded/displayed based on the severity of an error and based on the state of the "log events" key in the registry. There are three types of messages:
|
||
- Errors : A problem that cased the conversion to abort.
|
||
- Warnings : A non-fatal problem that the converter resolved.
|
||
- Information : Information that may be useful to trace the execution of the
|
||
conversion, such as the name of the font and the vendor.
|
||
|
||
If an error occurs then a pop-up is presented to the user with the appropriate message. Note that this will always happened, regardless of the "log events" key. These strings are defined in the string table in the dll's resource file (t1instal.rc).
|
||
|
||
The "log events" key is used for PSS and for debugging . It should not be used by the users. It should only be turned on when attempting to determine the cause of a failed conversion. This key causes all messages to be stored such that they are accessible by the Event Viewer. These strings are defined in the dll's message file (t1msg.mc). Note that warnings are being displayed in pop-up dialogs, in addition to errors, when "log events" is non zero.
|
||
|
||
The motivation for this approach is that PSS may need to be able to remotely resolve a problem that a customer has when converting a type 1 font. PSS will be able to do this by instructing the user to turn on the "log events" feature and get immediate feed-back when an error or a warning pops up a message. A computer that is connected to a network can be accessed directly through the Event Viewer by the PSS engineer.
|
||
|