2.1.14.2.1 matobj_copy

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Included
9 Reference

Description

MatrixObject copy function

Syntax

bool matobj_copy( MatrixObject & moDest, const MatrixObject & moSrc, bool bUseROI = true, vector<point> * pROI = NULL, bool bAllAttr = true )

Parameters

moDest: [modify] the destination MatrixObject
moSrc: [input] the MatrixObject to copy
bUseROI: [input] whether to copy region polygon information
pROI: [input] if not NULL, contains the new region polygon data
bAllAttr: [input] indicates whether to copy all attributes

Return

return true on success, else return false.

Examples

EX1

void    matobj_copy_ex1()
{
    //make sure there is a matrixpage name MBook1 with two layers exists before run this code
    //you may import two different images into each layer.
    MatrixPage mp(Project.FindPage("MBook1", EXIST_MATRIX));
    if ( mp )
    {
        MatrixLayer ml1 = mp.Layers(0);
        MatrixLayer ml2 = mp.Layers(1);
        if ( ml1 && ml2 )
        {
            MatrixObject moSrc(ml1, 0);
            MatrixObject moDest(ml2, 0);
            if ( moSrc && moDest )
            {
                bool bRet = matobj_copy(moDest, moSrc, true, NULL, true);
                if ( bRet )
                    printf("Copy MatrixObject successfully!");
                else
                    printf("Fail to copy MatrixObject!");
            }
        }
    }
}