SolidWorksMakroprogrammierung

Objekt · SldWorks

CollisionDetectionGroup-Objekt

Eine Kollisionsgruppe für die Kollisionserkennung: ihre Komponenten und deren Lage während der Prüfung.

Deklaration Dim x As SldWorks.CollisionDetectionGroup · in der englischen .NET-Hilfe: ICollisionDetectionGroup

Beschreibung

CollisionDetectionGroup gibt Zugriff auf eine Kollisionsgruppe. Eine Gruppe fasst Komponenten zusammen, die für die Prüfung gemeinsam verschoben werden. SOLIDWORKS prüft nur zwischen den Gruppen, nicht innerhalb einer Gruppe und nicht mit Komponenten außerhalb der Gruppen. Das Objekt gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Hebt die ausgewählten Komponenten für die Prüfung um 5 mm in Z an und prüft,
' ob sie dann mit einer der übrigen Komponenten der obersten Ebene kollidieren.
' Danach liegt alles wieder wie vorher.
' Vorbedingung: Eine Baugruppe ist offen, eine oder mehrere Komponenten der obersten Ebene sind ausgewählt.
' Ergebnis:     Das Ergebnis 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 swBewegt As SldWorks.CollisionDetectionGroup
    Dim swRest As SldWorks.CollisionDetectionGroup
    Dim swComp As SldWorks.Component2
    Dim aBewegt() As SldWorks.Component2
    Dim aRest() As SldWorks.Component2
    Dim aXform() As SldWorks.MathTransform
    Dim vAlle As Variant, vDaten As Variant
    Dim sGewaehlt As String
    Dim nBewegt As Long, nRest As Long, i 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
    Set swMathUtil = swApp.GetMathUtility

    For i = 1 To swSelMgr.GetSelectedObjectCount2(-1)
        Set swComp = swSelMgr.GetSelectedObjectsComponent4(i, -1)
        If Not swComp Is Nothing Then
            ReDim Preserve aBewegt(nBewegt)
            ReDim Preserve aXform(nBewegt)
            Set aBewegt(nBewegt) = swComp
            vDaten = swComp.Transform2.ArrayData
            vDaten(11) = vDaten(11) + 0.005                    ' 5 mm in Z
            Set aXform(nBewegt) = swMathUtil.CreateTransform(vDaten)
            sGewaehlt = sGewaehlt & "|" & swComp.Name2 & "|"
            nBewegt = nBewegt + 1
        End If
    Next i
    If nBewegt = 0 Then Exit Sub

    vAlle = swAssy.GetComponents(True)                       ' nur die oberste Ebene
    For i = 0 To UBound(vAlle)
        Set swComp = vAlle(i)
        If InStr(sGewaehlt, "|" & swComp.Name2 & "|") = 0 Then
            ReDim Preserve aRest(nRest)
            Set aRest(nRest) = swComp
            nRest = nRest + 1
        End If
    Next i
    If nRest = 0 Then Exit Sub

    Set swManager = swApp.GetCollisionDetectionManager
    If swManager.SetAssembly(swAssy) <> swCollisionManagerSetAssemblyErrors_Success Then Exit Sub
    Set swBewegt = swManager.CreateGroup
    Set swRest = swManager.CreateGroup
    swBewegt.SetComponents aBewegt
    swRest.SetComponents aRest
    swBewegt.ApplyTransforms aXform

    If swManager.IsCollisionPresent(False) = swCollisionDetectionResult_CollisionDetected Then
        Debug.Print "Kollision nach dem Anheben"
    Else
        Debug.Print "Keine Kollision nach dem Anheben"
    End If

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

Bemerkungen

Nur zwischen Gruppen: SOLIDWORKS prüft Kollisionen nur zwischen den Kollisionsgruppen. Komponenten, die in keiner Gruppe stehen, zählen nicht mit. Das Beispiel legt deshalb die übrigen Komponenten in eine zweite Gruppe.

Transformationen: Je Komponente der Gruppe übergibst du eine MathTransform. Das Beispiel nimmt an, dass sie die Lage im Raum der Baugruppe angibt, so wie Component2.Transform2 sie liefert.

Rückgabewerte: CollisionDetectionGroup.SetComponents und CollisionDetectionGroup.ApplyTransforms liefern Werte aus swCollisionGroupSetComponentsErrors_e und swCollisionGroupApplyTransformErrors_e. Das Beispiel prüft sie der Kürze halber nicht.

Eigenschaften und Methoden

Methoden 6, davon 6 beschrieben

NameBeschreibung
ApplyTransformsBringt die Komponenten der Kollisionsgruppe für die Kollisionserkennung in eine neue Lage.
GetComponentCountLiefert die Zahl der Komponenten in der Kollisionsgruppe.
GetComponentsLiefert die Komponenten der Kollisionsgruppe.
GetTransformsLiefert die aktuellen Transformationen der Komponenten in der Kollisionsgruppe.
RemoveAllTransformsNimmt alle Transformationen der Kollisionserkennung von den Komponenten der Gruppe zurück und stellt die alte Lage wieder her.
SetComponentsLegt die Komponenten der Kollisionsgruppe fest.

Siehe auch

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

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