Blender V5.3
Integrator Class Reference

#include <integrator.h>

Inherits Node.

Public Types

enum  : uint32_t { AO_PASS_MODIFIED = (1 << 0) , OBJECT_MANAGER = (1 << 1) , UPDATE_ALL = ~0u , UPDATE_NONE = 0u }

Public Member Functions

NODE_DECLARE NODE_SOCKET_API (bool, use_guiding)
 NODE_SOCKET_API (bool, deterministic_guiding)
 NODE_SOCKET_API (bool, use_surface_guiding)
 NODE_SOCKET_API (float, surface_guiding_probability)
 NODE_SOCKET_API (bool, use_volume_guiding)
 NODE_SOCKET_API (float, volume_guiding_probability)
 NODE_SOCKET_API (int, guiding_training_samples)
 NODE_SOCKET_API (bool, use_guiding_direct_light)
 NODE_SOCKET_API (bool, use_guiding_mis_weights)
 NODE_SOCKET_API (GuidingDistributionType, guiding_distribution_type)
 NODE_SOCKET_API (GuidingDirectionalSamplingType, guiding_directional_sampling_type)
 NODE_SOCKET_API (float, guiding_roughness_threshold)
 NODE_SOCKET_API (bool, use_direct_light)
 NODE_SOCKET_API (bool, use_indirect_light)
 NODE_SOCKET_API (bool, use_diffuse)
 NODE_SOCKET_API (bool, use_glossy)
 NODE_SOCKET_API (bool, use_transmission)
 NODE_SOCKET_API (bool, use_emission)
 NODE_SOCKET_API (bool, use_pixel_jitter)
 NODE_SOCKET_API (bool, use_custom_pixel_jitter_sample)
 NODE_SOCKET_API_ARRAY (array< float >, custom_pixel_jitter_sample)
 NODE_SOCKET_API (bool, use_denoise)
 NODE_SOCKET_API (DenoiserType, denoiser_type)
 NODE_SOCKET_API (int, denoise_start_sample)
 NODE_SOCKET_API (DenoiserPassMask, denoiser_passes)
 NODE_SOCKET_API (DenoiserPrefilter, denoiser_prefilter)
 NODE_SOCKET_API (bool, denoise_use_gpu)
 NODE_SOCKET_API (DenoiserQuality, denoiser_quality)
 NODE_SOCKET_API (float, denoiser_upscale_factor)
 Integrator ()
 ~Integrator () override
void device_update (Device *device, DeviceScene *dscene, Scene *scene)
void device_free (Device *device, DeviceScene *dscene, bool force_free=false)
void tag_update (Scene *scene, const uint32_t flag)
uint64_t get_kernel_features () const
AdaptiveSampling get_adaptive_sampling () const
DenoiseParams get_denoise_params () const
GuidingParams get_guiding_params (const Device *device) const
bool is_modified () const
void clear_modified ()
Public Member Functions inherited from Node
 Node (const NodeType *type, ustring name=ustring())
virtual ~Node ()=0
void set (const SocketType &input, bool value)
void set (const SocketType &input, const int value)
void set (const SocketType &input, const uint value)
void set (const SocketType &input, const uint64_t value)
void set (const SocketType &input, const float value)
void set (const SocketType &input, const float2 value)
void set (const SocketType &input, const float3 value)
void set (const SocketType &input, const char *value)
void set (const SocketType &input, ustring value)
void set (const SocketType &input, const Transform &value)
void set (const SocketType &input, Node *value)
template<class ValueType, std::enable_if_t< std::is_enum_v< ValueType >, bool > = true>
void set (const SocketType &input, const ValueType &value)
void set (const SocketType &input, array< bool > &value)
void set (const SocketType &input, array< int > &value)
void set (const SocketType &input, array< float > &value)
void set (const SocketType &input, array< float2 > &value)
void set (const SocketType &input, array< packed_float3 > &value)
void set (const SocketType &input, array< ustring > &value)
void set (const SocketType &input, array< Transform > &value)
void set (const SocketType &input, array< Node * > &value)
bool get_bool (const SocketType &input) const
int get_int (const SocketType &input) const
uint get_uint (const SocketType &input) const
uint64_t get_uint64 (const SocketType &input) const
float get_float (const SocketType &input) const
float2 get_float2 (const SocketType &input) const
float3 get_float3 (const SocketType &input) const
ustring get_string (const SocketType &input) const
Transform get_transform (const SocketType &input) const
Node * get_node (const SocketType &input) const
const array< bool > & get_bool_array (const SocketType &input) const
const array< int > & get_int_array (const SocketType &input) const
const array< float > & get_float_array (const SocketType &input) const
const array< float2 > & get_float2_array (const SocketType &input) const
const array< packed_float3 > & get_float3_array (const SocketType &input) const
const array< ustring > & get_string_array (const SocketType &input) const
const array< Transform > & get_transform_array (const SocketType &input) const
const array< Node * > & get_node_array (const SocketType &input) const
bool has_default_value (const SocketType &input) const
void set_default_value (const SocketType &input)
bool equals_value (const Node &other, const SocketType &socket) const
void copy_value (const SocketType &socket, const Node &other, const SocketType &other_socket)
void set_value (const SocketType &socket, const Node &other, const SocketType &other_socket)
bool equals (const Node &other) const
void hash (MD5Hash &md5)
size_t get_total_size_in_bytes () const
bool is_a (const NodeType *type)
bool socket_is_modified (const SocketType &input) const
bool is_modified () const
void tag_modified ()
void clear_modified ()
void print_modified_sockets () const
const NodeOwner * get_owner () const
void set_owner (const NodeOwner *owner_)
int reference_count () const
void reference ()
void dereference ()
void clear_reference_count ()

Public Attributes

HaltonSequence pixel_jitter_state
int pixel_jitter_frame = 0
bool shadow_catcher_needs_recalc_ = true
bool scene_has_shadow_catcher_ = false
Public Attributes inherited from Node
ustring name
const NodeType * type
InternalNode internal
LeafNode leaf

Static Public Attributes

static const int MAX_SAMPLES = (1 << 24)

Additional Inherited Members

Protected Member Functions inherited from Node
template<typename T>
void set_if_different (const SocketType &input, T value)
void set_if_different (const SocketType &input, Node *value)
template<typename T>
void set_if_different (const SocketType &input, array< T > &value)
void set_if_different (const SocketType &input, array< Node * > &value)
void dereference_all_used_nodes ()
Static Protected Member Functions inherited from Node
template<typename T>
static T & get_socket_value (const Node *node, const SocketType &socket)
Protected Attributes inherited from Node
const NodeOwner * owner
int ref_count {0}
SocketModifiedFlags socket_modified

Detailed Description

Definition at line 39 of file integrator.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum : uint32_t
Enumerator
AO_PASS_MODIFIED 
OBJECT_MANAGER 
UPDATE_ALL 
UPDATE_NONE 

Definition at line 132 of file integrator.h.

Constructor & Destructor Documentation

◆ Integrator()

Integrator::Integrator ( )

Definition at line 199 of file integrator.cpp.

References Node::Node().

◆ ~Integrator()

Member Function Documentation

◆ clear_modified()

void Integrator::clear_modified ( )

Definition at line 429 of file integrator.cpp.

References Node::clear_modified(), and shadow_catcher_needs_recalc_.

Referenced by device_update(), and ~Integrator().

◆ device_free()

void Integrator::device_free ( Device * device,
DeviceScene * dscene,
bool force_free = false )

◆ device_update()

void Integrator::device_update ( Device * device,
DeviceScene * dscene,
Scene * scene )

Definition at line 203 of file integrator.cpp.

References HaltonSequence::a2, HaltonSequence::a3, device_vector< T >::alloc(), Scene::bake_manager, clamp(), device_vector< T >::clear_modified(), clear_modified(), device_vector< T >::copy_to_device(), DeviceScene::data, DENOISER_DLSS, device_free(), DIRECT_LIGHT_SAMPLING_MIS, Scene::film, FILTER_CLOSURE_DIFFUSE, FILTER_CLOSURE_DIRECT_LIGHT, FILTER_CLOSURE_EMISSION, FILTER_CLOSURE_GLOSSY, FILTER_CLOSURE_TRANSMISSION, FILTER_CLOSURE_TRANSPARENT, FLT_MAX, device_vector< T >::free(), get_guiding_params(), Scene::has_shadow_catcher(), Shader::has_surface_transparent, Shader::has_volume, hash_uint(), hash_uint2(), hash_uint3(), is_modified(), is_power_of_two(), make_float2, MAX_SAMPLES, MAX_TAB_SOBOL_SAMPLES, min, MIN_TAB_SOBOL_SAMPLES, HaltonSequence::next(), next_power_of_two(), NUM_TAB_SOBOL_DIMENSIONS, NUM_TAB_SOBOL_PATTERNS, pixel_jitter_frame, pixel_jitter_state, TaskPool::push(), Node::reference_count(), HaltonSequence::reset(), reverse_integer_bits(), GuidingParams::roughness_threshold, DeviceScene::sample_pattern_lut, SAMPLING_PATTERN_BLUE_NOISE_FIRST, SAMPLING_PATTERN_BLUE_NOISE_PURE, SAMPLING_PATTERN_BLUE_NOISE_ROUND, SAMPLING_PATTERN_TABULATED_SOBOL, GuidingParams::sampling_type, scene_has_shadow_catcher_, Scene::shaders, device_vector< T >::size(), tabulated_sobol_generate_4D(), GuidingParams::type, Scene::update_stats, GuidingParams::use, GuidingParams::use_surface_guiding, GuidingParams::use_volume_guiding, and TaskPool::wait_work().

Referenced by Scene::device_update(), Scene::update_camera_resolution(), and ~Integrator().

◆ get_adaptive_sampling()

◆ get_denoise_params()

◆ get_guiding_params()

◆ get_kernel_features()

uint64_t Integrator::get_kernel_features ( ) const

◆ is_modified()

bool Integrator::is_modified ( ) const

◆ NODE_SOCKET_API() [1/28]

Integrator::NODE_SOCKET_API ( bool ,
denoise_use_gpu  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [2/28]

Integrator::NODE_SOCKET_API ( bool ,
deterministic_guiding  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [3/28]

Integrator::NODE_SOCKET_API ( bool ,
use_custom_pixel_jitter_sample  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [4/28]

Integrator::NODE_SOCKET_API ( bool ,
use_denoise  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [5/28]

Integrator::NODE_SOCKET_API ( bool ,
use_diffuse  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [6/28]

Integrator::NODE_SOCKET_API ( bool ,
use_direct_light  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [7/28]

Integrator::NODE_SOCKET_API ( bool ,
use_emission  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [8/28]

Integrator::NODE_SOCKET_API ( bool ,
use_glossy  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [9/28]

◆ NODE_SOCKET_API() [10/28]

Integrator::NODE_SOCKET_API ( bool ,
use_guiding_direct_light  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [11/28]

Integrator::NODE_SOCKET_API ( bool ,
use_guiding_mis_weights  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [12/28]

Integrator::NODE_SOCKET_API ( bool ,
use_indirect_light  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [13/28]

Integrator::NODE_SOCKET_API ( bool ,
use_pixel_jitter  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [14/28]

Integrator::NODE_SOCKET_API ( bool ,
use_surface_guiding  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [15/28]

Integrator::NODE_SOCKET_API ( bool ,
use_transmission  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [16/28]

Integrator::NODE_SOCKET_API ( bool ,
use_volume_guiding  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [17/28]

Integrator::NODE_SOCKET_API ( DenoiserPassMask ,
denoiser_passes  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [18/28]

Integrator::NODE_SOCKET_API ( DenoiserPrefilter ,
denoiser_prefilter  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [19/28]

Integrator::NODE_SOCKET_API ( DenoiserQuality ,
denoiser_quality  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [20/28]

Integrator::NODE_SOCKET_API ( DenoiserType ,
denoiser_type  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [21/28]

Integrator::NODE_SOCKET_API ( float ,
denoiser_upscale_factor  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [22/28]

Integrator::NODE_SOCKET_API ( float ,
guiding_roughness_threshold  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [23/28]

Integrator::NODE_SOCKET_API ( float ,
surface_guiding_probability  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [24/28]

Integrator::NODE_SOCKET_API ( float ,
volume_guiding_probability  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [25/28]

Integrator::NODE_SOCKET_API ( GuidingDirectionalSamplingType ,
guiding_directional_sampling_type  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [26/28]

Integrator::NODE_SOCKET_API ( GuidingDistributionType ,
guiding_distribution_type  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [27/28]

Integrator::NODE_SOCKET_API ( int ,
denoise_start_sample  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API() [28/28]

Integrator::NODE_SOCKET_API ( int ,
guiding_training_samples  )

References NODE_SOCKET_API().

◆ NODE_SOCKET_API_ARRAY()

Integrator::NODE_SOCKET_API_ARRAY ( array< float > ,
custom_pixel_jitter_sample  )

◆ tag_update()

Member Data Documentation

◆ MAX_SAMPLES

◆ pixel_jitter_frame

int Integrator::pixel_jitter_frame = 0

Definition at line 121 of file integrator.h.

Referenced by device_update().

◆ pixel_jitter_state

HaltonSequence Integrator::pixel_jitter_state

Definition at line 120 of file integrator.h.

Referenced by device_update().

◆ scene_has_shadow_catcher_

bool Integrator::scene_has_shadow_catcher_ = false

Definition at line 143 of file integrator.h.

Referenced by device_update(), and get_denoise_params().

◆ shadow_catcher_needs_recalc_

bool Integrator::shadow_catcher_needs_recalc_ = true

Definition at line 142 of file integrator.h.

Referenced by clear_modified(), is_modified(), and tag_update().


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