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.
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.
Links