Objekt · SldWorks
RayTraceRendererOptions-Objekt
Die Einstellungen eines Ray-Trace-Renderers: Bildgröße und Format, Qualität von Vorschau und endgültigem Rendern, Effekte wie Bloom, Kaustik und Kontur- oder Cartoon-Darstellung und das Rendern im Netzwerk.
Beschreibung
RayTraceRendererOptions gibt Zugriff auf die Einstellungen eines Ray-Trace-Renderers (RayTraceRenderer). Du stellst damit ein, wie groß und in welchem Format das Bild wird, in welcher Qualität Vorschau und endgültiges Rendern laufen und welche Effekte dazukommen. Die ersten Befehle gibt es seit SOLIDWORKS 2011, viele seit 2016.
Zugriff
RayTraceRenderer.RayTraceRendererOptions: die Einstellungen des Ray-Trace-Renderers, den du mitSldWorks.GetRayTraceRendererholst
Beispiel
' Stellt Größe, Format und Qualität ein und rendert das aktive Modell in eine Datei.
' Vorbedingung: Ein Modell ist offen, ein Ray-Trace-Renderer ist geladen,
' der Ordner C:\Temp existiert.
' Ergebnis: C:\Temp\Render.png mit 1280 x 720 Pixel, die Einstellungen stehen
' im Direktfenster. Das Rendern kann einige Minuten dauern.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swRenderer As SldWorks.RayTraceRenderer
Dim swOptionen As SldWorks.RayTraceRendererOptions
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swRenderer = swApp.GetRayTraceRenderer(0) ' die Hilfe nennt keine Konstante dafür
If swRenderer Is Nothing Then
Debug.Print "Kein Ray-Trace-Renderer geladen."
Exit Sub
End If
Set swOptionen = swRenderer.RayTraceRendererOptions
Debug.Print "Bisher: " & swOptionen.ImageWidth & " x " & swOptionen.ImageHeight & _
" Pixel, Format " & swOptionen.ImageFormat & ", Qualität " & swOptionen.FinalRenderQuality
swOptionen.ImageWidth = 1280
swOptionen.ImageHeight = 720
swOptionen.ImageFormat = swImageFormat_PNG
swOptionen.FinalRenderQuality = swRenderQuality_Better
swOptionen.BloomEnabled = False
If swRenderer.RenderToFile("C:\Temp\Render", 0, 0) Then
Debug.Print "Gespeichert: C:\Temp\Render.png"
Else
Debug.Print "Rendern fehlgeschlagen."
End If
swRenderer.CloseRayTraceRender
End SubBemerkungen
Renderer holen: SldWorks.GetRayTraceRenderer erwartet einen Wert aus swRayTraceRenderType_e, die Hilfe führt dort aber keinen auf. Das Hilfebeispiel „Update Graphics Area After Changing Render Options“ übergibt 0, die übrigen Hilfebeispiele lassen die Zeile auskommentiert. Der Ray-Trace-Renderer muss in SOLIDWORKS geladen sein, das Beispiel „Render Model“ verlangt außerdem eine Premium-Lizenz.
Vorschau und endgültiges Rendern: Viele Effekte, etwa Bloom und direkte Kaustik, sieht man nur im endgültigen Rendern. Geänderte Einstellungen zeigst du vorher mit RayTraceRendererOptions.UpdateGraphics im Grafikbereich.
Abhängige Einstellungen: Die Einstellungen für Konturlinien und Cartoon-Stil gelten nur, wenn RayTraceRendererOptions.ContourCartoonRenderingEnabled True ist. Spiegelungen und Brechungen gelten nur mit RayTraceRendererOptions.CustomRenderSettings.
Netzwerk: Rendern auf mehreren Rechnern können nur Kunden mit SOLIDWORKS Subscription Services.
Veraltet: ContourEnabled ist durch RayTraceRendererOptions.ContourCartoonRenderingEnabled ersetzt.
Unvollständige Hilfe: Für ContourCartoonRenderingEnabled, IncludeAnnotationsInRendering, RenderAnnotationsToSeparateImage, UseSceneBackgroundImageAspectRatio und UseSolidWorksViewAspectRatio hat die Hilfe nur die VBA-Syntax und eine Zeile in der Mitgliederliste. Für die Bloom-, Kaustik- und Gammawerte nennt sie weder Einheit noch Bereich.
Eigenschaften und Methoden
Eigenschaften 35, davon 34 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AlphaOutput | Liest oder setzt, ob der Ray-Trace-Renderer eine Alpha-Ausgabe erzeugt statt des Bilds in Endfarben. |
| BloomEnabled | Liest oder setzt, ob der Ray-Trace-Renderer den Bloom-Effekt (Überstrahlen heller Stellen) anwendet. |
| BloomRadius | Liest oder setzt, wie weit der Bloom-Effekt von der Lichtquelle ausstrahlt. |
| BloomThreshold | Liest oder setzt, ab welcher Helligkeit oder Leuchtkraft der Bloom-Effekt wirkt. |
| CausticAmount | Liest oder setzt die größte Zahl ausgesandter Photonen und damit die Menge sichtbarer Kaustik. |
| CausticQuality | Liest oder setzt die Zahl der Photonen, die je Pixel ausgewertet werden, und damit die Qualität der Kaustik. |
| ClientWorkload | Liest oder setzt, wie viele Buckets (Abschnitte des Renderns) jeder Client-Rechner beim Rendern im Netzwerk bekommt. |
| ContourCartoonRenderingEnabled | Liest oder setzt, ob der Ray-Trace-Renderer mit Konturlinien oder im Cartoon-Stil rendert. |
| ContourEnabled | veraltet ersetzt durch RayTraceRendererOptions.ContourCartoonRenderingEnabled |
| ContourLineColor | Liest oder setzt die Farbe der Konturlinien als RGB-Wert. |
| ContourLineThickness | Liest oder setzt die Breite der Konturlinien in Pixel. |
| CustomRenderSettings | Liest oder setzt, ob eigene Render-Einstellungen gelten, mit denen du die Zahl der Spiegelungen und Brechungen festlegst. |
| DefaultImagePath | Liest oder setzt den Standardpfad, unter dem das gerenderte Bild gespeichert wird. |
| DirectCaustics | Liest oder setzt, ob das endgültige Rendern direkte Kaustik zeigt. |
| FinalRenderQuality | Liest oder setzt die Qualität des endgültigen Renderns. |
| Gamma | Liest oder setzt den Gammawert, der die Mitteltöne des gerenderten Bilds aufhellt oder abdunkelt. |
| HasCartoonEdges | Liest oder setzt, ob der Ray-Trace-Renderer im Cartoon-Stil Kanten zeichnet. |
| HasCartoonShading | Liest oder setzt, ob der Ray-Trace-Renderer im Cartoon-Stil schattiert. |
| ImageFormat | Liest oder setzt das Dateiformat des gerenderten Bilds. |
| ImageHeight | Liest oder setzt die Höhe des gerenderten Bilds in Pixel. |
| ImageWidth | Liest oder setzt die Breite des gerenderten Bilds in Pixel. |
| IncludeAnnotationsInRendering | Liest oder setzt, ob die im Modell sichtbaren Beschriftungen und Bemaßungen beim Rendern in eine Datei mitgerendert werden. |
| NetworkRendering | Liest oder setzt, ob auf mehreren Rechnern im Netzwerk gerendert wird. |
| NetworkSharedDirectory | Liest oder setzt das freigegebene Netzwerkverzeichnis für das Rendern im Netzwerk. |
| NumberOfReflections | Liest oder setzt die Zahl der Spiegelungen im endgültigen Rendern. |
| NumberOfRefractions | Liest oder setzt die Zahl der Brechungen im endgültigen Rendern. |
| OffloadedRendering | Liest oder setzt, ob das Rendern an andere Rechner im Netzwerk abgegeben wird. |
| OutputAmbientOcclusion | Liest oder setzt, ob der Ray-Trace-Renderer mit Umgebungsverdeckung (ambient occlusion) rendert. |
| PreviewRenderQuality | Liest oder setzt die Qualität des Renderns im Vorschaufenster. |
| RenderAnnotationsToSeparateImage | Liest oder setzt, ob die im Modell sichtbaren Beschriftungen und Bemaßungen in ein eigenes Bild gerendert werden. |
| RenderType | Liest oder setzt, ob der Ray-Trace-Renderer mit Konturlinien oder im Cartoon-Stil rendert. |
| SendDataForNetworkJob | Liest oder setzt, ob die Daten für das Rendern im Netzwerk übers Netzwerk geschickt werden statt über ein freigegebenes Verzeichnis. |
| ShadedContour | Liest oder setzt, ob die Konturlinien schattiert werden. |
| UseSceneBackgroundImageAspectRatio | Liest oder setzt, ob Vorschau und endgültiges Rendern das Seitenverhältnis des Hintergrundbilds der Szene verwenden. |
| UseSolidWorksViewAspectRatio | Liest oder setzt, ob Vorschau und endgültiges Rendern das Seitenverhältnis der SOLIDWORKS-Ansicht verwenden. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| UpdateGraphics | Aktualisiert den Grafikbereich, damit du geänderte Render-Einstellungen vor dem Rendern prüfen kannst. |
Siehe auch
Englisches Original: IRayTraceRendererOptions in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.