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.
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
Face2.GetAllDecalProperties: die Abziehbilder einer Fläche in einem TeilFace2.GetAllAssemblyDecalProperties: die Abziehbilder einer Fläche in einer Baugruppen-Komponente, seit SOLIDWORKS 2022
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| TextureAngle | Liefert den Winkel der Textur des Abziehbilds. |
| TextureAngleUV | Liefert den UV-Winkel der Textur des Abziehbilds. |
| TextureFilename | Liefert Pfad und Namen der Bilddatei der Textur des Abziehbilds. |
| TextureFilenameID | Liefert die Kennung des Dateinamens der Textur des Abziehbilds. |
| TextureID | Liefert die Kennung der Textur des Abziehbilds. |
| TextureMapID | Liefert die Kennung der Abbildung (map) der Textur des Abziehbilds. |
| TextureMirrored | Liefert, ob die Textur des Abziehbilds gespiegelt ist. |
| TextureRenderMode | Liefert, wie die Textur des Abziehbilds dargestellt wird: als Bild oder als Helligkeit (Luminance). |
| TextureTranslationU | Liefert die Verschiebung der Textur des Abziehbilds in Richtung U. |
| TextureTranslationV | Liefert die Verschiebung der Textur des Abziehbilds in Richtung V. |
| TextureTranslationX | Liefert die Verschiebung der Textur des Abziehbilds in Richtung X. |
| TextureTranslationY | Liefert die Verschiebung der Textur des Abziehbilds in Richtung Y. |
| TextureUScale | Liefert den Maßstab der Textur des Abziehbilds in Richtung U. |
| TextureVScale | Liefert 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.