L_VecCopyLayer
#include "lvkrn.h"
L_LVKRN_API L_INT L_VecCopyLayer(pVectorDst, pLayerDst, pVectorSrc, pLayerSrc, dwFlags)
pVECTORHANDLE pVectorDst; |
/* pointer to a vector handle */ |
const pVECTORLAYER pLayerDst; |
/* pointer to a layer */ |
const pVECTORHANDLE pVectorSrc; |
/* pointer to a vector handle */ |
const pVECTORLAYER pLayerSrc; |
/* pointer to a vector layer */ |
L_UINT32 dwFlags; |
/* copy flags */ |
Copies the contents of one layer to another. This function is available in the LEADTOOLS Vector Imaging Pro Toolkit.
Parameter |
Description |
|
pVectorDst |
Pointer to the destination vector handle. |
|
pLayerDst |
Pointer to a VECTORLAYER structure that references the destination layer. |
|
pVectorSrc |
Pointer to the source vector handle. |
|
pLayerSrc |
Pointer to a VECTORLAYER structure that references the source layer. |
|
dwFlags |
Flag that indicates whether or not to empty the destination layer before copying. Possible values are: |
|
|
Value |
Meaning |
|
0 |
Do not empty the destination layer before copying. |
|
VECTOR_FLAGS_REPLACE |
Empty the destination layer before copying. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The destination layer can be in the same vector handle as the source layer, or it can be in a different vector handle.
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_VecAddLayer, L_VecGetLayer, L_VecGetLayerByName, L_VecGetLayerByIndex |
Topics: |
Example
This example will copy the layer with the given name from the source vector to the destination vector.
L_INT VecCopyLayerExample( pVECTORHANDLE pVectorDst, pVECTORHANDLE pVectorSrc, L_TCHAR* pszName) { VECTORLAYER LayerSrc, LayerDst; VECTORLAYERDESC LayerDesc; L_INT nRet; /* Get the layer with the given name */ nRet = L_VecGetLayerByName( pVectorSrc, pszName, &LayerSrc ); if( nRet == SUCCESS ) { /* get the layer properties */ nRet = L_VecGetLayer( pVectorSrc, &LayerSrc, &LayerDesc ); if(nRet != SUCCESS) return nRet; /* add to the destination vector */ nRet = L_VecAddLayer( pVectorDst, &LayerDesc, &LayerDst, VECTOR_FLAGS_RENAME_DUPLICATES); if(nRet != SUCCESS) return nRet; /* no need for the layer properties anymore */ nRet = L_VecFreeLayer( &LayerDesc ); if(nRet != SUCCESS) return nRet; /* copy content of source layer into destination */ nRet = L_VecCopyLayer( pVectorDst, &LayerDst, pVectorSrc, &LayerSrc, 0L ); } return nRet; }