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.
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
ModelDocExtension.CreateTexture: eine neue Textur, die du etwa mitFace2.SetTexturezuweistFace2.GetTexture,Body2.GetTexture,Feature.GetTexture,Component2.GetTexture,Component2.GetModelTextureundModelDocExtension.GetTexture: die Textur eines Elements
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Drehwinkel der Textur. |
| BlendColor | Liest oder setzt, ob die Farbe des Teils mit der Farbe der Textur gemischt wird. |
| DecalType | Liefert, ob die Textur ein Abziehbild ist. |
| IgnoreColorMaterial | Liefert, ob die Farbe des texturbasierten Erscheinungsbilds ignoriert wird. |
| MaterialName | Liest oder setzt Pfad und Dateiname des Texturbilds. |
| ScaleFactor | Liest oder setzt den Maßstab (die Körnung) der Textur. |
| TransX | Liefert die x-Koordinate des Verschiebepunkts eines texturbasierten Erscheinungsbilds. |
| TransY | Liefert die y-Koordinate des Verschiebepunkts eines texturbasierten Erscheinungsbilds. |
| UDir | Liefert den U-Wert eines texturbasierten Erscheinungsbilds. |
| VDir | Liefert den V-Wert eines texturbasierten Erscheinungsbilds. |
| VScale | Liefert den Maßstab eines texturbasierten Erscheinungsbilds oder Abziehbilds. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| GetSystemTextureName | Liefert 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.