Objekt · SldWorks
RenderMaterial-Objekt
Ein Erscheinungsbild (früher Material): Farben, Textur und ihre Abbildung, Beleuchtung, Oberflächenbeschaffenheit und die Elemente, auf denen es liegt.
Beschreibung
Mit RenderMaterial bringst du Erscheinungsbilder auf Modelle. Seit SOLIDWORKS 2008 heißen die früheren Materialien (materials) Erscheinungsbilder (appearances). Ein Erscheinungsbild stammt aus einer Datei (*.p2m) und legt Farben, eine Textur, das Verhalten im Licht und eine Oberflächenbeschaffenheit fest. Du legst es auf Elemente des Modells, in den Hilfebeispielen auf Flächen und Komponenten. Die meisten Befehle gibt es seit SOLIDWORKS 2008, einige für Abbildung und Oberflächenbeschaffenheit seit 2013 und 2025, die für DSPBR (DSPBRMaterial) seit 2026.
Zugriff
ModelDocExtension.CreateRenderMaterial: ein neues Erscheinungsbild aus einer DateiModelDocExtension.GetRenderMaterials2undComponent2.GetRenderMaterials2: die Erscheinungsbilder eines Modells oder einer KomponenteSWScene.GetFloorAppearance: das Erscheinungsbild des SzenenbodensModelDocExtension.CreateDecal: ein Abziehbild (Decal), das das Hilfebeispiel „Add Decal“ einer Variablen vom Typ RenderMaterial zuweist
Beispiel
' Erzeugt ein Erscheinungsbild aus einer Datei, färbt es rot, legt es auf die
' ausgewählte Fläche und gibt es für alle Anzeigezustände der aktiven Konfiguration frei.
' Vorbedingung: Ein Teil ist offen, eine Fläche ist ausgewählt. Die Datei unter sDatei
' gibt es. RealView ist eingeschaltet.
' Ergebnis: Die Fläche ist rot, die Angaben stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swExt As SldWorks.ModelDocExtension
Dim swMaterial As SldWorks.RenderMaterial
Dim swFace As SldWorks.Face2
Dim vZustaende As Variant
Dim nId1 As Long, nId2 As Long
Dim sDatei As String
sDatei = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\graphics\Materials\plastic\low gloss\blue low gloss plastic.p2m"
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.SelectionManager.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
Set swFace = swModel.SelectionManager.GetSelectedObject6(1, -1)
Set swExt = swModel.Extension
Set swMaterial = swExt.CreateRenderMaterial(sDatei)
If swMaterial Is Nothing Then Exit Sub
If False = swMaterial.AddEntity(swFace) Then Exit Sub
swMaterial.PrimaryColor = RGB(200, 30, 30)
swModel.ClearSelection2 True
vZustaende = swModel.ConfigurationManager.ActiveConfiguration.GetDisplayStates
If swExt.AddDisplayStateSpecificRenderMaterial(swMaterial, swAllDisplayState, vZustaende, nId1, nId2) Then
Debug.Print "Datei: " & swMaterial.FileName
Debug.Print "Kennungen: " & nId1 & ", " & nId2
Debug.Print "Beleuchtung (swRenderMaterialIlluminationTypes_e): " & swMaterial.IlluminationShaderType
Debug.Print "Elemente: " & swMaterial.GetEntitiesCount
End If
End SubBemerkungen
Zuweisen: Die Hilfebeispiele „Get Appearance File Name“ und „Add and Delete Appearances from Specific Display States“ erzeugen das Erscheinungsbild mit ModelDocExtension.CreateRenderMaterial, legen es mit RenderMaterial.AddEntity auf eine Fläche oder Komponente und bringen es dann mit ModelDocExtension.AddDisplayStateSpecificRenderMaterial in die Anzeigezustände. Entfernen kannst du es mit ModelDocExtension.DeleteDisplayStateSpecificRenderMaterial.
Sichtbar: Erscheinungsbilder siehst du nur, wenn RealView eingeschaltet ist (ModelDocExtension.ViewDisplayRealView). RenderMaterial.DoubleSided und RenderMaterial.RoundSharpEdges gelten nur, wenn ein Raytracing-Renderer geladen ist.
Was wann gilt: Viele Eigenschaften gelten nur unter Bedingungen, etwa nur bei einer bestimmten Abbildung (RenderMaterial.MappingType), Beleuchtung (RenderMaterial.IlluminationShaderType) oder Oberflächenbeschaffenheit (RenderMaterial.SurfaceFinishShaderType). Die Bedingungen stehen auf den Seiten der Befehle. Ob eine Änderung an einem schon zugewiesenen Erscheinungsbild sofort wirkt, sagt die Hilfe nicht.
Werte: Für die meisten Zahlenwerte nennt die Hilfe weder Einheit noch Wertebereich. Breite, Höhe und das Abrunden scharfer Kanten rechnet das Hilfebeispiel „Get Surface-finish Image Path and File Name“ mit * 1000 in Millimeter um, also Meter. Für die Winkel nennt die Hilfe keine Einheit.
Veraltete Befehle: RenderMaterial.SurfaceFinishShaderType ersetzt die Eigenschaft BumpMap, RenderMaterial.BumpStrength ersetzt BumpAmplitude und RenderMaterial.SurfaceFinishFile ersetzt BumpTextureFilename. Die Befehle mit der Endung 2, etwa RenderMaterial.GetCenterPoint2, ersetzen GetCenterPoint, SetCenterPoint, GetUDirection, SetUDirection, GetVDirection und SetVDirection.
Eigenschaften und Methoden
Eigenschaften 83, davon 80 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| AboutAxis | Liest oder setzt den Wert „um die Achse“ bei zylindrischer Abbildung des Erscheinungsbilds. |
| AccurateReflections | Liest oder setzt die Einstellung „Genaue Spiegelungen (langsamer)“ des Erscheinungsbilds. |
| AlongAxis | Liest oder setzt den Wert „entlang der Achse“ bei zylindrischer Abbildung des Erscheinungsbilds. |
| Ambient | Liest oder setzt die Stärke des Umgebungslichts für das Erscheinungsbild. |
| AnisotropicBias | Liest oder setzt die anisotrope Neigung, die die Wirkung des Lichts waagerecht oder senkrecht verstärkt. |
| AnisotropicCylinderDistance | Liest oder setzt den Abstand der gedachten Zylinder, mit denen die anisotrope Spiegelung nachgebildet wird. |
| AnisotropicFloorHeight | Liest oder setzt den Höhenunterschied zwischen benachbarten gedachten Zylindern bei anisotroper Spiegelung. |
| Brightness | Liest oder setzt, wie stark das Erscheinungsbild bei der Beleuchtungsart „Konstant“ selbst leuchtet. |
| BumpAmplitude | veraltet ersetzt durch RenderMaterial.BumpStrength |
| BumpBlend | Liest oder setzt die Überblendung, also wie weit der Übergang zwischen einer Erhebung und der Oberfläche reicht. |
| BumpDetail | Liest oder setzt den Detailgrad der Oberflächenbeschaffenheit. |
| BumpMap | veraltet ersetzt durch RenderMaterial.SurfaceFinishShaderType |
| BumpRadius | Liest oder setzt den Radius, der Größe und Abstand der Erhebungen bei Grübchen und Riffelblech steuert. |
| BumpRoughHigh | Liest oder setzt die obere Schwelle der Oberflächenbeschaffenheit. |
| BumpRoughLow | Liest oder setzt die untere Schwelle der Oberflächenbeschaffenheit. |
| BumpScale | Liest oder setzt den Maßstab, der bestimmt, wie dicht das Muster der Oberflächenbeschaffenheit ist. |
| BumpSharpness | Liest oder setzt die Schärfe, die die Form der Oberflächenbeschaffenheit beeinflusst. |
| BumpStrength | Liest oder setzt die Amplitude der Oberflächenbeschaffenheit. |
| BumpTextureFilename | veraltet ersetzt durch RenderMaterial.SurfaceFinishFile |
| BumpUseMappingScale | Liest oder setzt, ob die Oberflächenbeschaffenheit Maßstab und Abbildung des Erscheinungsbilds übernimmt. |
| CausticsCast | Liest oder setzt, ob spiegelnde Erscheinungsbilder Kaustik-Photonen zurückwerfen. |
| CausticsReceive | Liest oder setzt, ob diffuse Erscheinungsbilder Kaustik-Photonen aufnehmen. |
| ColorForm | Liest oder setzt, wie viele Farben das Erscheinungsbild beschreiben. |
| CustomHoleMeshFile | Liest oder setzt die Datei mit dem eigenen Lochmuster bei der Oberflächenbeschaffenheit „Lochblech, eigenes Muster“. |
| DensityOfHoles | Liest oder setzt die Dichte der Löcher bei korrodierten oder erodierten Erscheinungsbildern. |
| Diffuse | Liest oder setzt die Stärke des Lichts, das die Oberfläche gleichmäßig aus allen Richtungen beleuchtet. |
| DimpleSize | Liest oder setzt die Größe der Grübchen bei der Oberflächenbeschaffenheit „mit Grübchen“. |
| Direction1RotationAngle | Liest oder setzt den Winkel, um den die Textur gegen die waagerechte Achse gedreht wird. |
| Direction2RotationAngle | Liest oder setzt den Winkel, um den die Textur gegen die senkrechte Achse gedreht wird. |
| DoubleSided | Liest oder setzt, ob Flächen beim Rendern mit einem Raytracing-Renderer von beiden Seiten schattiert werden. |
| Emission | Liest oder setzt, wie viel Licht das Erscheinungsbild abgibt. |
| FaceWidth | Liest oder setzt die Flächenbreite (face width) des Erscheinungsbilds. |
| FileName | Liest oder setzt Pfad und Namen der Datei (*.p2m) des Erscheinungsbilds. |
| FitHeight | Liest oder setzt, ob die Textur in der Höhe auf das ausgewählte Element gestreckt wird. |
| FitWidth | Liest oder setzt, ob die Textur in der Breite auf das ausgewählte Element gestreckt wird. |
| FixedAspectRatio | Liest oder setzt, ob das Seitenverhältnis der Textur fest ist. |
| GlobalIlluminationCast | Liest oder setzt, ob spiegelnde Erscheinungsbilder Photonen für die indirekte Beleuchtung zurückwerfen. |
| GlobalIlluminationReceive | Liest oder setzt, ob diffuse Erscheinungsbilder Photonen der indirekten Beleuchtung aufnehmen. |
| Glossy | Liest oder setzt den Glanzfaktor, mit dem das Erscheinungsbild Lichter spiegelt. |
| HasDSPBRProperties | Liefert, ob das Erscheinungsbild DSPBR-Eigenschaften hat. |
| Height | Liest oder setzt die Höhe der Textur beim Abbilden des Erscheinungsbilds. |
| HeightMirror | Liest oder setzt, ob die Textur senkrecht gespiegelt wird. |
| HoleMeshSize | Liest oder setzt die Lochgröße bei den Oberflächenbeschaffenheiten „Lochblech“ mit rautenförmigen oder runden Löchern. |
| IgnoreMissingFile | Liest oder setzt, ob Warnungen über fehlende Bilddateien unterdrückt werden. |
| IlluminationShaderType | Liest oder setzt die Art der Beleuchtung des Erscheinungsbilds, etwa Kunststoff, Metall oder Glas. |
| IndexOfRefraction | Liest oder setzt den Brechungsindex des Erscheinungsbilds. |
| KnurlAngle | Liest oder setzt den Rändelwinkel bei der Oberflächenbeschaffenheit „gerändelt“. |
| KnurlHeightCap | Liest oder setzt die größte Höhe der Rändelung bei der Oberflächenbeschaffenheit „gerändelt“. |
| LinkToFile | Liest oder setzt, ob die Vorkommen des Erscheinungsbilds mit seiner Datei (*.p2m) verknüpft sind. |
| MappingType | Liest oder setzt die Art der Abbildung (mapping) der Textur: Fläche, Projektion, Kugel, Zylinder oder automatisch. |
| MaterialID | Liefert die Kennung des Erscheinungsbilds; seit SOLIDWORKS 2011 nicht mehr unterstützt. |
| MetallicAmplitude | Liest oder setzt die Amplitude der Metallflocken in der metallischen Schicht. |
| MetallicFlakeMaterial | Liest oder setzt das Metall der Flocken in der metallischen Schicht: Aluminium, Kupfer, Gold oder Silber. |
| MetallicMix | Liest oder setzt den metallischen Anteil des Erscheinungsbilds. |
| MetallicRoughness | Liest oder setzt die Größe (Rauheit) der Glanzlichter auf der metallischen Oberfläche. |
| MetallicScale | Liest oder setzt die Größe der Metallflocken in der metallischen Schicht. |
| NSamples | Liest oder setzt die Zahl der Stichproben, mit der der Glanzanteil berechnet wird. |
| ObjectAreaLight | Liest oder setzt, ob das Erscheinungsbild ein Flächenlicht ist, einen realistischen Lichtabfall hat oder beides. |
| OffsetLatitude | Liest oder setzt den Versatz in der Breite bei kugelförmiger Abbildung des Erscheinungsbilds. |
| OffsetLongitude | Liest oder setzt den Versatz in der Länge bei kugelförmiger Abbildung des Erscheinungsbilds. |
| PatternScale | Liest oder setzt den Maßstab des Musters bei prozeduralen Texturen. |
| PrimaryColor | Liest oder setzt die erste Farbe des Erscheinungsbilds. |
| ProjectionReference | Liest oder setzt die Projektionsrichtung beim Abbilden des Erscheinungsbilds. |
| Reflectivity | Liest oder setzt das Reflexionsvermögen des Erscheinungsbilds. |
| RotationAngle | Liest oder setzt den Winkel, um den die Textur gegen die Achsen gedreht wird. |
| Roughness | Liest oder setzt die Streuung der Glanzlichter (Rauheit) des Erscheinungsbilds. |
| RoundSharpEdges | Liest oder setzt, wie stark scharfe Kanten beim Rendern mit einem Raytracing-Renderer abgerundet werden. |
| SecondaryColor | Liest oder setzt die zweite Farbe des Erscheinungsbilds. |
| Specular | Liest oder setzt die Stärke der Glanzlichter des Erscheinungsbilds. |
| SpecularColor | Liest oder setzt die Farbe der Glanzlichter des Erscheinungsbilds. |
| SurfaceFinishFile | Liest oder setzt die Bilddatei für eine Oberflächenbeschaffenheit aus einer Datei. |
| SurfaceFinishFileNormalMap | Liest oder setzt, ob das Bild der Oberflächenbeschaffenheit als Normal Map verwendet wird. |
| SurfaceFinishShaderType | Liest oder setzt die Art der Oberflächenbeschaffenheit des Erscheinungsbilds, etwa gebürstet, gerändelt oder Lochblech. |
| TertiaryColor | Liest oder setzt die dritte Farbe des Erscheinungsbilds. |
| TextureFilename | Liest oder setzt Pfad und Namen der Texturdatei des Erscheinungsbilds. |
| ToonShaderTextureFilename | Liest oder setzt Pfad und Namen der Texturdatei für den Toon-Shader. |
| Translucency | Liest oder setzt, wie stark das Material Licht filtert und streut (Lichtdurchlässigkeit). |
| Transparency | Liest oder setzt, wie viel Licht das Material durchlässt (Transparenz). |
| TransparencyMappingShaderType | Liest oder setzt eine Einstellung für die Abbildung der Transparenz; die Hilfe enthält nur die Syntax. |
| Width | Liest oder setzt die Breite der Textur beim Abbilden des Erscheinungsbilds. |
| WidthMirror | Liest oder setzt, ob die Textur waagerecht gespiegelt wird. |
| XPosition | Liest oder setzt die Verschiebung des Erscheinungsbilds in X-Richtung. |
| YPosition | Liest oder setzt die Verschiebung des Erscheinungsbilds in Y-Richtung. |
Methoden 20, davon 14 beschrieben, 6 veraltet
| Name | Beschreibung |
|---|---|
| AddEntity | Legt das Erscheinungsbild auf ein Element, etwa eine Fläche oder Komponente. |
| GetCenterPoint | veraltet ersetzt durch RenderMaterial.GetCenterPoint2 |
| GetCenterPoint2 | Liefert den Mittelpunkt der Abbildung bei einem texturbasierten Erscheinungsbild. |
| GetDSPBRMaterial | Liefert das Objekt DSPBRMaterial des Erscheinungsbilds. |
| GetEntities | Liefert die Elemente, auf denen das Erscheinungsbild liegt. |
| GetEntitiesCount | Liefert die Zahl der Elemente, auf denen das Erscheinungsbild liegt. |
| GetLinkedDisplayStates | Liefert die Anzeigezustände, in denen das Erscheinungsbild gilt. |
| GetMaterialIds | Liefert die beiden Kennungen des Erscheinungsbilds. |
| GetUDirection | veraltet ersetzt durch RenderMaterial.GetUDirection2 |
| GetUDirection2 | Liefert die U-Richtung eines texturbasierten Erscheinungsbilds. |
| GetVDirection | veraltet ersetzt durch RenderMaterial.GetVDirection2 |
| GetVDirection2 | Liefert die V-Richtung eines texturbasierten Erscheinungsbilds. |
| RemoveAllEntities | Entfernt das Erscheinungsbild von allen Elementen, auf denen es liegt. |
| SetCenterPoint | veraltet ersetzt durch RenderMaterial.SetCenterPoint2 |
| SetCenterPoint2 | Setzt den Mittelpunkt der Abbildung bei einem texturbasierten Erscheinungsbild. |
| SetLinkedDisplayStates | Legt fest, in welchen Anzeigezuständen das Erscheinungsbild gilt. |
| SetUDirection | veraltet ersetzt durch RenderMaterial.SetUDirection2 |
| SetUDirection2 | Setzt die U-Richtung eines texturbasierten Erscheinungsbilds. |
| SetVDirection | veraltet ersetzt durch RenderMaterial.SetVDirection2 |
| SetVDirection2 | Setzt die V-Richtung eines texturbasierten Erscheinungsbilds. |
Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetEntities). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IRenderMaterial in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.