Blender V4.3
Classes | Public Member Functions | Public Attributes | Protected Types | Protected Member Functions | Protected Attributes | List of all members
Session Class Reference

#include <session.h>

Classes

struct  DelayedReset
 

Public Member Functions

 Session (const SessionParams &params, const SceneParams &scene_params)
 
 ~Session ()
 
void start ()
 
void cancel (bool quick=false)
 
void draw ()
 
void wait ()
 
bool ready_to_reset ()
 
void reset (const SessionParams &session_params, const BufferParams &buffer_params)
 
void set_pause (bool pause)
 
void set_samples (int samples)
 
void set_time_limit (double time_limit)
 
void set_output_driver (unique_ptr< OutputDriver > driver)
 
void set_display_driver (unique_ptr< DisplayDriver > driver)
 
double get_estimated_remaining_time () const
 
void device_free ()
 
float get_progress ()
 
void collect_statistics (RenderStats *stats)
 
void process_full_buffer_from_disk (string_view filename)
 

Public Attributes

Device * device
 
Device * denoise_device
 
Scene * scene
 
Progress progress
 
SessionParams params
 
Stats stats
 
Profiler profiler
 
function< void(string_view)> full_buffer_written_cb
 

Protected Types

enum  { SESSION_THREAD_WAIT , SESSION_THREAD_RENDER , SESSION_THREAD_END }
 

Protected Member Functions

void thread_run ()
 
void thread_render ()
 
bool is_session_thread_rendering ()
 
RenderWork run_update_for_next_iteration ()
 
bool run_wait_for_work (const RenderWork &render_work)
 
void run_main_render_loop ()
 
bool update_scene (int width, int height)
 
void update_status_time (bool show_pause=false, bool show_done=false)
 
void do_delayed_reset ()
 
int2 get_effective_tile_size () const
 

Protected Attributes

struct Session::DelayedReset delayed_reset_
 
thread * session_thread_ = nullptr
 
thread_condition_variable session_thread_cond_
 
thread_mutex session_thread_mutex_
 
enum Session:: { ... }  session_thread_state_ = SESSION_THREAD_WAIT
 
bool pause_ = false
 
bool new_work_added_ = false
 
thread_condition_variable pause_cond_
 
thread_mutex pause_mutex_
 
thread_mutex tile_mutex_
 
thread_mutex buffers_mutex_
 
TileManager tile_manager_
 
BufferParams buffer_params_
 
RenderScheduler render_scheduler_
 
unique_ptr< PathTrace > path_trace_
 

Detailed Description

Definition at line 108 of file session/session.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
protected
Enumerator
SESSION_THREAD_WAIT 
SESSION_THREAD_RENDER 
SESSION_THREAD_END 

Definition at line 217 of file session/session.h.

Constructor & Destructor Documentation

◆ Session()

CCL_NAMESPACE_BEGIN Session::Session ( const SessionParams & params,
const SceneParams & scene_params )
explicit

Definition at line 35 of file session/session.cpp.

References Device::create(), delayed_reset_, denoise_device, SessionParams::denoise_device, device, SessionParams::device, Session::DelayedReset::do_reset, Device::error_message(), full_buffer_written_cb, TileManager::full_buffer_written_cb, function_bind, Device::have_error(), SessionParams::headless, TaskScheduler::init(), new_work_added_, params, path_trace_, pause_, profiler, progress, render_scheduler_, session_thread_, Progress::set_error(), stats, thread_run(), SessionParams::threads, tile_manager_, and update_status_time().

◆ ~Session()

Session::~Session ( )

Definition at line 81 of file session/session.cpp.

References cancel(), denoise_device, device, TaskScheduler::exit(), thread::join(), path_trace_, scene, session_thread_, session_thread_cond_, SESSION_THREAD_END, session_thread_mutex_, and session_thread_state_.

Member Function Documentation

◆ cancel()

void Session::cancel ( bool quick = false)

Definition at line 129 of file session/session.cpp.

References Device::cancel(), device, is_session_thread_rendering(), path_trace_, pause_, pause_cond_, pause_mutex_, progress, Progress::set_cancel(), and wait().

Referenced by BlenderSession::bake(), BlenderSession::free_session(), HdCyclesRenderPass::~HdCyclesRenderPass(), and ~Session().

◆ collect_statistics()

void Session::collect_statistics ( RenderStats * stats)

Definition at line 756 of file session/session.cpp.

References RenderStats::collect_profiling(), SessionParams::device, DEVICE_CPU, params, profiler, DeviceInfo::type, and SessionParams::use_profiling.

Referenced by BlenderSession::render().

◆ device_free()

void Session::device_free ( )

Definition at line 750 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::render_frame_finish().

◆ do_delayed_reset()

void Session::do_delayed_reset ( )
protected

Definition at line 518 of file session/session.cpp.

References SessionParams::background, Session::DelayedReset::buffer_params, buffer_params_, delayed_reset_, Session::DelayedReset::do_reset, double(), BufferParams::exposure, get_effective_tile_size(), TileManager::get_num_tiles(), TileManager::has_multiple_tiles(), BufferParams::height, params, progress, render_scheduler_, RenderScheduler::reset(), Progress::reset_sample(), TileManager::reset_scheduling(), SessionParams::sample_offset, BufferParams::samples, SessionParams::samples, Session::DelayedReset::session_params, Progress::set_render_start_time(), Progress::set_start_time(), TileManager::set_temp_dir(), Progress::set_time_limit(), Progress::set_total_pixel_samples(), SessionParams::temp_dir, tile_manager_, SessionParams::time_limit, TileManager::update(), BufferParams::update_passes(), BufferParams::use_approximate_shadow_catcher, BufferParams::use_transparent_background, and BufferParams::width.

Referenced by run_update_for_next_iteration().

◆ draw()

void Session::draw ( )

Definition at line 487 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::draw(), and BlenderSession::view_draw().

◆ get_effective_tile_size()

int2 Session::get_effective_tile_size ( ) const
protected

Definition at line 492 of file session/session.cpp.

References buffer_params_, TileManager::compute_render_tile_size(), BufferParams::height, image_height, image_width, make_int2(), TileManager::MAX_TILE_SIZE, params, tile_manager_, SessionParams::tile_size, SessionParams::use_auto_tile, and BufferParams::width.

Referenced by do_delayed_reset().

◆ get_estimated_remaining_time()

double Session::get_estimated_remaining_time ( ) const

Definition at line 650 of file session/session.cpp.

References double(), TileManager::get_num_tiles(), Progress::get_progress(), Progress::get_time(), RenderScheduler::get_time_limit(), max, min, progress, render_scheduler_, tile_manager_, and total_time.

Referenced by BlenderSession::update_status_progress().

◆ get_progress()

float Session::get_progress ( )

◆ is_session_thread_rendering()

bool Session::is_session_thread_rendering ( )
protected

Definition at line 298 of file session/session.cpp.

References session_thread_mutex_, SESSION_THREAD_RENDER, and session_thread_state_.

Referenced by cancel(), and set_pause().

◆ process_full_buffer_from_disk()

void Session::process_full_buffer_from_disk ( string_view filename)

Definition at line 768 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::render_frame_finish().

◆ ready_to_reset()

bool Session::ready_to_reset ( )

Definition at line 158 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::synchronize(), and BlenderSession::view_draw().

◆ reset()

void Session::reset ( const SessionParams & session_params,
const BufferParams & buffer_params )

Definition at line 569 of file session/session.cpp.

References Session::DelayedReset::buffer_params, delayed_reset_, Session::DelayedReset::do_reset, Session::DelayedReset::mutex, path_trace_, pause_cond_, pause_mutex_, and Session::DelayedReset::session_params.

Referenced by BlenderSession::bake(), BlenderSession::create_session(), BlenderSession::render(), BlenderSession::reset_session(), session_init(), BlenderSession::synchronize(), and BlenderSession::view_draw().

◆ run_main_render_loop()

void Session::run_main_render_loop ( )
protected

Definition at line 163 of file session/session.cpp.

References SessionParams::background, buffers_mutex_, device, Device::error_message(), Progress::get_cancel(), Progress::get_time(), Device::have_error(), params, path_trace_, progress, render_scheduler_, RenderScheduler::render_work_reschedule_on_cancel(), run_update_for_next_iteration(), run_wait_for_work(), Progress::set_error(), Progress::set_status(), Progress::set_update(), total_time, update_status_time(), VLOG_INFO, and VLOG_INFO_IS_ON.

Referenced by thread_render().

◆ run_update_for_next_iteration()

RenderWork Session::run_update_for_next_iteration ( )
protected

Definition at line 304 of file session/session.cpp.

References Progress::add_finished_tile(), Progress::add_skip_time(), SessionParams::background, buffer_params_, buffers_mutex_, delayed_reset_, device, do_delayed_reset(), Session::DelayedReset::do_reset, BufferParams::full_height, BufferParams::full_width, BufferParams::full_x, BufferParams::full_y, Progress::get_cancel(), TileManager::get_current_tile(), RenderScheduler::get_render_work(), BufferParams::height, Device::is_ready(), max, Session::DelayedReset::mutex, TileManager::next(), params, path_trace_, profiler, progress, render_scheduler_, Profiler::reset(), RenderScheduler::reset_for_next_tile(), RenderWork::resolution_divider, SessionParams::sample_offset, SessionParams::samples, RenderScheduler::set_num_samples(), RenderScheduler::set_start_sample(), Progress::set_status(), RenderScheduler::set_time_limit(), tile, tile_manager_, SessionParams::time_limit, BufferParams::update_offset_stride(), update_scene(), GuidingParams::use, BufferParams::width, BufferParams::window_height, BufferParams::window_width, BufferParams::window_x, BufferParams::window_y, KernelWorkTile::x, and KernelWorkTile::y.

Referenced by run_main_render_loop().

◆ run_wait_for_work()

bool Session::run_wait_for_work ( const RenderWork & render_work)
protected

Definition at line 445 of file session/session.cpp.

References Progress::add_skip_time(), SessionParams::background, delayed_reset_, Session::DelayedReset::do_reset, Progress::get_cancel(), new_work_added_, params, pause_, pause_cond_, pause_mutex_, progress, Progress::set_update(), and update_status_time().

Referenced by run_main_render_loop().

◆ set_display_driver()

void Session::set_display_driver ( unique_ptr< DisplayDriver > driver)

Definition at line 645 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::bake(), BlenderSession::ensure_display_driver_if_needed(), HdCyclesRenderPass::HdCyclesRenderPass(), BlenderSession::render_frame_finish(), and session_init().

◆ set_output_driver()

void Session::set_output_driver ( unique_ptr< OutputDriver > driver)

Definition at line 640 of file session/session.cpp.

References path_trace_.

Referenced by BlenderSession::bake(), HdCyclesRenderPass::HdCyclesRenderPass(), BlenderSession::render(), BlenderSession::render_frame_finish(), and session_init().

◆ set_pause()

void Session::set_pause ( bool pause)

Definition at line 617 of file session/session.cpp.

References is_session_thread_rendering(), pause_, pause_cond_, pause_mutex_, and update_status_time().

Referenced by BlenderSession::create_session(), BlenderSession::synchronize(), and BlenderSession::view_draw().

◆ set_samples()

void Session::set_samples ( int samples)

Definition at line 585 of file session/session.cpp.

References new_work_added_, params, pause_cond_, pause_mutex_, and SessionParams::samples.

Referenced by HdCyclesDelegate::SetRenderSetting(), and BlenderSession::synchronize().

◆ set_time_limit()

void Session::set_time_limit ( double time_limit)

Definition at line 601 of file session/session.cpp.

References new_work_added_, params, pause_cond_, pause_mutex_, and SessionParams::time_limit.

Referenced by HdCyclesDelegate::SetRenderSetting(), and BlenderSession::synchronize().

◆ start()

void Session::start ( )

Definition at line 114 of file session/session.cpp.

References session_thread_cond_, session_thread_mutex_, SESSION_THREAD_RENDER, and session_thread_state_.

Referenced by BlenderSession::bake(), BlenderSession::render(), session_init(), and BlenderSession::synchronize().

◆ thread_render()

void Session::thread_render ( )
protected

Definition at line 270 of file session/session.cpp.

References SessionParams::device, DEVICE_CPU, Progress::get_cancel(), Progress::get_cancel_message(), params, profiler, progress, Progress::reset_sample(), run_main_render_loop(), Progress::set_status(), Progress::set_update(), Profiler::start(), Profiler::stop(), DeviceInfo::type, and SessionParams::use_profiling.

Referenced by thread_run().

◆ thread_run()

void Session::thread_run ( )
protected

Definition at line 233 of file session/session.cpp.

References path_trace_, session_thread_cond_, SESSION_THREAD_END, session_thread_mutex_, SESSION_THREAD_RENDER, session_thread_state_, SESSION_THREAD_WAIT, and thread_render().

Referenced by Session().

◆ update_scene()

bool Session::update_scene ( int width,
int height )
protected

Definition at line 682 of file session/session.cpp.

References progress, and Camera::set_screen_size().

Referenced by run_update_for_next_iteration().

◆ update_status_time()

void Session::update_status_time ( bool show_pause = false,
bool show_done = false )
protected

Definition at line 702 of file session/session.cpp.

References SessionParams::background, device, Progress::get_current_sample(), RenderScheduler::get_num_samples(), TileManager::get_num_tiles(), Progress::get_rendered_tiles(), TileManager::has_multiple_tiles(), Device::is_ready(), Integrator::MAX_SAMPLES, num_tiles, params, progress, render_scheduler_, Progress::set_end_time(), Progress::set_status(), status_append(), string_printf(), and tile_manager_.

Referenced by run_main_render_loop(), run_wait_for_work(), Session(), and set_pause().

◆ wait()

void Session::wait ( )

Definition at line 670 of file session/session.cpp.

References session_thread_cond_, session_thread_mutex_, SESSION_THREAD_RENDER, and session_thread_state_.

Referenced by BlenderSession::bake(), cancel(), main(), and BlenderSession::render().

Member Data Documentation

◆ buffer_params_

BufferParams Session::buffer_params_
protected

Definition at line 232 of file session/session.h.

Referenced by do_delayed_reset(), get_effective_tile_size(), and run_update_for_next_iteration().

◆ buffers_mutex_

thread_mutex Session::buffers_mutex_
protected

Definition at line 229 of file session/session.h.

Referenced by run_main_render_loop(), and run_update_for_next_iteration().

◆ delayed_reset_

struct Session::DelayedReset Session::delayed_reset_
protected

Referenced by do_delayed_reset(), reset(), run_update_for_next_iteration(), run_wait_for_work(), and Session().

◆ denoise_device

Device* Session::denoise_device

Definition at line 112 of file session/session.h.

Referenced by Session(), and ~Session().

◆ device

Device* Session::device

Definition at line 110 of file session/session.h.

Referenced by BlenderSession::builtin_images_load(), cancel(), run_main_render_loop(), run_update_for_next_iteration(), Session(), update_status_time(), and ~Session().

◆ full_buffer_written_cb

function<void(string_view)> Session::full_buffer_written_cb

Definition at line 122 of file session/session.h.

Referenced by BlenderSession::bake(), BlenderSession::render(), BlenderSession::render_frame_finish(), and Session().

◆ new_work_added_

bool Session::new_work_added_ = false
protected

Definition at line 224 of file session/session.h.

Referenced by run_wait_for_work(), Session(), set_samples(), and set_time_limit().

◆ params

SessionParams Session::params

Definition at line 115 of file session/session.h.

Referenced by collect_statistics(), do_delayed_reset(), get_effective_tile_size(), HdCyclesDelegate::GetRenderSetting(), BlenderSession::reset_session(), run_main_render_loop(), run_update_for_next_iteration(), run_wait_for_work(), Session(), set_samples(), set_time_limit(), HdCyclesDelegate::SetRenderSetting(), BlenderSession::stamp_view_layer_metadata(), BlenderSession::synchronize(), thread_render(), and update_status_time().

◆ path_trace_

unique_ptr<PathTrace> Session::path_trace_
protected

Definition at line 241 of file session/session.h.

Referenced by cancel(), device_free(), draw(), process_full_buffer_from_disk(), ready_to_reset(), reset(), run_main_render_loop(), run_update_for_next_iteration(), Session(), set_display_driver(), set_output_driver(), thread_run(), and ~Session().

◆ pause_

bool Session::pause_ = false
protected

Definition at line 223 of file session/session.h.

Referenced by cancel(), run_wait_for_work(), Session(), and set_pause().

◆ pause_cond_

thread_condition_variable Session::pause_cond_
protected

Definition at line 226 of file session/session.h.

Referenced by cancel(), reset(), run_wait_for_work(), set_pause(), set_samples(), and set_time_limit().

◆ pause_mutex_

thread_mutex Session::pause_mutex_
protected

Definition at line 227 of file session/session.h.

Referenced by cancel(), reset(), run_wait_for_work(), set_pause(), set_samples(), and set_time_limit().

◆ profiler

Profiler Session::profiler

Definition at line 117 of file session/session.h.

Referenced by collect_statistics(), run_update_for_next_iteration(), Session(), and thread_render().

◆ progress

Progress Session::progress

Definition at line 114 of file session/session.h.

Referenced by BlenderSession::bake(), BlenderSession::builtin_images_load(), cancel(), BlenderSession::check_and_report_session_error(), BlenderSession::create_session(), do_delayed_reset(), get_estimated_remaining_time(), BlenderSession::get_progress(), BlenderSession::get_status(), HdCyclesRenderPass::HdCyclesRenderPass(), BlenderSession::render(), BlenderSession::reset_session(), run_main_render_loop(), run_update_for_next_iteration(), run_wait_for_work(), Session(), session_init(), session_print_status(), BlenderSession::stamp_view_layer_metadata(), BlenderSession::test_cancel(), thread_render(), BlenderSession::update_bake_progress(), update_scene(), and update_status_time().

◆ render_scheduler_

RenderScheduler Session::render_scheduler_
protected

Definition at line 235 of file session/session.h.

Referenced by do_delayed_reset(), get_estimated_remaining_time(), run_main_render_loop(), run_update_for_next_iteration(), Session(), and update_status_time().

◆ scene

Scene* Session::scene

Definition at line 113 of file session/session.h.

Referenced by BlenderSession::builtin_images_load(), BlenderSession::create_session(), BlenderSession::draw(), HdCyclesFileReader::read(), scene_init(), BlenderSession::synchronize(), BlenderSession::view_draw(), and ~Session().

◆ session_thread_

thread* Session::session_thread_ = nullptr
protected

Definition at line 214 of file session/session.h.

Referenced by Session(), and ~Session().

◆ session_thread_cond_

thread_condition_variable Session::session_thread_cond_
protected

Definition at line 215 of file session/session.h.

Referenced by start(), thread_run(), wait(), and ~Session().

◆ session_thread_mutex_

thread_mutex Session::session_thread_mutex_
protected

Definition at line 216 of file session/session.h.

Referenced by is_session_thread_rendering(), start(), thread_run(), wait(), and ~Session().

◆ []

enum { ... } Session::session_thread_state_

Referenced by is_session_thread_rendering(), start(), thread_run(), wait(), and ~Session().

◆ stats

Stats Session::stats

Definition at line 116 of file session/session.h.

Referenced by BlenderSession::reset_session(), Session(), and BlenderSession::update_status_progress().

◆ tile_manager_

TileManager Session::tile_manager_
protected

Definition at line 231 of file session/session.h.

Referenced by do_delayed_reset(), get_effective_tile_size(), get_estimated_remaining_time(), run_update_for_next_iteration(), Session(), and update_status_time().

◆ tile_mutex_

thread_mutex Session::tile_mutex_
protected

Definition at line 228 of file session/session.h.

The documentation for this class was generated from the following files:
Generated on Thu Feb 6 2025 07:36:39 for Blender by  doxygen 1.11.0