SolidWorksMakroprogrammierung

Objekt · SldWorks

Modeler-Objekt

Der Zugang zum Geometriekern: erzeugt temporäre Körper, Kurven und Flächen, prüft Körper auf Interferenz und stellt die Toleranzen für die Ausgabe von Geometrie ein.

Deklaration Dim x As SldWorks.Modeler · in der englischen .NET-Hilfe: IModeler

Beschreibung

Modeler gibt Zugang zu temporären Körpern. Ein temporärer Körper (Body2) existiert nur im Speicher: Er hat kein Feature und steht nicht im FeatureManager. Mit Modeler erzeugst du solche Körper und dazu reine Geometrie: Kurven (Curve) und Flächen (Surface), die noch zu keinem Körper gehören. Mit den Körpern rechnest du, etwa mit Body2.Operations2, zeigst sie mit Body2.Display3 an oder machst mit PartDoc.CreateFeatureFromBody3 ein Feature daraus. Wo die Hilfe eine Version nennt, reicht sie von SOLIDWORKS 99 bis 2018.

Zugriff

Beispiel

' Erzeugt einen Quader 100 x 60 x 20 mm und einen Zylinder mit 20 mm Durchmesser als
' temporäre Körper, prüft, ob sie sich durchdringen, zieht den Zylinder vom Quader ab
' und zeigt das Ergebnis an.
' Vorbedingung: Ein Teil ist offen.
' Ergebnis:     Der Körper ist bis zum Klick auf OK zu sehen. Das Teil bleibt unverändert.
'               Das Volumen steht im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swModeler As SldWorks.Modeler
    Dim swQuader As SldWorks.Body2
    Dim swZylinder As SldWorks.Body2
    Dim swErgebnis As SldWorks.Body2
    Dim dQuader(8) As Double
    Dim dZylinder(7) As Double
    Dim vFlaechen1 As Variant, vFlaechen2 As Variant, vSchnitt As Variant
    Dim vKoerper As Variant, vMasse As Variant
    Dim nFehler As Long
    Dim aA(0) As SldWorks.Body2, aB(0) As SldWorks.Body2, vA As Variant, vB As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swModeler = swApp.GetModeler

    ' Quader: Mitte der Grundfläche (0/0/0), Achse Z, Breite in X, Länge in Y, Höhe
    dQuader(5) = 1
    dQuader(6) = 0.1: dQuader(7) = 0.06: dQuader(8) = 0.02
    Set swQuader = swModeler.CreateBodyFromBox3(dQuader)

    ' Zylinder: Mitte der Grundfläche 5 mm unter dem Quader, Achse Z, Radius, Höhe
    dZylinder(2) = -0.005
    dZylinder(5) = 1
    dZylinder(6) = 0.01: dZylinder(7) = 0.03
    Set swZylinder = swModeler.CreateBodyFromCyl(dZylinder)
    If swQuader Is Nothing Or swZylinder Is Nothing Then Exit Sub

    Set aA(0) = swQuader: vA = aA                  ' typisierte Arrays, nicht Array(...)
    Set aB(0) = swZylinder: vB = aB
    If swModeler.CheckInterference3((vA), (vB), _
            swBodyInterference_OptionDefault, vFlaechen1, vFlaechen2, vSchnitt) Then
        Debug.Print "Quader und Zylinder durchdringen sich."
    End If

    ' Danach sind Quader und Zylinder ungültig, es zählt nur das Ergebnis.
    vKoerper = swQuader.Operations2(SWBODYCUT, swZylinder, nFehler)
    If nFehler <> swBodyOperationNoError Then
        Debug.Print "Abziehen fehlgeschlagen, Fehler " & nFehler
        Exit Sub
    End If
    Set swErgebnis = vKoerper(0)
    vMasse = swErgebnis.GetMassProperties(1)
    Debug.Print "Temporär: " & swErgebnis.IsTemporaryBody & ", Volumen: " & _
        Format(vMasse(3) * 1000000000#, "0") & " mm³"

    swErgebnis.Display3 swModel, RGB(255, 128, 0), swTempBodySelectOptionNone
    MsgBox "Der temporäre Körper wird angezeigt. OK blendet ihn aus."
    swErgebnis.Hide swModel
End Sub

Bemerkungen

Temporäre Körper: Nach Modeler.Restore werden temporäre Körper nicht mit dem Dokument gespeichert, außer du speicherst sie ausdrücklich mit Body2.Save. Ob ein Körper temporär ist, liefert Body2.IsTemporaryBody. Eine temporäre Kopie eines Körpers aus dem Modell bekommst du mit Body2.Copy2. Solange Body2.Display3 einen Körper anzeigt, darf die Variable nach Body2.Hide nicht freigegeben werden. Das Beispiel blendet ihn deshalb vor dem Ende des Makros wieder aus. Ins Modell kommt ein Körper als Feature mit PartDoc.CreateFeatureFromBody3 oder als Flächen-Feature mit PartDoc.CreateSurfaceFeatureFromBody.

Kurven und Flächen begrenzen: Ebene, Zylinder-, Kegel-, Kugel- und Torusfläche sowie die Fläche aus Modeler.CreateSweptSurface sind unbegrenzt. Einen Flächenkörper machst du daraus mit Begrenzungskurven über Surface.CreateTrimmedSheet5 oder mit einem UV-Bereich über Modeler.CreateSheetFromSurface. Geraden und Bögen aus Modeler.CreateLine und Modeler.CreateArc begrenzt du dafür vorher mit Curve.CreateTrimmedCurve2. Den ganzen Ablauf vom Profil bis zum extrudierten Körper zeigt Modeler.CreateExtrudedBody.

Punkte und Richtungen: Viele Befehle erwarten Punkte und Richtungen als Double-Array mit den drei Werten X, Y, Z. Die Hilfebeispiele übergeben die Arrays mal direkt, mal in zusätzlichen Klammern wie (ptArr). Einige Befehle wollen stattdessen einen MathVector, den du mit MathUtility.CreateVector erzeugst.

Einheiten: Bei Modeler.SetToleranceValue und Modeler.SetInitKnitGapWidth gelten Meter und beim halben Öffnungswinkel von Modeler.CreateConicalSurface2 das Bogenmaß. Bei den übrigen Befehlen nennt die Hilfe keine Einheit. Für Radien, Längen und Abstände gelten auch dort Meter (belegt an CreateArc, CreateBodyFromBox3, CreateBodyFromCone, CreateBodyFromCyl, den Surface-Befehlen, CreateOffsetSurface und FindTwoEdgeMaxDeviation).

Parasolid: Bei Modeler.GeneralTopology und Modeler.GetBodyOutline2 spricht die Hilfe von einer Option und einer Vorgabe von Parasolid, dem Geometriekern von SOLIDWORKS.

Übergib Körper an Modeler.CheckInterference3 als typisierte Arrays wie im Beispiel. Mit Array(...) gebauten Arrays meldet der Befehl keine Durchdringung, auch wenn sich die Körper durchdringen.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
GeneralTopologyLiest oder setzt, ob der Geometriekern allgemeine, nicht mannigfaltige Körper erzeugen darf.

Methoden 63, davon 52 beschrieben, 11 veraltet

NameBeschreibung
CheckInterferenceveraltet ersetzt durch Modeler.CheckInterference3
CheckInterference3Prüft, ob sich Zielkörper und Werkzeugkörper durchdringen, und liefert auf Wunsch die betroffenen Flächen und Körper.
CheckInterferenceBetweenTwoBodiesPrüft zwei Körper aus einer Baugruppe auf Interferenz und liefert die betroffenen Flächen und Körper.
CopyWizardHoleÜberträgt die Daten einer Bohrung aus dem Bohrungsassistenten auf eine andere Bohrung.
CreateArcErzeugt eine Kreisbogen-Kurve aus Mittelpunkt, Achse, Radius, Anfangs- und Endpunkt.
CreateBodiesFromSheetsveraltet ersetzt durch Modeler.CreateBodiesFromSheets2
CreateBodiesFromSheets2Näht Flächenkörper zu Volumen- oder Flächenkörpern zusammen.
CreateBodyFromBoxveraltet ersetzt durch Modeler.CreateBodyFromBox3
CreateBodyFromBox3Erzeugt einen Quader als temporären Körper.
CreateBodyFromConeErzeugt einen Kegel oder Kegelstumpf als temporären Körper.
CreateBodyFromCylErzeugt einen Zylinder als temporären Körper.
CreateBodyFromFaces2Erzeugt aus Flächen eines Körpers einen neuen temporären Körper und schließt die Lücken auf eine gewählte Art.
CreateBrepBodyveraltet ersetzt durch Modeler.CreateBrepBody3
CreateBrepBody3Baut einen temporären Körper aus Topologie (Schalen, Flächen, Schleifen, Kanten, Eckpunkte) und Geometrie auf, also aus BREP-Daten.
CreateBsplineCurveErzeugt eine B-Spline-Kurve aus Ordnung, Knoten und Kontrollpunkten.
CreateBsplineSurfaceErzeugt eine B-Spline-Fläche (Surface) aus Ordnungen, Knoten und Kontrollpunkten.
CreateConicalSurfaceveraltet ersetzt durch Modeler.CreateConicalSurface2
CreateConicalSurface2Erzeugt eine unbegrenzte Kegelfläche (Surface).
CreateCoonsBSurfaceErzeugt eine B-Spline-Fläche (Coons-Fläche) aus vier Randkurven.
CreateCylindricalSurfaceveraltet ersetzt durch Modeler.CreateCylindricalSurface2
CreateCylindricalSurface2Erzeugt eine unbegrenzte Zylinderfläche (Surface).
CreateEllipseErzeugt eine Ellipse als Kurve aus Mittelpunkt, Halbachsen und deren Richtungen.
CreateExtrudedBodyExtrudiert einen Flächenkörper als Profil zu einem temporären Körper.
CreateExtrusionSurfaceErzeugt eine Extrusionsfläche (Surface), indem eine Profilkurve entlang einer Richtung verschoben wird.
CreateLineErzeugt eine Gerade als Kurve aus einem Punkt und einer Richtung.
CreateLoftBodyveraltet ersetzt durch Modeler.CreateLoftBody2
CreateLoftBody2Erzeugt einen Ausformungskörper (Loft) aus Profilskizzen, Leitkurven und Mittellinie als temporären Körper.
CreateLoftSurfaceErzeugt eine Ausformungsfläche (Surface) aus B-Spline-Kurven als Schnitten und aus Leitkurven.
CreateOffsetSurfaceErzeugt eine Fläche (Surface) mit Abstand zu einer vorhandenen Surface.
CreatePCurveErzeugt eine Kurve auf einer Surface aus einem B-Spline im UV-Raum dieser Surface (P-Kurve).
CreatePlanarSurfaceveraltet ersetzt durch Modeler.CreatePlanarSurface2
CreatePlanarSurface2Erzeugt eine unendliche Ebene (Surface).
CreateRevolutionSurfaceErzeugt eine Rotationsfläche (Surface) aus einer Profilkurve und einer Drehachse.
CreateRuledSurfaceErzeugt eine Regelfläche (Surface) zwischen zwei Kurven.
CreateRuledSurfaceFromEdgeErzeugt an einer Kante eine Regelfläche als Flächenkörper, ohne ein Feature anzulegen.
CreateSheetFromFacesErzeugt aus zusammenhängenden Flächen einen Flächenkörper.
CreateSheetFromSurfaceErzeugt aus einer Surface und einem UV-Bereich einen Flächenkörper.
CreateSphericalSurfaceveraltet ersetzt durch Modeler.CreateSphericalSurface2
CreateSphericalSurface2Erzeugt eine unbegrenzte Kugelfläche (Surface).
CreateSpringErzeugt ein neues Spring-Objekt, an dem du die Geometrie einer Feder festlegst.
CreateSweptBodyErzeugt einen Austragungskörper (Sweep) aus ausgewähltem Profil, Pfad und Leitkurven.
CreateSweptSurfaceErzeugt eine unendliche Fläche (Surface), indem eine Kurve entlang einer Richtung verschoben wird.
CreateToroidalSurfaceErzeugt eine unbegrenzte Torusfläche (Surface).
CreateWireBodyErzeugt aus Kurven oder Kanten einen Drahtkörper.
DeleteFacesFromSheetBodyLöscht nicht benötigte Flächen aus einem Flächenkörper, etwa die Rückseiten nach CreateBrepBody3.
FindTwoEdgeMaxDeviationLiefert den größten Abstand zwischen zwei Kanten.
GetBodyOutlineveraltet ersetzt durch Modeler.GetBodyOutline2
GetBodyOutline2Liefert die Kurven, die in einer Blickrichtung den Umriss von Körpern bilden.
GetInitKnitGapWidthLiefert die Anfangsbreite der Lücke, mit der der Geometriekern beim Vernähen eines Körpers beginnt.
GetManifoldBodiesCountLiefert, wie viele mannigfaltige Körper aus einem nicht mannigfaltigen Körper entstehen.
GetToleranceValueLiefert den aktuellen Wert einer Toleranz des Geometriekerns, etwa für die Ausgabe von Kurven oder die Tessellierung.
ImprintingFacesPrägt Werkzeugflächen auf Zielflächen eines anderen Körpers und liefert die Kanten und Eckpunkte dazu.
MakeManifoldBodiesZerlegt einen nicht mannigfaltigen (allgemeinen) Körper in mannigfaltige Körper.
MergeCurvesFügt mehrere Kurven zu einer Kurve zusammen.
ProjectCurveOnSurfaceProjiziert eine Spline-Kurve in einer Richtung auf eine Surface.
ReplaceSurfacesErsetzt die Geometrie (Surface) unter Flächen eines Körpers durch neue Surfaces.
RestoreStellt einen temporären Körper aus einem Datenstrom wieder her, den Body2.Save geschrieben hat.
SetInitKnitGapWidthSetzt die Anfangsbreite der Lücke, mit der der Geometriekern beim Vernähen eines Körpers beginnt.
SetTolerancesveraltet ersetzt durch Modeler.GetToleranceValue und Modeler.SetToleranceValue
SetToleranceValueSetzt eine Toleranz des Geometriekerns für die Ausgabe von Geometrie und liefert den bisherigen Wert.
SplitFaceOnParamTeilt eine Fläche an einem festen U- oder V-Parameter und liefert die neuen Flächen.
ThickenSheetVerdickt einen Flächenkörper zu einem temporären Volumenkörper.
UnsetTolerancesSetzt Toleranzen des Geometriekerns auf die Systemeinstellung zurück.

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

Siehe auch

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

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