OptiX 6.5 implementation of the ray tracing backend. More...

#include <OptiX6Backend.h>

Inheritance diagram for helios::OptiX6Backend:

Public Member Functions
void	initialize () override
	Initialize the ray tracing backend.

void	shutdown () override
	Shutdown the ray tracing backend.

void	updateGeometry (const RayTracingGeometry &geometry) override
	Update geometry data in the ray tracing backend.

void	buildAccelerationStructure () override
	Build or rebuild the acceleration structure.

void	updateMaterials (const RayTracingMaterial &materials) override
	Update material properties (reflectivity, transmissivity, specular)

void	updateSources (const std::vector< RayTracingSource > &sources) override
	Update radiation source definitions.

void	updateDiffuseRadiation (const std::vector< float > &flux, const std::vector< float > &extinction, const std::vector< helios::vec3 > &peak_dir, const std::vector< float > &dist_norm, const std::vector< float > &sky_energy) override
	Update diffuse (ambient) radiation parameters.

void	updateSkyModel (const std::vector< helios::vec4 > &sky_radiance_params, const std::vector< float > &camera_sky_radiance, const helios::vec3 &sun_direction, const std::vector< float > &solar_disk_radiance, float solar_disk_cos_angle) override
	Update sky radiance model parameters (for camera rendering)

void	launchDirectRays (const RayTracingLaunchParams &params) override
	Launch direct (unscattered) rays to radiation sources.

void	launchDiffuseRays (const RayTracingLaunchParams &params) override
	Launch diffuse (hemispherically-distributed) rays.

void	launchCameraRays (const RayTracingLaunchParams &params) override
	Launch camera rays for image rendering.

void	launchPixelLabelRays (const RayTracingLaunchParams &params) override
	Launch pixel labeling rays (for primitive identification in images)

void	getRadiationResults (RayTracingResults &results) override
	Get radiation simulation results.

void	getCameraResults (std::vector< float > &pixel_data, std::vector< uint > &pixel_labels, std::vector< float > &pixel_depths, uint camera_id, const helios::int2 &resolution) override
	Get camera rendering results.

void	zeroRadiationBuffers (size_t launch_band_count) override
	Zero all radiation result buffers (radiation_in, radiation_out, radiation_specular)

void	zeroScatterBuffers () override
	Zero scatter buffers (scatter_buff_top, scatter_buff_bottom)

void	zeroCameraPixelBuffers (const helios::int2 &resolution) override
	Zero camera pixel label and depth buffers.

void	copyScatterToRadiation () override
	Copy scatter buffer contents to radiation buffers.

void	uploadRadiationOut (const std::vector< float > &radiation_out_top, const std::vector< float > &radiation_out_bottom) override
	Upload radiation_out buffers directly (without launching rays)

void	uploadCameraScatterBuffers (const std::vector< float > &scatter_top_cam, const std::vector< float > &scatter_bottom_cam) override
	Upload camera scatter buffers.

void	zeroCameraScatterBuffers (size_t launch_band_count) override
	Zero camera scatter buffers (scatter_buff_top_cam, scatter_buff_bottom_cam)

void	uploadSourceFluxes (const std::vector< float > &fluxes) override
	Upload source flux values for launched bands.

void	uploadSourceFluxesCam (const std::vector< float > &fluxes_cam) override
	Upload camera-weighted source flux values for specular reflection.

void	queryGPUMemory () const override
	Query and report GPU memory usage.

std::string	getBackendName () const override
	Get the name of the backend implementation.

Static Public Member Functions
static bool	probe () noexcept
	Probe whether OptiX 6.5 can create a context.

Static Public Member Functions inherited from helios::RayTracingBackend
static std::unique_ptr< RayTracingBackend >	create (const std::string &backend_type)
	Create a ray tracing backend instance.

Detailed Description

OptiX 6.5 implementation of the ray tracing backend.

This backend wraps the existing OptiX 6.5 code from RadiationModel, providing the same functionality through the RayTracingBackend interface.

Definition at line 56 of file OptiX6Backend.h.

Constructor & Destructor Documentation

◆ OptiX6Backend()

OptiX6Backend::OptiX6Backend ( )

Definition at line 26 of file OptiX6Backend.cpp.

◆ ~OptiX6Backend()

OptiX6Backend::~OptiX6Backend ( )

override

Definition at line 48 of file OptiX6Backend.cpp.

Member Function Documentation

◆ buildAccelerationStructure()

void OptiX6Backend::buildAccelerationStructure ( )

overridevirtual

Build or rebuild the acceleration structure.

Constructs the BVH or other acceleration structure for efficient ray traversal. Should be called after updateGeometry() or when geometry changes.

Implements helios::RayTracingBackend.

Definition at line 504 of file OptiX6Backend.cpp.

◆ copyScatterToRadiation()

void OptiX6Backend::copyScatterToRadiation ( )

overridevirtual

Copy scatter buffer contents to radiation buffers.

Used for multi-bounce radiation: scattering iteration results are accumulated into the main radiation buffers.

Implements helios::RayTracingBackend.

Definition at line 895 of file OptiX6Backend.cpp.

◆ getBackendName()

std::string OptiX6Backend::getBackendName ( ) const

overridevirtual

Get the name of the backend implementation.

Returns: Backend name (e.g., "OptiX 6.5", "OptiX 7.7", "Vulkan")

Implements helios::RayTracingBackend.

Definition at line 960 of file OptiX6Backend.cpp.

◆ getCameraResults()

void OptiX6Backend::getCameraResults	(	std::vector< float > &	pixel_data,
		std::vector< uint > &	pixel_labels,
		std::vector< float > &	pixel_depths,
		uint	camera_id,
		const helios::int2 &	resolution
	)

overridevirtual

Get camera rendering results.

Parameters

[out]	pixel_data	Flattened pixel values [band][pixel_y][pixel_x]
[out]	pixel_labels	Primitive UUID for each pixel (0 if sky/miss)
[out]	pixel_depths	Depth value for each pixel
[in]	camera_id	Camera identifier
[in]	resolution	Camera resolution (width, height)

Implements helios::RayTracingBackend.

Definition at line 790 of file OptiX6Backend.cpp.

◆ getRadiationResults()

void OptiX6Backend::getRadiationResults ( RayTracingResults & results )

overridevirtual

Get radiation simulation results.

Parameters

[out] results Structure containing radiation_in, radiation_out, scatter buffers, etc.

Retrieves absorbed and emitted radiation for all primitives and bands.

Implements helios::RayTracingBackend.

Definition at line 775 of file OptiX6Backend.cpp.

◆ initialize()

void OptiX6Backend::initialize ( )

overridevirtual

Initialize the ray tracing backend.

Creates the ray tracing context, allocates buffers, compiles/loads programs, and sets up the acceleration structure.

Implements helios::RayTracingBackend.

Definition at line 54 of file OptiX6Backend.cpp.

◆ launchCameraRays()

void OptiX6Backend::launchCameraRays ( const RayTracingLaunchParams & params )

overridevirtual

Launch camera rays for image rendering.

Parameters

[in] params Launch parameters including camera position, direction, FOV, etc.

Implements helios::RayTracingBackend.

Definition at line 697 of file OptiX6Backend.cpp.

◆ launchDiffuseRays()

void OptiX6Backend::launchDiffuseRays ( const RayTracingLaunchParams & params )

overridevirtual

Launch diffuse (hemispherically-distributed) rays.

Parameters

[in] params Launch parameters including diffuse distribution parameters

Implements helios::RayTracingBackend.

Definition at line 619 of file OptiX6Backend.cpp.

◆ launchDirectRays()

void OptiX6Backend::launchDirectRays ( const RayTracingLaunchParams & params )

overridevirtual

Launch direct (unscattered) rays to radiation sources.

Parameters

[in] params Launch parameters (dimensions, seed, band config, etc.)

Implements helios::RayTracingBackend.

Definition at line 566 of file OptiX6Backend.cpp.

◆ launchPixelLabelRays()

void OptiX6Backend::launchPixelLabelRays ( const RayTracingLaunchParams & params )

overridevirtual

Launch pixel labeling rays (for primitive identification in images)

Parameters

[in] params Launch parameters with camera configuration

Implements helios::RayTracingBackend.

Definition at line 749 of file OptiX6Backend.cpp.

◆ probe()

bool OptiX6Backend::probe ( )

staticnoexcept

Probe whether OptiX 6.5 can create a context.

Creates and immediately destroys an RTcontext. This is the lightest possible check for OptiX 6.5 since there is no equivalent to optixInit().

Returns: true if rtContextCreate succeeds

Definition at line 30 of file OptiX6Backend.cpp.

◆ queryGPUMemory()

void OptiX6Backend::queryGPUMemory ( ) const

overridevirtual

Query and report GPU memory usage.

Implements helios::RayTracingBackend.

Definition at line 947 of file OptiX6Backend.cpp.

◆ shutdown()

void OptiX6Backend::shutdown ( )

overridevirtual

Shutdown the ray tracing backend.

Destroys the context, frees all buffers and resources.

Implements helios::RayTracingBackend.

Definition at line 458 of file OptiX6Backend.cpp.

◆ updateDiffuseRadiation()

void OptiX6Backend::updateDiffuseRadiation	(	const std::vector< float > &	flux,
		const std::vector< float > &	extinction,
		const std::vector< helios::vec3 > &	peak_dir,
		const std::vector< float > &	dist_norm,
		const std::vector< float > &	sky_energy
	)

overridevirtual

Update diffuse (ambient) radiation parameters.

Parameters

[in]	flux	Diffuse flux per band
[in]	extinction	Extinction coefficient per band
[in]	peak_dir	Peak direction for diffuse distribution per band
[in]	dist_norm	Distribution normalization factor per band
[in]	sky_energy	Energy absorbed by sky per band

Implements helios::RayTracingBackend.

Definition at line 548 of file OptiX6Backend.cpp.

◆ updateGeometry()

void OptiX6Backend::updateGeometry ( const RayTracingGeometry & geometry )

overridevirtual

Update geometry data in the ray tracing backend.

Parameters

[in] geometry Geometry data for all primitive types

This uploads vertex data, transform matrices, UUIDs, texture masks, and all other geometry-related data to the GPU.

Implements helios::RayTracingBackend.

Definition at line 473 of file OptiX6Backend.cpp.

◆ updateMaterials()

void OptiX6Backend::updateMaterials ( const RayTracingMaterial & materials )

overridevirtual

Update material properties (reflectivity, transmissivity, specular)

Parameters

[in] materials Material data for all primitives, sources, and bands

Implements helios::RayTracingBackend.

Definition at line 520 of file OptiX6Backend.cpp.

◆ updateSkyModel()

void OptiX6Backend::updateSkyModel	(	const std::vector< helios::vec4 > &	sky_radiance_params,
		const std::vector< float > &	camera_sky_radiance,
		const helios::vec3 &	sun_direction,
		const std::vector< float > &	solar_disk_radiance,
		float	solar_disk_cos_angle
	)

overridevirtual

Update sky radiance model parameters (for camera rendering)

Parameters

[in]	sky_radiance_params	Prague sky model parameters per band (vec4)
[in]	camera_sky_radiance	Sky radiance for cameras per band
[in]	sun_direction	Direction to the sun
[in]	solar_disk_radiance	Solar disk radiance per band
[in]	solar_disk_cos_angle	Cosine of solar disk angular radius

Implements helios::RayTracingBackend.

Definition at line 557 of file OptiX6Backend.cpp.

◆ updateSources()

void OptiX6Backend::updateSources ( const std::vector< RayTracingSource > & sources )

overridevirtual

Update radiation source definitions.

Parameters

[in] sources Vector of radiation sources (collimated, sphere, sun, rectangle, disk)

Implements helios::RayTracingBackend.

Definition at line 536 of file OptiX6Backend.cpp.

◆ uploadCameraScatterBuffers()

void OptiX6Backend::uploadCameraScatterBuffers	(	const std::vector< float > &	scatter_top_cam,
		const std::vector< float > &	scatter_bottom_cam
	)

overridevirtual

Upload camera scatter buffers.

Parameters

[in]	scatter_top_cam	Scattered radiation for cameras (top surface) indexed by [primitive * Nbands_launch + band]
[in]	scatter_bottom_cam	Scattered radiation for cameras (bottom surface)

Used to upload emission energy that cameras should see before scatter iterations.

Implements helios::RayTracingBackend.

Definition at line 918 of file OptiX6Backend.cpp.

◆ uploadRadiationOut()

void OptiX6Backend::uploadRadiationOut	(	const std::vector< float > &	radiation_out_top,
		const std::vector< float > &	radiation_out_bottom
	)

overridevirtual

Upload radiation_out buffers directly (without launching rays)

Parameters

[in]	radiation_out_top	Top-face outgoing radiation [Nprims * Nbands]
[in]	radiation_out_bottom	Bottom-face outgoing radiation [Nprims * Nbands]

Used to set outgoing radiation for scattering iterations.

Implements helios::RayTracingBackend.

Definition at line 905 of file OptiX6Backend.cpp.

◆ uploadSourceFluxes()

void OptiX6Backend::uploadSourceFluxes ( const std::vector< float > & fluxes )

overridevirtual

Upload source flux values for launched bands.

Parameters

[in] fluxes Source flux values indexed by [source * Nbands_launch + band]

Used to set per-band source fluxes before direct ray launch.

Implements helios::RayTracingBackend.

Definition at line 931 of file OptiX6Backend.cpp.

◆ uploadSourceFluxesCam()

void OptiX6Backend::uploadSourceFluxesCam ( const std::vector< float > & fluxes_cam )

overridevirtual

Upload camera-weighted source flux values for specular reflection.

Parameters

[in] fluxes_cam Camera spectral response weights indexed by [source * Nbands_launch + band]

Uploads per-camera spectral response weights used for specular reflection in camera rendering. The weights represent ∫(source_spectrum × camera_response) / ∫(source_spectrum) for each source/band combination. Called before each camera render with the current camera's weights.

Implements helios::RayTracingBackend.

Definition at line 941 of file OptiX6Backend.cpp.

◆ zeroCameraPixelBuffers()

void OptiX6Backend::zeroCameraPixelBuffers ( const helios::int2 & resolution )

overridevirtual

Zero camera pixel label and depth buffers.

Parameters

[in] resolution Full camera resolution (width, height)

Must be called before launching pixel label rays for multiple tiles. Each tile launch accumulates results without zeroing, so this must be called once before the tile loop to initialize the buffers.

Implements helios::RayTracingBackend.

Definition at line 882 of file OptiX6Backend.cpp.

◆ zeroCameraScatterBuffers()

void OptiX6Backend::zeroCameraScatterBuffers ( size_t launch_band_count )

overridevirtual

Zero camera scatter buffers (scatter_buff_top_cam, scatter_buff_bottom_cam)

Parameters

[in] launch_band_count Number of bands being launched in current iteration

Buffers are sized by launch_band_count to prevent double-counting when accumulating camera scatter across multiple ray launches.

Implements helios::RayTracingBackend.

Definition at line 862 of file OptiX6Backend.cpp.

◆ zeroRadiationBuffers()

void OptiX6Backend::zeroRadiationBuffers ( size_t launch_band_count )

overridevirtual

Zero all radiation result buffers (radiation_in, radiation_out, radiation_specular)

Parameters

[in] launch_band_count Number of bands being launched in current iteration

Camera scatter buffers are sized by launch_band_count (not global band count) to match per-launch accumulation semantics. All other buffers use the global band count.

Implements helios::RayTracingBackend.

Definition at line 802 of file OptiX6Backend.cpp.

◆ zeroScatterBuffers()

void OptiX6Backend::zeroScatterBuffers ( )

overridevirtual

Zero scatter buffers (scatter_buff_top, scatter_buff_bottom)

Implements helios::RayTracingBackend.

Definition at line 846 of file OptiX6Backend.cpp.

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

plugins/radiation/src/backends/OptiX6Backend.h
plugins/radiation/src/backends/OptiX6Backend.cpp

	1.3.72

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ OptiX6Backend()

◆ ~OptiX6Backend()

Member Function Documentation

◆ buildAccelerationStructure()

◆ copyScatterToRadiation()

◆ getBackendName()

◆ getCameraResults()

◆ getRadiationResults()

◆ initialize()

◆ launchCameraRays()

◆ launchDiffuseRays()

◆ launchDirectRays()

◆ launchPixelLabelRays()

◆ probe()

◆ queryGPUMemory()

◆ shutdown()

◆ updateDiffuseRadiation()

◆ updateGeometry()

◆ updateMaterials()

◆ updateSkyModel()

◆ updateSources()

◆ uploadCameraScatterBuffers()

◆ uploadRadiationOut()

◆ uploadSourceFluxes()

◆ uploadSourceFluxesCam()

◆ zeroCameraPixelBuffers()

◆ zeroCameraScatterBuffers()

◆ zeroRadiationBuffers()

◆ zeroScatterBuffers()