L_Doc2GetZoneLayout

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2GetZoneLayout(hDoc, nPageIndex, nZoneIndex, pprc, pnRectCount)

L_HDOC2 hDoc;	/* handle to the OCR document */
L_INT nPageIndex;	/* page index */
L_INT nZoneIndex;	/* zone index */
RECT ** pprc;	/* point to RECT array to be updated */
L_INT * pnRectCount;	/* address of variable to be updated */

Gets user zone shape rectangles.

Parameter	Description
hDoc	Handle to the OCR document. This handle is obtained by calling the L_Doc2StartUp function.
nPageIndex	Index of the page. This is a zero-based index.
nZoneIndex	Index of the zone. This is a zero-based index.
pprc	Address of an array of RECT structures to be updated.
pnRectCount	Address of a variable to be updated with the number of array elements.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Use this function to obtain information about the shape of a specific zone in the user zone list of the specified page.

First, call this function by passing NULL to pprc to get the element count of the rectangle array. Then allocate an array of RECT structures. Then call this function a second time, passing the address of the allocated array to the pprc parameter to obtain the shape of the zone in terms of rectangles.

To set zone rectangles call the L_Doc2SetZoneLayout function.

To add a user zone, call the L_Doc2AddZone function. To add rectangle(s) to a user zone to make its shape irregular, call the L_Doc2AddZoneRect function.

Required DLLs and Libraries

LTDOC2

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Functions:	L_Doc2AddZone, L_Doc2UpdateZone, L_Doc2GetZoneCount, L_Doc2GetZone, L_Doc2RemoveZone, L_Doc2ImportZones, L_Doc2ExportZones, L_Doc2FindZones, L_Doc2SetZoneOptions, L_Doc2GetZoneOptions, L_Doc2AddZoneRect, L_Doc2GetZoneColor, L_Doc2GetZoneNodes, L_Doc2ExcludeZoneRect, L_Doc2SetZoneLayout
Topics:	Working with Zones