SetAntialiasingMode

 

#include “BlackIceDEVMODE.h”

 

BOOL SetAntialiasingMode (BlackIceDEVMODE* pBlackIceDevMode, DWORD dwValue)

Description

Sets the Antialiasing Mode the driver uses for rendering text for image output file formats. Text antialiasing is for Grayscale and Color output formats. For 1 bit black and white documents, the ANTIALIASING_AUTO or ANTIALIASING_NONE options should be used, otherwise jagged edges will appear on the rendered characters.

Parameters

BlackIceDEVMODE* pBlackIceDevMode        - pointer to the BlackIceDEVMODE structure

DWORD dwValue   - The new conversion method. Can be one of the values of the AntialiasingMode enum:

 

ANTIALIASING_NONE = 0,

Turns off text antialiasing.

ANTIALIASING_NORMAL = 1,

Uses the default antialiasing method. This method is not recommended for 1 bit black and white output formats.

ANTIALIASING_CLEARTYPE = 2,

Uses Microsoft ClearType antialiasing for fonts. This method is using sub-pixel rendering and it is meant to be used for output images that will be displayed on computer screens at 100% size. This method is not recommended for 1 bit black and white output formats.

ANTIALIASING_LEGACY = 3

Emulates the behavior of Black Ice Printer Drivers before version 14.99. This method is not recommended for 1 bit black and white output formats.

ANTIALIASING_AUTO = 4

Automatically selects the best antialiasing method based on output format and resolution. Antialiasing is disabled for 1 bit black and white documents. For 8 or 24 bit documents that have resolution below 150 DPI, ClearType antialiasing is used. For 8 or 24 bit documents that has a resolution of 150 DPI or above, normal antialiasing is used. The printing application can change the antialiasing method on a per-font basis during printing, but antialiasing for 1 bit output formats is not allowed. (default value)

Return value

TRUE on success, otherwise FALSE

Programming Notes

None

Code Example

None