SolidWorksMakroprogrammierung

Objekt · SldWorks

Decal-Objekt

Ein Abziehbild an einem Modell: seine Kennung, ob es ausgeblendet ist, und seine Maske.

Deklaration Dim x As SldWorks.Decal · in der englischen .NET-Hilfe: IDecal

Beschreibung

Decal gibt Zugriff auf die Abziehbilder (decals) in Modellen. Am Objekt selbst stehen nur die Kennung, das Ausblenden und die Maske. Bild, Abbildung und Flächen stellt das Hilfebeispiel „Add Decal“ über RenderMaterial ein: Es weist das Decal einer Variablen vom Typ RenderMaterial zu. Wie die Textur auf einer einzelnen Fläche liegt, liefert FaceDecalProperties. Die Befehle gibt es seit SOLIDWORKS 2008.

Zugriff

Die Zahl der Abziehbilder liefert ModelDocExtension.GetDecalsCount. Ausblenden, Löschen und die Reihenfolge regeln außerdem ModelDocExtension.HideDecal, ModelDocExtension.DeleteDecal, ModelDocExtension.DeleteAllDecals und ModelDocExtension.ReverseDecalsOrder.

Beispiel

' Gibt für jedes Abziehbild des aktiven Modells Kennung, Sichtbarkeit und Maske aus.
' Vorbedingung: Ein Teil oder eine Baugruppe mit mindestens einem Abziehbild ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster, das Modell bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDecal As SldWorks.Decal
    Dim vDecals As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Debug.Print swModel.Extension.GetDecalsCount & " Abziehbild(er)"
    vDecals = swModel.Extension.GetDecals
    If Not IsArray(vDecals) Then Exit Sub
    For i = 0 To UBound(vDecals)
        Set swDecal = vDecals(i)
        Debug.Print "Kennung " & swDecal.DecalID & IIf(swDecal.Hidden, ", ausgeblendet", "")
        Select Case swDecal.MaskType
            Case 0: Debug.Print "  keine Maske"
            Case 1: Debug.Print "  Maskenbild: " & swDecal.MaskFilename & IIf(swDecal.MaskInvert, " (umgekehrt)", "")
            Case 2: Debug.Print "  Farbmaske, " & swDecal.GetMaskExcludedColorsCount & " ausgeschlossene Farbe(n)"
            Case 3: Debug.Print "  Alphakanal des Bilds"
        End Select
    Next i
End Sub

Bemerkungen

Hilfebeispiele: „Add Decal“ legt mit ModelDocExtension.CreateDecal ein Abziehbild an, weist es mit Set swMaterial = swDecal einem RenderMaterial zu, fügt mit RenderMaterial.AddEntity die Fläche hinzu und setzt Datei (*.p2d), Bilddatei, Abbildung und Einpassen. Dann bringt es das Abziehbild mit ModelDocExtension.AddDecal auf. Das Beispiel setzt voraus, dass ein Raytracing-Renderer aktiv ist. „Get Mask Types of Each Decal“ holt die Abziehbilder mit ModelDocExtension.GetDecal für die Kennungen 1 bis ModelDocExtension.GetDecalsCount in der Konfiguration „Default“ und gibt Decal.MaskType aus. „Delete Decal“ liest Decal.DecalID und löscht damit jedes Abziehbild.

Darstellung: In den genauen Darstellungen „Verdeckte Kanten entfernt“, „Verdeckte Kanten sichtbar“ und „Drahtdarstellung“ kannst du Abziehbilder weder hinzufügen noch bearbeiten.

Ausgeschlossene Farben: Welche Farben die Maske ausschließt, liefern und setzen nur IGetMaskExcludedColors und ISetMaskExcludedColors. Die gibt es nur in C++, nicht in VBA. In VBA bekommst du nur die Zahl mit Decal.GetMaskExcludedColorsCount.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
DecalIDLiefert die Kennung des Abziehbilds im Modell.
HiddenLiest oder setzt, ob das Abziehbild ausgeblendet ist.
MaskFilenameLiest oder setzt das Bild, das das Abziehbild als Maske nutzt.
MaskInvertLiest oder setzt, ob die Maske des Abziehbilds umgekehrt wird.
MaskTypeLiest oder setzt die Art der Maske des Abziehbilds: keine, Maskenbild, Farbmaske oder Alphakanal.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetMaskExcludedColorsCountLiefert die Zahl der Farben, die die Maske des Abziehbilds ausschließt.

Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetMaskExcludedColors). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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