Member Functions

virtual bool mi::​neuraylib::​IScheduling_configuration::get_accept_delegations() const [pure virtual]

Returns if delegations of work are currently accepted from other hosts.

See also:

set_accept_delegations()

Returns

The currently configured value.

virtual Float32 mi::​neuraylib::​IScheduling_configuration::get_cpu_load_limit() const [pure virtual]

Returns the CPU load limit.

See also:

set_cpu_load_limit()

virtual Float32 mi::​neuraylib::​IScheduling_configuration::get_gpu_load_limit() const [pure virtual]

Returns the GPU load limit.

See also:

set_gpu_load_limit()

virtual bool mi::​neuraylib::​IScheduling_configuration::get_gpu_work_delegation_enabled() const [pure virtual]

Returns if GPU work is currently delegated to other hosts. Note that this reflects the configured value but is not affected by disabling work delegation completely.

See also:

set_gpu_work_delegation_enabled(), set_work_delegation_enabled(), get_work_delegation_enabled()

Returns

The currently configured value.

virtual bool mi::​neuraylib::​IScheduling_configuration::get_thread_affinity_enabled() const [pure virtual]

Returns the CPU affinity for threads.

See also:

set_thread_affinity_enabled()

virtual bool mi::​neuraylib::​IScheduling_configuration::get_work_delegation_enabled() const [pure virtual]

Returns if work is currently delegated to other hosts.

See also:

set_work_delegation_enabled()

Returns

The currently configured value.

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_accept_delegations( bool value) [pure virtual]

Sets if the host accepts delegations from other hosts. This can be called at any time by any thread. Enforcing the limitation may take a short amount of time, though, because current delegations will still be handled.

See also:

get_accept_delegations()

Parameters

value

true if delegations are accepted, false otherwise.

Returns

0, in case of success, -1 in case of failure.

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_cpu_load_limit( Float32 limit) [pure virtual]

Sets the CPU load limit. The CPU load is the sum of the CPU loads caused by all currently active threads. A single thread fully using a single CPU core is said to cause a CPU load of 1.0. The CPU load limit defaults to the number of CPU cores.

Note:

If the limit is reduced, it might take some time until the current CPU load obeys the limit.

See also:

get_cpu_load_limit()

Parameters

limit

The new CPU load limit. The value might be clamped against some upper bound imposed by license restrictions.

Returns

• 0: Success
• -1: Invalid new limit (less than 1.0).

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_gpu_load_limit( Float32 limit) [pure virtual]

Sets the GPU load limit. The GPU load is the sum of the GPU loads caused by all currently active threads. A single thread fully using a single GPU is said to cause a GPU load of 1.0. The GPU load limit defaults to the number of GPUs.

Note:

If the limit is reduced, it might take some time until the current GPU load obeys the limit.

See also:

get_gpu_load_limit()

Parameters

limit

The new GPU load limit. The value might be clamped against some upper bound imposed by license restrictions.

Returns

• 0: Success
• -1: Invalid new limit (less than 1.0).

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_gpu_work_delegation_enabled( bool value) [pure virtual]

Sets if the host will currently delegate GPU work to other hosts. This can be called at any time by any thread. Enforcing the limitation may take a short amount of time, though, because current delegations will still be handled.

Note that if the system does not delegate work at all this is also applied to GPU work. Thus, even if this is set to true, no GPU work will be delegated if work delegation as a whole is disabled.

See also:

get_gpu_work_delegation_enabled(), set_work_delegation_enabled(), get_work_delegation_enabled()

Parameters

value

true if work is delegated, false otherwise.

Returns

0, in case of success, -1 in case of failure.

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_thread_affinity_enabled( bool value) [pure virtual]

Sets the CPU affinity for threads. If thread affinity is enabled for a thread then this thread is bound to the CPU it is currently running on. If thread affinity is disabled (the default) the operating system is free to migrate the thread between CPUs as it sees fit (which might suffer from cache misses).

This thread affinity setting only affects internal threads that are used to execute jobs. Application threads are not affected by this setting.

Note that changing this value does not affect a job that is currently being executed, it only affects subsequently started jobs (or fragments thereof).

This method can only be used while is running.

Parameters

value

Returns

• 0: Success.
• -1: Setting the thread affinity is not supported for this (Linux with glibc older than 2.6 and MacOS X).
• -2: The method cannot be called at this point of time.

virtual Sint32 mi::​neuraylib::​IScheduling_configuration::set_work_delegation_enabled( bool value) [pure virtual]

Sets if the host will currently delegate work to other hosts. This can be called at any time by any thread. Enforcing the limitation may take a short amount of time, though, because current delegations will still be handled.

See also:

get_work_delegation_enabled()

Parameters

value

true if work is delegated, false otherwise.

Returns

0, in case of success, -1 in case of failure.