SolidWorksMakroprogrammierung

Methode · RayTraceRenderer

RenderToFile-Methode (RayTraceRenderer)

Rendert die aktuelle Ansicht des Modells und speichert sie als Bild in eine Datei.

Syntax

Function RenderToFile( _
   ByVal ImageFileName As String, _
   ByVal Width As Long, _
   ByVal Height As Long _
) As Boolean
bErfolg = swRenderer.RenderToFile("C:\Temp\Render", 0, 0)

Parameter

ImageFileNameStringByVal
Pfad und Name der Datei. Hast du vorher RayTraceRendererOptions.ImageFormat gesetzt, kannst du die Endung weglassen.
WidthLongByVal
Die Breite des Bilds in Pixel. 0: Wert aus RayTraceRendererOptions.ImageWidth.
HeightLongByVal
Die Höhe des Bilds in Pixel. 0: Wert aus RayTraceRendererOptions.ImageHeight.

Rückgabewert

True, wenn das Bild gespeichert wurde, sonst False.

Beispiel

' swRenderer ist der Ray-Trace-Renderer (RayTraceRenderer), etwa aus SldWorks.GetRayTraceRenderer.
Dim swOptionen As SldWorks.RayTraceRendererOptions
Set swOptionen = swRenderer.RayTraceRendererOptions
swOptionen.ImageFormat = swImageFormat_HDR
Debug.Print "HDR: " & swRenderer.RenderToFile("C:\Temp\Bild_2", 0, 0)
swOptionen.ImageFormat = swImageFormat_WindowsBmp
Debug.Print "BMP: " & swRenderer.RenderToFile("C:\Temp\Bild_1", 800, 600)
swRenderer.CloseRayTraceRender

Bemerkungen

Lege vorher das Format mit RayTraceRendererOptions.ImageFormat fest. Sollen die im Modell sichtbaren Beschriftungen und Bemaßungen ins Bild, setzt du RayTraceRendererOptions.IncludeAnnotationsInRendering auf True, für ein eigenes Bild dazu RayTraceRendererOptions.RenderAnnotationsToSeparateImage. Width und Height überschreiben die Werte aus ImageWidth und ImageHeight, mit 0 gelten diese.

Danach rufst du RayTraceRenderer.CloseRayTraceRender auf. Die Hilfebeispiele zu Beschriftungen nehmen stattdessen RayTraceRenderer.CloseFinalRenderWindow. Im Hilfebeispiel „Render Model“ steht, dass das Rendern einige Minuten dauern kann. Ob die Methode bis dahin wartet, sagt die Hilfe nicht, das Hilfebeispiel ruft sie zweimal direkt nacheinander auf.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

Englisches Original: IRayTraceRenderer::RenderToFile in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.