Click or drag to resize
SoOffscreenRenderAreaRenderToFile Method (String, SoOffscreenRenderAreaOutputFormats)

Render the given scene graph and save the result in the given file.

Namespace: OIV.Inventor
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2024.1.0.0 (2024.1.0)
Syntax
public bool RenderToFile(
	string filename,
	SoOffscreenRenderAreaOutputFormats outputFormat
)

Parameters

filename
Type: SystemString

path and name of the image file to be generated. If the file extension is not one of the above type, no file is generated.

outputFormat
Type: OIV.InventorSoOffscreenRenderAreaOutputFormats

defines which components to write to the output. If set to OIV.Inventor.SoOffscreenRenderArea.OutputFormats.RGBA, the alpha component of the rendering is also written to the file. However if the targeted file type does not support alpha component, the file will be generated with OIV.Inventor.SoOffscreenRenderArea.OutputFormats.RGB components only. See the 3rd column of the above table.

Return Value

Type: Boolean
Remarks

The format of the generated image is chosen automatically according to the file extension. Returns true if successful.

If your application needs more control over creation of the file, please see the OIV.Inventor.SoOffscreenRenderArea.RenderToBuffer(OIV.Inventor.Devices.SoBufferObject, OIV.Inventor.SoOffscreenRenderArea.OutputFormats) method.

Supported file types are:

extension file (case insensitive) raster image type Alpha Component Support
.bmp Windows bitmap YES
.dds DirectDraw surface YES
.gif Graphics Interchange Format YES
.hdr hdr NO
.jp2, .j2c, .j2k, .jpc, .jpx, .ecw, .ecwp jpeg 2000 YES
.jpg, .jpeg, .jif, .jfif Joint Photographic Experts Group NO
.pgx pgx NO
.png Portable Network Graphics YES
.pnm .pgm .ppm pnm YES
.ps PostScript NO
.rgb .sgi sgi YES
.ras sun YES
.tif .tiff Tagged Image File Format YES

See Also