SolidWorksMakroprogrammierung

Objekt · SldWorks

Surface-Objekt

Steht für die Geometrie hinter einer Fläche: Ebene, Zylinder, Kegel, Kugel, Torus oder Freiform, unbegrenzt und ohne Rand.

Deklaration Dim x As SldWorks.Surface · in der englischen .NET-Hilfe: ISurface

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

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 Sub

Bemerkungen

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

NameBeschreibung
ConeParamsveraltet ersetzt durch Surface.ConeParams2
ConeParams2Liefert Spitze, Achse, Radius und Öffnungswinkel einer Kegelfläche.
CylinderParamsLiefert Achse und Radius einer Zylinderfläche.
PlaneParamsLiefert Normale und einen Punkt einer ebenen Fläche.
SphereParamsLiefert Mittelpunkt und Radius einer Kugelfläche.
TorusParamsLiefert Mittelpunkt, Achse und beide Radien einer Torusfläche.

Methoden 44, davon 35 beschrieben, 9 veraltet

NameBeschreibung
AddTrimmingLoopveraltet ersetzt durch Surface.AddTrimmingLoop2
AddTrimmingLoop2Fügt einer neuen Surface eine Begrenzungsschleife aus UV-Kurven hinzu, um daraus eine begrenzte Fläche zu machen.
CopyLiefert eine Kopie einer Surface.
CreateNewCurveErzeugt eine neue, leere Kurve.
CreateTrimmedSheetveraltet ersetzt durch Surface.CreateTrimmedSheet5
CreateTrimmedSheet4veraltet ersetzt durch Surface.CreateTrimmedSheet5
CreateTrimmedSheet5Erzeugt aus einer Surface und Begrenzungskurven einen temporären Flächenkörper.
EvaluateBerechnet Punkt, Ableitungen und Normale einer Surface an einer Stelle U, V.
EvaluateAtPointLiefert Normale, Hauptkrümmungsrichtungen und Hauptkrümmungen einer Surface an einem Punkt.
FindMinimumRadiusSucht den kleinsten Krümmungsradius einer Surface in einem UV-Bereich.
GetBSurfParamsveraltet ersetzt durch Surface.GetBSurfParams3
GetBSurfParams2veraltet ersetzt durch Surface.GetBSurfParams3
GetBSurfParams3Liefert eine Surface als B-Spline-Fläche: Ordnungen, Knoten und Kontrollpunkte.
GetClosestPointOnLiefert den Punkt einer Surface, der einem gegebenen Punkt am nächsten liegt, samt U und V.
GetExtrusionsurfParamsLiefert die Richtung, in der das Profil einer extrudierten Surface ausgetragen ist.
GetIntersectCurveCountveraltet ersetzt durch Surface.GetIntersectCurveCount2
GetIntersectCurveCount2Liefert die Anzahl der Schnittpunkte einer Surface mit einer Kurve.
GetIntersectSurfaceCountLiefert die Anzahl der Schnittkurven zweier Surfaces.
GetOffsetSurfParamsveraltet ersetzt durch Surface.GetOffsetSurfParams2
GetOffsetSurfParams2Liefert den Abstand, die Ausgangs-Surface und die Richtung einer Offset-Surface.
GetProfileCurveLiefert das Profil, aus dem eine Dreh- oder Extrusions-Surface entstanden ist.
GetProjectedPointOnProjiziert einen Punkt entlang einer Richtung auf eine Surface.
GetRevsurfParamsLiefert Drehachse und Profilbereich einer Dreh-Surface.
IdentityLiefert die Art einer Surface als Zahl, etwa Ebene, Zylinder oder B-Spline-Fläche.
IntersectCurveveraltet ersetzt durch Surface.IntersectCurve2
IntersectCurve2Berechnet die Schnittpunkte einer Surface mit einer begrenzten Kurve.
IntersectSurfaceBerechnet die Schnittkurven zweier Surfaces.
IsBlendingPrüft, ob eine Surface eine Übergangsfläche (Blend) ist.
IsConePrüft, ob eine Surface ein Kegel ist.
IsCylinderPrüft, ob eine Surface ein Zylinder ist.
IsForeignPrüft, ob eine Surface eine Fremdfläche ist.
IsOffsetPrüft, ob eine Surface eine Offset-Fläche ist.
IsParametricPrüft, ob eine Surface eine parametrische Fläche (B-Spline) ist.
IsPlanePrüft, ob eine Surface eine Ebene ist.
IsRevolvedPrüft, ob eine Surface eine Drehfläche ist.
IsSpherePrüft, ob eine Surface eine Kugel ist.
IsSweptPrüft, ob eine Surface eine ausgetragene Fläche (Sweep) ist.
IsTorusPrüft, ob eine Surface ein Torus ist.
MakeIsoCurveErzeugt eine Kurve auf einer Surface, entlang der U oder V konstant ist. Vorgänger von MakeIsoCurve2.
MakeIsoCurve2Erzeugt eine Kurve auf einer Surface, entlang der U oder V konstant ist.
MakeIsoCurvesErzeugt Kurven auf einer Surface in einem UV-Bereich unter einem Winkel zu einer Richtung.
Parameterizationveraltet ersetzt durch Surface.Parameterization2
Parameterization2Liefert den Bereich der Parameter U und V einer Surface.
ReverseEvaluateLiefert 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.