helios::OptiX8Backend Class Reference

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) 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 507 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 1155 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 139 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 1080 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 1054 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 939 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 807 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 748 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 1006 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 1242 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 233 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 663 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 315 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 519 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  )

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 703 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 598 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 1186 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 1170 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 1217 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 1227 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 1142 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 1202 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 1103 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 1134 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