Detailed Description

The Framebuffer object controls the file output of a RenderChannel object. It can be created using the Pass::CreateFramebuffer function.

The framebuffer format can be selected from the list of formats provided by the rendering engine selected on the framebuffer's Pass object.

See also:: RenderChannel SceneRenderProperty Pass

Since:: 6.0

Example:

This example demonstrates how to list all framebuffers from all passes and the resolved paths they point to.

        #include <xsi_project.h>
        #include <xsi_scene.h>
        #include <xsi_pass.h>
        #include <xsi_passcontainer.h>
        #include <xsi_framebuffer.h>
        #include <xsi_parameter.h>
        #include <xsi_time.h>
        using namespace XSI;

        // Helpers
        void ListPasses()
        {
            Application xsi = Application();
            CRefArray passes = xsi.GetActiveProject().GetActiveScene().GetPasses();
            xsi.LogMessage(L"# of passes found: "+CString(passes.GetCount()));
            for ( LONG i=0; i<passes.GetCount(); i++ )
            {
                Pass oPass = Pass(CRef(passes[i]));
                xsi.LogMessage( L"Pass '"  + oPass.GetName() + L"': " );

                CRefArray buffers = oPass.GetFramebuffers();
                xsi.LogMessage(L"# of buffers found: "+CString(buffers.GetCount()));
                for( LONG j=0; j<buffers.GetCount(); j++ )
                {
                    Framebuffer oFramebuffer = Framebuffer(CRef(buffers[j]));
                    xsi.LogMessage( L"Framebuffer '" + oFramebuffer.GetName() + L"' writes to '" +
                        oFramebuffer.GetResolvedPath(CTime()) + L"'" );
                }
            }
        }

        CValue NewScene( const CString& in_ProjectPathName, const bool& in_Confirm )
        {
            CValueArray args(2);
            CValue retval;

            args[0]= in_ProjectPathName;
            args[1]= in_Confirm;

            Application app;
            CStatus st = app.ExecuteCommand( L"NewScene", args, retval );

            return retval;
        }

        Application app = Application();
        NewScene( L"", false );
        Scene oScene = app.GetActiveProject().GetActiveScene();
        Pass oNewPass = oScene.GetPassContainer().AddPass( L"", L"" );
        Framebuffer oDiffuseBuffer = oNewPass.CreateFramebuffer( L"Diffuse" );
        oDiffuseBuffer.PutParameterValue(L"FileName", L"diffuse.[Frame #4]");

        // Invoke the ListPasses( ) function
        ListPasses( );

        // Expected results:
        // INFO : Pass 'Default_Pass':
        // INFO : Framebuffer 'Main' writes to '<factorypath>\Data\XSI_SAMPLES\Render_Pictures\Default_Pass_Main.1.pic'

#include <xsi_framebuffer.h>

Inheritance diagram for Framebuffer:

[legend]

List of all members.

Public Member Functions
	Framebuffer ()
	~Framebuffer ()
	Framebuffer (const CRef &in_ref)
	Framebuffer (const Framebuffer &in_obj)
bool	IsA (siClassID in_ClassID) const
siClassID	GetClassID () const
Framebuffer &	operator= (const Framebuffer &in_obj)
Framebuffer &	operator= (const CRef &in_ref)
RenderChannel	GetRenderChannel ()
CString	GetResolvedPath (const CTime &in_rTime)
CString	GetResolvedPath ()
CStringArray	GetFormats ()
CStringArray	GetDataTypes ()
CLongArray	GetBitDepths ()
XSI::siImageBitDepth	GetDisplayBitDepth ()
CString	GetResolvedPath (const CTime &in_rTime, const CRef &in_rCtx)
CString	GetResolvedPath (const CRef &in_rCtx)

Constructor & Destructor Documentation

Framebuffer ( )

Default constructor.

~Framebuffer ( )

Default destructor.

Framebuffer ( const CRef & in_ref )

Constructor.

Parameters:

in_ref constant reference object.

Framebuffer ( const Framebuffer & in_obj )

Copy constructor.

Parameters:

in_obj constant class object.

Member Function Documentation

bool IsA ( siClassID in_ClassID ) const [virtual]

Returns true if a given class type is compatible with this API class.

Parameters:

in_ClassID class type.

Returns:: true if the class is compatible, false otherwise.

Reimplemented from ProjectItem.

siClassID GetClassID ( ) const [virtual]

Returns the type of the API class.

Returns:: The class type.

Reimplemented from ProjectItem.

Framebuffer& operator= ( const Framebuffer & in_obj )

Creates an object from another object. The newly created object is set to empty if the input object is not compatible.

Parameters:

in_obj constant class object.

Returns:: The new Framebuffer object.

Framebuffer& operator= ( const CRef & in_ref )

Creates an object from a reference object. The newly created object is set to empty if the input reference object is not compatible.

Parameters:

in_ref constant class object.

Returns:: The new Framebuffer object.

Reimplemented from ProjectItem.

RenderChannel GetRenderChannel ( )

Returns the RenderChannel this Framebuffer represents. All rendering takes place in a render channel and is output to disk by the framebuffer object.

Returns:: The RenderChannel object.

See also:: RenderChannel siRenderChannelType

CString GetResolvedPath ( const CTime & in_rTime )

Takes the output file name path template given in the framebuffer and resolves it, for the specified time, into a real path name and returns it as a CString. See section "Output Path Templates" in the Softimage User Guide for more details.

The in_rTime parameter controls the result of the [Frame] and [Field] tokens.

Parameters:

in_rTime The time to resolve the path template at.

Returns:: The resolved file name path template at the given time.

See also:: Pass::GetResolvedArchivePath XSIUtils.ResolveTokenString

Since:: 6.01

CString GetResolvedPath ( )

Takes the output file name path template given in the framebuffer and resolves it into a time-independent path, where any instance of [Frame] is substituted with the a sequence of '#' symbols, that represent the current frame number and padding width. See section "Output Path Templates" in the Softimage User Guide for more details.

Returns:: The time-independent resolved file name path template.

See also:: Pass::GetResolvedArchivePath XSIUtils.ResolveTokenString

Since:: 6.01

CStringArray GetFormats ( )

Returns a list of the available image output file formats that can be set for this framebuffer. The format selection is dependent on the current rendering engine and the channel type of the RenderChannel object represented by this framebuffer.

Returns:: A list of format extensions corresponding to the image file formats available to this framebuffer.

See also:: RenderChannel siRenderChannelType

CStringArray GetDataTypes ( )

Returns a list of the available output data types for the image output file format selected for this framebuffer.

Returns:: An array of data types for the selected image output format. Although the data type can be any string, many of them are predefined in siImageDataType.

See also:: RenderChannel siRenderChannelType siImageDataType

CLongArray GetBitDepths ( )

Returns a list of the available bit depths for the selected output data type for this framebuffer.

Returns:: A list of siImageBitDepth values available for the selected output data type.

See also:: RenderChannel siRenderChannelType siImageDataType siImageBitDepth

XSI::siImageBitDepth GetDisplayBitDepth ( )

Returns the bit depth to use for returning color data back to Softimage for display at render time. This value will be passed to RendererImageFragment::GetScanlineRGBA when Softimage asks for image fragment data.

Returns:: A color bit depth for display data.

See also:: RendererImageFragment

Since:: 7.0

CString GetResolvedPath	(	const CTime &	in_rTime,
		const CRef &	in_rCtx
	)

Takes the output file name path template given in the framebuffer and resolves it, for the specified time, into a real path name and returns it as a CString. See section "Output Path Templates" in the Softimage User Guide for more details.

The in_rTime parameter controls the result of the [Frame] and [Field] tokens.

Parameters:

in_rTime	The time to resolve the path template at.
in_rCtx	The renderer context given, used to resolve context specific tokens such as the current camera used

Returns:: The resolved file name path template at the given time.

See also:: Pass::GetResolvedArchivePath XSIUtils.ResolveTokenString

Since:: 12.0 (2014)

CString GetResolvedPath ( const CRef & in_rCtx )

Takes the output file name path template given in the framebuffer and resolves it into a time-independent path, where any instance of [Frame] is substituted with the a sequence of '#' symbols, that represent the current frame number and padding width. See section "Output Path Templates" in the Softimage User Guide for more details.

Parameters:

in_rCtx The renderer context given, used to resolve context specific tokens such as the current camera used

Returns:: The time-independent resolved file name path template.

See also:: Pass::GetResolvedArchivePath XSIUtils.ResolveTokenString

Since:: 12.0 (2014)

The documentation for this class was generated from the following file:

xsi_framebuffer.h

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

Member Function Documentation