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.
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
SldWorks.GetModeler: der Modeler. Einen anderen Zugang nennt die Hilfe nicht.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GeneralTopology | Liest oder setzt, ob der Geometriekern allgemeine, nicht mannigfaltige Körper erzeugen darf. |
Methoden 63, davon 52 beschrieben, 11 veraltet
| Name | Beschreibung |
|---|---|
| CheckInterference | veraltet ersetzt durch Modeler.CheckInterference3 |
| CheckInterference3 | Prüft, ob sich Zielkörper und Werkzeugkörper durchdringen, und liefert auf Wunsch die betroffenen Flächen und Körper. |
| CheckInterferenceBetweenTwoBodies | Prü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. |
| CreateArc | Erzeugt eine Kreisbogen-Kurve aus Mittelpunkt, Achse, Radius, Anfangs- und Endpunkt. |
| CreateBodiesFromSheets | veraltet ersetzt durch Modeler.CreateBodiesFromSheets2 |
| CreateBodiesFromSheets2 | Näht Flächenkörper zu Volumen- oder Flächenkörpern zusammen. |
| CreateBodyFromBox | veraltet ersetzt durch Modeler.CreateBodyFromBox3 |
| CreateBodyFromBox3 | Erzeugt einen Quader als temporären Körper. |
| CreateBodyFromCone | Erzeugt einen Kegel oder Kegelstumpf als temporären Körper. |
| CreateBodyFromCyl | Erzeugt einen Zylinder als temporären Körper. |
| CreateBodyFromFaces2 | Erzeugt aus Flächen eines Körpers einen neuen temporären Körper und schließt die Lücken auf eine gewählte Art. |
| CreateBrepBody | veraltet ersetzt durch Modeler.CreateBrepBody3 |
| CreateBrepBody3 | Baut einen temporären Körper aus Topologie (Schalen, Flächen, Schleifen, Kanten, Eckpunkte) und Geometrie auf, also aus BREP-Daten. |
| CreateBsplineCurve | Erzeugt eine B-Spline-Kurve aus Ordnung, Knoten und Kontrollpunkten. |
| CreateBsplineSurface | Erzeugt eine B-Spline-Fläche (Surface) aus Ordnungen, Knoten und Kontrollpunkten. |
| CreateConicalSurface | veraltet ersetzt durch Modeler.CreateConicalSurface2 |
| CreateConicalSurface2 | Erzeugt eine unbegrenzte Kegelfläche (Surface). |
| CreateCoonsBSurface | Erzeugt eine B-Spline-Fläche (Coons-Fläche) aus vier Randkurven. |
| CreateCylindricalSurface | veraltet ersetzt durch Modeler.CreateCylindricalSurface2 |
| CreateCylindricalSurface2 | Erzeugt eine unbegrenzte Zylinderfläche (Surface). |
| CreateEllipse | Erzeugt eine Ellipse als Kurve aus Mittelpunkt, Halbachsen und deren Richtungen. |
| CreateExtrudedBody | Extrudiert einen Flächenkörper als Profil zu einem temporären Körper. |
| CreateExtrusionSurface | Erzeugt eine Extrusionsfläche (Surface), indem eine Profilkurve entlang einer Richtung verschoben wird. |
| CreateLine | Erzeugt eine Gerade als Kurve aus einem Punkt und einer Richtung. |
| CreateLoftBody | veraltet ersetzt durch Modeler.CreateLoftBody2 |
| CreateLoftBody2 | Erzeugt einen Ausformungskörper (Loft) aus Profilskizzen, Leitkurven und Mittellinie als temporären Körper. |
| CreateLoftSurface | Erzeugt eine Ausformungsfläche (Surface) aus B-Spline-Kurven als Schnitten und aus Leitkurven. |
| CreateOffsetSurface | Erzeugt eine Fläche (Surface) mit Abstand zu einer vorhandenen Surface. |
| CreatePCurve | Erzeugt eine Kurve auf einer Surface aus einem B-Spline im UV-Raum dieser Surface (P-Kurve). |
| CreatePlanarSurface | veraltet ersetzt durch Modeler.CreatePlanarSurface2 |
| CreatePlanarSurface2 | Erzeugt eine unendliche Ebene (Surface). |
| CreateRevolutionSurface | Erzeugt eine Rotationsfläche (Surface) aus einer Profilkurve und einer Drehachse. |
| CreateRuledSurface | Erzeugt eine Regelfläche (Surface) zwischen zwei Kurven. |
| CreateRuledSurfaceFromEdge | Erzeugt an einer Kante eine Regelfläche als Flächenkörper, ohne ein Feature anzulegen. |
| CreateSheetFromFaces | Erzeugt aus zusammenhängenden Flächen einen Flächenkörper. |
| CreateSheetFromSurface | Erzeugt aus einer Surface und einem UV-Bereich einen Flächenkörper. |
| CreateSphericalSurface | veraltet ersetzt durch Modeler.CreateSphericalSurface2 |
| CreateSphericalSurface2 | Erzeugt eine unbegrenzte Kugelfläche (Surface). |
| CreateSpring | Erzeugt ein neues Spring-Objekt, an dem du die Geometrie einer Feder festlegst. |
| CreateSweptBody | Erzeugt einen Austragungskörper (Sweep) aus ausgewähltem Profil, Pfad und Leitkurven. |
| CreateSweptSurface | Erzeugt eine unendliche Fläche (Surface), indem eine Kurve entlang einer Richtung verschoben wird. |
| CreateToroidalSurface | Erzeugt eine unbegrenzte Torusfläche (Surface). |
| CreateWireBody | Erzeugt aus Kurven oder Kanten einen Drahtkörper. |
| DeleteFacesFromSheetBody | Löscht nicht benötigte Flächen aus einem Flächenkörper, etwa die Rückseiten nach CreateBrepBody3. |
| FindTwoEdgeMaxDeviation | Liefert den größten Abstand zwischen zwei Kanten. |
| GetBodyOutline | veraltet ersetzt durch Modeler.GetBodyOutline2 |
| GetBodyOutline2 | Liefert die Kurven, die in einer Blickrichtung den Umriss von Körpern bilden. |
| GetInitKnitGapWidth | Liefert die Anfangsbreite der Lücke, mit der der Geometriekern beim Vernähen eines Körpers beginnt. |
| GetManifoldBodiesCount | Liefert, wie viele mannigfaltige Körper aus einem nicht mannigfaltigen Körper entstehen. |
| GetToleranceValue | Liefert den aktuellen Wert einer Toleranz des Geometriekerns, etwa für die Ausgabe von Kurven oder die Tessellierung. |
| ImprintingFaces | Prägt Werkzeugflächen auf Zielflächen eines anderen Körpers und liefert die Kanten und Eckpunkte dazu. |
| MakeManifoldBodies | Zerlegt einen nicht mannigfaltigen (allgemeinen) Körper in mannigfaltige Körper. |
| MergeCurves | Fügt mehrere Kurven zu einer Kurve zusammen. |
| ProjectCurveOnSurface | Projiziert eine Spline-Kurve in einer Richtung auf eine Surface. |
| ReplaceSurfaces | Ersetzt die Geometrie (Surface) unter Flächen eines Körpers durch neue Surfaces. |
| Restore | Stellt einen temporären Körper aus einem Datenstrom wieder her, den Body2.Save geschrieben hat. |
| SetInitKnitGapWidth | Setzt die Anfangsbreite der Lücke, mit der der Geometriekern beim Vernähen eines Körpers beginnt. |
| SetTolerances | veraltet ersetzt durch Modeler.GetToleranceValue und Modeler.SetToleranceValue |
| SetToleranceValue | Setzt eine Toleranz des Geometriekerns für die Ausgabe von Geometrie und liefert den bisherigen Wert. |
| SplitFaceOnParam | Teilt eine Fläche an einem festen U- oder V-Parameter und liefert die neuen Flächen. |
| ThickenSheet | Verdickt einen Flächenkörper zu einem temporären Volumenkörper. |
| UnsetTolerances | Setzt 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.