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:


Waste 

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.



Links

       back to index

       www.optimalprograms.com