This functionality is provided as a preview
of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the
Fusion API and Scripts forum.
Because this is a preview of future functionality, there is the possibility that it will change, which will possibly
break any existing programs that use this functionality. Because of that, you should never deliver any programs that use
any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.
| 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(). |
| convertImportedToFusionPMI | Converts this PMIAnnotation to a Fusion PMIAnnotation if it is of supported type and has valid reference geometry. Supported types are: Imported PMI annotation (PMIImportedDimension) and valid reference geometry is converted to Hole/Thread Note PMI. Imported PMI annotation (PMIImportedNote) and valid reference geometry is converted to Leader Line Note PMI. Imported PMI folder (PMIImportedFolder) which includes information about a Hole Note is converted to Hole/Thread Note PMI. The converted PMIAnnotation can then be edited. After successful conversion, the new PMIAnnotation will be added to the collection of PMI in the component, and the original PMIAnnotation will be removed. If it fails to convert, the original PMIAnnotation remains unchanged. |
| 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 PMI. |
| markUpToDate | Marks the PMI as up-to-date and dismisses warnings. |
| setAnnotationPlane | Sets the annotation plane for Leader Line Note PMI. |
| setAnnotationTargetPoint | Sets the point on the annotation plane where the leader line meets the annotated geometry. |
| Name | Description |
| adjacentPlanarFaces | Gets the adjacent planar faces to the geometry that can be used to define the annotation plane with type NormalToFaceLeaderLineNotePlaneType. |
| annotationPlaneReferencedFace | Gets the BRepFace used as the alternate plane for the leader line note, if there's any. Applicable when the planeType is NormalToCustomFaceLeaderLineNotePlaneType or NormalToFaceLeaderLineNotePlaneType. |
| annotationPlaneType | Gets the LeaderLineNotePlaneTypes that the Leader Line Note PMI is currently using. |
| annotationTargetPoint | Gets the point on the annotation plane where the leader line meets the annotated geometry. |
| annotationTextPoint | Gets and sets the point on the annotation plane where the PMI text is anchored. |
| 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. |
| errorOrWarningMessage | If there are errors or warnings in the PMI, this property will return a string that contains the error or warning message. Otherwise it returns an empty string. Only applies to PMI that has an associated parametric Feature. Returns empty string for other PMI types that don't have a parametric Feature. |
| geometry | The geometric entity to which the Note PMI is associated. This can be a BRepFace, BRepEdge or BRepVertex object. For BRepEdge objects, only linear, circular and elliptical edges are supported. The note will be positioned relative to this entity and will maintain its association with the entity geometry. The geometry obtained is equivalent to referencedEntities[0]. Setting the geometry will set a default annotation plane and target point. Resetting the geometry will reset to default annotation plane and target point. Native object will be used when setting the geometry. |
| hasImportedGeometry | Gets whether the created PMI was converted from an imported PMI and therefore whether it has original graphics/geometry that can be shown. |
| healthState | Gets the health state of the PMI. Only applies to PMI that have a timeline object, in Parametric Modelling. Returns UnknownFeatureHealthState for other PMI types that don't have a parametric Feature. |
| horizontalAlignment | Gets and sets the horizontal alignment of the PMI text relative to its anchor point. This determines how the text box is positioned relative to the text placement point. |
| isDeletable | Indicates if this PMI can be deleted. |
| isLightBulbOn | Indicates if the light bulb (as displayed in the browser) is on. A PMI will only be visible if its light bulb, the containing folder's light bulb, the collection's and the component's light bulbs are all on. |
| isOutOfDate | Indicates if this PMI is outdated and needs to be recomputed. This typically happens when the geometry or parameters that the PMI references have been modified. Applicable for both imported and created PMI, regardless of whether they are parametric or not. |
| isParametric | Indicates if this PMI is parametric or not. |
| isPerpendicularLine | Gets and sets whether the PMI text is perpendicular to the leader line or parallel to it. |
| isShowImportedGeometry | Gets and sets whether the original graphics/geometry of the PMI should be visible. Only supported for PMI that has been converted from imported data. |
| isSuppressed | Indicates if this PMI is suppressed. Only applies to PMI that has an associated parametric Feature. Returns false for other PMI types that don't have a parametric Feature. |
| isValid | Indicates if this object is still valid, i.e. hasn't been deleted or some other action done to invalidate the reference. |
| isVisible | Indicates if the PMI is visible. This property is affected by the AssemblyContext (parent component) of the PMI. |
| leaderLineExtension | Gets and sets the length of the leader line extension. This value extends the leader line in the direction determined by the perpendicular setting. |
| name | Gets and sets the name of the PMI as it is shown in the browser. |
| 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 | This property is supported by all objects in the API and returns a string that contains the full name (namespace::objecttype) describing the type of the object. It's often useful to use this in combination with the classType method to see if an object is a certain type. For example: if obj.objectType == adsk.core.Point3D.classType(): |
| parentComponent | Gets the component this PMI belongs to. |
| plainText | This is a convenience property that provides the plain-text representation of the PMI text. It iterates through the segments and concatenates their text representation. |
| plane | Gets the plane of the PMI. |
| referencedEntities | Returns an array of referenced entities for this PMI. |
| segments | Gets and sets the list of PMISegments used to define the PMI text. The segments can be any combination of PMITextSegment, PMISymbolSegment and PMILineBreakSegment objects. Changing this property will result in changing the displayed text of the PMI. |
| supportedAnnotationPlaneTypes | Gets the available annotation plane types that can be set on this Leader Line Note PMI. |
| timelineObject | Gets the timeline object associated with this PMI. Only applies to PMI that has an associated timeline feature. Returns null if the PMI does not have an associated timeline feature. |
| type | Gets the type of this PMI annotation. |
| verticalAlignment | Gets and sets the vertical alignment of the PMI text relative to its anchor point. This determines the vertical positioning of the text box relative to the calculated text placement point. |