SolidWorksMakroprogrammierung

Objekt · SldWorks

RayTraceRenderer-Objekt

Ein Ray-Trace-Renderer: zeigt Vorschau und endgültiges Rendern und speichert das gerenderte Modell als Bild.

Deklaration Dim x As SldWorks.RayTraceRenderer · in der englischen .NET-Hilfe: IRayTraceRenderer

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

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 Sub

Bemerkungen

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

NameBeschreibung
RayTraceRendererOptionsLiefert die Einstellungen des Ray-Trace-Renderers.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AbortFinalRenderBricht das endgültige Rendern im Fenster für das endgültige Rendern ab.
CloseFinalRenderWindowSchließt das Fenster für das endgültige Rendern, das Vorschaufenster bleibt offen.
CloseRayTraceRenderSchließt das Vorschaufenster und das Fenster für das endgültige Rendern.
DisplayPreviewWindowZeigt das Vorschaufenster des Ray-Trace-Renderers.
InvokeFinalRenderÖffnet das Fenster für das endgültige Rendern und startet es.
RenderToFileRendert 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.