Add Method

Description

Adds an occurrence of the referenced object.

Syntax

Visual Basic
Public Function Add( _ ByVal NumEdges As Long, _ ByRef EdgeSet() As Object, _ ByRef KeyPointTypeConstants() As KeyPointType, _ ByVal StartpointEndType As KeypointEndConditionConstants, _ Optional ByVal EndpointEndType As Variant _ ) As KeyPointCurve

Visual Basic

Public Function Add( _
   ByVal NumEdges As Long, _
   ByRef EdgeSet() As Object, _
   ByRef KeyPointTypeConstants() As KeyPointType, _
   ByVal StartpointEndType As KeypointEndConditionConstants, _
   Optional ByVal EndpointEndType As Variant _
) As KeyPointCurve

Parameters

NumEdges

Specifies the number of elements in the EdgeArray and KeypointConstantArray.

EdgeSet

Array of Edge objects, each containing a keypoint on the curve, that defines the order of points in the curve.

KeyPointTypeConstants

Value	Description
igKeyPointCallback	Keypoint Type - Callback
igKeyPointCenter	Keypoint Type - Center
igKeyPointEnd	Keypoint Type - End
igKeyPointHorizontalSilhouette	Keypoint Type - Horizontal Silhouette
igKeyPointInteriorNode	Keypoint Type - Interior Node
igKeyPointInteriorPole	Keypoint Type - Interior Pole
igKeyPointMajorAxis	Keypoint Type - Major Axis
igKeyPointMiddle	Keypoint Type - Middle
igKeyPointMinorAxis	Keypoint Type - Minor Axis
igKeyPointNonDefining	Keypoint Type - Non-defining
igKeyPointPointOnly	Keypoint Type - Point Only
igKeyPointStart	Keypoint Type - Start
igKeyPointVerticalSilhouette	Keypoint Type - Vertical Silhouette

Array of KeypointType constants. Specifies the keypoint locations in the EdgeArray.

StartpointEndType

Value	Description
seKeypointEndConditionCurvatureContinuous	Keypoint End Condition - Curvature Continuous
seKeypointEndConditionNatural	Keypoint End Condition - Natural
seKeypointEndConditionNormalToFace	Keypoint End Condition - Normal To Face
seKeypointEndConditionPeriodic	Keypoint End Condition - Periodic
seKeypointEndConditionTangent	Keypoint End Condition - Tangent

KeypointEndCondition constant that specifies how the start point of the curve relates to the rest of the curve and the surrounding geometry.

EndpointEndType

KeypointEndCondition constant that specifies how the endpoint of the curve relates to the rest of the curve and the surrounding geometry.

Remarks

StartpointEndCondition: If seKeypointEndConditionPeriodic, then the curve is closed on itself, and the EndpointEndCondition is not required. The KeypointCurve fails if the EndpointEndCondition is supplied but is not periodic. If seKeypointEndConditionNatural, then the curve is open, and the StartParentEdge is not required. The start point of the curve is not forced to be tangent to the Edge that contains the start point; the curvature at that point is dictated solely by the other points in the curve. If seKeypointEndConditionTangent, then the curve is open, and the StartParentEdge is required. The initial EndPointDerivMagnitude value is automatically calculated, and the curve is forced to be tangent to the Edge that contains the start point. EndpointEndCondition: If seKeypointEndConditionPeriodic, StartpointEndCondition must also be Periodic. If seKeypointEndConditionNatural, then the curve is open, and the EndParentEdge is not required. The endpoint of the curve is not forced to be tangent to the Edge that contains the endpoint; the curvature at that point is dictated solely by the other points in the curve. If seKeypointEndConditionTangent, then the curve is open, and the EndParentEdge is required. The initial EndPointDerivMagnitude value is automatically calculated, and the curve is forced to be tangent to the the Edge that contains the endpoint.