docs
Loading...
Searching...
No Matches
ULGPUDeviceCaps

#include <Ultralight/CAPI/CAPI_GPUDriver.h>

Overview

Optional capabilities reported by a ULGPUDriver.

The library zero-initializes this structure and passes it to your get_device_caps callback. Your driver fills in what it supports.

A capability field left at zero means the feature is not supported.

A limit field left at zero uses the library's built-in default.

Leaving a capability unset still produces correct output, but it can reduce performance– for example, leaving supports_partial_redraw unset forces the library to redraw the whole View on every composite.

See <Ultralight/platform/GPUDriver.h> for full field semantics.

Public Attributes

unsigned int compressed_formats
 Bitwise OR of supported ULGPUCompressedFormat values.
unsigned int supports_msaa
 Nonzero if multisampled render targets are supported.
unsigned int max_texture_dimension
 Largest texture width/height, in pixels (0 = default).
unsigned int max_msaa_samples
 Sample count for multisampled targets (0 = default).
unsigned int max_geometry_size
 Largest vertex/index buffer, in bytes (0 = default).
unsigned int supports_partial_redraw
 Whether or not the library may redraw only the changed region of a View's render target.

Member Data Documentation

◆ compressed_formats

unsigned int compressed_formats

Bitwise OR of supported ULGPUCompressedFormat values.

◆ max_geometry_size

unsigned int max_geometry_size

Largest vertex/index buffer, in bytes (0 = default).

◆ max_msaa_samples

unsigned int max_msaa_samples

Sample count for multisampled targets (0 = default).

◆ max_texture_dimension

unsigned int max_texture_dimension

Largest texture width/height, in pixels (0 = default).

◆ supports_msaa

unsigned int supports_msaa

Nonzero if multisampled render targets are supported.

◆ supports_partial_redraw

unsigned int supports_partial_redraw

Whether or not the library may redraw only the changed region of a View's render target.

When set to 0 (the default), every composite with changes clears and redraws the entire View target, even for a small change.

Set this to 1 when the View's render target keeps its contents between frames.

Warning
When nonzero, the View's render target must keep its contents between frames. Bind the target without clearing, discarding, or using a "don't care" load action. Clear the target only when handling kCommandType_ClearRenderBuffer. The same native texture must also back each texture ID across frames.

The documentation for this struct was generated from the following file: