All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HdxPrimOriginInfo Struct Reference

#include <pickTask.h>

Public Member Functions

HDX_API SdfPath GetFullPath (const TfToken &nameInPrimOrigin=HdPrimOriginSchemaTokens->scenePath) const

Static Public Member Functions

static HDX_API HdxPrimOriginInfo FromPickHit (HdRenderIndex *renderIndex, const HdxPickHit &hit)

Public Attributes

std::vector< HdxInstancerContextinstancerContexts
HdContainerDataSourceHandle primOrigin

Detailed Description

A helper to extract information about the picked prim that allows modern applications to identify a prim and, e.g., obtain the scene path such as the path of the corresponding UsdPrim.

Note that this helper assumes that we use scene indices and that the primOrigin data source was populated for each pickable prim in the scene index. Typically, an application will populate the scenePath in the primOrigin data source. But the design allows an application to populate the primOrigin container data source with arbitrary data that helps to give context about a prim and identify the picked prim.

Note that legacy applications using scene delegates cannot use HdxPrimOriginInfo and have to translate the scene index path to a scene path using the scene delegate API HdSceneDelegate::GetScenePrimPath and HdSceneDelegate::ConvertIndexPathToCachePath.

Definition at line 178 of file pickTask.h.

Member Function Documentation

static HDX_API HdxPrimOriginInfo HdxPrimOriginInfo::FromPickHit ( HdRenderIndex renderIndex,
const HdxPickHit hit 

Query terminal scene index of render index for information about picked prim.

HDX_API SdfPath HdxPrimOriginInfo::GetFullPath ( const TfToken nameInPrimOrigin = HdPrimOriginSchemaTokens->scenePath) const

Combines instance scene paths and prim scene path to obtain the full scene path.

The scene path is extracted from the prim origin container data source by using the given key.

Member Data Documentation

std::vector<HdxInstancerContext> HdxPrimOriginInfo::instancerContexts

Information about the instancers instancing the picked object. The outer most instancer will be first.

Definition at line 200 of file pickTask.h.

HdContainerDataSourceHandle HdxPrimOriginInfo::primOrigin

The prim origin data source for the picked prim if provided by the scene index.

Definition at line 203 of file pickTask.h.

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