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 BooleanbErfolg = swRenderer.RenderToFile("C:\Temp\Render", 0, 0)Parameter
ImageFileNameStringByVal- Pfad und Name der Datei. Hast du vorher
RayTraceRendererOptions.ImageFormatgesetzt, kannst du die Endung weglassen. WidthLongByVal- Die Breite des Bilds in Pixel.
0: Wert ausRayTraceRendererOptions.ImageWidth. HeightLongByVal- Die Höhe des Bilds in Pixel.
0: Wert ausRayTraceRendererOptions.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.CloseRayTraceRenderBemerkungen
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.