TBLContextCreateInfo

Information that can be used to customize the rendering context.

Definition

Unit: Blend2D

type TBLContextCreateInfo = record ... end;

Fields

Name	Description
_Reserved	Reserved for future use, must be zero.
CommandQueueLimit	Maximum number of commands to be queued.
CpuFeatures	CPU features to use in isolated JIT runtime (if supported), only used when Flags contains TBLContextCreateFlag.OverrideCpuFeatures.
Flags	Create flags.
PixelOrigin	Pixel origin.
SavedStateLimit	Maximum number of saved states.
ThreadCount	Number of worker threads to use for asynchronous rendering, if non-zero.

Methods

Name	Description
Reset

Field Descriptions

_Reserved

Reserved for future use, must be zero.

var _Reserved: Cardinal

Type: Cardinal

---

CommandQueueLimit

Maximum number of commands to be queued.

If this parameter is zero the queue size will be determined automatically.

var CommandQueueLimit: Integer

Type: Integer

---

CpuFeatures

CPU features to use in isolated JIT runtime (if supported), only used when Flags contains TBLContextCreateFlag.OverrideCpuFeatures.

var CpuFeatures: Cardinal

Type: Cardinal

---

Flags

Create flags.

var Flags: TBLContextCreateFlags

Type: TBLContextCreateFlags

---

PixelOrigin

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.

var PixelOrigin: TBLPointI

Type: TBLPointI

---

SavedStateLimit

Maximum number of saved states.

var SavedStateLimit: Integer

Type: Integer

Remarks

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.

---

ThreadCount

Number of worker threads to use for asynchronous rendering, if non-zero.

If ThreadCount is zero it means to initialize the context for synchronous rendering. This means that every operation will take effect immediately. If ThreadCount 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 ThreadCount is greater than 1 then total of ThreadCount - 1 threads will be acquired from thread-pool and used as additional workers.

var ThreadCount: Integer

Type: Integer

---

Method Descriptions

Reset

procedure Reset; inline

---