HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | List of all members
HgiInterop Class Referencefinal

#include <hgiInterop.h>

Public Member Functions

HGIINTEROP_API HgiInterop ()
 
HGIINTEROP_API ~HgiInterop ()
 
HGIINTEROP_API void TransferToApp (Hgi *srcHgi, HgiTextureHandle const &srcColor, HgiTextureHandle const &srcDepth, TfToken const &dstApi, VtValue const &dstFramebuffer, GfVec4i const &dstRegion)
 

Detailed Description

Hydra Graphics Interface Interop.

HgiInterop provides functionality to transfer render targets between supported APIs as efficiently as possible.

Definition at line 49 of file hgiInterop.h.

Constructor & Destructor Documentation

HGIINTEROP_API HgiInterop::HgiInterop ( )
HGIINTEROP_API HgiInterop::~HgiInterop ( )

Member Function Documentation

HGIINTEROP_API void HgiInterop::TransferToApp ( Hgi *  srcHgi,
HgiTextureHandle const &  srcColor,
HgiTextureHandle const &  srcDepth,
TfToken const &  dstApi,
VtValue const &  dstFramebuffer,
GfVec4i const &  dstRegion 
)

Composite the provided textures over the application / viewer's framebuffer contents. srcHgi: Determines the source format/platform of the textures. Eg. if hgi is of type HgiMetal, the textures are HgiMetalTexture. srcColor: is the source color aov texture to composite to screen. srcDepth: (optional) is the depth aov texture to composite to screen. dstApi: Determines what target format/platform the application is using. E.g. If hgi==HgiMetal and dstApi==OpenGL then TransferToApp will present the metal textures to the gl application. dstFramebuffer: The framebuffer that the source textures are presented into. This is a VtValue that encoding a framebuffer in a dstApi specific way. E.g., a uint32_t (aka GLuint) for framebuffer object for dstApi==OpenGL. For backwards compatibility, the currently bound framebuffer is used when the VtValue is empty.

dstRegion: Subrect region of the framebuffer over which to composite. Coordinates are (left, BOTTOM, width, height) which is the same convention as OpenGL viewport coordinates.

Note: To composite correctly, blending is enabled. If srcDepth is provided, depth testing is enabled. As a result, the contents of the application framebuffer matter. In order to use the contents of srcColor and srcDepth as-is (i.e., blit), the color attachment should be cleared to (0,0,0,0) and the depth attachment needs to be cleared to 1.

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