SolidWorksMakroprogrammierung

Objekt · SldWorks

CollisionDetectionManager-Objekt

Der Manager für die schnelle Kollisionserkennung zwischen Gruppen von Komponenten, die du für die Prüfung verschiebst.

Deklaration Dim x As SldWorks.CollisionDetectionManager · in der englischen .NET-Hilfe: ICollisionDetectionManager

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

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 Sub

Bemerkungen

Ablauf: Eine Prüfung läuft so ab:

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

NameBeschreibung
GraphicsRedrawEnabledLiest oder setzt, ob der Grafikbereich die Komponenten in ihrer verschobenen Lage zeigt.

Methoden 8, davon 8 beschrieben

NameBeschreibung
CreateGroupLegt eine neue Kollisionsgruppe an.
GetAssemblyLiefert die Baugruppe, die für die Kollisionserkennung gesetzt ist.
GetCollisionsLiefert die Zahl der gefundenen Kollisionen und die Kollisionen selbst.
GetGroupLiefert eine Kollisionsgruppe über ihre Nummer.
GetGroupCountLiefert die Zahl der Kollisionsgruppen.
IsCollisionPresentPrüft, ob es zwischen den Kollisionsgruppen eine Kollision gibt.
RemoveGroupEntfernt eine Kollisionsgruppe aus der Kollisionserkennung.
SetAssemblyLegt 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.