BLContextCreateInfo Struct Reference [¶]
Information that can be used to customize the rendering context.
Public Members
uint32_t flags
uint32_t thread_count
uint32_t cpu_features
uint32_t command_queue_limit
uint32_t saved_state_limit
uint32_t reserved[1]
uint32_t BLContextCreateInfo::flags[¶]
Create flags, see BLContextCreateFlags.
uint32_t BLContextCreateInfo::thread_count[¶]
Number of worker threads to use for asynchronous rendering, if non-zero.
If thread_count is zero it means to initialize the context for synchronous rendering. This means that every operation will take effect immediately. If thread_count is 1 it means that the rendering will be asynchronous, but no thread would be acquired from a thread-pool, because the user thread will be used as a worker. And finally, if thread_count is greater than 1 then total of thread_count - 1 threads will be acquired from thread-pool and used as additional workers.
uint32_t BLContextCreateInfo::cpu_features[¶]
CPU features to use in isolated JIT runtime (if supported), only used when flags contains BL_CONTEXT_CREATE_FLAG_OVERRIDE_CPU_FEATURES.
uint32_t BLContextCreateInfo::command_queue_limit[¶]
Maximum number of commands to be queued.
If this parameter is zero the queue size will be determined automatically.
TODO: To be documented, has no effect at the moment.
uint32_t BLContextCreateInfo::saved_state_limit[¶]
Maximum number of saved states.
Note
Zero value tells the rendering engine to use the default saved state limit, which currently defaults to 4096 states. This option allows to even increase or decrease the limit, depending on the use case.
BLPointI BLContextCreateInfo::pixel_origin[¶]
Pixel origin.
Pixel origin is an offset in pixel units that can be used as an origin for fetchers and effects that use a pixel X/Y coordinate in the calculation. One example of using pixel origin is dithering, where it's used to shift the dithering matrix.
uint32_t BLContextCreateInfo::reserved[1][¶]
Reserved for future use, must be zero.