GetRelativeCut


Name


            GetRelativeCut


When to use it


            During the OnFinish event.


            This method is available only for StartMultiStages.

            For standard guillotine use GetCut instead


Prototype


HRESULT GetRelativeCut(

            SheetIndex: long/*[in]*/,

            CutIndex: long/*[in]*/,

            TopX: long /*[out]*/,

            TopY: long /*[out]*/,

            BottomX: long /*[out]*/,

            BottomY: long /*[out]*/,

            CutThickness: long /*[out]*/,

            Level: 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 relative (to the previous cut) coordinates of the current cut.

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

           Level - the level on which this cut is. First cuts have level 0. The cuts perpendicular on the first cuts have level 1 and so on.

            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 multi-stage guillotine cuts (from one side to another side of the material).

            For non-guillotine cuts this method has no meaning.

            For standard guillotine see GetCut.


See Also:


            GetCut, GetCutMultiStages, BladeWidth, NumberOfCuttings, StartMultiStages, OnFinish.



Links

       back to index

       www.optimalprograms.com