L_Doc2ExcludeZoneRect

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2ExcludeZoneRect(hDoc, nPageIndex, nZoneIndex, prc)

L_HDOC2 hDoc;	/* handle to the OCR document */
L_INT nPageIndex;	/* page index */
L_INT nZoneIndex;	/* zone index */
RECT * prc;	/* Pointer to RECT structure */

Excludes a rectangle from a user zone.

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.
prc	Pointer to RECT structure to be subtracted from specific zone

Returns

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

Comments

This function subtracts a rectangle from an existing user zone. The function will recalculate the rectangle list of the zone. The resulting list must be a pizzabox-shape except for OMR zones.

A pizzabox shape is a union of rectangles, where the top of each rectangle in the union must touch the bottom of the rectangle above it. A rectangle can touch at most one rectangle above and one below. The following zones cannot have a pizzabox shape:

Table zones (must be rectangular)
OMR zone (can contain non-touching rectangles)

To add a new rectangle to a zone, 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.

See Also

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_Doc2GetZoneLayout, L_Doc2GetZoneNodes, L_Doc2SetZoneLayout
Topics:	Working with Zones

Example

For an Example, refer to L_Doc2AddZoneRect