Objekt · SldWorks
Surface-Objekt
Steht für die Geometrie hinter einer Fläche: Ebene, Zylinder, Kegel, Kugel, Torus oder Freiform, unbegrenzt und ohne Rand.
Beschreibung
Eine Fläche (Face2) ist ein begrenztes Stück Oberfläche eines Körpers. Die Surface dahinter ist die reine Geometrie ohne Rand: zu einer ebenen Fläche eine unendliche Ebene, zu einer Bohrung ein unendlich langer Zylinder. Mit der Surface fragst du ab, welche Form eine Fläche hat, und holst ihre Maße, etwa Radius und Achse eines Zylinders.
Zugriff
Face2.GetSurface: die Surface einer FlächeModeler.CreatePlanarSurface2,Modeler.CreateCylindricalSurface2und weitereCreate…Surface-Befehle vonModeler: neue Surfaces für temporäre KörperBody2.CreatePlanarSurface: eine Ebene in einem temporären Körper
Beispiel
' Gibt aus, welche Form die ausgewählte Fläche hat, und ihre wichtigsten Maße.
' Vorbedingung: In einem Teil ist eine Fläche ausgewählt.
' Ergebnis: Zeilen im Direktfenster (Strg+G).
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 v As Variant
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
swApp.SendMsgToUser2 "Bitte zuerst eine Fläche auswählen.", swMbWarning, swMbOk
Exit Sub
End If
Set swFace = swSelMgr.GetSelectedObject6(1, -1)
Set swSurf = swFace.GetSurface
If swSurf.IsPlane Then
v = swSurf.PlaneParams
Debug.Print "Ebene, Normale " & v(0) & " / " & v(1) & " / " & v(2)
ElseIf swSurf.IsCylinder Then
v = swSurf.CylinderParams
Debug.Print "Zylinder, Durchmesser " & Format(v(6) * 2000, "0.000") & " mm"
ElseIf swSurf.IsCone Then
v = swSurf.ConeParams2
Debug.Print "Kegel, halber Öffnungswinkel " & Format(v(7) * 180 / 3.14159265358979, "0.00") & "°"
ElseIf swSurf.IsSphere Then
v = swSurf.SphereParams
Debug.Print "Kugel, Radius " & Format(v(3) * 1000, "0.000") & " mm"
ElseIf swSurf.IsTorus Then
v = swSurf.TorusParams
Debug.Print "Torus, Radien " & Format(v(6) * 1000, "0.000") & " und " & Format(v(7) * 1000, "0.000") & " mm"
Else
Debug.Print "Andere Fläche, Typ " & swSurf.Identity
End If
End SubBemerkungen
Die Normale der Surface muss nicht in dieselbe Richtung zeigen wie die der Fläche. Ob sie entgegengesetzt ist, sagt Face2.FaceInSurfaceSense. Längen und Koordinaten sind in Metern, Winkel im Bogenmaß.
Viele Befehle arbeiten mit den Parametern U und V. Sie beschreiben eine Stelle auf der Surface, so wie Länge und Breite eine Stelle auf der Erde. Den gültigen Bereich liefert Surface.Parameterization2, den Bereich einer bestimmten Fläche Face2.GetUVBounds.
Eigenschaften und Methoden
Eigenschaften 6, davon 5 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| ConeParams | veraltet ersetzt durch Surface.ConeParams2 |
| ConeParams2 | Liefert Spitze, Achse, Radius und Öffnungswinkel einer Kegelfläche. |
| CylinderParams | Liefert Achse und Radius einer Zylinderfläche. |
| PlaneParams | Liefert Normale und einen Punkt einer ebenen Fläche. |
| SphereParams | Liefert Mittelpunkt und Radius einer Kugelfläche. |
| TorusParams | Liefert Mittelpunkt, Achse und beide Radien einer Torusfläche. |
Methoden 44, davon 35 beschrieben, 9 veraltet
| Name | Beschreibung |
|---|---|
| AddTrimmingLoop | veraltet ersetzt durch Surface.AddTrimmingLoop2 |
| AddTrimmingLoop2 | Fügt einer neuen Surface eine Begrenzungsschleife aus UV-Kurven hinzu, um daraus eine begrenzte Fläche zu machen. |
| Copy | Liefert eine Kopie einer Surface. |
| CreateNewCurve | Erzeugt eine neue, leere Kurve. |
| CreateTrimmedSheet | veraltet ersetzt durch Surface.CreateTrimmedSheet5 |
| CreateTrimmedSheet4 | veraltet ersetzt durch Surface.CreateTrimmedSheet5 |
| CreateTrimmedSheet5 | Erzeugt aus einer Surface und Begrenzungskurven einen temporären Flächenkörper. |
| Evaluate | Berechnet Punkt, Ableitungen und Normale einer Surface an einer Stelle U, V. |
| EvaluateAtPoint | Liefert Normale, Hauptkrümmungsrichtungen und Hauptkrümmungen einer Surface an einem Punkt. |
| FindMinimumRadius | Sucht den kleinsten Krümmungsradius einer Surface in einem UV-Bereich. |
| GetBSurfParams | veraltet ersetzt durch Surface.GetBSurfParams3 |
| GetBSurfParams2 | veraltet ersetzt durch Surface.GetBSurfParams3 |
| GetBSurfParams3 | Liefert eine Surface als B-Spline-Fläche: Ordnungen, Knoten und Kontrollpunkte. |
| GetClosestPointOn | Liefert den Punkt einer Surface, der einem gegebenen Punkt am nächsten liegt, samt U und V. |
| GetExtrusionsurfParams | Liefert die Richtung, in der das Profil einer extrudierten Surface ausgetragen ist. |
| GetIntersectCurveCount | veraltet ersetzt durch Surface.GetIntersectCurveCount2 |
| GetIntersectCurveCount2 | Liefert die Anzahl der Schnittpunkte einer Surface mit einer Kurve. |
| GetIntersectSurfaceCount | Liefert die Anzahl der Schnittkurven zweier Surfaces. |
| GetOffsetSurfParams | veraltet ersetzt durch Surface.GetOffsetSurfParams2 |
| GetOffsetSurfParams2 | Liefert den Abstand, die Ausgangs-Surface und die Richtung einer Offset-Surface. |
| GetProfileCurve | Liefert das Profil, aus dem eine Dreh- oder Extrusions-Surface entstanden ist. |
| GetProjectedPointOn | Projiziert einen Punkt entlang einer Richtung auf eine Surface. |
| GetRevsurfParams | Liefert Drehachse und Profilbereich einer Dreh-Surface. |
| Identity | Liefert die Art einer Surface als Zahl, etwa Ebene, Zylinder oder B-Spline-Fläche. |
| IntersectCurve | veraltet ersetzt durch Surface.IntersectCurve2 |
| IntersectCurve2 | Berechnet die Schnittpunkte einer Surface mit einer begrenzten Kurve. |
| IntersectSurface | Berechnet die Schnittkurven zweier Surfaces. |
| IsBlending | Prüft, ob eine Surface eine Übergangsfläche (Blend) ist. |
| IsCone | Prüft, ob eine Surface ein Kegel ist. |
| IsCylinder | Prüft, ob eine Surface ein Zylinder ist. |
| IsForeign | Prüft, ob eine Surface eine Fremdfläche ist. |
| IsOffset | Prüft, ob eine Surface eine Offset-Fläche ist. |
| IsParametric | Prüft, ob eine Surface eine parametrische Fläche (B-Spline) ist. |
| IsPlane | Prüft, ob eine Surface eine Ebene ist. |
| IsRevolved | Prüft, ob eine Surface eine Drehfläche ist. |
| IsSphere | Prüft, ob eine Surface eine Kugel ist. |
| IsSwept | Prüft, ob eine Surface eine ausgetragene Fläche (Sweep) ist. |
| IsTorus | Prüft, ob eine Surface ein Torus ist. |
| MakeIsoCurve | Erzeugt eine Kurve auf einer Surface, entlang der U oder V konstant ist. Vorgänger von MakeIsoCurve2. |
| MakeIsoCurve2 | Erzeugt eine Kurve auf einer Surface, entlang der U oder V konstant ist. |
| MakeIsoCurves | Erzeugt Kurven auf einer Surface in einem UV-Bereich unter einem Winkel zu einer Richtung. |
| Parameterization | veraltet ersetzt durch Surface.Parameterization2 |
| Parameterization2 | Liefert den Bereich der Parameter U und V einer Surface. |
| ReverseEvaluate | Liefert U und V eines Punkts, der auf einer Surface liegt. |
Nicht aufgeführt sind 33 C++-Varianten (Namen mit I davor, zum Beispiel IAddTrimmingLoop). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISurface in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.