EXOBJ_CONTENTBOUND_OPTIONS

Summary

Provides the options for calculating the content bounds.

Syntax

typedef struct EXOBJ_CONTENTBOUND_OPTIONS 
{ 
   L_UINT uStructSize; 
   L_UINT uFlags; 
   L_VOID * pInternalCache; 
   pEXOBJ_OBJECT * pObjectsOfInterest; 
   L_UINT uObjectsOfInterestCount; 
   L_UINT uFullObjectMargin; 
} EXOBJ_CONTENTBOUND_OPTIONS, * pEXOBJ_CONTENTBOUND_OPTIONS;

Members

L_UINT uStructSize

Size of this structure in bytes, for versioning. Use the sizeof(EXOBJ_CONTENTBOUND_OPTIONS) operator to calculate this value.

L_UINT uFlags

Flag that indicates to cache certain calculations. Possible values are:

Value	Meaning
EXOBJ_CONTENTBOUND_OPTIMIZED_FOR_REPETITION	[0x1] Cache certain calculations from this iteration for use in consecutive calls

L_VOID * pInternalCache

Internal cache of previous calculations.

pEXOBJ_OBJECT * pObjectsOfInterest

Pointer to array of objects to process.

L_UINT uObjectsOfInterestCount

Number of objects in the array pObjectsOfInterest.

L_UINT uFullObjectMargin

Additional margin when extracting full object bounds.

Comments

To free pInternalCache call L_ExtractObjects_ClearInternalCache. It will also be freed automatically when calling L_ExtractObjects_FreeData.

If EXOBJ_CONTENTBOUND_OPTIMIZED_FOR_REPETITION is selected and L_ExtractObjects_CalcContentBound is called, pObjectsOfInterest will be ignored on the next call.

Set uFullObjectMargin to 0 to use outline-only clipping.

Usage

L_ExtractObjects_CalcContentBound
L_ExtractObjects_ClearInternalCache