SolidWorksMakroprogrammierung

Objekt · SldWorks

Collision-Objekt

Eine gefundene Kollision bei der Kollisionserkennung: die beteiligten Komponenten, ihre Lage und ob sie sich durchdringen.

Deklaration Dim x As SldWorks.Collision · in der englischen .NET-Hilfe: ICollision

Beschreibung

Collision gibt Zugriff auf die Daten einer Kollision. CollisionDetectionManager.GetCollisions liefert ein Array solcher Objekte. Die Objekte sind flüchtig: Sie werden ungültig, sobald du die nächste Prüfung startest, Komponenten neu verschiebst, Kollisionsgruppen anlegst oder änderst oder eine andere Baugruppe setzt. Das Objekt gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Verschiebt die zweite ausgewählte Komponente für die Prüfung um 10 mm in X
' und gibt alle Kollisionen mit der ersten aus. Danach liegt alles wieder wie vorher.
' Vorbedingung: Eine Baugruppe ist offen, zwei Komponenten sind ausgewählt.
' Ergebnis:     Die Kollisionen stehen 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 swGruppe1 As SldWorks.CollisionDetectionGroup
    Dim swGruppe2 As SldWorks.CollisionDetectionGroup
    Dim swKollision As SldWorks.Collision
    Dim swComp As SldWorks.Component2
    Dim aKomp1(0) As SldWorks.Component2
    Dim aKomp2(0) As SldWorks.Component2
    Dim aXform(0) As SldWorks.MathTransform
    Dim vDaten As Variant, vKollisionen As Variant, vKomponenten As Variant
    Dim n As Long, i As Long, j As Long

    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)

    Set swManager = swApp.GetCollisionDetectionManager
    If swManager.SetAssembly(swAssy) <> swCollisionManagerSetAssemblyErrors_Success Then Exit Sub
    Set swGruppe1 = swManager.CreateGroup
    Set swGruppe2 = swManager.CreateGroup
    swGruppe1.SetComponents aKomp1
    swGruppe2.SetComponents aKomp2

    vDaten = aKomp2(0).Transform2.ArrayData                   ' Lage der zweiten Komponente
    vDaten(9) = vDaten(9) + 0.01                             ' 10 mm in X
    Set swMathUtil = swApp.GetMathUtility
    Set aXform(0) = swMathUtil.CreateTransform(vDaten)
    swGruppe2.ApplyTransforms aXform

    n = swManager.GetCollisions(False, vKollisionen)          ' Berührungen nicht mitzählen
    Debug.Print n & " Kollisionen"
    For i = 0 To n - 1
        Set swKollision = vKollisionen(i)                    ' gleich auswerten, die Objekte sind flüchtig
        vKomponenten = swKollision.GetComponents
        For j = 0 To UBound(vKomponenten)
            Set swComp = vKomponenten(j)
            Debug.Print "  " & swComp.Name2
        Next j
        Debug.Print "  Durchdringung: " & swKollision.IsPenetrating
    Next i

    swGruppe2.RemoveAllTransforms                            ' alte Lage wiederherstellen
    swManager.RemoveGroup 1
    swManager.RemoveGroup 0
End Sub

Bemerkungen

Flüchtig: Collision-Objekte werden ungültig, wenn du CollisionDetectionManager.IsCollisionPresent oder CollisionDetectionManager.GetCollisions aufrufst, Komponenten neu verschiebst, Kollisionsgruppen anlegst oder änderst oder eine andere Baugruppe setzt. Halte Komponenten und Transformationen deshalb fest, bevor die nächste Prüfung beginnt.

Ablauf: Den Ablauf einer Prüfung beschreibt die Hilfe bei CollisionDetectionManager.

Transformationen: Das Beispiel nimmt an, dass CollisionDetectionGroup.ApplyTransforms die Lage im Raum der Baugruppe erwartet, so wie Component2.Transform2 sie liefert. Die Komponenten werden auf genaue Positionen im Modellraum gebracht. Das Hilfebeispiel setzt die Werte direkt.

Eigenschaften und Methoden

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetComponentsLiefert die Komponenten, die an der Kollision beteiligt sind.
GetTransformsLiefert die aktuellen Transformationen der Komponenten, die an der Kollision beteiligt sind.
IsPenetratingLiefert, ob sich die Komponenten der Kollision durchdringen oder nur berühren.

Siehe auch

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

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