RectangularPatternFeature Object

Derived from: Feature Object
Defined in namespace "adsk::fusion" and the header file is <Fusion/Features/RectangularPatternFeature.h>

Description

Object that represents an existing rectangular pattern feature in a design.

Methods

Name Description
classType

Static function that all classes support that returns the type of the class as a string. The returned string matches the string returned by the objectType property. For example if you have a reference to an object and you want to check if it's a SketchLine you can use myObject.objectType == fusion.SketchLine.classType().

createForAssemblyContext

Creates or returns a proxy for the native object - i.e. a new object that represents this object but adds the assembly context defined by the input occurrence.

deleteMe

Deletes the feature. This works for both parametric and non-parametric features.

dissolve

Dissolves the feature so that the feature information is lost and only the B-Rep geometry defined by the feature remains. This is only valid for non-parametric features.

Properties

Name Description
assemblyContext Returns the assembly occurrence (i.e. the occurrence) of this object in an assembly. This is only valid in the case where this is acting as a proxy in an assembly. Returns null in the case where the object is not in the context of an assembly but is already the native object.
attributes Returns the collection of attributes associated with this face.
baseFeature If this feature is associated with a base feature, this property will return that base feature. If it's not associated with a base feature, this property will return null.
bodies Returns the bodies that were modified or created by this feature. This works for both parametric and non-parametric features. For a BaseFeature this returns the bodies that are owned by the base feature.
directionOne Returns a Vector3D indicating the positive direction of direction one.
directionOneEntity Gets and sets the first direction entity. This can be a linear edge, construction axis, sketch line or rectangular pattern feature. If a rectangular pattern feature is set, the directionOneEntity and directionTwoEntity properties return the same rectangular pattern feature.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
directionTwo Returns a Vector3D indicating the positive direction of direction two.
directionTwoEntity Gets and sets the second direction entity. This can be a linear edge, construction axis, sketch line or rectangular pattern feature. If a rectangular pattern feature is set, the directionOneEntity and directionTwoEntity properties return the same rectangular pattern feature. This can be null when not entity has been specified to control the second direction. In this case Fusion will compute a default direction which is 90 degrees to the direction one.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
distanceOne Gets the distance in the first direction. Edit the value through ModelParameter. Returns nothing in the case where the feature is non-parametric.
distanceTwo Gets the distance in the second direction. Edit the value through ModelParameter. Returns nothing in the case where the feature is non-parametric.
entityToken
errorOrWarningMessage Returns the error or warning message in the case where the healthState property returns either WarningFeatureHealthState or ErrorFeatureHealthState. Otherwise this property returns an empty string.
faces Returns the faces that were created by this feature. This works for both parametric and non-parametric features.
healthState Returns the current health state of the feature.
inputEntities Gets and sets the entities to pattern using an ObjectCollection. The collection can contain BRepFace, PartFeature, BRepBody, or Occurrence objects. All of the entities provided must be the same type. For example, it must contain only bodies and can't contain both bodies and faces.

ConstructionPoint, ConstructionAxis, and ConstructionPlane objects can also be patterned. When patterning any construction geometry, only one entity can be patterned at a time, so the ObjectCollection will always contain a single entity

To use this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
isParametric Indicates if this feature is parametric or not.
isSuppressed Gets and sets if this feature is suppressed. This is only valid for parametric features.
isSymmetricInDirectionOne Gets and sets if the pattern in direction one is in one direction or symmetric.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
isSymmetricInDirectionTwo Gets and sets if the pattern in direction two is in one direction or symmetric.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
isValid Indicates if this object is still valid, i.e. hasn't been deleted or some other action done to invalidate the reference.
linkedFeatures Returns the set of features that are linked to this feature. The set of linked features are all of the features that were created in various components as the result of a single feature being created in the user interface.
name Returns the name of the feature as seen in the browser (non-parametric) or in the timeline (parametric).
nativeObject The NativeObject is the object outside the context of an assembly and in the context of its parent component. Returns null in the case where this object is not in the context of an assembly but is already the native object.
objectType Returns a string indicating the type of the object.
parentComponent Returns the parent component that owns this feature.
patternComputeOption Gets and sets the compute option for this pattern feature. This property only applies when patterning features and is ignored in the direct modeling environment.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
patternDistanceType Gets and sets how the distance between elements is computed. Is initialized to ExtentPatternDistanceType when a new RectangularPatternFeatureInput has been created.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
patternElements Gets the PatternElements collection that contains the elements created by this pattern.
patternEntityType Returns the type of entities the pattern consists of. This can be used to help determine the type of results that will be found in the pattern elements.
quantityOne Gets the number of instances in the first direction. Edit the value through ModelParameter. Returns nothing in the case where the feature is non-parametric.
quantityTwo Gets the number of instances in the second direction. Edit the value through ModelParameter. Returns nothing in the case where the feature is non-parametric.
resultFeatures Get the features that were created for this pattern. Returns null in the case where the feature is parametric.
suppressedElementsIds Gets and sets the ids of the patterns to suppress.

To set this property, you need to position the timeline marker to immediately before this feature. This can be accomplished using the following code: thisFeature.timelineObject.rollTo(True)
timelineObject Returns the timeline object associated with this feature.

Accessed From

RectangularPatternFeature.createForAssemblyContext, RectangularPatternFeature.nativeObject, RectangularPatternFeatures.add, RectangularPatternFeatures.item, RectangularPatternFeatures.itemByName

Samples

Name Description
Manage Participant Bodies API Sample Demonstrates how to manage participant During Cut operation. Same API can be used to manage participants During intersection also.
RectangularPattern Feature Demonstrates creating a new rectangular pattern feature.

Version

Introduced in version November 2014