All Frameworks  Object Hierarchy  This Framework  Indexes   

HybridShapeBlend (Object)

Represents the hybrid shape blended surface object.
Role: To access the data of the hybrid shape blended surface object.

This data includes:

Use the CATIAHybridShapeFactory to create a HybridShapeBlend object.

See also:
HybridShapeFactory

Property Index

Coupling
Returns or sets the type of coupling between the limits of the blend.
RuledDevelopableSurface
Returns or sets the ruled developable surface mode.
SmoothAngleThresholdActivity
Returns or sets information whether a blending operation is smoothed or not.
SmoothAngleThreshold
Returns the angular threshold.
SmoothDeviationActivity
Returns or sets information whether a deviation from guide curves is allowed or not.
SmoothDeviation
Returns the deviation value (length) from guide curves allowed during a sweeping operation in order to smooth it.
Spine
Returns or sets a curve used as spine for coupling in Blend computation.

Method Index

GetBorderMode
Returns the type of border to a limit of the blend.
GetClosingPoint
Returns the closing point of a closed curve of the blend.
GetContinuity
Retrieves the continuity of a limit of the blend.
GetCurve
Returns a curve from the blend.
GetOrientation
Returns the orientation of a curve of the blend.
GetRuledDevelopableSurfaceConnection
Returns or sets the ruled developable surface connection type.
GetSupport
Returns a support from the blend.
GetTensionInDouble
Returns the tension values of a limit of the blend.
GetTensionType
Returns the tension type of a limit of the blend.
GetTransition
Returns the transition orientation from a limit of the blend.
GetTrimSupport
Returns whether a support of the blend will be trimmed off.
InsertCouplingPoint
Inserts a coupling point to a coupling of the blend.
InsertCoupling
Inserts a coupling into the blend.
SetBorderMode
Sets the type of border to a limit of the blend.
SetClosingPoint
Sets a new closing point to a closed curve of the blend.
SetContinuity
Sets the continuity to a limit of the blend.
SetCurve
Sets a curve to the blend.
SetOrientation
Sets the orientation of a curve of the blend.
SetRuledDevelopableSurfaceConnection
SetSmoothAngleThreshold
Sets the angular threshold.
SetSmoothDeviation
Sets the deviation value (length) from guide curves allowed during sweeping operation in order to smooth it.
SetSupport
Sets a support to the blend.
SetTensionInDouble
Sets the tension values to a limit of the blend.
SetTensionType
Sets the tension type of a limit of the blend.
SetTransition
Sets the transition orientation to a limit of the blend.
SetTrimSupport
Sets whether a support of the blend is to be trimmed off.
UnsetClosingPoint
Unsets the closing point of a closed curve of the blend.
UnsetSupport
Unsets a support from the blend.

Properties


o Property Coupling() As
Returns or sets the type of coupling between the limits of the blend.
Legal values: The values representing the type of coupling can be:
1
Ratio: the curves are coupled according to the curvilinear abscissa ratio
2
Tangency: the curves are coupled according to their tangency discontinuity points. If they do not have the same number of tangency discontinuity points, they cannot be coupled and an error message is displayed
3
Tangency then curvature: the curves are coupled according to their tangency discontinuity points first, then according to their curvature discontinuity points. If they do not have the same number of tangency and curvature discontinuity points, they cannot be coupled and an error message is displayed
4
Vertices: the curves are coupled according to their vertices. If they do not have the same number of vertices, they cannot be coupled and an error message is displayed
5
Spine: coupling is completely driven by a curve (called spine)
Example:
This example retrieves in CouplingVal the coupling value of the ShpBlend hybrid shape blended feature.
 CouplingVal = ShpBlend.Coupling
 
o Property RuledDevelopableSurface() As
Returns or sets the ruled developable surface mode.
TRUE means that the mode is enabled and FALSE means that it is disabled.
o Property SmoothAngleThresholdActivity() As
Returns or sets information whether a blending operation is smoothed or not.
TRUE if the blending operation is smoothed, or FALSE otherwise (FALSE if not specified).
o Property SmoothAngleThreshold() As (Read Only)
Returns the angular threshold.
o Property SmoothDeviationActivity() As
Returns or sets information whether a deviation from guide curves is allowed or not.
Gives the information on performing smoothing during blending operation.
TRUE if a deviation from guide curves is allowed, or FALSE otherwise (FALSE if not specified).
o Property SmoothDeviation() As (Read Only)
Returns the deviation value (length) from guide curves allowed during a sweeping operation in order to smooth it.
o Property Spine() As
Returns or sets a curve used as spine for coupling in Blend computation. Setting the spine curve also changes coupling mode to CATGSMSpineCoupling. In order to remove the spine, set another coupling mode.
Parameters:
iSpine
spine curve

Methods


o Func GetBorderMode( iBlendLimit) As
Returns the type of border to a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend whose type of border is to be retrieved.
Legal values: 1 for the first limit, and 2 for the second one
Returns:
The type of border
Legal values:
1
The border of the blend will be tangent to the border of the support surface, or if the curve ends on the border of a face of the support surface, then the border of the blend will be tangent to the border face.
2
The border of the blend is not constrained.
Example:
This example retrieves in BorderType the type of border of the first limit of the ShpBlend hybrid shape blended feature.
 BorderType = ShpBlend.GetBorderMode(1)
 
o Func GetClosingPoint( iBlendLimit) As
Returns the closing point of a closed curve of the blend.
Parameters:
iBlendLimit
The limit of the blend whose curve closing point is returned.
Legal values: 1 for the first curve, and 2 for the second one
Returns:
The retrieved closing point
Example:
This example retrieves in ClosingPoint the closing point of the curve of the second limit of the ShpBlend hybrid shape blended feature.
 Dim ClosingPoint As Reference
 ClosingPoint = ShpBlend.GetClosingPoint(2)
 
o Func GetContinuity( iBlendLimit) As
Retrieves the continuity of a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend whose continuity is to be retrieved.
Legal values: 1 for the first limit, and 2 for the second one
Returns:
The retrieved continuity.
Legal values:
0
Point continuity
1
Tangency continuity
2
Curvature continuity
Example:
This example retrieves in Continuity the continuity of the second limit of the ShpBlend hybrid shape blended feature.
 Continuity = ShpBlend.GetContinuity(2)
 
o Func GetCurve( iBlendLimit) As
Returns a curve from the blend.
Parameters:
iBlendLimit
The limit of the blend from which the curve will be retrieved.
Legal values: 1 for the first curve, and 2 for the second one
Returns:
The retrieved curve
Example:
This example retrieves in BlendCurve the curve of the second limit of the ShpBlend hybrid shape blended feature.
 Dim BlendCurve As Reference
 BlendCurve = ShpBlend.GetCurve(2)
 
o Func GetOrientation( iBlendLimit) As
Returns the orientation of a curve of the blend.
Parameters:
iBlendLimit
The limit of the blend whose curve orientation is to be retrieved.
Legal values: 1 for the first curve, and 2 for the second one
Returns:
The orientation to set to the curve.
Legal values: 1 for direct and -1 for reverse
Example:
This example retrieves in Orientation the orientation of the second limit of the ShpBlend hybrid shape blended feature.
 Orientation = ShpBlend.GetOrientation(2)
 
o Func GetRuledDevelopableSurfaceConnection( iBlendLimit) As
Returns or sets the ruled developable surface connection type.
Parameters:
iBlendLimit
The limit of the blend for which the connection type is to be set.
Legal values: 1 for the start limit, and 2 for the end one
oBlendConnection
The value of connection type
Legal values:
1
Connect to both extremities
2
Free first curve
3
Free second curve
o Func GetSupport( iBlendLimit) As
Returns a support from the blend.
Parameters:
iBlendLimit
The limit of the blend whose support is to be retrieved.
Legal values: 1 for the first support, and 2 for the second one
Returns:
The retrieved support surface
Example:
This example retrieves in SupportSurf the support surface of the second limit of the ShpBlend hybrid shape blended feature.
 Dim SupportSurf As Reference 
 SupportSurf = ShpBlend.GetSupport(2)
 
o Func GetTensionInDouble( iBlendLimit,
iRank) As
Returns the tension values of a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend from which the tension type and values are to be retrieved.
Legal values: 1 for the first limit, and 2 for the second one
iRank
The rank of the value to retrieve among those available, depending on the tension type.
Legal values: iRank can take the following values:
1
With default tension and constant tension, for the unique available value, and with linear tension for the first value
2
With linear tension for the second value
Returns:
The retrieved tension value
Example:
This example retrieves in TensionVal the tension value of the tension, supposed to be a constant tension, of the first limit of the ShpBlend hybrid shape blended feature.
 Dim ConstTensionVal As RealParam
 Set ConstTensionVal = ShpBlend.GetTensionInDouble(1, 1)
 
o Func GetTensionType( iBlendLimit) As
Returns the tension type of a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend from which the tension type is to be retrieved.
Legal values: 1 for the first limit, and 2 for the second one
Returns:
The value of tension type
Legal values:
1
Default tension
2
Constant tension
3
Linear tension
Example:
This example retrieves in TensionType the tension type of the first limit of the ShpBlend hybrid shape blended feature.
 TensionType.GetTensionType(1)
 
o Func GetTransition( iBlendLimit) As
Returns the transition orientation from a limit of the blend.
Let T be the tangent to the wire, and N be the normal to the skin body. The transition orientation defines how the blend goes from the initial wires: it takes the direction of iTransition*(T^N), where ^ is the cross product.
Parameters:
iBlendLimit
The limit of the blend whose transition orientation is to be retrieved.
Legal values: 1 for the first support, and 2 for the second one
Returns:
The retrieved value of transition orientation.
Legal values: 1 for direct and -1 for reverse
Example:
This example retrieves in TransOrientation the transition orientation of the second limit of the ShpBlend hybrid shape blended feature.
 TransOrientation = ShpBlend.GetTransition(2)
 
o Func GetTrimSupport( iBlendLimit) As
Returns whether a support of the blend will be trimmed off.
If the support is set to be trimmed, it will be trimmed using the curve then joined to the blend.
Parameters:
iBlendLimit
The limit of the blend whose support is to be trimmed.
Legal values: 1 for the first limit, and 2 for the second one
Returns:
The trim support mode
Legal values:
1
No trim
2
The support will be trimmed
Example:
This example retrieves whether the second limit of the ShpBlend hybrid shape blended feature should be trimmed off.
 IsTrimmed = ShpBlend.GetTrimSupport(2)
 
o Sub InsertCouplingPoint( iCouplingIndex,
iPosition,
iPoint)
Inserts a coupling point to a coupling of the blend.
Parameters:
iCouplingIndex
The index of the coupling in the list of couplings into which the coupling point will be inserted.
iPosition
The position of the coupling point in the list of coupling points. Setting iPosition to 0 inserts the coupling point at the end of the list.
iPoint
The coupling point to be inserted. This point must lay on the section with the same position.
Sub-element(s) supported (see
Boundary object): Vertex.
Example:
This example inserts the Point23 point into the third coupling at the end of the list of coupling points of the ShpBlend hybrid shape blended feature.
 ShpBlend.InsertCouplingPoint 3, 0, Point23
 
o Sub InsertCoupling( iPosition)
Inserts a coupling into the blend.
Parameters:
iPosition
The position of the coupling in the list of couplings. Setting iPosition to 0 inserts the coupling at the end of the list.
Example:
This example inserts a coupling at the end of the coupling list of the ShpBlend hybrid shape blended feature.
 ShpBlend.InsertCouplingt 0
 
o Sub SetBorderMode( iBlendLimit,
iBorder)
Sets the type of border to a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend whose type of border is to be set.
Legal values: 1 for the first limit, and 2 for the second one
iBorder
The type of border
Legal values:
1
The border of the blend will be tangent to the border of the support surface, or if the curve ends on the border of a face of the support surface, then the border of the blend will be tangent to the border face.
2
The border of the blend is not constrained.
3
The border of the blend will be tangent to the border of the support surface at the start extremity of the curve, or if the curve ends on the border of a face of the support surface, then the border of the blend will be tangent to the border face at the start extremity of the curve.
4
The border of the blend will be tangent to the border of the support surface at the end extremity of the curve, or if the curve ends on the border of a face of the support surface, then the border of the blend will be tangent to the border face at the end extremity of the curve.
Example:
This example sets the type of border of the second limit of the ShpBlend hybrid shape blended feature to "no constraint".
 ShpBlend.SetBorderMode 2, 2
 
o Sub SetClosingPoint( iBlendLimit,
iClosingPoint)
Sets a new closing point to a closed curve of the blend.
Parameters:
iBlendLimit
The limit of the blend whose curve will be set a new closing point.
Legal values: 1 for the first curve, and 2 for the second one
iClosingPoint
The closing point to be set. This point must lay on the curve of the blend limit.
Sub-element(s) supported (see
Boundary object): Vertex.
Example:
This example sets the Point10 point as the closing point to the second limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.SetClosingPoint 2, Point10
 
o Sub SetContinuity( iBlendLimit,
iContinuity)
Sets the continuity to a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend whose continuity is to be set.
Legal values: 1 for the first limit, and 2 for the second one
iContinuity
The continuity to set
Legal values:
0
Point continuity
1
Tangency continuity
2
Curvature continuity
Example:
This example sets the continuity of the second limit of the ShpBlend hybrid shape blended feature to tangency continuity.
 ShpBlend.SetContinuity 2, 1
 
o Sub SetCurve( iBlendLimit,
iCurve)
Sets a curve to the blend.
Parameters:
iBlendLimit
The limit of the blend to which the curve will be set.
Legal values: 1 for the first curve, and 2 for the second one
iCurve
The curve to be set.
Sub-element(s) supported (see
Boundary object): TriDimFeatEdge and BiDimFeatEdge.
Example:
This example sets the CurveForBlend curve to the second limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.SetCurve 2, CurveForBlend
 
o Sub SetOrientation( iBlendLimit,
iOrientation)
Sets the orientation of a curve of the blend.
Parameters:
iBlendLimit
The limit of the blend whose curve orientation is to be set.
Legal values: 1 for the first curve, and 2 for the second one
iOrientation
The orientation to set to the curve.
Legal values: 1 for direct and -1 for reverse
Example:
This example sets the orientation of the second limit of the ShpBlend hybrid shape blended feature to direct.
 ShpBlend.SetOrientation 2, 1
 
o Sub SetRuledDevelopableSurfaceConnection( iBlendLimit,
iBlendConnection)
o Sub SetSmoothAngleThreshold( iAngle)
Sets the angular threshold.
Parameters:
iAngle
The angular threshold
o Sub SetSmoothDeviation( iLength)
Sets the deviation value (length) from guide curves allowed during sweeping operation in order to smooth it.
Parameters:
iLength
The deviation value
o Sub SetSupport( iBlendLimit,
iSupport)
Sets a support to the blend.
Parameters:
iBlendLimit
The limit of the blend whose support is to be set.
Legal values: 1 for the first support, and 2 for the second one
iSupport
The support surface to be set. The curve of the blend limit must lay on the surface.
Sub-element(s) supported (see
Boundary object): Face.
Example:
This example sets the SupportSurf surface as the support of the second limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.SetSupport 2, SupportSurf
 
o Sub SetTensionInDouble( iBlendLimit,
iTensionType,
iFirstTension,
iSecondTension)
Sets the tension values to a limit of the blend. The values must be expressed as doubles and must be positive.
Parameters:
iBlendLimit
The limit of the blend to which the tension values are to be set.
Legal values: 1 for the first limit, and 2 for the second one
iTensionType
The tension type
Legal values:
1
Default tension
2
Constant tension
3
Linear tension
iFirstTension
The value for the first tension. It must be used with any tension type
Legal values: it must be a double and positive.
iSecondTension
The value for the second tension. It can be used with linear tension only
Legal values: it must be a double and positive.
Example:
This example sets the tension values of the tension, supposed to be a linear tension, of the first limit of the ShpBlend hybrid shape blended feature to respectively 1.5 and 0.5.
 ShpBlend.SetTensionInDouble 1, 3, 1.5, 0.5
 
o Sub SetTensionType( iBlendLimit,
iTensionType)
Sets the tension type of a limit of the blend.
Parameters:
iBlendLimit
The limit of the blend for which the tension type is to be set.
Legal values: 1 for the first limit, and 2 for the second one
iBlendLimit
The value of tension type
Legal values:
1
Default tension
2
Constant tension
3
Linear tension
4
SType tension
Example:
This example sets the tension type as Default Tension for the first limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.SetTensionType 1, 1
 
o Sub SetTransition( iBlendLimit,
iTransition)
Sets the transition orientation to a limit of the blend.
Role: Let T be the tangent to the wire, and N be the normal to the skin body. The transition orientation defines how the blend goes from the initial wires: it takes the direction of iTransition*(T^N), where ^ is the cross product.
Parameters:
iBlendLimit
The limit of the blend whose transition orientation is to be set.
Legal values: 1 for the first support, and 2 for the second one
iTransition
The value of transition orientation.
Legal values: 1 for direct and -1 for reverse
Example:
This example sets the transition orientation of the second limit of the ShpBlend hybrid shape blended feature to reverse.
 ShpBlend.SetTransition 2, -1
 
o Sub SetTrimSupport( iBlendLimit,
iTrimSupport)
Sets whether a support of the blend is to be trimmed off.
If the support is set to be trimmed, it will be trimmed using the curve then joined to the blend.
Parameters:
iBlendLimit
The limit of the blend whose support is to be trimmed.
Legal values: 1 for the first limit, and 2 for the second one
iTrimSupport
The trim support mode
Legal values:
1
No trim
2
The support will be trimmed
Example:
This example sets that the second limit of the ShpBlend hybrid shape blended feature should be trimmed off.
 ShpBlend.SetTrimSupport 2, 2
 
o Sub UnsetClosingPoint( iBlendLimit)
Unsets the closing point of a closed curve of the blend.
Parameters:
iBlendLimit
The limit of the blend whose curve closing point is unset.
Legal values: 1 for the first curve, and 2 for the second one
Example:
This example unsets the closing point of the second limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.UnsetClosingPoint 2
 
o Sub UnsetSupport( iBlendLimit)
Unsets a support from the blend.
Parameters:
iBlendLimit
The limit of the blend whose support is to be unset.
Legal values: 1 for the first support, and 2 for the second one
Example:
This example unsets the support surface of the second limit of the ShpBlend hybrid shape blended feature.
 ShpBlend.UnsetSupport 2
 

Copyright © 2003, Dassault Systèmes. All rights reserved.