DIBTextOverlay

#include "BITIFF.H"

HANDLE CALLBACK DIBTextOverlay( HANDLE      hDIB,
int                  nX,
int                  nY,
LPTSTR        lpTextString,
LPTSTR        lpFontTypeFace,
int                  nFontPointSize)

Description

This function is designed for text retrieval applications to overlay scanned form image. It overlays a form with ASCII text in a transparent mode. The form is a black and white device independent bitmap (DIB). 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 lpTextString points to a NULL terminated ASCII string in memory.

Parameters

HANDLE

hDIB

The handle of a DIB.

int

nX

The x coordinates in pixels.

int

nY

The y coordinates in pixels.

LPTSTR

lpTextString

The ASCII text string in memory.

LPTSTR

lpFontTypeFace

The font type face.

int

nFontPointSize

The font size in points.

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 device independent bitmap (DIB). NULL on error.

Programming notes

The image should have 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.