GetRepositoryHole

 

Name

 

            GetRepositoryHole

 

When to use it

 

            After setting the sizes using the SetRepositoryPiece method and before the OnFinish event ends.

 

Prototype

 

    HRESULT GetRepositoryHole(

            RepositoryIndex: long/*[in]*/,

            HoleIndex: long/*[in]*/,

            TopX: long /*[out]*/,

            TopY: long/*[out]*/,

            BottomX: long /*[out]*/,

            BottomY: long /*[out]*/,

            ExternalID: long/*[out]*/,

    );

 

Explanations

 

            With this method you may get the size and position of each hole from a Repository sheet. By using holes you may specify faults (areas to be avoided) in the material.

            The cutting algorithms will generate solutions such that no demand piece will be placed over (intersect) a hole.

            The number of holes may be get by using GetRepositoryPiece method.

            The dimensions of each hole can be set using the SetRepositoryHole method.

 

Parameters

 

            RepositoryIndex - the index of the sheet whose holes are you extracting. This number is in range [0...NumberOfRepositoryPieces - 1].

            HoleIndex - the index of the hole whose information are extracted.

            TopX, TopY, BottomX, BottomY - margins of hole (top-left and bottom-right).

            ExternalID - an user defined value which can help you to track down the hole during the OnFinish event.

 

See Also

 

            SetRepositoryHole, SetRepositoryPiece, GetRepositoryPiece, NumberOfRepositoryPieces.