Objekt · SldWorks
CollisionDetectionManager-Objekt
Der Manager für die schnelle Kollisionserkennung zwischen Gruppen von Komponenten, die du für die Prüfung verschiebst.
Beschreibung
CollisionDetectionManager, CollisionDetectionGroup und Collision prüfen schnell und dynamisch, ob Gruppen von Komponenten kollidieren. Geprüft wird nur zwischen den Kollisionsgruppen, nicht innerhalb einer Gruppe und nicht mit Komponenten außerhalb der Gruppen. Für eine feste Prüfung auf Überschneidungen zwischen Komponenten nennt die Hilfe stattdessen InterferenceDetectionMgr. Den Manager gibt es seit SOLIDWORKS 2019.
Zugriff
SldWorks.GetCollisionDetectionManager: der Manager von SOLIDWORKS
Beispiel
' Schiebt die zweite ausgewählte Komponente für die Prüfung in Schritten von 2 mm in X,
' bis sie mit der ersten kollidiert, höchstens 50 mm weit. Danach liegt alles wieder wie vorher.
' Vorbedingung: Eine Baugruppe ist offen, zwei Komponenten sind ausgewählt.
' Ergebnis: Der Weg bis zur ersten Kollision steht im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swSelMgr As SldWorks.SelectionMgr
Dim swMathUtil As SldWorks.MathUtility
Dim swManager As SldWorks.CollisionDetectionManager
Dim swFest As SldWorks.CollisionDetectionGroup
Dim swBewegt As SldWorks.CollisionDetectionGroup
Dim aKomp1(0) As SldWorks.Component2
Dim aKomp2(0) As SldWorks.Component2
Dim aXform(0) As SldWorks.MathTransform
Dim vStart As Variant, vDaten As Variant
Dim dWeg As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swAssy = swModel
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectCount2(-1) <> 2 Then Exit Sub
Set aKomp1(0) = swSelMgr.GetSelectedObjectsComponent4(1, -1)
Set aKomp2(0) = swSelMgr.GetSelectedObjectsComponent4(2, -1)
vStart = aKomp2(0).Transform2.ArrayData
Set swMathUtil = swApp.GetMathUtility
Set swManager = swApp.GetCollisionDetectionManager
If swManager.SetAssembly(swAssy) <> swCollisionManagerSetAssemblyErrors_Success Then Exit Sub
swManager.GraphicsRedrawEnabled = False ' schneller, ohne Zwischenbilder
Set swFest = swManager.CreateGroup
Set swBewegt = swManager.CreateGroup
swFest.SetComponents aKomp1
swBewegt.SetComponents aKomp2
For dWeg = 0.002 To 0.0501 Step 0.002
vDaten = vStart
vDaten(9) = vDaten(9) + dWeg
Set aXform(0) = swMathUtil.CreateTransform(vDaten)
swBewegt.ApplyTransforms aXform
If swManager.IsCollisionPresent(False) = swCollisionDetectionResult_CollisionDetected Then Exit For
Next dWeg
If dWeg > 0.0501 Then
Debug.Print "Bis 50 mm keine Kollision"
Else
Debug.Print "Erste Kollision nach " & Format(dWeg * 1000, "0") & " mm"
End If
swBewegt.RemoveAllTransforms ' alte Lage wiederherstellen
swManager.RemoveGroup 1
swManager.RemoveGroup 0
swManager.GraphicsRedrawEnabled = True
End SubBemerkungen
Ablauf: Eine Prüfung läuft so ab:
- Mit
CollisionDetectionManager.SetAssemblydie Baugruppe festlegen. - Mit
CollisionDetectionManager.CreateGroupzwei Kollisionsgruppen anlegen und mitCollisionDetectionGroup.SetComponentsfüllen. - Die Komponenten mit
CollisionDetectionGroup.ApplyTransformsin die gewünschte Lage bringen. - Mit
CollisionDetectionManager.IsCollisionPresentoderCollisionDetectionManager.GetCollisionsprüfen und dieCollision-Objekte auswerten. - Für die nächste Lage nur neu verschieben, für andere Gruppen neue Gruppen anlegen, für eine andere Baugruppe neu beginnen.
Flüchtige Ergebnisse: Collision-Objekte werden ungültig, sobald du neu prüfst, Komponenten neu verschiebst, Gruppen änderst oder eine andere Baugruppe setzt. Werte sie sofort aus.
Schnell oder genau: IsCollisionPresent ist schneller als GetCollisions. Für eine Suche wie im Beispiel reicht IsCollisionPresent.
Transformationen: Das Beispiel nimmt an, dass ApplyTransforms die Lage im Raum der Baugruppe erwartet, so wie Component2.Transform2 sie liefert.
Die Verschiebungen in den Transformationen sind in Metern. Körper, die sich nur berühren, zählen nicht als Kollision.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GraphicsRedrawEnabled | Liest oder setzt, ob der Grafikbereich die Komponenten in ihrer verschobenen Lage zeigt. |
Methoden 8, davon 8 beschrieben
| Name | Beschreibung |
|---|---|
| CreateGroup | Legt eine neue Kollisionsgruppe an. |
| GetAssembly | Liefert die Baugruppe, die für die Kollisionserkennung gesetzt ist. |
| GetCollisions | Liefert die Zahl der gefundenen Kollisionen und die Kollisionen selbst. |
| GetGroup | Liefert eine Kollisionsgruppe über ihre Nummer. |
| GetGroupCount | Liefert die Zahl der Kollisionsgruppen. |
| IsCollisionPresent | Prüft, ob es zwischen den Kollisionsgruppen eine Kollision gibt. |
| RemoveGroup | Entfernt eine Kollisionsgruppe aus der Kollisionserkennung. |
| SetAssembly | Legt die Baugruppe fest, in der die Kollisionserkennung läuft. |
Siehe auch
Englisches Original: ICollisionDetectionManager in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.