Objekt · SldWorks
SWScene-Objekt
Die Szene einer Konfiguration: Hintergrund, Umgebungsbild (HDRI), Boden mit Schatten und Spiegelungen und die Helligkeit fürs Rendern.
Beschreibung
SWScene gibt Zugriff auf die Szene eines Modells. Die Szene ist die Umgebung, in der das Modell erscheint: ein Hintergrund (einfarbig, mit Farbverlauf, als Bild oder als Umgebung), eine Kugel mit einem HDRI-Umgebungsbild und ein Boden, auf den das Modell Schatten und Spiegelungen wirft. Jede Konfiguration hat ihre Szene. Die meisten Befehle gibt es seit SOLIDWORKS 2015, die Befehle für das Erscheinungsbild des Bodens seit 2025.
Zugriff
Configuration.GetScene: die Szene einer Konfiguration
Beispiel
' Gibt Szenendatei, Hintergrund und Boden der aktiven Konfiguration aus und stellt den
' Hintergrund auf einen Farbverlauf von Hellblau nach Weiß um.
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis: Die Angaben stehen im Direktfenster, der Hintergrund hat einen Farbverlauf.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swConfig As SldWorks.Configuration
Dim swSzene As SldWorks.SWScene
Dim swPunkt As SldWorks.MathPoint
Dim swNormale As SldWorks.MathVector
Dim sDatei As String
Dim vWerte As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swConfig = swModel.ConfigurationManager.ActiveConfiguration
Set swSzene = swConfig.GetScene
If swSzene Is Nothing Then Exit Sub
swSzene.GetP2SFileName sDatei
Debug.Print "Szenendatei: " & sDatei
Debug.Print "Hintergrund (swSceneBackgroundType_e): " & swSzene.BackgroundType
Debug.Print "Schatten: " & swSzene.FloorShadows & ", Spiegelungen: " & swSzene.FloorReflections
swSzene.GetFloorNormal swPunkt, swNormale
vWerte = swNormale.ArrayData
Debug.Print "Bodennormale: " & vWerte(0) & ", " & vWerte(1) & ", " & vWerte(2)
swSzene.BackgroundType = swBackgroundType_Graduated
swSzene.BackgroundTopGradientColor = RGB(170, 200, 255)
swSzene.BackgroundBottomGradientColor = RGB(255, 255, 255)
swModel.ActiveView.GraphicsRedraw Empty
End SubBemerkungen
Neu zeichnen: Rufe nach Änderungen an einer Szene ModelView.GraphicsRedraw auf, damit der Grafikbereich neu gezeichnet wird.
Was wann gilt: Viele Eigenschaften gelten nur unter Bedingungen, etwa nur bei einer bestimmten Art von Hintergrund (SWScene.BackgroundType), nur bei abgeflachtem Boden (SWScene.FlattenFloor) oder nur, wenn ein Raytracing-Renderer aktiv ist. Die Bedingungen stehen auf den Seiten der Befehle.
Speichern: SWScene.Modify ändert und speichert die Szene. Ob du die Methode nach dem Setzen von Eigenschaften brauchst, sagt die Hilfe nicht. Das Hilfebeispiel „Get and Set Scene Properties“ setzt Eigenschaften, ohne sie aufzurufen.
Einheiten: Die Drehungen von Umgebung und Boden gibt die Hilfe ausnahmsweise in Grad an. Für Breite, Tiefe und Abstand des Bodens und für die Größe der Umgebung nennt sie keine Einheit, vermutlich Meter.
Eigenschaften und Methoden
Eigenschaften 28, davon 28 beschrieben
| Name | Beschreibung |
|---|---|
| AccurateEnvLighting | Liest oder setzt, ob die genaue Beleuchtungsberechnung aus dem HDRI-Umgebungsbild verwendet wird. |
| AspectRatio | Liefert das Seitenverhältnis des Szenenbodens. |
| BackgroundBottomGradientColor | Liest oder setzt die untere Farbe des Farbverlaufs im Hintergrund der Szene. |
| BackgroundBrightness | Liest oder setzt die Helligkeit des Hintergrunds beim Rendern. |
| BackgroundEnvImage | Liest oder setzt das Umgebungsbild der Szene. |
| BackgroundImage | Liest oder setzt das Hintergrundbild der Szene. |
| BackgroundTopGradientColor | Liest oder setzt die Hintergrundfarbe der Szene, beim Farbverlauf die obere Farbe. |
| BackgroundType | Liest oder setzt die Art des Hintergrunds der Szene: keiner, einfarbig, Farbverlauf, Bild oder Umgebung. |
| EnvironmentRotation | Liest oder setzt die Drehung des Umgebungsbilds der Szene. |
| EnvironmentSize | Liest oder setzt die Größe der HDRI-Kugel, die das Modell umgibt. |
| FitToSWWindow | Liest oder setzt, ob das Hintergrundbild auf das SOLIDWORKS-Fenster gestreckt wird. |
| FixedAspectRatio | Liest oder setzt, ob das Seitenverhältnis des Szenenbodens fest ist. |
| FlattenFloor | Liest oder setzt, ob der Boden der kugelförmigen Umgebung abgeflacht wird. |
| FloorAlignment | Liest oder setzt, an welcher Ebene der Szenenboden ausgerichtet ist. |
| FloorAutoSize | Liest oder setzt, ob die Größe des Szenenbodens aus dem umgebenden Quader des Modells folgt. |
| FloorDepth | Liest oder setzt die Tiefe des Szenenbodens. |
| FloorDirection | Liest oder setzt, ob die Richtung des Szenenbodens umgekehrt ist. |
| FloorOffset | Liest oder setzt den Abstand zwischen Szenenboden und Modell. |
| FloorOffsetDirection | Liest oder setzt, ob die Lage von Szenenboden und Modell vertauscht wird. |
| FloorReflections | Liest oder setzt, ob das Modell sich im Szenenboden spiegelt. |
| FloorRotation | Liest oder setzt die Drehung des Szenenbodens gegenüber der Umgebung. |
| FloorSelection | Liest oder setzt das Erscheinungsbild des Szenenbodens als AppearanceSetting. |
| FloorShadows | Liest oder setzt, ob das Modell Schatten auf den Szenenboden wirft. |
| FloorWidth | Liest oder setzt die Breite des Szenenbodens. |
| HorizonHeight | Liest oder setzt, in welcher Höhe der HDRI-Kugel der abgeflachte Boden beginnt. |
| KeepBackground | Liest oder setzt, ob der Hintergrund erhalten bleibt, wenn die Szene ersetzt wird. |
| RenderingBrightness | Liest oder setzt die Helligkeit, die die HDRI-Umgebung beim Rendern beiträgt. |
| SceneReflectivity | Liest oder setzt, wie stark die HDRI-Umgebung sich spiegelt. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AddOrEditFloorAppearance | Legt das Erscheinungsbild des Szenenbodens an oder ändert es. |
| DeleteFloorAppearance | Löscht das Erscheinungsbild des Szenenbodens. |
| GetFloorAppearance | Liefert das Erscheinungsbild des Szenenbodens. |
| GetFloorNormal | Liefert einen Punkt und die Normale des Szenenbodens. |
| GetP2SFileName | Liefert die Szenendatei (*.p2s) der Szene. |
| Modify | Ändert die Szene und speichert sie. |
| OffsetToGeometry | Setzt den Abstand zwischen Szenenboden und Modell zurück. |
Siehe auch
Englisches Original: ISwScene in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.