| Flutter Impeller |

Public Member Functions | Friends | List of all members
impeller::StandardCapabilities Class Referencefinal
Inheritance diagram for impeller::StandardCapabilities:

## Public Member Functions
| ~StandardCapabilities () override=default
bool | SupportsOffscreenMSAA () const override
| Whether the context backend supports attaching offscreen MSAA color/stencil textures. More...
bool | SupportsImplicitResolvingMSAA () const override
| Whether the context backend supports multisampled rendering to the on-screen surface without requiring an explicit resolve of the MSAA color attachment. More...
bool | SupportsSSBO () const override
| Whether the context backend supports binding Shader Storage Buffer Objects (SSBOs) to pipelines. More...
bool | SupportsBufferToTextureBlits () const override
| Whether the context backend supports blitting from a given `DeviceBuffer` view to a texture region (via the relevant `BlitPass::AddCopy` overloads). More...
bool | SupportsTextureToTextureBlits () const override
| Whether the context backend supports blitting from one texture region to another texture region (via the relevant `BlitPass::AddCopy` overloads). More...
bool | SupportsFramebufferFetch () const override
| Whether the context backend is able to support pipelines with shaders that read from the framebuffer (i.e. pixels that have been written by previous draw calls in the current render pass). More...
bool | SupportsCompute () const override
| Whether the context backend supports `ComputePass`. More...
bool | SupportsComputeSubgroups () const override
| Whether the context backend supports configuring `ComputePass` command subgroups. More...
bool | SupportsReadFromResolve () const override
| Whether the context backend supports binding the current `RenderPass` attachments. This is supported if the backend can guarantee that attachment textures will not be mutated until the render pass has fully completed. More...
bool | SupportsDecalSamplerAddressMode () const override
| Whether the context backend supports `SamplerAddressMode::Decal`. More...
PixelFormat | GetDefaultColorFormat () const override
| Returns a supported `PixelFormat` for textures that store 4-channel colors (red/green/blue/alpha). More...
PixelFormat | GetDefaultStencilFormat () const override
| Returns a supported `PixelFormat` for textures that store stencil information. May include a depth channel if a stencil-only format is not available. More...
PixelFormat | GetDefaultDepthStencilFormat () const override
| Returns a supported `PixelFormat` for textures that store both a stencil and depth component. This will never return a depth-only or stencil-only texture. Returns `PixelFormat::kUnknown` if no suitable depth+stencil format was found. More...
bool | SupportsDeviceTransientTextures () const override
| Whether the context backend supports allocating `StorageMode::kDeviceTransient` (aka "memoryless") textures, which are temporary textures kept in tile memory for the duration of the `RenderPass` it's attached to. More...
Public Member Functions inherited from impeller::Capabilities
virtual | ~Capabilities ()

## Friends
class | CapabilitiesBuilder

## Additional Inherited Members
Protected Member Functions inherited from impeller::Capabilities
| Capabilities ()
| Capabilities (const Capabilities &)=delete
Capabilities & | operator= (const Capabilities &)=delete

## Detailed Description

Definition at line 13 of file capabilities.cc.

## Constructor & Destructor Documentation

## ◆ ~StandardCapabilities()

impeller::StandardCapabilities::~StandardCapabilities | ( |  | ) |
| override default

## Member Function Documentation

## ◆ GetDefaultColorFormat()

PixelFormat impeller::StandardCapabilities::GetDefaultColorFormat | ( |  | ) | const
| inline override virtual

Returns a supported `PixelFormat` for textures that store 4-channel colors (red/green/blue/alpha).

Implements impeller::Capabilities.

Definition at line 63 of file capabilities.cc.

63 {
64 return default_color_format_;
65 }

## ◆ GetDefaultDepthStencilFormat()

PixelFormat impeller::StandardCapabilities::GetDefaultDepthStencilFormat | ( |  | ) | const
| inline override virtual

Returns a supported `PixelFormat` for textures that store both a stencil and depth component. This will never return a depth-only or stencil-only texture. Returns `PixelFormat::kUnknown` if no suitable depth+stencil format was found.

Implements impeller::Capabilities.

Definition at line 73 of file capabilities.cc.

73 {
74 return default_depth_stencil_format_;
75 }

## ◆ GetDefaultStencilFormat()

PixelFormat impeller::StandardCapabilities::GetDefaultStencilFormat | ( |  | ) | const
| inline override virtual

Returns a supported `PixelFormat` for textures that store stencil information. May include a depth channel if a stencil-only format is not available.

Implements impeller::Capabilities.

Definition at line 68 of file capabilities.cc.

68 {
69 return default_stencil_format_;
70 }

## ◆ SupportsBufferToTextureBlits()

bool impeller::StandardCapabilities::SupportsBufferToTextureBlits | ( |  | ) | const
| inline override virtual

Whether the context backend supports blitting from a given `DeviceBuffer` view to a texture region (via the relevant `BlitPass::AddCopy` overloads).

Implements impeller::Capabilities.

Definition at line 30 of file capabilities.cc.

30 {
31 return supports_buffer_to_texture_blits_;
32 }

## ◆ SupportsCompute()

bool impeller::StandardCapabilities::SupportsCompute | ( |  | ) | const
| inline override virtual

Whether the context backend supports `ComputePass`.

Implements impeller::Capabilities.

Definition at line 45 of file capabilities.cc.

45 { return supports_compute_; }

## ◆ SupportsComputeSubgroups()

bool impeller::StandardCapabilities::SupportsComputeSubgroups | ( |  | ) | const
| inline override virtual

Whether the context backend supports configuring `ComputePass` command subgroups.

Implements impeller::Capabilities.

Definition at line 48 of file capabilities.cc.

48 {
49 return supports_compute_subgroups_;
50 }

## ◆ SupportsDecalSamplerAddressMode()

bool impeller::StandardCapabilities::SupportsDecalSamplerAddressMode | ( |  | ) | const
| inline override virtual

Whether the context backend supports `SamplerAddressMode::Decal`.

Implements impeller::Capabilities.

Definition at line 58 of file capabilities.cc.

58 {
59 return supports_decal_sampler_address_mode_;
60 }

## ◆ SupportsDeviceTransientTextures()

bool impeller::StandardCapabilities::SupportsDeviceTransientTextures | ( |  | ) | const
| inline override virtual

Whether the context backend supports allocating `StorageMode::kDeviceTransient` (aka "memoryless") textures, which are temporary textures kept in tile memory for the duration of the `RenderPass` it's attached to.

This feature is especially useful for MSAA and stencils.

Implements impeller::Capabilities.

Definition at line 77 of file capabilities.cc.

77 {
78 return supports_device_transient_textures_;
79 }

## ◆ SupportsFramebufferFetch()

bool impeller::StandardCapabilities::SupportsFramebufferFetch | ( |  | ) | const
| inline override virtual

Whether the context backend is able to support pipelines with shaders that read from the framebuffer (i.e. pixels that have been written by previous draw calls in the current render pass).

Example of reading from the first color attachment in a GLSL shader: ``` uniform subpassInput subpass_input;

out vec4 frag_color;

void main() { vec4 color = subpassLoad(subpass_input); // Invert the colors drawn to the framebuffer. frag_color = vec4(vec3(1) - color.rgb, color.a); } ```

Implements impeller::Capabilities.

Definition at line 40 of file capabilities.cc.

40 {
41 return supports_framebuffer_fetch_;
42 }

## ◆ SupportsImplicitResolvingMSAA()

bool impeller::StandardCapabilities::SupportsImplicitResolvingMSAA | ( |  | ) | const
| inline override virtual

Whether the context backend supports multisampled rendering to the on-screen surface without requiring an explicit resolve of the MSAA color attachment.

Implements impeller::Capabilities.

Definition at line 24 of file capabilities.cc.

24 { return false; }

## ◆ SupportsOffscreenMSAA()

bool impeller::StandardCapabilities::SupportsOffscreenMSAA | ( |  | ) | const
| inline override virtual

Whether the context backend supports attaching offscreen MSAA color/stencil textures.

Implements impeller::Capabilities.

Definition at line 19 of file capabilities.cc.

19 {
20 return supports_offscreen_msaa_;
21 }

## ◆ SupportsReadFromResolve()

bool impeller::StandardCapabilities::SupportsReadFromResolve | ( |  | ) | const
| inline override virtual

Whether the context backend supports binding the current `RenderPass` attachments. This is supported if the backend can guarantee that attachment textures will not be mutated until the render pass has fully completed.

This is possible because many mobile graphics cards track `RenderPass` attachment state in intermediary tile memory prior to Storing the pass in the heap allocated attachments on DRAM. Metal's hazard tracking and Vulkan's barriers are granular enough to allow for safely accessing attachment textures prior to storage in the same `RenderPass`.

Implements impeller::Capabilities.

Definition at line 53 of file capabilities.cc.

53 {
54 return supports_read_from_resolve_;
55 }

## ◆ SupportsSSBO()

bool impeller::StandardCapabilities::SupportsSSBO | ( |  | ) | const
| inline override virtual

Whether the context backend supports binding Shader Storage Buffer Objects (SSBOs) to pipelines.

Implements impeller::Capabilities.

Definition at line 27 of file capabilities.cc.

27 { return supports_ssbo_; }

## ◆ SupportsTextureToTextureBlits()

bool impeller::StandardCapabilities::SupportsTextureToTextureBlits | ( |  | ) | const
| inline override virtual

Whether the context backend supports blitting from one texture region to another texture region (via the relevant `BlitPass::AddCopy` overloads).

Implements impeller::Capabilities.

Definition at line 35 of file capabilities.cc.

35 {
36 return supports_texture_to_texture_blits_;
37 }

## Friends And Related Function Documentation

## ◆ CapabilitiesBuilder

friend class CapabilitiesBuilder
| friend

Definition at line 110 of file capabilities.cc.

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

- impeller/renderer/capabilities.cc