This class is a component of the DtIndirectGeometry It inputs are: -> the instances registered with DtIndirectGeometry -> the viewing parameters (view matrix, projection matrix, etc) -> the indirect registrar (so that it can generate gpu data for -> the models of the instances from the interim data accessible -> via the registrar It outputs are: -> Tndirect command buffer -> The count of the indirect commands -> The input instances shuffled around/culled/lod'ed reflecting -> their order within the indirect command buffer generated -> It will also (optionally) do culling and lod.

Classes
struct	InstancesOffsetAndNumOfInstances

struct	StateIdOffsetAndMaxCommands

Public Types
typedef std::vector < StateIdOffsetAndMaxCommands >	VectorStateIdOffsetAndMaxCommands

typedef std::set < osg::observer_ptr< const osg::Camera > >	CameraSet

Public Member Functions
virtual	~DtGpuCulling ()

virtual void	setRegistrar (DtIndirectGeometryRegistrar *registrar)

virtual void	setRegistrarInvalid (void)

virtual void	setDebug (bool debug)

virtual const DtCullShaderConfig &	cullShaderConfig (void) const

virtual void	updateGpuBuffers (bool amortizeTextures)

virtual void	modelIdsToNumInstancesChanged (void)

virtual void	updatePerInstancePerGeomBuffers (const MapIntToInt &modelIdsToNumInstances, const osg::Camera *camera)

virtual void	doCulling (const DtIndirectViewParameters &viewParameters, const osg::FrameStamp frameStamp, const DtGlBuffer gpuLodVisibleBuffer, const DtGlBuffer gpuDofTransformBuffer, const DtGlBuffer gpuSwitchStateBuffer, const DtGlBuffer gpuPerInstanceDataBuffer, const osg::Camera camera, bool &outputInstanceBufferChanged)

virtual bool	bindGpuOutputInstanceBuffersWithAddressRange (const osg::Camera *camera) const

virtual bool	bindCommandBufferAndSsbos (const DtGlBuffer gpuDofTransformBuffer, const DtGlBuffer gpuDofModelScaleBuffer, const DtGlBuffer gpuUvOffsetBuffer, const DtGlBuffer gpuPerInstanceDataBuffer, const osg::Camera *camera)

virtual void	unbindCommandBufferAndSsbos (const osg::Camera *camera)

virtual void	bindGpuOutputInstanceBufferDebug (const osg::Camera *camera) const

virtual void	unbindGpuOutputInstanceBufferDebug (const osg::Camera *camera) const

virtual bool	bindIndirectThingsDebug (const DtGlBuffer gpuDofTransformBuffer, const osg::Camera camera)

virtual void	unbindIndirectThingsDebug (const osg::Camera *camera)

virtual bool	useInstanceCount (void) const

virtual int	numDrawCommands (const osg::Camera *camera) const

virtual void	releaseGLObjects (void)

virtual void	reloadShaders () const

virtual bool	buffersInitializedForCamera (const osg::Camera *camera) const

virtual unsigned int	maxNumInstances (void) const

virtual const VectorStateIdOffsetAndMaxCommands &	stateIdOffsetAndMaxCommands (void) const

virtual const std::vector < InstancesOffsetAndNumOfInstances > &	instancesOffsetAndNumInstances (void) const

virtual bool	readyToUpdateAndGpuBuffersNeedUpdate () const

virtual bool	gpuBuffersNeedUpdate () const

virtual bool	textureUpdateDirty () const

virtual void	setTextureUpdateDirty (bool flag)

virtual bool	perGeomInstanceDataDirty () const

virtual void	setPerGeomInstanceDataDirty (bool flag)

virtual bool	instancesInvalidatedDirty () const

virtual void	invalidateInstance (int instanceId, int offset, int size)

virtual const DtGlBuffer *	gpuInputPerGeomInstancesBuffer (void) const

virtual const DtGlBuffer *	gpuMaterialsBuffer () const

virtual void	fillOutputInstances (std::vector< DtVector4< int > > &outputInstances, const osg::Camera *camera) const

virtual const DtIndirectEffectTexturesTemplate &	currentEffectTexturesState () const

virtual void	setName (const std::string &name)

virtual const std::string &	name (void) const

Static Public Member Functions
static bool	setUpOutputFormatAndBindings ()

static void	unsetUpOutputFormatAndBindings ()

Public Attributes
friend	DtGpuCullingCreator

Protected Member Functions
	DtGpuCulling (DtDe &de, DtInstanceContainer &container, const DtCullShaderConfig &)

virtual void	updateGpuTexturesBuffer (bool amortizeTextures)

virtual void	updateInstancesOffsetAndInstances (const MapIntToInt &modelIdsToNumInstances)

virtual void	updateInstancesOffsetAndInstancesBuffer (void)

virtual void	updateStateIdToMaxNumCommands (const MapIntToInt &modelIdsToNumInstances)

virtual void	updateStateIdToMaxNumCommandsBuffer (void)

virtual void	deleteBuffers (void)

virtual void	flushSingleCameraSet (CameraSet &cameraSet)

virtual void	incrementUsersAndLoadIfNecessary (DtIndirectModelInfo *info)

virtual void	releaseGlObjectsDecrementUsersAndUnLoadIfNecessary ()

virtual DtGpuCullingTcsUserData *	getOrCreate (const osg::Camera *camera)


virtual void	updateGpuInputPerGeomInstancesBufferByInvalidating ()

virtual void	updateGpuGeometrySpecificationsBuffer ()

virtual void	updateGpuMaterialsBuffer ()

virtual void	updateGpuInputPerGeomInstancesBuffer ()

virtual void	updateGpuLightPointBuffers ()

virtual void	updateGpuIndirectBuffersInstanceCount (const MapIntToInt &modelIdsToNumInstances, DtGpuCullingTcsUserData *userData)

virtual void	updateGpuIndirectBuffersNonInstanceCount (const MapIntToInt &modelIdsToNumInstances, DtGpuCullingTcsUserData *userData)

virtual void	clearGpuIndirectBuffer (DtGpuCullingTcsUserData *userData)

virtual void	clearStateIdCommandCountBuffer ()

virtual void	clearLightSourceIndexOutputBuffer (unsigned int maxNumLightSources, DtGpuCullingTcsUserData *userData)

Protected Attributes
DtIndirectGeometryRegistrar *	myRegistrar

bool	myRegistrarValid

const DtInstanceContainer &	myInstanceContainer

DtGlBuffer *	myGpuInputPerGeomInstancesBuffer

bool	myPerGeomInstanceDataDirty

DtIndirectInstancesInvalidated	myInstancesInvalidated

std::vector < DtGeometrySpecification >	myGeometrySpecifications

DtGlBuffer *	myGpuGeometrySpecificationsBuffer

std::vector < DrawElementsIndirectBindlessCommandNV >	myBindlessIndexAndVertexBuffers

DtGlBuffer *	myBindlessIndexAndVertexBuffersBuffer

DtGlBuffer *	myGpuMaterialsBuffer

DtIndirectMaterialVector	myMaterials

DtGlBuffer *	myGpuTexturesBuffer

DtIndirectCullProgram *	myCullProgram

const DtCullShaderConfig	myCullShaderConfig

std::vector < InstancesOffsetAndNumOfInstances >	myInstancesOffsetAndNumInstances

DtGlBuffer *	myGpuInstancesOffsetAndNumInstancesBuffer

unsigned int	myMaxNumInstancesPreCulling

unsigned int	myMaxNumInstances

unsigned int	myMaxNumLightSources

VectorStateIdOffsetAndMaxCommands	myStateIdToMaxNumCommands

DtGlBuffer *	myGpuStateIdToMaxNumCommandsBuffer

DtGlBuffer *	myGpuStateIdToCommandCountBuffer

VectorInts	myGeomSpecIndexToCommandIndex

DtGlBuffer *	myGpuSpecIndexToCommandIndexBuffer

DtOsgLightPointManager &	myLightPointManager

DtDe &	myDe

DtFirstTextureStreamedModelAndIndexTracker	myFirstTextureStreamedModelAndIndexTracker

unsigned int	myLastNumEffectTextures

unsigned int	myLastNumUniqueGeometriesForGpuTextures

bool	myTextureUpdateDirty

DtModelIdAndStreamedBytesTracker	myMaterialBufferTracker

DtModelIdAndStreamedBytesTracker	mySpecBufferTracker

int	myStreamedGeometryOffsetIdx

int	myNumGeometries

CameraSet	myModelIdsToNumInstancesChanged

DtCoreGlBufferCreator &	myDtCoreGlBufferCreator

DtIndirectEffectTexturesTemplate	myCurrentEffectTextureState

std::string	myName

DtIndirectClearBufferProgram *	myClearBufferProgram

std::unordered_set < DtIndirectModelInfo * >	myModelsBeingUsed

DtGlDeleteObjectManager &	myGlDeleteObjectManager

std::unordered_set < DtIndirectGlTextureObject * >	myIndirectTexturesBeingUsed

DtIndirectGlTextureObjectManager &	myIndirectGlTextureObjectManager

DtThreadCameraStreamDataManager &	myTcsDataManager

DtGpuCullingTcsUserDataCreator &	myUserDataCreator

Static Protected Attributes
static const int	theGpuOutputInstanceBufferIndex

static const int	theGpuOutputInstanceOffsetInPerInstanceDataBufferIndex

static const int	theGpuOutputInstanceBufferDebugIndex

static std::thread::id	theMainThreadId

Private Member Functions
	DtGpuCulling ()=delete

	DtGpuCulling (const DtGpuCulling &other)=delete

DtGpuCulling &	operator= (const DtGpuCulling &other)=delete

Member Typedef Documentation

typedef std::vector<StateIdOffsetAndMaxCommands> makVrv::DtGpuCulling::VectorStateIdOffsetAndMaxCommands

typedef std::set<osg::observer_ptr<const osg::Camera> > makVrv::DtGpuCulling::CameraSet

Constructor & Destructor Documentation

virtual makVrv::DtGpuCulling::~DtGpuCulling ( )

virtual

destructor

makVrv::DtGpuCulling::DtGpuCulling	(	DtDe &	de,
		DtInstanceContainer &	container,
		const DtCullShaderConfig &
	)

protected

CTOR. only creator can create.

makVrv::DtGpuCulling::DtGpuCulling ( )

privatedelete

not allowed

makVrv::DtGpuCulling::DtGpuCulling ( const DtGpuCulling & other )

privatedelete

not allowed

Member Function Documentation

DtGpuCulling& makVrv::DtGpuCulling::operator= ( const DtGpuCulling & other )

privatedelete

not allowed

virtual void makVrv::DtGpuCulling::setRegistrar ( DtIndirectGeometryRegistrar * registrar )

virtual

set the registrar

virtual void makVrv::DtGpuCulling::setRegistrarInvalid ( void )

virtual

invalidate the registrar. happens for gs cells

virtual void makVrv::DtGpuCulling::setDebug ( bool debug )

virtual

set the compute shader to debug

virtual const DtCullShaderConfig& makVrv::DtGpuCulling::cullShaderConfig ( void ) const

virtual

get the compute shader config

virtual void makVrv::DtGpuCulling::updateGpuBuffers ( bool amortizeTextures )

virtual

updateGpuBuffers outInstanceTransformsUpdated indicates whether instance transforms that were marked dirty were sent to the GPU. This may not always happen with a call to updateGpuBuffers.

virtual void makVrv::DtGpuCulling::modelIdsToNumInstancesChanged ( void )

virtual

indicate to the culling that model ids to num instances changed so that internal maps get updated

virtual void makVrv::DtGpuCulling::updatePerInstancePerGeomBuffers	(	const MapIntToInt &	modelIdsToNumInstances,
		const osg::Camera *	camera
	)

virtual

update the buffers that are needed to be correct every frame

virtual void makVrv::DtGpuCulling::doCulling	(	const DtIndirectViewParameters &	viewParameters,
		const osg::FrameStamp *	frameStamp,
		const DtGlBuffer *	gpuLodVisibleBuffer,
		const DtGlBuffer *	gpuDofTransformBuffer,
		const DtGlBuffer *	gpuSwitchStateBuffer,
		const DtGlBuffer *	gpuPerInstanceDataBuffer,
		const osg::Camera *	camera,
		bool &	outputInstanceBufferChanged
	)

virtual

Do the culling (view frustum, lod, switch)

Parameters

outputInstanceBufferChanged indicates whether output instance buffers that get get bound were determined to need resize and were resized, and because of that the gpu address also likely changed (which should trigger an external re-generation of the vao which uses these)

static bool makVrv::DtGpuCulling::setUpOutputFormatAndBindings ( )

static

bind the output instance buffer

static void makVrv::DtGpuCulling::unsetUpOutputFormatAndBindings ( )

static

unbind the output instance buffer format and bindings

virtual bool makVrv::DtGpuCulling::bindGpuOutputInstanceBuffersWithAddressRange ( const osg::Camera * camera ) const

virtual

For bindless, bind the output buffers from the culling with buffer address range This is because in bindless, the main buffers are via indirect bindless call (which is internally a buffer address range bind). You can't mix and match regular buffer binds and vertex buffer unified memory style (buffer address range)

virtual bool makVrv::DtGpuCulling::bindCommandBufferAndSsbos	(	const DtGlBuffer *	gpuDofTransformBuffer,
		const DtGlBuffer *	gpuDofModelScaleBuffer,
		const DtGlBuffer *	gpuUvOffsetBuffer,
		const DtGlBuffer *	gpuPerInstanceDataBuffer,
		const osg::Camera *	camera
	)

virtual

bind the indirect command buffer and the count buffer returns false if handle is 0. Can happen if the buffer hasn't been re-created yet (e.g. when the context is deleted and recreated), depending on the job/frame syc this can happen a few frames later

virtual void makVrv::DtGpuCulling::unbindCommandBufferAndSsbos ( const osg::Camera * camera )

virtual

unbind the indirect command buffer and the count buffer

virtual void makVrv::DtGpuCulling::bindGpuOutputInstanceBufferDebug ( const osg::Camera * camera ) const

virtual

Bind the buffer containing the output instances of the cull shader with debugging. This is the buffer representing the non-switched otu & non-loded out instances (all non view frustum culled instances).

virtual void makVrv::DtGpuCulling::unbindGpuOutputInstanceBufferDebug ( const osg::Camera * camera ) const

virtual

Unbind the buffer containing the output instances of the cull shader with debugging.

virtual bool makVrv::DtGpuCulling::bindIndirectThingsDebug	(	const DtGlBuffer *	gpuDofTransformBuffer,
		const osg::Camera *	camera
	)

virtual

bind the debug indirect command buffer, dof transform buffer and the specs buffer This allows us to draw all instances that are not switched out, lod'ed out (all non view frustum culled instances)

virtual void makVrv::DtGpuCulling::unbindIndirectThingsDebug ( const osg::Camera * camera )

virtual

unbind the debug indirect command buffer, dof transform buffer and the specs buffer

virtual bool makVrv::DtGpuCulling::useInstanceCount ( void ) const

virtual

whether we are optimizing for shared models (useInstanceCount()=true) or unique models (useInstanceCount()=false), across instances

virtual int makVrv::DtGpuCulling::numDrawCommands ( const osg::Camera * camera ) const

virtual

The number of draw commands generated. Is a value between [0, DtIndirectGeoUtils::getMaxDrawCountNoCullingNoLod()], inclusive.

virtual void makVrv::DtGpuCulling::releaseGLObjects ( void )

virtual

release the GL objects for the GpuCulling compute shader

virtual void makVrv::DtGpuCulling::reloadShaders ( ) const

virtual

destroy the cull program and shader if they exists so they can be recreated next frame.

virtual bool makVrv::DtGpuCulling::buffersInitializedForCamera ( const osg::Camera * camera ) const

virtual

check to see if the buffers for this camera have been initialized.

virtual unsigned int makVrv::DtGpuCulling::maxNumInstances ( void ) const

virtual

get the max number of instances that can possibly be rendered if none are culled out.

virtual const VectorStateIdOffsetAndMaxCommands& makVrv::DtGpuCulling::stateIdOffsetAndMaxCommands ( void ) const

virtual

get the map of the state id to their offset/number

virtual const std::vector<InstancesOffsetAndNumOfInstances>& makVrv::DtGpuCulling::instancesOffsetAndNumInstances ( void ) const

virtual

access the instances offset and num of instances map

virtual bool makVrv::DtGpuCulling::readyToUpdateAndGpuBuffersNeedUpdate ( ) const

virtual

helper function to decide if a job should be launched

virtual bool makVrv::DtGpuCulling::gpuBuffersNeedUpdate ( ) const

virtual

is anything in the buffers dirty?

virtual bool makVrv::DtGpuCulling::textureUpdateDirty ( ) const

virtual

are there textures that still need updating.

virtual void makVrv::DtGpuCulling::setTextureUpdateDirty ( bool flag )

virtual

inform that textures are dirty

virtual bool makVrv::DtGpuCulling::perGeomInstanceDataDirty ( ) const

virtual

is per geom instance data dirty?

virtual void makVrv::DtGpuCulling::setPerGeomInstanceDataDirty ( bool flag )

virtual

set the per geom instance data dirty

virtual bool makVrv::DtGpuCulling::instancesInvalidatedDirty ( ) const

virtual

were any instances invalidated?

virtual void makVrv::DtGpuCulling::invalidateInstance	(	int	instanceId,
		int	offset,
		int	size
	)

virtual

invalidate an instance

virtual const DtGlBuffer* makVrv::DtGpuCulling::gpuInputPerGeomInstancesBuffer ( void ) const

virtual

Accessor for the gpu per geom instances buffer.

virtual const DtGlBuffer* makVrv::DtGpuCulling::gpuMaterialsBuffer ( ) const

virtual

Accessor for the gpu materials buffer.

virtual void makVrv::DtGpuCulling::fillOutputInstances	(	std::vector< DtVector4< int > > &	outputInstances,
		const osg::Camera *	camera
	)		const

virtual

For debugging. Get the values of the output instances computed by the compute shader.

virtual const DtIndirectEffectTexturesTemplate& makVrv::DtGpuCulling::currentEffectTexturesState ( ) const

virtual

get the current effect texture state as it was after the last time the textures were sent down

virtual void makVrv::DtGpuCulling::setName ( const std::string & name )

virtual

set a name on this (useful for debugging)

virtual const std::string& makVrv::DtGpuCulling::name ( void ) const

virtual

get the name on this (useful for debugging)

virtual void makVrv::DtGpuCulling::updateGpuInputPerGeomInstancesBufferByInvalidating ( )

protectedvirtual