SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.FreePointCurveFeatureData · in der englischen .NET-Hilfe: IFreePointCurveFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
PointArrayLiest oder setzt die X-, Y- und Z-Koordinaten der Punkte der Kurve durch freie Punkte.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetPointCountLiefert die Zahl der Werte im Punkt-Array, also dreimal die Zahl der Punkte.
LoadPointsFromFileLädt die Punkte der Kurve durch freie Punkte aus einer Kurvendatei.
SavePointsToFileSpeichert 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.