GetCut

 

Name

 

            GetCut

 

When to use it

 

            During the OnFinish event.

 

            This method is available only for guillotine cuts (methods StartGuillotine and StartMultiStages). For StartNested the result provided by this method is undefined.

 

 

Prototype

 

HRESULT GetCut(

            SheetIndex: long/*[in]*/,

            CutIndex: long/*[in]*/,

            TopX: long /*[out]*/,

            TopY: long /*[out]*/,

            BottomX: long /*[out]*/,

            BottomY: long /*[out]*/,

            CutThickness: long /*[out]*/,

            RepositoryIndex: long /*[out]*/,

            RepositoryExternalID: long /*[out]*/

);

 

Explanations

 

            This method returns information about one cut.

            The number of cuts performed is obtained using the property NumberOfCuttings.

 

Parameters

 

            SheetIndex - Is the index of the layout (sheet) where the cut is performed. SheetIndex must be between 0 and TotalNumberOfUtilizedRepositoryPieces - 1.

            CutIndex - the index of the cut whose information are extracted. This number is in range [0...NumberOfCuttings - 1].

            TopX, TopY, BottomX and BottomY are coordinates of the current cut.

            CutThickness - the actual thickness of a cut (see below).

            RepositoryIndex - The index of the Repository piece where the cut is performed. RepositoryIndex is between 0 and NumberOfRepositoryPieces  - 1.

            RepositoryExternalID- The external ID of the Repository piece where the cut is performed.

 

 

In most of the cases CutThickness is equal to BladeWidth, but there are some cases (specially at the margins of the table or when there is only one piece left tu extract) where the thickness is smaller. See picture below:

 

 

 

Note

 

            This property is available only for guillotine cuts (from one side to another side of the material).

            For multi-stages cuts you may use GetCutMultiStages. It gives you the stage of the cut too.

            For non-guillotine cuts this method has no meaning.

 

 

See Also:

 

            NumberOfCuttings, BladeWidth, GetCutMultiStages, GetUtilizedDemandPiece, StartGuillotine, StartMultiStages, OnFinish.