All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HdSampledDataSource Class Referenceabstract

#include <dataSource.h>

+ Inheritance diagram for HdSampledDataSource:

Public Types

using Time = float

Public Member Functions

virtual VtValue GetValue (Time shutterOffset)=0
virtual bool GetContributingSampleTimesForInterval (Time startTime, Time endTime, std::vector< Time > *outSampleTimes)=0
- Public Member Functions inherited from HdDataSourceBase
virtual HD_API ~HdDataSourceBase ()=0

Detailed Description

A datasource representing time-sampled values. Note that implementations are responsible for providing cache invalidation, if necessary.

Definition at line 169 of file dataSource.h.

Member Typedef Documentation

Definition at line 173 of file dataSource.h.

Member Function Documentation

virtual bool HdSampledDataSource::GetContributingSampleTimesForInterval ( Time  startTime,
Time  endTime,
std::vector< Time > *  outSampleTimes 
pure virtual

Given a shutter window of interest (startTime and endTime relative to the current frame), return a list of sample times for the caller to query with GetValue such that the caller can reconstruct the signal over the shutter window. For a sample-based attribute, this might be a list of times when samples are defined. For a procedural scene, this might be a generated distribution. Note that the returned samples don't need to be within startTime and endTime; if a boundary sample is outside of the window, implementers can return it, and callers should expect it and interpolate to startTime or endTime accordingly. If this call returns true, the caller is expected to pass the list of outSampleTimes to GetValue. If this call returns false, this value is uniform across the shutter window and the caller should call GetValue(0) to get that uniform value.

Implemented in UsdImagingDataSourceXformMatrix, UsdImagingDataSourceXformResetXformStack, HdRetainedTypedMultisampledDataSource< T >, HdRetainedTypedSampledDataSource< T >, UsdImagingDataSourceExtentCoordinate, HdRetainedSampledDataSource, UsdImagingDataSourceAttribute< T >, UsdImagingDataSourceAttributeColorSpace, UsdImagingDataSourcePointInstancerMask, and UsdImagingDataSourceRelationship.

virtual VtValue HdSampledDataSource::GetValue ( Time  shutterOffset)
pure virtual

Returns the value of this data source at frame-relative time shutterOffset. The caller does not track the frame; the scene index producing this datasource is responsible for that, if applicable. Note that, although this call returns a VtValue for each shutter offset, the type of the held value is expected to be the same across all shutter offsets. This call is expected to be threadsafe.

Implemented in UsdImagingDataSourceXformMatrix, UsdImagingDataSourceXformResetXformStack, HdRetainedTypedMultisampledDataSource< T >, HdRetainedTypedSampledDataSource< T >, HdRetainedSampledDataSource, UsdImagingDataSourceExtentCoordinate, UsdImagingDataSourceAttribute< T >, UsdImagingDataSourcePointInstancerMask, UsdImagingDataSourceAttributeColorSpace, and UsdImagingDataSourceRelationship.

HdSampledDataSource::HD_DECLARE_DATASOURCE_ABSTRACT ( HdSampledDataSource  )

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