All Frameworks  Object Hierarchy  This Framework  Indexes

CircPattern (Object)

Represents the circular pattern.
The shape is duplicated along concentric circles to build crowns. A linear repartition object defines the duplication along radial directions, thus determining the number of crowns. An angular repartition object defines the duplication on the crowns.
See also:
LinearRepartition, AngularRepartition

Property Index

AngularDirectionRow
Returns the position of the shape to be copied along the angular direction.
AngularRepartition
Returns the angular repartition.
CircularPatternParameters
Returns or sets the circular pattern parameters required to define the pattern.
RadialAlignment
Returns or sets whether the copied shapes should be rotated or radial aligned with respect to the original one.
RadialDirectionRow
Returns the position of the shape to be copied along the radial direction.
RadialRepartition
Returns the radial repartition.
RotationOrientation
Returns or sets whether the shapes are copied clockwise on the crowns with respect to the rotation axis direction.

Method Index

GetRotationAxis
Returns the rotation axis.
GetRotationCenter
Returns the rotation center if the user defined it.
SetInstanceAngularSpacing
Sets the InstanceAngularSpacing.
SetRotationAxis
Sets the rotation axis.
SetRotationCenter
Sets the rotation center.
SetUnequalInstanceNumber
Sets the Instance Number.
SetUnequalStep
This method is deprecated Sets the UnequalStep.

Properties


o Property AngularDirectionRow() As (Read Only)
Returns the position of the shape to be copied along the angular direction.
Example:
The following example returns in AngularDirPos the position of the shape to be copied along the angular direction. 
 Set AngularDirPos = firstPattern.AngularDirectionRow
o Property AngularRepartition() As (Read Only)
Returns the angular repartition. The angular repartition is the repartition on a crown.
Example:
The following example returns in repartA the angular repartition of the circular pattern firstPattern: 
 Set repartA = firstPattern.AngularRepartition
o Property CircularPatternParameters() As
Returns or sets the circular pattern parameters required to define the pattern. These parameters are used when reading the CATIAAngularRepartition properties.
Example:
The following example returns in parameters the circular pattern parameters of the firstPattern circular pattern, and then sets it to catCompleteCrown, so that only the number of instances is used to define the Pattern: 
 Set parameters = firstPattern.CircularPatternParameters
 Set firstPattern.CircularPatternParameters = catCompleteCrown
o Property RadialAlignment() As
Returns or sets whether the copied shapes should be rotated or radial aligned with respect to the original one.
True if the copied shapes are rotated.
Example:
The following example returns in alignedR the radial alignment of the circular pattern firstPattern, and then sets it to False: 
 Set alignedR = firstPattern.RadialAlignment
 firstPattern.RadialAlignment = False
o Property RadialDirectionRow() As (Read Only)
Returns the position of the shape to be copied along the radial direction.
Example:
The following example returns in RadialDirPos the position of the shape to be copied along the radial direction. 
 Set RadialDirPos = firstPattern.RadialDirectionRow
o Property RadialRepartition() As (Read Only)
Returns the radial repartition. The radial repartition is the repartition along a radius.
Example:
The following example returns in repartR the radial repartition of the circular pattern firstPattern: 
 Set repartR = firstPattern.RadialRepartition
o Property RotationOrientation() As
Returns or sets whether the shapes are copied clockwise on the crowns with respect to the rotation axis direction.
True if the shapes are copied counterclockwise when the rotation axis direction goes towards you when you look at the crown.
Example:
The following example returns in alignedAxis whether the circular pattern firstPattern is built clockwise, and then sets it to True: 
 alignedAxis = firstPattern.RotationOrientation
 firstPattern.RotationOrientation = True

Methods


o Sub GetRotationAxis( ioRotationAxis)
Returns the rotation axis. The rotation axis is returned as an array containing the rotation axis vector components. Assume this array is oRotationAxis. It contains:
oRotationAxis[0],oRotationAxis[1],oRotationAxis[2]
The X, Y, and Z rotation axis vector components
Example:
The following example returns in axisArray the rotation axis components of the circular pattern firstPattern: 
 Call firstPattern.GetRotationAxis(axisArray)
 Set x = axisArray[0]
 Set y = axisArray[1]
 Set z = axisArray[2]
o Sub GetRotationCenter( ioRotationCenter)
Returns the rotation center if the user defined it. Returns E_FAIL if no rotation center has been defined The rotation center is returned as an array containing the rotation center coordinates. Assume this array is oRotationCenter. It contains:
oRotationCenter[0],oRotationCenter[1],oRotationCenter[2]
The X, Y, and Z rotation center coordinates
Example:
The following example returns in centerArray the rotation center coordinates of the circular pattern firstPattern, and saves them in variables: 
 Call firstPattern.GetRotationCenter(centerArray)
 x = centerArray[0]
 y = centerArray[1]
 z = centerArray[2]
o Sub SetInstanceAngularSpacing( iInstanceNumber,
iAngularSpacing)
Sets the InstanceAngularSpacing.
Parameters:
iInstanceNumber
The Instance Number
iAngularSpacing
The Angular Spacing
Example:
The following example sets the InstanceAngularSpacing of the circular pattern
o Sub SetRotationAxis( iRotationAxis)
Sets the rotation axis.
Parameters:
iRotationAxis
The rotation axis. It is passed as reference and can be valuated with a line, an edge or a plane reference: in this case the plane normal is taken into account.
The following
Boundary objects are supported: PlanarFace, CylindricalFace RectilinearTriDimFeatEdge and RectilinearBiDimFeatEdge.
Example:
The following example sets the rotation axis of the circular pattern firstPattern with the refLine1 reference: 
 firstPattern.SetRotationAxis refLine1
o Sub SetRotationCenter( iRotationCenter)
Sets the rotation center.
Parameters:
iRotationCenter
The rotation center
Example:
The following example sets the rotation center of the circular pattern firstPattern with point1Ref point: 
 firstPattern.SetRotationCenter point1Ref
o Sub SetUnequalInstanceNumber( iInstanceNumber)
Sets the Instance Number.
Parameters:
iInstanceNumber
The Instance Number
Example:
The following example modifies the instance number for unequal angular spacing
o Sub SetUnequalStep( iInstanceNumber)
This method is deprecated Sets the UnequalStep.
Parameters:
iInstanceNumber
The Instance Number
Example:
The following example creates the number of pattern spacing objects in pattern object

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