Exporting Archives

Archive export mode is triggered when the user wants to export render archives to be rendered using a standalone version of the rendering engine, outside of the XSI interface.

This mode is only called if the renderer plug-in registered itself as archive export capable by adding siRenderProcessExportArchive to Renderer::PutProcessTypes , and registering an archive file format with Renderer::PutArchiveFormat.

Since the archive is meant to be rendered outside of XSI it is important that the renderer plug-in include all information required to do so, since it is impossible to request any missing information from XSI later on.

Single and Multi-Frame Archives

You can output archives in both single- and multiple-frame mode. Single-frame archives contain only enough data to render a single frame (or a pair of fields) whereas a multi-frame archive contains enough render data to render a whole sequence from a single file.

In both cases the Process callback gets called for individual frames so it is up to the renderer plug-in to maintain enough state information between calls to properly output multiple frames to a single archive.

In each case, the filename to use for each frame is provided in the "ArchiveFileName" context attribute. For multi-frame archives, this is always the same value for all frames in the sequence.

Multi-frame archive support is optional and is enabled by calling Renderer::PutArchiveFormat and passing a value of true to the in_bMultiFrame argument.



SOFTIMAGE|XSI v6.01     

Return to Softimage XSI Index