SolidWorksMakroprogrammierung

Objekt · SldWorks

SWScene-Objekt

Die Szene einer Konfiguration: Hintergrund, Umgebungsbild (HDRI), Boden mit Schatten und Spiegelungen und die Helligkeit fürs Rendern.

Deklaration Dim x As SldWorks.SWScene · in der englischen .NET-Hilfe: ISwScene

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

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 Sub

Bemerkungen

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

NameBeschreibung
AccurateEnvLightingLiest oder setzt, ob die genaue Beleuchtungsberechnung aus dem HDRI-Umgebungsbild verwendet wird.
AspectRatioLiefert das Seitenverhältnis des Szenenbodens.
BackgroundBottomGradientColorLiest oder setzt die untere Farbe des Farbverlaufs im Hintergrund der Szene.
BackgroundBrightnessLiest oder setzt die Helligkeit des Hintergrunds beim Rendern.
BackgroundEnvImageLiest oder setzt das Umgebungsbild der Szene.
BackgroundImageLiest oder setzt das Hintergrundbild der Szene.
BackgroundTopGradientColorLiest oder setzt die Hintergrundfarbe der Szene, beim Farbverlauf die obere Farbe.
BackgroundTypeLiest oder setzt die Art des Hintergrunds der Szene: keiner, einfarbig, Farbverlauf, Bild oder Umgebung.
EnvironmentRotationLiest oder setzt die Drehung des Umgebungsbilds der Szene.
EnvironmentSizeLiest oder setzt die Größe der HDRI-Kugel, die das Modell umgibt.
FitToSWWindowLiest oder setzt, ob das Hintergrundbild auf das SOLIDWORKS-Fenster gestreckt wird.
FixedAspectRatioLiest oder setzt, ob das Seitenverhältnis des Szenenbodens fest ist.
FlattenFloorLiest oder setzt, ob der Boden der kugelförmigen Umgebung abgeflacht wird.
FloorAlignmentLiest oder setzt, an welcher Ebene der Szenenboden ausgerichtet ist.
FloorAutoSizeLiest oder setzt, ob die Größe des Szenenbodens aus dem umgebenden Quader des Modells folgt.
FloorDepthLiest oder setzt die Tiefe des Szenenbodens.
FloorDirectionLiest oder setzt, ob die Richtung des Szenenbodens umgekehrt ist.
FloorOffsetLiest oder setzt den Abstand zwischen Szenenboden und Modell.
FloorOffsetDirectionLiest oder setzt, ob die Lage von Szenenboden und Modell vertauscht wird.
FloorReflectionsLiest oder setzt, ob das Modell sich im Szenenboden spiegelt.
FloorRotationLiest oder setzt die Drehung des Szenenbodens gegenüber der Umgebung.
FloorSelectionLiest oder setzt das Erscheinungsbild des Szenenbodens als AppearanceSetting.
FloorShadowsLiest oder setzt, ob das Modell Schatten auf den Szenenboden wirft.
FloorWidthLiest oder setzt die Breite des Szenenbodens.
HorizonHeightLiest oder setzt, in welcher Höhe der HDRI-Kugel der abgeflachte Boden beginnt.
KeepBackgroundLiest oder setzt, ob der Hintergrund erhalten bleibt, wenn die Szene ersetzt wird.
RenderingBrightnessLiest oder setzt die Helligkeit, die die HDRI-Umgebung beim Rendern beiträgt.
SceneReflectivityLiest oder setzt, wie stark die HDRI-Umgebung sich spiegelt.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AddOrEditFloorAppearanceLegt das Erscheinungsbild des Szenenbodens an oder ändert es.
DeleteFloorAppearanceLöscht das Erscheinungsbild des Szenenbodens.
GetFloorAppearanceLiefert das Erscheinungsbild des Szenenbodens.
GetFloorNormalLiefert einen Punkt und die Normale des Szenenbodens.
GetP2SFileNameLiefert die Szenendatei (*.p2s) der Szene.
ModifyÄndert die Szene und speichert sie.
OffsetToGeometrySetzt 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.