Objekt · SldWorks
RayTraceRenderer-Objekt
Ein Ray-Trace-Renderer: zeigt Vorschau und endgültiges Rendern und speichert das gerenderte Modell als Bild.
Beschreibung
RayTraceRenderer gibt Zugriff auf Ray-Trace-Renderer, also Render-Engines, die das Modell mit Licht, Spiegelungen und Schatten fotorealistisch darstellen. Damit zeigst du das Vorschaufenster und das Fenster für das endgültige Rendern, speicherst die aktuelle Ansicht als Bild und schließt die Fenster wieder. Bildgröße, Format, Qualität und Effekte stehen in den Einstellungen (RayTraceRendererOptions). Die Befehle gibt es seit SOLIDWORKS 2011.
Zugriff
SldWorks.GetRayTraceRenderer: der Ray-Trace-Renderer, falls einer geladen ist
Beispiel
' Rendert das aktive Modell einmal als JPEG mit der eingestellten Größe und einmal als
' PNG mit 800 x 600 Pixel und schließt danach die Render-Fenster.
' Vorbedingung: Ein Modell ist offen, ein Ray-Trace-Renderer ist geladen,
' der Ordner C:\Temp existiert.
' Ergebnis: C:\Temp\Modell_1.jpg und C:\Temp\Modell_2.png. 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
swOptionen.FinalRenderQuality = swRenderQuality_Better
swOptionen.ImageFormat = swImageFormat_JPEG
Debug.Print "JPEG (" & swOptionen.ImageWidth & " x " & swOptionen.ImageHeight & "): " & _
swRenderer.RenderToFile("C:\Temp\Modell_1", 0, 0)
swOptionen.ImageFormat = swImageFormat_PNG
Debug.Print "PNG (800 x 600): " & swRenderer.RenderToFile("C:\Temp\Modell_2", 800, 600)
If False = swRenderer.CloseRayTraceRender Then Debug.Print "Fenster nicht geschlossen."
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. Fragt SOLIDWORKS beim Rendern nach Kamera oder Perspektive, klickst du wie in den Hilfebeispielen auf „Continue without Camera or Perspective“ (in der deutschen Oberfläche entsprechend übersetzt).
Fenster: Das Vorschaufenster zeigt RayTraceRenderer.DisplayPreviewWindow, das Fenster für das endgültige Rendern RayTraceRenderer.InvokeFinalRender. RayTraceRenderer.CloseRayTraceRender schließt beide, RayTraceRenderer.CloseFinalRenderWindow nur das zweite. Nach RayTraceRenderer.RenderToFile rufst du CloseRayTraceRender auf.
Hilfebeispiel: „Render Model“ öffnet filter.sldprt aus den Lernbeispielen, ändert viele Einstellungen und rendert das Teil als HDR und als BMP. DisplayPreviewWindow, InvokeFinalRender, AbortFinalRender und CloseRayTraceRender stehen dort nur auskommentiert.
Unklar: Ob die Methoden warten, bis das Rendern fertig ist, sagt die Hilfe nicht. Welcher Renderer gemeint ist (PhotoView 360 oder ein anderer), nennt die API-Hilfe ebenfalls nicht.
Eigenschaften und Methoden
Eigenschaften 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| RayTraceRendererOptions | Liefert die Einstellungen des Ray-Trace-Renderers. |
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| AbortFinalRender | Bricht das endgültige Rendern im Fenster für das endgültige Rendern ab. |
| CloseFinalRenderWindow | Schließt das Fenster für das endgültige Rendern, das Vorschaufenster bleibt offen. |
| CloseRayTraceRender | Schließt das Vorschaufenster und das Fenster für das endgültige Rendern. |
| DisplayPreviewWindow | Zeigt das Vorschaufenster des Ray-Trace-Renderers. |
| InvokeFinalRender | Öffnet das Fenster für das endgültige Rendern und startet es. |
| RenderToFile | Rendert die aktuelle Ansicht des Modells und speichert sie als Bild in eine Datei. |
Siehe auch
Englisches Original: IRayTraceRenderer in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.