L_VecCopyObject
#include "lvkrn.h"
L_INT EXT_FUNCTION L_VecCopyObject(pVectorDst, pLayerDst, pObjectDst, pVectorSrc, pObjectSrc)
pVECTORHANDLE pVectorDst; |
/* pointer to a vector handle */ |
const pVECTORLAYER pLayerDst; |
/* pointer to a vector layer */ |
pVECTOROBJECT pObjectDst; |
/* pointer to a vector object */ |
const pVECTORHANDLE pVectorSrc; |
/* pointer to a vector handle */ |
const pVECTOROBJECT pObjectSrc; |
/* pointer to a vector object */ |
Copies a vector object to another object. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
Parameter |
Description |
pVectorDst |
Pointer to the destination vector handle. |
pLayerDst |
Pointer to the destination vector layer. |
pObjectDst |
Pointer to the destination vector object. |
pVectorSrc |
Pointer to the source vector handle. |
pObjectSrc |
Pointer to the source vector object. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function can be used to do the following:
copy an object within the same layer.
copy an object from one layer to another layer within the same vector handle.
copy an object from a layer in one vector handle to a layer in another vector handle.
This function creates a new object that is a carbon copy of the source object, but they are not related. The source object can be deleted after the copying process without affecting the newly copied object.
Setting the pLayerDst parameter to NULL will copy the object into the current active layer in the destination vector handle (pVectorDst).
If the pObjectDst parameter is set to NULL, a handle to the newly added object will not be provided when the function returns. This is similar to calling L_VecAddObject with the pNewObject parameter set to NULL.
Required DLLs and Libraries
LVKRN 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_VecAddObject, L_VecGetObject, L_VecFreeObject, L_VecSetObject, L_VecExplodeObject |
Topics: |
Example
/* This example will copy the object under current mouse cursor to the active layer of another given vector handle */
L_VOID CopyMyObject( pVECTORHANDLE pVectorSrc, pVECTORHANDLE pVectorDst, const POINT *pptMouse )
{
VECTOROBJECT ObjectSrc;
VECTOROBJECT ObjectDst;
L_INT nRet;
/* Get object under mouse cursor */
nRet = L_VecHitTest( pVectorSrc, pptMouse, &ObjectSrc );
if( nRet == SUCCESS )
{
/* Object was found, copy to destination vector handle. Use the current active layer */
L_VecCopyObject( pVectorDst, NULL, &ObjectDst, pVectorSrc, &ObjectSrc );
}
}