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

#include <OptiX8Backend.h>

Inheritance diagram for helios::OptiX8Backend:

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, const std::vector< float > &camera_diffuse_flux, const std::vector< uint32_t > &band_emission_flag) 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
	Lightweight probe to check if OptiX 8 hardware is available.

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 8.1 implementation of the ray tracing backend.

Uses the modern OptiX 8 pipeline/SBT model. Compatible with NVIDIA drivers >= 560 (required for OptiX 8.0+). Automatically selected when HELIOS_HAVE_OPTIX8 is defined at compile time.

Architecture:

Single GAS with 6 AABB custom intersection programs (one per primitive type)
Single pipeline: 4 raygen + 4 closesthit + 4 miss + 6 intersection programs
Launch params struct passed to optixLaunch for all data sharing
PerRayData via pointer-in-two-payload-registers pattern

Definition at line 71 of file OptiX8Backend.h.

Constructor & Destructor Documentation

◆ ~OptiX8Backend()

helios::OptiX8Backend::~OptiX8Backend ( )

override

Definition at line 49 of file OptiX8Backend.cpp.

Member Function Documentation

◆ buildAccelerationStructure()

void helios::OptiX8Backend::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 511 of file OptiX8Backend.cpp.

◆ copyScatterToRadiation()

void helios::OptiX8Backend::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 1205 of file OptiX8Backend.cpp.

◆ getBackendName()

std::string helios::OptiX8Backend::getBackendName ( ) const

inlineoverridevirtual

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 141 of file OptiX8Backend.h.

◆ getCameraResults()

void helios::OptiX8Backend::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 1130 of file OptiX8Backend.cpp.

◆ getRadiationResults()

void helios::OptiX8Backend::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 1104 of file OptiX8Backend.cpp.

◆ initialize()

void helios::OptiX8Backend::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 59 of file OptiX8Backend.cpp.

◆ launchCameraRays()

void helios::OptiX8Backend::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 989 of file OptiX8Backend.cpp.

◆ launchDiffuseRays()

void helios::OptiX8Backend::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 857 of file OptiX8Backend.cpp.

◆ launchDirectRays()

void helios::OptiX8Backend::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 798 of file OptiX8Backend.cpp.

◆ launchPixelLabelRays()

void helios::OptiX8Backend::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 1056 of file OptiX8Backend.cpp.

◆ probe()

bool helios::OptiX8Backend::probe ( )

staticnoexcept

Lightweight probe to check if OptiX 8 hardware is available.

Checks CUDA device availability and OptiX driver initialization without allocating persistent GPU resources.

Returns: true if a CUDA device exists and optixInit() succeeds

Definition at line 35 of file OptiX8Backend.cpp.

◆ queryGPUMemory()

void helios::OptiX8Backend::queryGPUMemory ( ) const

overridevirtual

Query and report GPU memory usage.

Implements helios::RayTracingBackend.

Definition at line 1295 of file OptiX8Backend.cpp.

◆ shutdown()

void helios::OptiX8Backend::shutdown ( )

overridevirtual

Shutdown the ray tracing backend.

Destroys the context, frees all buffers and resources.

Implements helios::RayTracingBackend.

Definition at line 235 of file OptiX8Backend.cpp.

◆ updateDiffuseRadiation()

void helios::OptiX8Backend::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 689 of file OptiX8Backend.cpp.

◆ updateGeometry()

void helios::OptiX8Backend::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 319 of file OptiX8Backend.cpp.

◆ updateMaterials()

void helios::OptiX8Backend::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 523 of file OptiX8Backend.cpp.

◆ updateSkyModel()

void helios::OptiX8Backend::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,
		const std::vector< float > &	camera_diffuse_flux,
		const std::vector< uint32_t > &	band_emission_flag
	)

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
[in]	camera_diffuse_flux	Diffuse (hemispherical) sky flux per band, sampled by cameras when band_emission_flag[b] is true. Allows cameras to see isotropic sky longwave/thermal emission.
[in]	band_emission_flag	Per-band flag (1 = emission enabled, 0 = disabled). Gates whether cameras add the isotropic sky-emission contribution from camera_diffuse_flux on a ray miss.

Implements helios::RayTracingBackend.

Definition at line 729 of file OptiX8Backend.cpp.

◆ updateSources()

void helios::OptiX8Backend::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 624 of file OptiX8Backend.cpp.

◆ uploadCameraScatterBuffers()

void helios::OptiX8Backend::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 1236 of file OptiX8Backend.cpp.

◆ uploadRadiationOut()

void helios::OptiX8Backend::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 1220 of file OptiX8Backend.cpp.

◆ uploadSourceFluxes()

void helios::OptiX8Backend::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 1267 of file OptiX8Backend.cpp.

◆ uploadSourceFluxesCam()

void helios::OptiX8Backend::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 1279 of file OptiX8Backend.cpp.

◆ zeroCameraPixelBuffers()

void helios::OptiX8Backend::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 1192 of file OptiX8Backend.cpp.

◆ zeroCameraScatterBuffers()

void helios::OptiX8Backend::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 1252 of file OptiX8Backend.cpp.

◆ zeroRadiationBuffers()

void helios::OptiX8Backend::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 1153 of file OptiX8Backend.cpp.

◆ zeroScatterBuffers()

void helios::OptiX8Backend::zeroScatterBuffers ( )

overridevirtual

Zero scatter buffers (scatter_buff_top, scatter_buff_bottom)

Implements helios::RayTracingBackend.

Definition at line 1184 of file OptiX8Backend.cpp.

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

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

	1.3.77

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~OptiX8Backend()

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()