SolidWorksMakroprogrammierung

Objekt · SldWorks

BSurfParamData-Objekt

Die Daten einer Fläche als B-Spline-Fläche: Ordnungen, Knotenvektoren, Periodizität und die Matrix der Kontrollpunkte.

Deklaration Dim x As SldWorks.BSurfParamData · in der englischen .NET-Hilfe: IBSurfParamData

Beschreibung

BSurfParamData gibt Zugriff auf die Daten einer B-Spline-Fläche. Du bekommst das Objekt von Surface.GetBSurfParams3, das jede Fläche als B-Spline-Fläche beschreibt. Alle Eigenschaften sind nur lesbar. Das Objekt gibt es seit SOLIDWORKS 2011.

Zugriff

Beispiel

' Gibt Ordnungen, Größe der Kontrollpunkt-Matrix und den ersten Kontrollpunkt
' der ausgewählten Fläche aus.
' Vorbedingung: Ein Teil ist offen, eine Fläche ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFace As SldWorks.Face2
    Dim swSurf As SldWorks.Surface
    Dim swParam As Object
    Dim swBSurf As SldWorks.BSurfParamData
    Dim vPunkt As Variant
    Dim bGleich As Boolean

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
    Set swFace = swSelMgr.GetSelectedObject6(1, -1)
    Set swSurf = swFace.GetSurface
    Set swParam = swSurf.Parameterization2
    Set swBSurf = swSurf.GetBSurfParams3(False, False, swParam, 0.00001, bGleich)
    If swBSurf Is Nothing Then Exit Sub

    Debug.Print "Ordnung U: " & swBSurf.UOrder & ", V: " & swBSurf.VOrder
    Debug.Print "Kontrollpunkte: " & swBSurf.ControlPointRowCount & " x " & swBSurf.ControlPointColumnCount & _
                ", je " & swBSurf.ControlPointDimension & " Zahlen"
    Debug.Print "Periodisch in U: " & swBSurf.UPeriodicity & ", in V: " & swBSurf.VPeriodicity
    vPunkt = swBSurf.GetControlPoints(1, 1)                        ' Zeile und Spalte zählen ab 1
    Debug.Print "Erster Kontrollpunkt: " & vPunkt(0) * 1000 & ", " & vPunkt(1) * 1000 & ", " & vPunkt(2) * 1000 & " mm"
End Sub

Bemerkungen

Kontrollpunkte: Die Kontrollpunkte bilden eine Matrix. Zeile und Spalte zählen bei BSurfParamData.GetControlPoints ab 1. U läuft in Richtung der Zeilen, V in Richtung der Spalten. Zu einem Punkt gehören 3 Zahlen (X, Y, Z) oder bei rationalen Flächen 4 (dazu das Gewicht), siehe BSurfParamData.ControlPointDimension.

Knoten: BSurfParamData.UKnots enthält so viele Werte wie Spalten plus Ordnung in U, BSurfParamData.VKnots so viele wie Zeilen plus Ordnung in V. Periodische Flächen liefert SOLIDWORKS in nicht periodischer Form, mit zusätzlichen Knoten an den Enden.

Umwandlung: Ob die Fläche kubisch oder nicht rational geliefert wird und mit welcher Toleranz, legst du mit den Parametern von Surface.GetBSurfParams3 fest. Das Hilfebeispiel übergibt eine Toleranz von 0,01, die Seite von GetBSurfParams3 empfiehlt meist kleinere Werte.

Einheiten: Die Hilfe nennt keine. Die Koordinaten sind in Metern.

Unbeschnittene Fläche: Die Daten beschreiben die Fläche ohne Begrenzung. Für die Deckfläche eines Quaders lagen die Kontrollpunkte in SOLIDWORKS 2024 rund 10 km vom Ursprung entfernt.

Eigenschaften und Methoden

Eigenschaften 9, davon 9 beschrieben

NameBeschreibung
ControlPointColumnCountLiefert die Zahl der Spalten in der Matrix der Kontrollpunkte.
ControlPointDimensionLiefert, wie viele Zahlen zu einem Kontrollpunkt gehören: 3 bei nicht rationalen, 4 bei rationalen Flächen.
ControlPointRowCountLiefert die Zahl der Zeilen in der Matrix der Kontrollpunkte.
UKnotsLiefert den Knotenvektor der Fläche in U-Richtung.
UOrderLiefert die Ordnung der Fläche in U-Richtung.
UPeriodicityLiefert, ob die Fläche in U-Richtung periodisch ist, also in sich geschlossen.
VKnotsLiefert den Knotenvektor der Fläche in V-Richtung.
VOrderLiefert die Ordnung der Fläche in V-Richtung.
VPeriodicityLiefert, ob die Fläche in V-Richtung periodisch ist, also in sich geschlossen.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetControlPointsLiefert die Koordinaten des Kontrollpunkts in einer Zeile und Spalte der Matrix, bei rationalen Flächen mit Gewicht.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetControlPoints). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IBSurfParamData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.