Objekt · SldWorks
CollisionDetectionGroup-Objekt
Eine Kollisionsgruppe für die Kollisionserkennung: ihre Komponenten und deren Lage während der Prüfung.
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
CollisionDetectionManager.CreateGroup: eine neue KollisionsgruppeCollisionDetectionManager.GetGroup: eine vorhandene Kollisionsgruppe über ihre Nummer
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ApplyTransforms | Bringt die Komponenten der Kollisionsgruppe für die Kollisionserkennung in eine neue Lage. |
| GetComponentCount | Liefert die Zahl der Komponenten in der Kollisionsgruppe. |
| GetComponents | Liefert die Komponenten der Kollisionsgruppe. |
| GetTransforms | Liefert die aktuellen Transformationen der Komponenten in der Kollisionsgruppe. |
| RemoveAllTransforms | Nimmt alle Transformationen der Kollisionserkennung von den Komponenten der Gruppe zurück und stellt die alte Lage wieder her. |
| SetComponents | Legt 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.