L_VecExplodeObject

Summary

Explodes a vector object or objects to smaller parts. This function is available in the LEADTOOLS Vector Imaging Toolkit.

Syntax

L_LVKRN_API L_INT L_VecExplodeObject(pVector, pObject, dwFlags)

Parameters

pVECTORHANDLE pVector

Pointer to a vector handle.

const pVECTOROBJECT pObject

Pointer to a vector object.

L_UINT32 dwFlags

Flag that indicates which object(s) to explode. Possible values are:

Returns

Comments

If pObject is NULL and dwFlags is set to VECTOR_FLAGS_SELECTED_ONLY, this function will explode only selected objects within the vector handle.

If pObject is NULL and dwFlags is set to 0, this function will explode all objects within the vector handle.

If pObject is not NULL, only the specified object is exploded and dwFlags is ignored.

If the VECTOR_FLAGS_EXPLODE_TO_LINES flag is not specified, then not all objects can be exploded. For example an attempt to explode a VECTOR_LINE has no effect and returns SUCCESS.

Below is a list of object types and the objects into which they explode:

Required DLLs and Libraries

• LTVKRN
• 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

Topics

• Working with Vector Objects

Example

This example will explode all selected objects inside a vector handle.

L_INT VecExplodeObjectExample(pVECTORHANDLE pVector) 
{ 
   L_INT nRet; 
   
   nRet = L_VecExplodeObject( pVector, NULL, VECTOR_FLAGS_SELECTED_ONLY ); 
    
   return nRet; 
}