Blender V5.3
blender::eevee::Sampling Class Reference

#include <eevee_sampling.hh>

Public Member Functions

 Sampling (Instance &inst, ClampData &clamp_data)
 ~Sampling ()
template<typename PassType>
void bind_resources (PassType &pass)
float rng_get (eSamplingDimension dimension) const
float2 rng_2d_get (eSamplingDimension starting_dimension) const
float3 rng_3d_get (eSamplingDimension starting_dimension) const
bool finished () const
bool finished_viewport () const
bool interactive_mode () const
uint64_t sample_count () const
uint64_t sample_index () const
bool use_custom_pixel_jitter_sample () const
bool use_clamp_direct () const
bool use_clamp_indirect () const
bool use_direct_scale () const
float direct_scale () const
bool use_indirect_scale () const
float indirect_scale () const
bool do_render_sync () const
uint64_t dof_ring_count_get () const
uint64_t dof_sample_count_get () const

Static Public Member Functions

Cumulative Distribution Function (CDF)
static void cdf_from_curvemapping (const CurveMapping &curve, Vector< float > &cdf)
static void cdf_invert (Vector< float > &cdf, Vector< float > &inverted_cdf)

Sampling

void init (const Scene *scene)
void init (const Object &probe_object)
void end_sync ()
void step ()
void reset ()
bool is_reset () const
void update_time ()

Sampling patterns

void dof_disk_sample_get (float *r_radius, float *r_theta) const
static float3 sample_ball (const float3 &rand)
static float2 sample_disk (const float2 &rand)
static float3 sample_hemisphere (const float2 &rand)
static float3 sample_sphere (const float2 &rand)
static float2 sample_spiral (const float2 &rand)

Detailed Description

Definition at line 25 of file eevee_sampling.hh.

Constructor & Destructor Documentation

◆ Sampling()

blender::eevee::Sampling::Sampling ( Instance & inst,
ClampData & clamp_data )
inline

Definition at line 86 of file eevee_sampling.hh.

◆ ~Sampling()

blender::eevee::Sampling::~Sampling ( )
inline

Definition at line 87 of file eevee_sampling.hh.

Member Function Documentation

◆ bind_resources()

template<typename PassType>
void blender::eevee::Sampling::bind_resources ( PassType & pass)
inline

Definition at line 101 of file eevee_sampling.hh.

References SAMPLING_BUF_SLOT.

◆ cdf_from_curvemapping()

void blender::eevee::Sampling::cdf_from_curvemapping ( const CurveMapping & curve,
Vector< float > & cdf )
static

Creates a discrete cumulative distribution function table from a given curvemapping. Output cdf vector is expected to already be sized according to the wanted resolution.

Definition at line 427 of file eevee_sampling.cc.

References blender::BKE_curvemapping_evaluateF(), blender::BLI_assert(), float, blender::Vector< T, InlineBufferCapacity, Allocator >::index_range(), blender::IndexRange::IndexRange(), blender::Vector< T, InlineBufferCapacity, Allocator >::last(), blender::Vector< T, InlineBufferCapacity, Allocator >::size(), and blender::x.

Referenced by blender::eevee::MotionBlurModule::init().

◆ cdf_invert()

void blender::eevee::Sampling::cdf_invert ( Vector< float > & cdf,
Vector< float > & inverted_cdf )
static

◆ direct_scale()

float blender::eevee::Sampling::direct_scale ( ) const
inline

Definition at line 186 of file eevee_sampling.hh.

◆ do_render_sync()

bool blender::eevee::Sampling::do_render_sync ( ) const
inline

Definition at line 203 of file eevee_sampling.hh.

◆ dof_disk_sample_get()

void blender::eevee::Sampling::dof_disk_sample_get ( float * r_radius,
float * r_theta ) const

Special RNG for depth of field. Returns radius and theta angle offset to apply to the web sampling pattern.

Definition at line 386 of file eevee_sampling.cc.

References float, and M_PI.

◆ dof_ring_count_get()

uint64_t blender::eevee::Sampling::dof_ring_count_get ( ) const
inline

Returns sample count inside the jittered depth of field web pattern.

Definition at line 255 of file eevee_sampling.hh.

◆ dof_sample_count_get()

uint64_t blender::eevee::Sampling::dof_sample_count_get ( ) const
inline

Returns sample count inside the jittered depth of field web pattern.

Definition at line 263 of file eevee_sampling.hh.

◆ end_sync()

void blender::eevee::Sampling::end_sync ( )

◆ finished()

bool blender::eevee::Sampling::finished ( ) const
inline

◆ finished_viewport()

bool blender::eevee::Sampling::finished_viewport ( ) const
inline

◆ indirect_scale()

float blender::eevee::Sampling::indirect_scale ( ) const
inline

Definition at line 196 of file eevee_sampling.hh.

◆ init() [1/2]

void blender::eevee::Sampling::init ( const Object & probe_object)

◆ init() [2/2]

◆ interactive_mode()

bool blender::eevee::Sampling::interactive_mode ( ) const
inline

Definition at line 144 of file eevee_sampling.hh.

Referenced by step().

◆ is_reset()

bool blender::eevee::Sampling::is_reset ( ) const

Definition at line 327 of file eevee_sampling.cc.

References blender::BLI_assert().

◆ reset()

void blender::eevee::Sampling::reset ( )

◆ rng_2d_get()

float2 blender::eevee::Sampling::rng_2d_get ( eSamplingDimension starting_dimension) const
inline

Definition at line 117 of file eevee_sampling.hh.

◆ rng_3d_get()

float3 blender::eevee::Sampling::rng_3d_get ( eSamplingDimension starting_dimension) const
inline

Definition at line 125 of file eevee_sampling.hh.

◆ rng_get()

float blender::eevee::Sampling::rng_get ( eSamplingDimension dimension) const
inline

Definition at line 109 of file eevee_sampling.hh.

◆ sample_ball()

float3 blender::eevee::Sampling::sample_ball ( const float3 & rand)
static

Special ball distribution: Point are distributed in a way that when they are orthogonally projected into any plane, the resulting distribution is (close to) a uniform disc distribution. rand is 3 random float in the [0..1] range. Returns point in a ball of radius 1 and centered on the origin.

Definition at line 339 of file eevee_sampling.cc.

References cosf, fmaxf, M_PI, sample, sinf, sqrtf, and blender::square_f().

◆ sample_count()

uint64_t blender::eevee::Sampling::sample_count ( ) const
inline

◆ sample_disk()

float2 blender::eevee::Sampling::sample_disk ( const float2 & rand)
static

Uniform disc distribution. rand is 2 random float in the [0..1] range. Returns point in a disk of radius 1 and centered on the origin.

Definition at line 354 of file eevee_sampling.cc.

References cosf, M_PI, sinf, and sqrtf.

Referenced by blender::eevee::Film::pixel_jitter_get().

◆ sample_hemisphere()

float3 blender::eevee::Sampling::sample_hemisphere ( const float2 & rand)
static

Uniform hemisphere distribution. rand is 2 random float in the [0..1] range. Returns point on a Z positive hemisphere of radius 1 and centered on the origin.

Definition at line 360 of file eevee_sampling.cc.

References cos_theta(), cosf, M_PI, blender::safe_sqrtf(), sin_theta(), sinf, and blender::square_f().

◆ sample_index()

uint64_t blender::eevee::Sampling::sample_index ( ) const
inline

◆ sample_sphere()

float3 blender::eevee::Sampling::sample_sphere ( const float2 & rand)
static

Uniform sphere distribution. rand is 2 random float in the [0..1] range. Returns point on the sphere of radius 1 and centered on the origin.

Definition at line 368 of file eevee_sampling.cc.

References cos_theta(), cosf, M_PI, blender::safe_sqrtf(), sin_theta(), sinf, and blender::square_f().

Referenced by blender::eevee::IrradianceBake::raylists_build().

◆ sample_spiral()

float2 blender::eevee::Sampling::sample_spiral ( const float2 & rand)
static

Uniform disc distribution using Fibonacci spiral sampling. rand is 2 random float in the [0..1] range. Returns point in a disk of radius 1 and centered on the origin.

Definition at line 376 of file eevee_sampling.cc.

References cosf, M_PI, sinf, and sqrtf.

Referenced by blender::eevee::Film::update_sample_table().

◆ step()

void blender::eevee::Sampling::step ( )

Definition at line 180 of file eevee_sampling.cc.

References blender::BLI_assert(), blender::BLI_halton_1d(), blender::BLI_halton_2d(), blender::BLI_halton_3d(), float, blender::fractf(), blender::IndexRange::IndexRange(), interactive_mode(), blender::eevee::SAMPLING_AO_U, blender::eevee::SAMPLING_AO_V, blender::eevee::SAMPLING_AO_W, blender::eevee::SAMPLING_CLOSURE, blender::eevee::SAMPLING_CURVES_U, blender::eevee::SAMPLING_FILM_U, blender::eevee::SAMPLING_FILTER_U, blender::eevee::SAMPLING_FILTER_V, blender::eevee::SAMPLING_GBUFFER_U, blender::eevee::SAMPLING_GBUFFER_V, blender::eevee::SAMPLING_GBUFFER_W, blender::eevee::SAMPLING_LENS_U, blender::eevee::SAMPLING_LENS_V, blender::eevee::SAMPLING_LIGHTPROBE, blender::eevee::SAMPLING_PANORAMIC_U, blender::eevee::SAMPLING_PANORAMIC_V, blender::eevee::SAMPLING_RAYTRACE_U, blender::eevee::SAMPLING_RAYTRACE_V, blender::eevee::SAMPLING_RAYTRACE_W, blender::eevee::SAMPLING_RAYTRACE_X, blender::eevee::SAMPLING_SHADOW_I, blender::eevee::SAMPLING_SHADOW_J, blender::eevee::SAMPLING_SHADOW_K, blender::eevee::SAMPLING_SHADOW_U, blender::eevee::SAMPLING_SHADOW_V, blender::eevee::SAMPLING_SHADOW_W, blender::eevee::SAMPLING_SHADOW_X, blender::eevee::SAMPLING_SHADOW_Y, blender::eevee::SAMPLING_SSS_U, blender::eevee::SAMPLING_SSS_V, blender::eevee::SAMPLING_TIME, blender::eevee::SAMPLING_TRANSPARENCY, blender::eevee::SAMPLING_VOLUME_U, blender::eevee::SAMPLING_VOLUME_V, blender::eevee::SAMPLING_VOLUME_W, blender::square_i(), UNUSED_VARS_NDEBUG, and blender::x.

Referenced by blender::eevee::Instance::light_bake_irradiance().

◆ update_time()

void blender::eevee::Sampling::update_time ( )

◆ use_clamp_direct()

bool blender::eevee::Sampling::use_clamp_direct ( ) const
inline

◆ use_clamp_indirect()

bool blender::eevee::Sampling::use_clamp_indirect ( ) const
inline

◆ use_custom_pixel_jitter_sample()

bool blender::eevee::Sampling::use_custom_pixel_jitter_sample ( ) const
inline

Definition at line 166 of file eevee_sampling.hh.

◆ use_direct_scale()

bool blender::eevee::Sampling::use_direct_scale ( ) const
inline

◆ use_indirect_scale()

bool blender::eevee::Sampling::use_indirect_scale ( ) const
inline

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