SolidWorksMakroprogrammierung

Objekt · SldWorks

Texture-Objekt

Eine 2D-Textur auf Flächen, Körpern, Features, Komponenten oder Modellen: Bilddatei, Maßstab, Drehung, Farbmischung und die Lage bei Abziehbildern.

Deklaration Dim x As SldWorks.Texture · in der englischen .NET-Hilfe: ITexture

Beschreibung

Mit Texture bringst du 2D-Texturen auf Teile und Baugruppen, damit sie echter aussehen. Eine Textur ist ein Bild, das auf Flächen, Körper, Features, Komponenten oder das ganze Modell gelegt wird. Du stellst Bilddatei, Maßstab (Körnung), Drehung und das Mischen mit der Teilefarbe ein. Einige nur lesbare Eigenschaften seit SOLIDWORKS 2016 liefern Lage und Maßstab bei texturbasierten Erscheinungsbildern und Abziehbildern. Die übrigen Befehle gibt es seit SOLIDWORKS 2005.

Zugriff

Beispiel

' Ändert Drehung und Maßstab der Textur auf der ausgewählten Fläche. Hat die Fläche
' keine Textur, bekommt sie ein Schachbrettmuster.
' Vorbedingung: Ein Teil ist offen, eine Fläche ist ausgewählt.
'               Die Texturdatei unter sBild gibt es.
' Ergebnis:     Die Fläche hat die geänderte oder neue Textur, Werte im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFace As SldWorks.Face2
    Dim swTextur As SldWorks.Texture
    Dim sBild As String, sKonfig As String
    Dim bOk As Boolean

    sBild = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\Images\textures\pattern\checker2.jpg"
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    sKonfig = swModel.ConfigurationManager.ActiveConfiguration.Name   ' etwa "Standard"
    If swModel.SelectionManager.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
    Set swFace = swModel.SelectionManager.GetSelectedObject6(1, -1)

    Set swTextur = swFace.GetTexture(sKonfig)
    If swTextur Is Nothing Then
        Set swTextur = swModel.Extension.CreateTexture(sBild, 5, 45, False)
    Else
        Debug.Print "Bisher: " & swTextur.MaterialName & ", Maßstab " & swTextur.ScaleFactor & ", " & swTextur.Angle & "°"
        swTextur.Angle = 340
        swTextur.ScaleFactor = 25
    End If
    If swFace.SetTexture(sKonfig, swTextur) Then
        Debug.Print "Jetzt: " & swTextur.GetSystemTextureName(swTextur.MaterialName, bOk)
    End If
End Sub

Bemerkungen

Zuweisen: Das Hilfebeispiel „Change Texture on Face in Specified Configuration“ ändert die Werte der Textur und weist sie danach mit Face2.SetTexture neu zu. Vermutlich wirkt eine Änderung erst so. Die Hilfe sagt das nicht ausdrücklich.

Ordner für Texturen: Den Ordner für Texturdateien liest und setzt du mit SldWorks.GetUserPreferenceStringValue und SetUserPreferenceStringValue und dem Wert swFileLocationsTextures aus swUserPreferenceStringValue_e.

Winkel: Die Hilfe gibt Texture.Angle in Grad an, nicht wie sonst in der API in Bogenmaß.

Der Konfigurationsname hängt von der Sprachfassung ab: In der deutschen Fassung heißt die Standardkonfiguration „Standard“, mit „Default“ liefert Face2.GetTexture Nothing.

Eigenschaften und Methoden

Eigenschaften 11, davon 11 beschrieben

NameBeschreibung
AngleLiest oder setzt den Drehwinkel der Textur.
BlendColorLiest oder setzt, ob die Farbe des Teils mit der Farbe der Textur gemischt wird.
DecalTypeLiefert, ob die Textur ein Abziehbild ist.
IgnoreColorMaterialLiefert, ob die Farbe des texturbasierten Erscheinungsbilds ignoriert wird.
MaterialNameLiest oder setzt Pfad und Dateiname des Texturbilds.
ScaleFactorLiest oder setzt den Maßstab (die Körnung) der Textur.
TransXLiefert die x-Koordinate des Verschiebepunkts eines texturbasierten Erscheinungsbilds.
TransYLiefert die y-Koordinate des Verschiebepunkts eines texturbasierten Erscheinungsbilds.
UDirLiefert den U-Wert eines texturbasierten Erscheinungsbilds.
VDirLiefert den V-Wert eines texturbasierten Erscheinungsbilds.
VScaleLiefert den Maßstab eines texturbasierten Erscheinungsbilds oder Abziehbilds.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetSystemTextureNameLiefert den Namen einer mitgelieferten Textur, wie er im PropertyManager Textur steht.

Siehe auch

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

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