SolidWorksMakroprogrammierung

Objekt · SldWorks

FaceDecalProperties-Objekt

Die Eigenschaften eines Abziehbilds auf einer Fläche: Bilddatei, Kennungen, Winkel, Verschiebung, Maßstab, Spiegelung und Darstellungsart der Textur. Alles nur lesbar.

Deklaration Dim x As SldWorks.FaceDecalProperties · in der englischen .NET-Hilfe: IFaceDecalProperties

Beschreibung

FaceDecalProperties gibt Zugriff auf die Eigenschaften eines Abziehbilds (decal), das auf einer Fläche eines Modells liegt. Das Abziehbild selbst ist ein Decal, das du etwa mit ModelDocExtension.CreateDecal anlegst und mit ModelDocExtension.AddDecal aufbringst. FaceDecalProperties zeigt, wie seine Textur auf der einzelnen Fläche liegt. Alle Befehle sind nur lesbar und gibt es seit SOLIDWORKS 2008.

Zugriff

Wie viele Abziehbilder auf einer Fläche liegen, liefert vorher Face2.GetDecalsCount.

Beispiel

' Gibt für jede Fläche des aktiven Teils mit Abziehbild die Bilddatei, den Winkel,
' die Verschiebung und den Maßstab jeder Textur aus.
' Vorbedingung: Ein Teil mit mindestens einem Abziehbild ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swBody As SldWorks.Body2
    Dim swFace As SldWorks.Face2
    Dim swAbzieh As SldWorks.FaceDecalProperties
    Dim vKoerper As Variant
    Dim vFlaechen As Variant
    Dim vAbzieh As Variant
    Dim i As Long
    Dim j As Long
    Dim k As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel

    vKoerper = swPart.GetBodies2(swAllBodies, True)
    If Not IsArray(vKoerper) Then Exit Sub
    For i = 0 To UBound(vKoerper)
        Set swBody = vKoerper(i)
        vFlaechen = swBody.GetFaces
        If IsArray(vFlaechen) Then
            For j = 0 To UBound(vFlaechen)
                Set swFace = vFlaechen(j)
                If swFace.GetDecalsCount > 0 Then
                    Debug.Print swBody.Name & ", Fläche " & j + 1 & ": " & swFace.GetDecalsCount & " Abziehbild(er)"
                    vAbzieh = swFace.GetAllDecalProperties
                    For k = 0 To UBound(vAbzieh)
                        Set swAbzieh = vAbzieh(k)
                        Debug.Print "  Datei: " & swAbzieh.TextureFilename
                        Debug.Print "  Winkel: " & swAbzieh.TextureAngle & ", gespiegelt: " & swAbzieh.TextureMirrored
                        Debug.Print "  Verschiebung U/V: " & swAbzieh.TextureTranslationU & " / " & swAbzieh.TextureTranslationV
                        Debug.Print "  Maßstab U/V: " & swAbzieh.TextureUScale & " / " & swAbzieh.TextureVScale
                    Next k
                End If
            Next j
        End If
    Next i
End Sub

Bemerkungen

Hilfebeispiel: „Add Decal“ öffnet ein Beispielteil, wählt eine Fläche, legt mit ModelDocExtension.CreateDecal ein Abziehbild an und stellt es über RenderMaterial ein: Datei (*.p2d), Bilddatei, Abbildung und Einpassen. Dann bringt es das Abziehbild mit ModelDocExtension.AddDecal auf, baut neu auf, wählt die Fläche erneut und gibt alle 14 Eigenschaften jedes Abziehbilds aus. Als Vorbedingung nennt es einen aktiven Raytracing-Renderer.

Einheiten: Die Hilfe nennt für keine Eigenschaft eine Einheit. Die Winkel sind vermutlich im Bogenmaß, die Verschiebungen in X und Y vermutlich in Metern. Im Test kamen für X und Y aber 3,70 und 3,84 bei einer Fläche von 100 x 60 mm, Meter sind es also nicht. Was U und V gegenüber X und Y bedeuten, sagt die Hilfe nicht. Vermutlich gelten U und V in den Parameterrichtungen der Fläche.

Darstellungsart: Für FaceDecalProperties.TextureRenderMode nennt die Hilfe 0 für Bild und 1 für Helligkeit (Luminance). In swTextureRenderModes_e hat Luminance aber den Wert 2, die 1 steht dort für Überblenden (Blend). Nur der Wert 0 ist eindeutig.

Nur lesen: Ändern kannst du ein Abziehbild nicht über FaceDecalProperties. Die Einstellungen der Textur setzt das Hilfebeispiel über RenderMaterial, bevor es das Abziehbild aufbringt.

Nach einem einzigen Aufruf von ModelDocExtension.AddDecal kann Face2.GetAllDecalProperties zwei Abziehbilder mit gleichen Werten liefern.

Eigenschaften und Methoden

Eigenschaften 14, davon 14 beschrieben

NameBeschreibung
TextureAngleLiefert den Winkel der Textur des Abziehbilds.
TextureAngleUVLiefert den UV-Winkel der Textur des Abziehbilds.
TextureFilenameLiefert Pfad und Namen der Bilddatei der Textur des Abziehbilds.
TextureFilenameIDLiefert die Kennung des Dateinamens der Textur des Abziehbilds.
TextureIDLiefert die Kennung der Textur des Abziehbilds.
TextureMapIDLiefert die Kennung der Abbildung (map) der Textur des Abziehbilds.
TextureMirroredLiefert, ob die Textur des Abziehbilds gespiegelt ist.
TextureRenderModeLiefert, wie die Textur des Abziehbilds dargestellt wird: als Bild oder als Helligkeit (Luminance).
TextureTranslationULiefert die Verschiebung der Textur des Abziehbilds in Richtung U.
TextureTranslationVLiefert die Verschiebung der Textur des Abziehbilds in Richtung V.
TextureTranslationXLiefert die Verschiebung der Textur des Abziehbilds in Richtung X.
TextureTranslationYLiefert die Verschiebung der Textur des Abziehbilds in Richtung Y.
TextureUScaleLiefert den Maßstab der Textur des Abziehbilds in Richtung U.
TextureVScaleLiefert den Maßstab der Textur des Abziehbilds in Richtung V.

Siehe auch

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

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