Objekt · SldWorks
BSurfParamData-Objekt
Die Daten einer Fläche als B-Spline-Fläche: Ordnungen, Knotenvektoren, Periodizität und die Matrix der Kontrollpunkte.
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
Surface.GetBSurfParams3: die B-Spline-Daten einer Fläche
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ControlPointColumnCount | Liefert die Zahl der Spalten in der Matrix der Kontrollpunkte. |
| ControlPointDimension | Liefert, wie viele Zahlen zu einem Kontrollpunkt gehören: 3 bei nicht rationalen, 4 bei rationalen Flächen. |
| ControlPointRowCount | Liefert die Zahl der Zeilen in der Matrix der Kontrollpunkte. |
| UKnots | Liefert den Knotenvektor der Fläche in U-Richtung. |
| UOrder | Liefert die Ordnung der Fläche in U-Richtung. |
| UPeriodicity | Liefert, ob die Fläche in U-Richtung periodisch ist, also in sich geschlossen. |
| VKnots | Liefert den Knotenvektor der Fläche in V-Richtung. |
| VOrder | Liefert die Ordnung der Fläche in V-Richtung. |
| VPeriodicity | Liefert, ob die Fläche in V-Richtung periodisch ist, also in sich geschlossen. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GetControlPoints | Liefert 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.