Blender V4.3
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Friends | List of all members
Device Class Referenceabstract

#include <device.h>

Inherited by CPUDevice, DummyDevice, GPUDevice, and MultiDevice.

Public Member Functions

virtual ~Device () noexcept(false)
virtual const string & error_message ()
bool have_error ()
virtual void set_error (const string &error)
virtual BVHLayoutMask get_bvh_layout_mask (uint kernel_features) const =0
virtual void const_copy_to (const char *name, void *host, size_t size)=0
virtual bool load_kernels (uint)
virtual bool load_osl_kernels ()
virtual void cancel ()
virtual bool is_ready (string &) const
virtual unique_ptr< DeviceQueue > gpu_queue_create ()
virtual void get_cpu_kernel_thread_globals (vector< CPUKernelThreadGlobals > &)
virtual void * get_cpu_osl_memory ()
virtual void build_bvh (BVH *bvh, Progress &progress, bool refit)
virtual void release_bvh (BVH *)
virtual int device_number (Device *)
virtual void optimize_for_scene (Scene *)
virtual bool is_resident (device_ptr, Device *sub_device)
virtual bool check_peer_access (Device *)
virtual bool should_use_graphics_interop ()
virtual void * get_native_buffer (device_ptr)
virtual void * get_guiding_device () const
virtual void foreach_device (const function< void(Device *)> &callback)

Static Public Member Functions

static const CPUKernels & get_cpu_kernels ()
static Device * create (const DeviceInfo &info, Stats &stats, Profiler &profiler, bool headless)
static DeviceType type_from_string (const char *name)
static string string_from_type (DeviceType type)
static vector< DeviceType > available_types ()
static vector< DeviceInfo > available_devices (uint device_type_mask=DEVICE_MASK_ALL)
static DeviceInfo dummy_device (const string &error_msg="")
static string device_capabilities (uint device_type_mask=DEVICE_MASK_ALL)
static DeviceInfo get_multi_device (const vector< DeviceInfo > &subdevices, int threads, bool background)
static void tag_update ()
static void free_memory ()

Public Attributes

DeviceInfo info
Stats & stats
Profiler & profiler
bool headless = true

Protected Member Functions

 Device (const DeviceInfo &info_, Stats &stats_, Profiler &profiler_, bool headless_)
virtual device_ptr mem_alloc_sub_ptr (device_memory &, size_t, size_t)
virtual void mem_free_sub_ptr (device_ptr)
virtual void mem_alloc (device_memory &mem)=0
virtual void mem_copy_to (device_memory &mem)=0
virtual void mem_copy_from (device_memory &mem, size_t y, size_t w, size_t h, size_t elem)=0
virtual void mem_zero (device_memory &mem)=0
virtual void mem_free (device_memory &mem)=0

Protected Attributes

string error_msg

Friends

class device_sub_ptr
class MultiDevice
class DeviceServer
class device_memory

Detailed Description

Definition at line 136 of file device/device.h.

Constructor & Destructor Documentation

◆ Device()

Device::Device ( const DeviceInfo & info_,
Stats & stats_,
Profiler & profiler_,
bool headless_ )
inlineprotected

Definition at line 140 of file device/device.h.

References headless, info, profiler, and stats.

Referenced by check_peer_access(), CPUDevice::CPUDevice(), create(), device_number(), MultiDevice::device_number(), DummyDevice::DummyDevice(), foreach_device(), MultiDevice::foreach_device(), GPUDevice::GPUDevice(), is_resident(), MultiDevice::is_resident(), and MultiDevice::MultiDevice().

◆ ~Device()

Device::~Device ( )
virtual

Definition at line 50 of file device/device.cpp.

References false.

Member Function Documentation

◆ available_devices()

vector< DeviceInfo > Device::available_devices ( uint device_type_mask = DEVICE_MASK_ALL)
static

Definition at line 211 of file device/device.cpp.

References device_cpu_info(), device_cuda_info(), device_cuda_init(), device_hip_info(), device_hip_init(), DEVICE_MASK_CPU, DEVICE_MASK_CUDA, DEVICE_MASK_HIP, DEVICE_MASK_METAL, DEVICE_MASK_ONEAPI, DEVICE_MASK_OPTIX, device_metal_info(), device_metal_init(), device_oneapi_info(), device_oneapi_init(), device_optix_info(), device_optix_init(), info, lock, and mask().

Referenced by available_devices_func(), blender_device_info(), and options_parse().

◆ available_types()

vector< DeviceType > Device::available_types ( )
static

Definition at line 185 of file device/device.cpp.

References DEVICE_CPU, DEVICE_CUDA, DEVICE_HIP, DEVICE_HIPRT, DEVICE_METAL, DEVICE_ONEAPI, DEVICE_OPTIX, and types.

Referenced by get_device_types_func(), and options_parse().

◆ build_bvh()

void Device::build_bvh ( BVH * bvh,
Progress & progress,
bool refit )
virtual

Reimplemented in CPUDevice, and MultiDevice.

Definition at line 52 of file device/device.cpp.

References BVH2::build(), BVHParams::bvh_layout, BVH_LAYOUT_BVH2, BVH::params, BVH2::refit(), refit(), and stats.

Referenced by CPUDevice::build_bvh(), MultiDevice::build_bvh(), Geometry::compute_bvh(), and GeometryManager::device_update_bvh().

◆ cancel()

virtual void Device::cancel ( )
inlinevirtual

Definition at line 199 of file device/device.h.

◆ check_peer_access()

virtual bool Device::check_peer_access ( Device * )
inlinevirtual

Definition at line 244 of file device/device.h.

References Device().

◆ const_copy_to()

virtual void Device::const_copy_to ( const char * name,
void * host,
size_t size )
pure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References size().

Referenced by MultiDevice::const_copy_to(), GeometryManager::device_update(), and shade_background_pixels().

◆ create()

Device * Device::create ( const DeviceInfo & info,
Stats & stats,
Profiler & profiler,
bool headless )
static

Definition at line 65 of file device/device.cpp.

References Device(), DEVICE_CPU, device_cpu_create(), DEVICE_CUDA, device_cuda_create(), device_cuda_init(), device_dummy_create(), DEVICE_HIP, device_hip_create(), device_hip_init(), DEVICE_METAL, device_metal_create(), device_metal_init(), device_multi_create(), DEVICE_ONEAPI, device_oneapi_create(), DEVICE_OPTIX, device_optix_create(), device_optix_init(), headless, info, NULL, profiler, and stats.

Referenced by DenoiserPipeline::DenoiserPipeline(), MultiDevice::MultiDevice(), Session::Session(), and RenderGraph::SetUp().

◆ device_capabilities()

string Device::device_capabilities ( uint device_type_mask = DEVICE_MASK_ALL)
static

Definition at line 312 of file device/device.cpp.

References device_capabilities(), device_cpu_capabilities(), device_cuda_capabilities(), device_cuda_init(), device_hip_capabilities(), device_hip_init(), DEVICE_MASK_CPU, DEVICE_MASK_CUDA, DEVICE_MASK_HIP, DEVICE_MASK_METAL, DEVICE_MASK_ONEAPI, device_metal_capabilities(), device_metal_init(), device_oneapi_capabilities(), device_oneapi_init(), lock, and mask().

Referenced by device_capabilities(), and system_info_func().

◆ device_number()

virtual int Device::device_number ( Device * )
inlinevirtual

Reimplemented in MultiDevice.

Definition at line 230 of file device/device.h.

References Device().

◆ dummy_device()

DeviceInfo Device::dummy_device ( const string & error_msg = "")
static

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

References DEVICE_DUMMY, error_msg, and info.

Referenced by blender_device_info().

◆ error_message()

virtual const string & Device::error_message ( )
inlinevirtual

Reimplemented in MultiDevice.

Definition at line 161 of file device/device.h.

References error_message(), and error_msg.

Referenced by error_message(), MultiDevice::error_message(), and have_error().

◆ foreach_device()

virtual void Device::foreach_device ( const function< void(Device *)> & callback)
inlinevirtual

Reimplemented in MultiDevice.

Definition at line 283 of file device/device.h.

References Device().

Referenced by find_best_device(), and MultiDevice::foreach_device().

◆ free_memory()

void Device::free_memory ( )
static

Definition at line 457 of file device/device.cpp.

Referenced by exit_func(), and tag_update().

◆ get_bvh_layout_mask()

virtual BVHLayoutMask Device::get_bvh_layout_mask ( uint kernel_features) const
pure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

Referenced by Geometry::compute_bvh(), GeometryManager::device_update(), GeometryManager::device_update_bvh(), ObjectManager::device_update_prim_offsets(), and MultiDevice::get_bvh_layout_mask().

◆ get_cpu_kernel_thread_globals()

void Device::get_cpu_kernel_thread_globals ( vector< CPUKernelThreadGlobals > & )
virtual

Reimplemented in CPUDevice.

Definition at line 481 of file device/device.cpp.

References LOG.

Referenced by ShaderEval::eval_cpu().

◆ get_cpu_kernels()

const CPUKernels & Device::get_cpu_kernels ( )
static

Definition at line 474 of file device/device.cpp.

Referenced by CPUDevice::CPUDevice(), and ShaderEval::eval_cpu().

◆ get_cpu_osl_memory()

void * Device::get_cpu_osl_memory ( )
virtual

Reimplemented in CPUDevice, and MultiDevice.

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

Referenced by GeometryManager::device_free(), and GeometryManager::update_osl_globals().

◆ get_guiding_device()

virtual void * Device::get_guiding_device ( ) const
inlinevirtual

Reimplemented in CPUDevice.

Definition at line 272 of file device/device.h.

References LOG.

◆ get_multi_device()

DeviceInfo Device::get_multi_device ( const vector< DeviceInfo > & subdevices,
int threads,
bool background )
static

Definition at line 373 of file device/device.cpp.

References DeviceInfo::cpu_threads, DENOISER_ALL, DeviceInfo::denoisers, DEVICE_CPU, DEVICE_MULTI, DEVICE_NONE, DeviceInfo::has_guiding, DeviceInfo::has_mnee, DeviceInfo::has_nanovdb, DeviceInfo::has_osl, DeviceInfo::has_peer_memory, DeviceInfo::has_profiling, DeviceInfo::id, info, max, TaskScheduler::max_concurrency(), DeviceInfo::type, DeviceInfo::use_hardware_raytracing, and VLOG_INFO.

Referenced by blender_device_info().

◆ get_native_buffer()

virtual void * Device::get_native_buffer ( device_ptr )
inlinevirtual

Definition at line 264 of file device/device.h.

◆ gpu_queue_create()

unique_ptr< DeviceQueue > Device::gpu_queue_create ( )
virtual

Definition at line 468 of file device/device.cpp.

References LOG.

Referenced by DenoiserGPU::DenoiserGPU(), and ShaderEval::eval_gpu().

◆ have_error()

bool Device::have_error ( )
inline

Definition at line 165 of file device/device.h.

References error_message().

Referenced by PathTrace::path_trace(), and set_error().

◆ is_ready()

virtual bool Device::is_ready ( string & ) const
inlinevirtual

Definition at line 202 of file device/device.h.

◆ is_resident()

virtual bool Device::is_resident ( device_ptr ,
Device * sub_device )
inlinevirtual

Reimplemented in MultiDevice.

Definition at line 238 of file device/device.h.

References Device().

◆ load_kernels()

virtual bool Device::load_kernels ( uint )
inlinevirtual

Reimplemented in CPUDevice, and MultiDevice.

Definition at line 188 of file device/device.h.

Referenced by MultiDevice::load_kernels().

◆ load_osl_kernels()

virtual bool Device::load_osl_kernels ( )
inlinevirtual

Reimplemented in MultiDevice.

Definition at line 193 of file device/device.h.

Referenced by MultiDevice::load_osl_kernels().

◆ mem_alloc()

virtual void Device::mem_alloc ( device_memory & mem)
protectedpure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References device_memory.

Referenced by MultiDevice::mem_alloc().

◆ mem_alloc_sub_ptr()

virtual device_ptr Device::mem_alloc_sub_ptr ( device_memory & ,
size_t ,
size_t  )
inlineprotectedvirtual

Reimplemented in CPUDevice.

Definition at line 147 of file device/device.h.

References device_memory.

◆ mem_copy_from()

virtual void Device::mem_copy_from ( device_memory & mem,
size_t y,
size_t w,
size_t h,
size_t elem )
protectedpure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References device_memory, w(), and y.

Referenced by MultiDevice::mem_copy_from().

◆ mem_copy_to()

virtual void Device::mem_copy_to ( device_memory & mem)
protectedpure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References device_memory.

Referenced by MultiDevice::mem_copy_to().

◆ mem_free()

virtual void Device::mem_free ( device_memory & mem)
protectedpure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References device_memory, and thread_mutex.

Referenced by MultiDevice::mem_free().

◆ mem_free_sub_ptr()

virtual void Device::mem_free_sub_ptr ( device_ptr )
inlineprotectedvirtual

Definition at line 153 of file device/device.h.

◆ mem_zero()

virtual void Device::mem_zero ( device_memory & mem)
protectedpure virtual

Implemented in CPUDevice, DummyDevice, and MultiDevice.

References device_memory.

Referenced by MultiDevice::mem_zero().

◆ optimize_for_scene()

virtual void Device::optimize_for_scene ( Scene * )
inlinevirtual

Definition at line 236 of file device/device.h.

◆ release_bvh()

virtual void Device::release_bvh ( BVH * )
inlinevirtual

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

◆ set_error()

virtual void Device::set_error ( const string & error)
inlinevirtual

Definition at line 169 of file device/device.h.

References error(), error_msg, and have_error().

Referenced by GPUDevice::generic_alloc().

◆ should_use_graphics_interop()

virtual bool Device::should_use_graphics_interop ( )
inlinevirtual

Definition at line 258 of file device/device.h.

Referenced by find_best_device(), and PathTraceWorkGPU::should_use_graphics_interop().

◆ string_from_type()

string Device::string_from_type ( DeviceType type)
static

Definition at line 155 of file device/device.cpp.

References DEVICE_CPU, DEVICE_CUDA, DEVICE_HIP, DEVICE_HIPRT, DEVICE_METAL, DEVICE_MULTI, DEVICE_ONEAPI, and DEVICE_OPTIX.

Referenced by available_devices_func(), HdCyclesDelegate::GetRenderSetting(), and options_parse().

◆ tag_update()

void Device::tag_update ( )
static

Definition at line 452 of file device/device.cpp.

References free_memory().

◆ type_from_string()

DeviceType Device::type_from_string ( const char * name)
static

Definition at line 125 of file device/device.cpp.

References DEVICE_CPU, DEVICE_CUDA, DEVICE_HIP, DEVICE_HIPRT, DEVICE_METAL, DEVICE_MULTI, DEVICE_NONE, DEVICE_ONEAPI, and DEVICE_OPTIX.

Referenced by available_devices_func(), and options_parse().

◆ device_memory

friend class device_memory
friend

Definition at line 310 of file device/device.h.

References device_memory.

Referenced by device_memory, CPUDevice::global_alloc(), CPUDevice::global_free(), CPUDevice::mem_alloc(), mem_alloc(), DummyDevice::mem_alloc(), MultiDevice::mem_alloc(), CPUDevice::mem_alloc_sub_ptr(), mem_alloc_sub_ptr(), CPUDevice::mem_copy_from(), mem_copy_from(), DummyDevice::mem_copy_from(), MultiDevice::mem_copy_from(), CPUDevice::mem_copy_to(), mem_copy_to(), DummyDevice::mem_copy_to(), MultiDevice::mem_copy_to(), CPUDevice::mem_free(), mem_free(), DummyDevice::mem_free(), MultiDevice::mem_free(), CPUDevice::mem_zero(), mem_zero(), DummyDevice::mem_zero(), and MultiDevice::mem_zero().

◆ device_sub_ptr

friend class device_sub_ptr
friend

Definition at line 137 of file device/device.h.

References device_sub_ptr.

Referenced by device_sub_ptr.

◆ DeviceServer

friend class DeviceServer
friend

Definition at line 309 of file device/device.h.

References DeviceServer.

Referenced by DeviceServer.

◆ MultiDevice

friend class MultiDevice
friend

Definition at line 308 of file device/device.h.

References MultiDevice.

Referenced by MultiDevice.

Member Data Documentation

◆ error_msg

string Device::error_msg
protected

Definition at line 145 of file device/device.h.

Referenced by dummy_device(), DummyDevice::DummyDevice(), error_message(), MultiDevice::error_message(), and set_error().

◆ headless

bool Device::headless = true

Definition at line 182 of file device/device.h.

Referenced by create(), Device(), and MultiDevice::MultiDevice().

◆ info

DeviceInfo Device::info

Definition at line 160 of file device/device.h.

Referenced by available_devices(), MultiDevice::build_bvh(), CPUDevice::CPUDevice(), Denoiser::create(), create(), PathTraceWork::create(), denoiser_device_report(), Device(), dummy_device(), DummyDevice::DummyDevice(), ShaderEval::eval(), ShaderEval::eval_cpu(), find_best_device(), CPUDevice::get_cpu_kernel_thread_globals(), get_effective_denoise_params(), Integrator::get_guiding_params(), get_multi_device(), is_single_device(), local_tbb_arena_create(), MultiDevice::MultiDevice(), PathTraceWorkCPU::PathTraceWorkCPU(), PathTrace::set_denoiser_params(), use_gpu_oidn_denoiser(), and use_optix_denoiser().

◆ profiler

Profiler& Device::profiler

Definition at line 181 of file device/device.h.

Referenced by create(), Device(), CPUDevice::get_cpu_kernel_thread_globals(), MultiDevice::MultiDevice(), and PathTrace::PathTrace().

◆ stats

Stats& Device::stats

Definition at line 180 of file device/device.h.

Referenced by CPUDevice::build_bvh(), build_bvh(), create(), Device(), MultiDevice::find_suitable_mem_device(), GPUDevice::generic_alloc(), GPUDevice::generic_free(), CPUDevice::global_alloc(), CPUDevice::global_free(), CPUDevice::mem_alloc(), MultiDevice::mem_alloc(), MultiDevice::mem_copy_to(), CPUDevice::mem_free(), MultiDevice::mem_free(), MultiDevice::mem_zero(), MultiDevice::MultiDevice(), PathTrace::PathTrace(), CPUDevice::tex_alloc(), and CPUDevice::tex_free().

The documentation for this class was generated from the following files:
Generated on Sat Oct 4 2025 05:32:23 for Blender by  doxygen 1.14.0