xiiRenderDoc Class Reference

RenderDoc implementation of the xiiFrameCaptureInterface interface. More...

#include <RenderDocSingleton.h>

Inheritance diagram for xiiRenderDoc:

Public Member Functions
virtual bool	IsInitialized () const override
	Determine if a singleton implementing this interface has successfully been initialized and frame capture functionality is available.
virtual void	SetAbsCaptureFilePathTemplate (xiiStringView sFilePathTemplate) override
	Specify the absolute base file path for storing frame captures. For the final output file name, an identifier and/or frame or capture number will be appended. Note that the final output file name is determined by the frame capture implementation. Use GetLastAbsCaptureFileName() for retrieving the actual absolute file name of the most recently written capture file.
virtual xiiStringView	GetAbsCaptureFilePathTemplate () const override
	Retrieve the absolute file path for storing frame captures.
virtual void	StartFrameCapture (xiiWindowHandle hWnd) override
	Start capturing a frame rendered to the given window.
virtual bool	IsFrameCapturing () const override
	Determine if a frame capture is currently in progress.
virtual void	EndFrameCaptureAndWriteOutput (xiiWindowHandle hWnd) override
	End the current frame capture and write the result to the path given by SetAbsCaptureFilePathTemplate.
virtual void	EndFrameCaptureAndDiscardResult (xiiWindowHandle hWnd) override
	End the current frame capture and discard the corresponding data, saving processing time and file I/O in the process.
virtual xiiResult	GetLastAbsCaptureFileName (xiiStringBuilder &out_sFileName) const override
	Retrieve the absolute file name of the last successful frame capture. Returns XII_FAILURE if no successful capture has been performed.

Detailed Description

RenderDoc implementation of the xiiFrameCaptureInterface interface.

Adds support for capturing frames through RenderDoc. When the plugin gets loaded, a xiiRenderDoc instance is created and initialized. It tries to find a RenderDoc DLL dynamically, so for initialization to succeed, the DLL has to be available in some search directory (e.g. binary folder or PATH). If an outdated RenderDoc DLL is found, initialization will fail and the plugin will be deactivated.

For interface documentation see xiiFrameCaptureInterface

Member Function Documentation

EndFrameCaptureAndDiscardResult()

void xiiRenderDoc::EndFrameCaptureAndDiscardResult ( xiiWindowHandle hWnd )

overridevirtual

End the current frame capture and discard the corresponding data, saving processing time and file I/O in the process.

Implements xiiFrameCaptureInterface.

EndFrameCaptureAndWriteOutput()

void xiiRenderDoc::EndFrameCaptureAndWriteOutput ( xiiWindowHandle hWnd )

overridevirtual

End the current frame capture and write the result to the path given by SetAbsCaptureFilePathTemplate.

Implements xiiFrameCaptureInterface.

GetAbsCaptureFilePathTemplate()

xiiStringView xiiRenderDoc::GetAbsCaptureFilePathTemplate ( ) const

overridevirtual

Retrieve the absolute file path for storing frame captures.

Implements xiiFrameCaptureInterface.

GetLastAbsCaptureFileName()

xiiResult xiiRenderDoc::GetLastAbsCaptureFileName ( xiiStringBuilder & out_sFileName ) const

overridevirtual

Retrieve the absolute file name of the last successful frame capture. Returns XII_FAILURE if no successful capture has been performed.

Implements xiiFrameCaptureInterface.

IsFrameCapturing()

bool xiiRenderDoc::IsFrameCapturing ( ) const

overridevirtual

Determine if a frame capture is currently in progress.

Implements xiiFrameCaptureInterface.

IsInitialized()

bool xiiRenderDoc::IsInitialized ( ) const

overridevirtual

Determine if a singleton implementing this interface has successfully been initialized and frame capture functionality is available.

Implements xiiFrameCaptureInterface.

SetAbsCaptureFilePathTemplate()

void xiiRenderDoc::SetAbsCaptureFilePathTemplate ( xiiStringView sFilePathTemplate )

overridevirtual

Specify the absolute base file path for storing frame captures. For the final output file name, an identifier and/or frame or capture number will be appended. Note that the final output file name is determined by the frame capture implementation. Use GetLastAbsCaptureFileName() for retrieving the actual absolute file name of the most recently written capture file.

Implements xiiFrameCaptureInterface.

StartFrameCapture()

void xiiRenderDoc::StartFrameCapture ( xiiWindowHandle hWnd )

overridevirtual

Start capturing a frame rendered to the given window.

Implements xiiFrameCaptureInterface.

---

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

• /home/runner/work/XII/XII/Source/EnginePlugins/RenderDocPlugin/RenderDocSingleton.h
• /home/runner/work/XII/XII/Source/EnginePlugins/RenderDocPlugin/RenderDocSingleton.cpp