ManualArrangeGuillotineAddPiece

 

Name

 

            ManualArrangeGuillotineAddPiece

 

When to use it

 

            When the optimization process is NOT running.

            NOT during the OnFinish or OnAfterManualArrange event.

            After all other information has been set.

 

Prototype

 

    HRESULT ManualArrangeGuillotineAddPiece(

            TopX: long /*[in]*/,

            TopY: long /*[in]*/,

            BottomX: long /*[in]*/,

            BottomY: long /*[in]*/,

            Rotated: long/*[in]*/,

            CutType: long /*[in]*/,

            ExternalID: long /*[in]*/,

            IndexWasteRemoved: long /*[out]*/,

            IndexWasteInserted1: long /*[out]*/,

            IndexWasteInserted2: long /*[out]*/,

            IndexCutInserted1: long /*[out]*/,

            IndexCutInserted2: long /*[out]*/

    );

 

Explanations

 

            Manually adds a piece to the existing layout. The actual position of the piece will be computed automatically.

            The piece will be place to that corner (of the waste where is intended to be placed) which is the nearest to (TopX, TopY) point.

 

Parameters

 

            TopX, TopY, BottomX, BottomY - the coordinates of the extremities of the piece. These coordinates will be adjusted by the component in order to have a valid guillotine layout. This means that the piece will be moved (if necessarily) to the left and top until some existing cuttings (or the margin of the sheet) will be reached.

            Rotated - if this piece comes from a previous optimization you should set the rotation status here. Otherwise the Rotated parameter can be set to 0.

            CutType - 0 = best cut; 1 = Left Right first and then Top-Bottom; 2 = Top-Bottom first and then Left-Right.

            ExternalID - an user defined value which can help you to track down the piece during the OnFinish event. This value will be returned by the GetDemandPiece method.

            IndexWasteRemoved - index of the waste to be removed.

            IndexWasteInserted1 - index of the first waste to be added in the array of waste parts. This value has value -1 if this waste is 0.

            IndexWasteInserted2 - index of the second waste to be added in the array of waste parts. This value has value -1 if this waste is 0.

            IndexCutInserted1 - index of the first cut to be added into the array of cuttings. If this value is -1 the cutting is not performed.

            IndexCutInserted2 - index of the second cut to be added into the array of cuttings. If this value is -1 the cutting is not performed.

 

Remarks

 

            Waste rectangles that are generated by the trim cuts (and the corresponding cuttings) are not reported here, even if they may appear during the piece insertion. Use the methods and properties allowed to be called in order to obtain the the complete information about the manual arrange results.

 

            The parameter CutType is not taken into account in the case of Multi-stages guillotine cuttings.

 

See Also

 

        How to arrange pieces manually, ManualArrangeGuillotineIsValidPositionForAPiece, OnAfterManualArrange.