BendPartFeatures.Add Method
Parent Object: BendPartFeaturesDescription
Method that creates a new bend part feature. If the bend part feature is created successfully, a BendPartFeature object corresponding to the newly created bend part feature is returned.
Syntax
BendPartFeatures.Add( BendLine As SketchLine, BendPartType As BendPartTypeEnum, InputOne As Variant, InputTwo As Variant, BendSide As PartFeatureExtentDirectionEnum, BendInSketchNormalDirection As Boolean, [Body] As Variant, [BendMinimum] As Boolean ) As BendPartFeatureParameters
| Name | Type | Description |
| BendLine | SketchLine | Input SketchLine object that represents the bend line. |
| BendPartType | BendPartTypeEnum | Input constant that indicates the type of the bend part feature. See Note 1. |
| InputOne | Variant | Input Variant that defines the first input for the bend arc. See Note 2. |
| InputTwo | Variant | Input Variant that defines the second input for the bend arc. See Note 3. |
| BendSide | PartFeatureExtentDirectionEnum | Input constant that indicates which side of the model to bend. See Note 4 |
| BendInSketchNormalDirection | Boolean | Input boolean that indicates the bend direction. If True is specified, the model will be bent in the direction normal to the sketch on which the input bend line (sketch line) exists. If False is specified, the model will be bent in the direction opposite to the sketch normal. If no value is explicitly specified, the default value of True will be used. |
| Body | Variant | Optional input SurfaceBody object that specifies the solid body to bend. If not specified, a default body is chosen in the case of multi solid body parts. This is an optional argument whose default value is null. |
| BendMinimum | Boolean | Optional Input boolean that indicates whether minimum bend should be applied. If True is specified, minium bend will be applied. If no value is explicitly specified, the default value of True will be used. This is an optional argument whose default value is True. |
Notes
Note 1.The BendPartType argument specifies the type of the input values used to define the bend arc. The values specified for the InputOne and InputTwo arguments will depend on the value specified for this argument.
The valid input is one of the constants in BendPartTypeEnum: kArcLengthAndAngleBendPart, kRadiusAndAngleBendPart and kRadiusAndArcLengthBendPart.
The following table describes how this argument determines the values that need to be specified for the InputOne and InputTwo arguments:
| BendPartType | InputOne | InputOne |
| kArcLengthAndAngleBendPart | Arc Length | Angle |
| kRadiusAndAngleBendPart | Radius | Angle |
| kRadiusAndArcLengthBendPart | Radius | Arc Length |
The InputOne parameter can be either a numeric value or a string. A parameter for this value will be created and the supplied string or value is assigned to the parameter.
The type of the input value will be determined by the BendPartType argument. The following table shows what this input value should be based on the BendPartType argument:
| BendPartType | InputOne |
| kArcLengthAndAngleBendPart | Arc Length |
| kRadiusAndAngleBendPart | Radius |
| kRadiusAndArcLengthBendPart | Radius |
For example, if the bend is defined using the arc length and angle as indicated by the BendPartType argument being kArcLengthAndAngleBendPart, then this argument should be used to specify the arc length of the bend arc. Similarly, if the bend is defined using the radius and angle as indicated by the BendPartType argument being kRadiusAndAngleBendPart, then this argument should be used to specify the radius of the bend arc.
If a value is input, the units are the default database units (centimeters for distance and radians for angle). If a string is input, the units can be specified as part of the string or it will default to the current unit type for the document.
Note 3.The InputTwo parameter can be either a numeric value or a string. A parameter for this value will be created and the supplied string or value is assigned to the parameter.
The type of the input value will be determined by the BendPartType argument. The following table shows what this input value should be based on the BendPartType argument:
| BendPartType | InputTwo |
| kArcLengthAndAngleBendPart | Angle |
| kRadiusAndAngleBendPart | Angle |
| kRadiusAndArcLengthBendPart | Arc Length |
For example, if the bend is defined using the arc length and angle as indicated by the BendPartType argument being kArcLengthAndAngleBendPart, then this argument should be used to specify the angle of the bend arc. Similarly, if the bend is defined using the radius and arc length as indicated by the BendPartType argument being kRadiusAndArcLengthBendPart, then this argument should be used to specify the arc length of the bend arc. If a value is input, the units are the default database units (centimeters for distance and radians for angle). If a string is input, the units can be specified as part of the string or it will default to the current unit type for the document.
Note 4.The bend side is specified with respect to the input bend line (sketch line), i.e. whether the model to the left, right or both sides of the bend line should be bent. The left side is the natural normal direction at any point on the sketch line (the cross-product of the vector representing the direction of the sketch line and the vector representing the sketch normal). The right side refers to the direction opposite to that of the natural normal. The following figure demonstrates an example of how the bend side is determined based on the normal direction of the sketch line.
The figure represents a model in which a sketch plane has been drawn on the rectangular side face. The sketch plane consists of a single sketch line which represents the bend line. The sketch plane normal direction is perpendicular to the face and coming out of the model. The direction of the sketch line which can be inferred from the start point and end points of the sketch line is towards the right. Therefore, the normal vector at any point on the sketch line is pointing in the downward direction (imagine standing on the normal side of the sketch plane and viewing in the direction of the sketch line, the normal of the sketch line will be towards your right). For the bend part feature, the left side of the bend corresponds to this normal direction of the sketch line. As indicated by the preview in the figure, when the left side is specified, the model in the normal direction of the sketch line is selected for the bend.
The valid input is one of the constants in PartFeatureExtentDirectionEnum: kNegativeExtentDirection, kPositiveExtentDirection or kSymmetricExtentDirection.
- If kNegativeExtentDirection is specified, the model on the left side of the input bend line will be bent.
- If kPositiveExtentDirection is specified, the model on the right side of the input bend line will be bent.
- If kSymmetricExtentDirection is specified, the model on both sides of the input bend line will be bent.