#include “BlackIceDEVMODE.h”
BOOL SetTextOutputGlyphMethod (BlackIceDEVMODE* pBlackIceDevMode, DWORD dwValue)
Description
Some text is passed by the printing application to the printer driver as a series of glyph indexes of a font instead of regular characters. This function sets the method used by the Printer Driver to convert glyph indexes to readable text. This conversion is not guaranteed to work every time and may result in glyph characters appearing in the text output.
To convert glyph characters to readable text, the Filter glyph characters option must be turned off using the SetTextOutputFilterGlyphs function.
Parameters
BlackIceDEVMODE* pBlackIceDevMode - pointer to the BlackIceDEVMODE structure
DWORD dwValue - The new conversion method. Can be one of the values of the TEXTOUTPUT_GLYPHCONVERSION enum:
TEXTOUTPUT_GLYPHCONVERSION_AUTO = 0,
Automatic (default) - This option tries to determine the appropriate method for converting glyph characters to text. This method does not depend on the Character Set setting of the printer driver, it is usable for any language.
TEXTOUTPUT_GLYPHCONVERSION_TABLE = 1,
Use glyph table from the font file
TEXTOUTPUT_GLYPHCONVERSION_SHIFT = 2,
Shift values (mainly for printing from Adobe Reader)
TEXTOUTPUT_GLYPHCONVERSION_LEGACY_AUTO = 3
Legacy automatic - The automatic glyph conversion method has changed with Printer Driver version 14.56. This option uses the glyph conversion method from Printer Driver version 14.55 and earlier, and could be useful to achieve the same text output as with version 14.55 and earlier. This method is usable for languages that primarily use the English alphabet. The method depends on the Character Set setting of the printer driver. It is recommended to use the ANSI Character Set in the Text Output configuration. If the Character Set is not set to ANSI, this method is the same as the "Shift values" method.
Return value
TRUE on success, otherwise FALSE
Programming Notes
None
Code Example
None