Objekt · SldWorks
FreePointCurveFeatureData-Objekt
Die Definition einer Kurve durch freie Punkte (Kurve durch XYZ-Punkte): die Koordinaten der Punkte, ihre Zahl und das Laden und Speichern als Kurvendatei.
Beschreibung
FreePointCurveFeatureData gibt Zugriff auf eine Kurve, die durch Punkte mit X-, Y- und Z-Koordinaten läuft (free-point curve). In der Oberfläche heißt das Feature „Kurve durch XYZ-Punkte“. Die Punkte kannst du als Array lesen und setzen oder aus einer Kurvendatei (.sldcrv oder .txt) laden und in eine speichern. Die Befehle gibt es seit SOLIDWORKS 2003.
Zugriff
Feature.GetDefinition: bei einer Kurve durch freie Punkte mit dem TypnamenCurveInFile(Feature.GetTypeName2)
Ein solches Feature legst du mit ModelDoc2.InsertCurveFileBegin, ModelDoc2.InsertCurveFilePoint und ModelDoc2.InsertCurveFileEnd an oder mit ModelDoc2.InsertCurveFile aus einer Datei. Im Hilfebeispiel heißt es dann Curve1, und es wählt das Feature mit ModelDocExtension.SelectByID2 und dem Typ REFERENCECURVES aus.
Beispiel
' Gibt die Punkte der ausgewählten Kurve durch freie Punkte in mm aus und speichert
' sie als Kurvendatei.
' Vorbedingung: Ein Teil mit einer Kurve durch XYZ-Punkte ist offen, die Kurve ist
' im FeatureManager ausgewählt. Den Ordner C:\Temp gibt es.
' Ergebnis: Die Punkte stehen im Direktfenster (Strg+G), die Datei liegt in C:\Temp.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.FreePointCurveFeatureData
Dim vPunkte As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
If swFeat.GetTypeName2 <> "CurveInFile" Then Exit Sub
Set swDaten = swFeat.GetDefinition
Debug.Print swFeat.Name & ": " & swDaten.GetPointCount \ 3 & " Punkte"
vPunkte = swDaten.PointArray
If IsArray(vPunkte) Then
For i = 0 To UBound(vPunkte) - 2 Step 3
Debug.Print " " & i \ 3 + 1 & ": " & vPunkte(i) * 1000# & ", " & _
vPunkte(i + 1) * 1000# & ", " & vPunkte(i + 2) * 1000#
Next i
End If
If swDaten.SavePointsToFile("C:\Temp\" & swFeat.Name & ".sldcrv") Then
Debug.Print "Gespeichert."
End If
End SubBemerkungen
Hilfebeispiel: „Insert Free Point Curve Feature“ legt in einem neuen Teil mit ModelDoc2.InsertCurveFileBegin eine Kurve durch sechs Punkte an, wählt sie als Curve1 aus, holt mit Feature.GetDefinition die Definition und gibt FreePointCurveFeatureData.GetPointCount und alle Werte aus FreePointCurveFeatureData.PointArray aus. Dann speichert es die Punkte mit FreePointCurveFeatureData.SavePointsToFile nach c:\temp\MyFreePointCurveFeature.sldcrv.
Punkte als Array: FreePointCurveFeatureData.PointArray enthält je Punkt drei Werte hintereinander: x1, y1, z1, x2, y2, z2, …. FreePointCurveFeatureData.GetPointCount liefert die Zahl dieser Werte, also dreimal die Zahl der Punkte, nicht die Zahl der Punkte. Eine Einheit nennt die Hilfe nicht. Es sind Meter, wie bei den Punkten aus ModelDoc2.InsertCurveFilePoint im Hilfebeispiel (0.0127, 0.0254 …).
Dateien: Kurvendateien .sldcrv und Textdateien .txt gehen im selben Format. Beim Speichern nimmt SOLIDWORKS die Einheiten des Dokuments, zu dem das Feature gehört, nicht unbedingt die des aktiven Dokuments. Das Format der Dateien beschreibt die API-Hilfe nicht, sie verweist auf die SOLIDWORKS-Hilfe. Die Hilfe zu ModelDoc2.InsertCurveFile gibt an, dass in einer Datei je Zeile ein Punkt steht.
Ändern: Die Hilfe beschreibt das Ändern nicht. FreePointCurveFeatureData hat kein AccessSelections. Vermutlich setzt du die Punkte mit FreePointCurveFeatureData.PointArray oder FreePointCurveFeatureData.LoadPointsFromFile und rufst dann Feature.ModifyDefinition auf. Bei PointArray verweist die Hilfe dafür auf das Kapitel „Accessing Selections that Define Features“.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| PointArray | Liest oder setzt die X-, Y- und Z-Koordinaten der Punkte der Kurve durch freie Punkte. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetPointCount | Liefert die Zahl der Werte im Punkt-Array, also dreimal die Zahl der Punkte. |
| LoadPointsFromFile | Lädt die Punkte der Kurve durch freie Punkte aus einer Kurvendatei. |
| SavePointsToFile | Speichert die Punkte der Kurve durch freie Punkte in eine Kurvendatei. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetPointArray). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IFreePointCurveFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.