BitmapTextOverlay

#include "BITIFF.H"

HBITMAP CALLBACK BitmapTextOverlay( HBITMAP   hBitmap,
int                 nX,
int                 nY,
LPTSTR       lpTextString,
LPTSTR       lpFontTypeFace,
int                 nFontPointSize,
int                 nXDPI,
int                 nYDPI)

Description

This function is designed for text retrieval applications to overlay scanned form images. It overlays a form with ASCII text in a transparent mode. The form is a black and white bitmap. The overlay will start at the (x,y) coordinates defined by the nX and nY parameters. The coordinates are in pixels. The carriage return and line feed is used to advance to a new line on the form. This function can be called multiple times. The lpTextStringpoints to a NULL terminated ASCII string in memory. The nXDPI and nYDPI parameters are the bitmap dot per inch (DPI ) resolution. These parameters can be set to zero when the resolution is not known.

Parameters

HBITMAP

hBitmap

The handle of the BITMAP.

int

nX

The x coordinates in pixel.

int

nY

The y coordinates in pixel.

LPTSTR

lpTextString

The ASCII text string in memory.

LPTSTR

lpFontTypeFace

The font type face.

int

nFontPointSize

The font size in points.

int

nXDPI

The resolution in X direction.

int

nYDPI

The resolution in Y direction.

Additional Information

This example shows how to use the dll when loading statically including the header file. Otherwise if the dll is loaded dynamically, for further information read the “About the difference of static and dynamic library loading” section of the manual.

Return values

Handle of the BITMAP. NULL on error.

Programming notes

The image should have a valid dot per inch resolution (DPI). The Image DPI will be used to scale the font size to get a proportional view.

Requirements

Header :     Declared in BiTiff.h; include BiTiff.h.

Library :    Use BiTIFF.lib.

DLLs :       BiTiff.dll.