L_Doc2ExcludeZoneRectExt

#include "ltdoc2.h"

L_LTDOC2_API L_INT L_Doc2ExcludeZoneRectExt(hDoc, nDocId, nPageIndex, nZoneIndex, prc)

Excludes a rectangle from a user zone.

Parameters

L_HDOC2 hDoc

Handle to the OCR document. This handle is obtained by calling the L_Doc2StartUp function.

L_INT nDocId

Document ID created by calling L_Doc2CreateDocument.

L_INT nPageIndex

Zero-based page index of the page.

L_INT nZoneIndex

Zero-based Zone index of the zone.

RECT * prc

Pointer to a RECT structure to be subtracted from specified zone.

Returns

Comments

L_Doc2ExcludeZoneRectExt subtracts a rectangle from an existing user zone. It recalculates 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 zone types 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/L_Doc2AddZoneRectExt 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.