Flutter Impeller
capabilities.cc
Go to the documentation of this file.
1 // Copyright 2013 The Flutter Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 
7 
8 namespace impeller {
9 
10 Capabilities::Capabilities() = default;
11 
12 Capabilities::~Capabilities() = default;
13 
14 class StandardCapabilities final : public Capabilities {
15  public:
16  // |Capabilities|
17  ~StandardCapabilities() override = default;
18 
19  // |Capabilities|
20  bool SupportsOffscreenMSAA() const override {
21  return supports_offscreen_msaa_;
22  }
23 
24  // |Capabilities|
25  bool SupportsImplicitResolvingMSAA() const override { return false; }
26 
27  // |Capabilities|
28  bool SupportsSSBO() const override { return supports_ssbo_; }
29 
30  // |Capabilities|
31  bool SupportsTextureToTextureBlits() const override {
32  return supports_texture_to_texture_blits_;
33  }
34 
35  // |Capabilities|
36  bool SupportsFramebufferFetch() const override {
37  return supports_framebuffer_fetch_;
38  }
39 
40  // |Capabilities|
41  bool SupportsCompute() const override { return supports_compute_; }
42 
43  // |Capabilities|
44  bool SupportsComputeSubgroups() const override {
45  return supports_compute_subgroups_;
46  }
47 
48  // |Capabilities|
49  bool SupportsReadFromResolve() const override {
50  return supports_read_from_resolve_;
51  }
52 
53  // |Capabilities|
54  bool SupportsDecalSamplerAddressMode() const override {
55  return supports_decal_sampler_address_mode_;
56  }
57 
58  // |Capabilities|
59  bool SupportsTriangleFan() const override { return supports_triangle_fan_; }
60 
61  // |Capabilities|
63  return default_color_format_;
64  }
65 
66  // |Capabilities|
68  return default_stencil_format_;
69  }
70 
71  // |Capabilities|
73  return default_depth_stencil_format_;
74  }
75 
76  // |Capabilities|
77  bool SupportsDeviceTransientTextures() const override {
78  return supports_device_transient_textures_;
79  }
80 
81  // |Capabilities|
83  return default_glyph_atlas_format_;
84  }
85 
86  // |Capabilities|
88  return default_maximum_render_pass_attachment_size_;
89  }
90 
91  // |Capabilities|
92  bool SupportsPrimitiveRestart() const override { return true; }
93 
94  private:
95  StandardCapabilities(bool supports_offscreen_msaa,
96  bool supports_ssbo,
97  bool supports_texture_to_texture_blits,
98  bool supports_framebuffer_fetch,
99  bool supports_compute,
100  bool supports_compute_subgroups,
101  bool supports_read_from_resolve,
102  bool supports_decal_sampler_address_mode,
103  bool supports_device_transient_textures,
104  bool supports_triangle_fan,
105  PixelFormat default_color_format,
106  PixelFormat default_stencil_format,
107  PixelFormat default_depth_stencil_format,
108  PixelFormat default_glyph_atlas_format,
109  ISize default_maximum_render_pass_attachment_size)
110  : supports_offscreen_msaa_(supports_offscreen_msaa),
111  supports_ssbo_(supports_ssbo),
112  supports_texture_to_texture_blits_(supports_texture_to_texture_blits),
113  supports_framebuffer_fetch_(supports_framebuffer_fetch),
114  supports_compute_(supports_compute),
115  supports_compute_subgroups_(supports_compute_subgroups),
116  supports_read_from_resolve_(supports_read_from_resolve),
117  supports_decal_sampler_address_mode_(
118  supports_decal_sampler_address_mode),
119  supports_device_transient_textures_(supports_device_transient_textures),
120  supports_triangle_fan_(supports_triangle_fan),
121  default_color_format_(default_color_format),
122  default_stencil_format_(default_stencil_format),
123  default_depth_stencil_format_(default_depth_stencil_format),
124  default_glyph_atlas_format_(default_glyph_atlas_format),
125  default_maximum_render_pass_attachment_size_(
126  default_maximum_render_pass_attachment_size) {}
127 
128  friend class CapabilitiesBuilder;
129 
130  bool supports_offscreen_msaa_ = false;
131  bool supports_ssbo_ = false;
132  bool supports_texture_to_texture_blits_ = false;
133  bool supports_framebuffer_fetch_ = false;
134  bool supports_compute_ = false;
135  bool supports_compute_subgroups_ = false;
136  bool supports_read_from_resolve_ = false;
137  bool supports_decal_sampler_address_mode_ = false;
138  bool supports_device_transient_textures_ = false;
139  bool supports_triangle_fan_ = false;
140  PixelFormat default_color_format_ = PixelFormat::kUnknown;
141  PixelFormat default_stencil_format_ = PixelFormat::kUnknown;
142  PixelFormat default_depth_stencil_format_ = PixelFormat::kUnknown;
143  PixelFormat default_glyph_atlas_format_ = PixelFormat::kUnknown;
144  ISize default_maximum_render_pass_attachment_size_ = ISize(1, 1);
145 
147 
148  StandardCapabilities& operator=(const StandardCapabilities&) = delete;
149 };
150 
152 
154 
156  supports_offscreen_msaa_ = value;
157  return *this;
158 }
159 
161  supports_ssbo_ = value;
162  return *this;
163 }
164 
166  bool value) {
167  supports_texture_to_texture_blits_ = value;
168  return *this;
169 }
170 
172  bool value) {
173  supports_framebuffer_fetch_ = value;
174  return *this;
175 }
176 
178  supports_compute_ = value;
179  return *this;
180 }
181 
183  bool value) {
184  supports_compute_subgroups_ = value;
185  return *this;
186 }
187 
189  PixelFormat value) {
190  default_color_format_ = value;
191  return *this;
192 }
193 
195  PixelFormat value) {
196  default_stencil_format_ = value;
197  return *this;
198 }
199 
201  PixelFormat value) {
202  default_depth_stencil_format_ = value;
203  return *this;
204 }
205 
207  bool read_from_resolve) {
208  supports_read_from_resolve_ = read_from_resolve;
209  return *this;
210 }
211 
213  bool value) {
214  supports_decal_sampler_address_mode_ = value;
215  return *this;
216 }
217 
219  bool value) {
220  supports_device_transient_textures_ = value;
221  return *this;
222 }
223 
225  PixelFormat value) {
226  default_glyph_atlas_format_ = value;
227  return *this;
228 }
229 
231  supports_triangle_fan_ = value;
232  return *this;
233 }
234 
236  ISize size) {
237  default_maximum_render_pass_attachment_size_ = size;
238  return *this;
239 }
240 
241 std::unique_ptr<Capabilities> CapabilitiesBuilder::Build() {
242  return std::unique_ptr<StandardCapabilities>(new StandardCapabilities( //
243  supports_offscreen_msaa_, //
244  supports_ssbo_, //
245  supports_texture_to_texture_blits_, //
246  supports_framebuffer_fetch_, //
247  supports_compute_, //
248  supports_compute_subgroups_, //
249  supports_read_from_resolve_, //
250  supports_decal_sampler_address_mode_, //
251  supports_device_transient_textures_, //
252  supports_triangle_fan_, //
253  default_color_format_.value_or(PixelFormat::kUnknown), //
254  default_stencil_format_.value_or(PixelFormat::kUnknown), //
255  default_depth_stencil_format_.value_or(PixelFormat::kUnknown), //
256  default_glyph_atlas_format_.value_or(PixelFormat::kUnknown), //
257  default_maximum_render_pass_attachment_size_.value_or(ISize{1, 1}) //
258  ));
259 }
260 
261 } // namespace impeller
CapabilitiesBuilder & SetDefaultColorFormat(PixelFormat value)
CapabilitiesBuilder & SetSupportsComputeSubgroups(bool value)
CapabilitiesBuilder & SetSupportsTextureToTextureBlits(bool value)
CapabilitiesBuilder & SetDefaultStencilFormat(PixelFormat value)
CapabilitiesBuilder & SetSupportsDeviceTransientTextures(bool value)
CapabilitiesBuilder & SetSupportsTriangleFan(bool value)
CapabilitiesBuilder & SetSupportsFramebufferFetch(bool value)
CapabilitiesBuilder & SetSupportsDecalSamplerAddressMode(bool value)
CapabilitiesBuilder & SetSupportsOffscreenMSAA(bool value)
CapabilitiesBuilder & SetSupportsSSBO(bool value)
CapabilitiesBuilder & SetMaximumRenderPassAttachmentSize(ISize size)
CapabilitiesBuilder & SetDefaultGlyphAtlasFormat(PixelFormat value)
CapabilitiesBuilder & SetSupportsCompute(bool value)
std::unique_ptr< Capabilities > Build()
CapabilitiesBuilder & SetDefaultDepthStencilFormat(PixelFormat value)
CapabilitiesBuilder & SetSupportsReadFromResolve(bool value)
~StandardCapabilities() override=default
bool SupportsReadFromResolve() const override
Whether the context backend supports binding the current RenderPass attachments. This is supported if...
Definition: capabilities.cc:49
PixelFormat GetDefaultDepthStencilFormat() const override
Returns a supported PixelFormat for textures that store both a stencil and depth component....
Definition: capabilities.cc:72
bool SupportsComputeSubgroups() const override
Whether the context backend supports configuring ComputePass command subgroups.
Definition: capabilities.cc:44
bool SupportsOffscreenMSAA() const override
Whether the context backend supports attaching offscreen MSAA color/stencil textures.
Definition: capabilities.cc:20
ISize GetMaximumRenderPassAttachmentSize() const override
Return the maximum size of a render pass attachment.
Definition: capabilities.cc:87
bool SupportsTextureToTextureBlits() const override
Whether the context backend supports blitting from one texture region to another texture region (via ...
Definition: capabilities.cc:31
bool SupportsFramebufferFetch() const override
Whether the context backend is able to support pipelines with shaders that read from the framebuffer ...
Definition: capabilities.cc:36
PixelFormat GetDefaultGlyphAtlasFormat() const override
Returns the default pixel format for the alpha bitmap glyph atlas.
Definition: capabilities.cc:82
PixelFormat GetDefaultStencilFormat() const override
Returns a supported PixelFormat for textures that store stencil information. May include a depth chan...
Definition: capabilities.cc:67
bool SupportsCompute() const override
Whether the context backend supports ComputePass.
Definition: capabilities.cc:41
bool SupportsSSBO() const override
Whether the context backend supports binding Shader Storage Buffer Objects (SSBOs) to pipelines.
Definition: capabilities.cc:28
bool SupportsDeviceTransientTextures() const override
Whether the context backend supports allocating StorageMode::kDeviceTransient (aka "memoryless") text...
Definition: capabilities.cc:77
bool SupportsImplicitResolvingMSAA() const override
Whether the context backend supports multisampled rendering to the on-screen surface without requirin...
Definition: capabilities.cc:25
bool SupportsPrimitiveRestart() const override
Whether primitive restart is supported.
Definition: capabilities.cc:92
PixelFormat GetDefaultColorFormat() const override
Returns a supported PixelFormat for textures that store 4-channel colors (red/green/blue/alpha).
Definition: capabilities.cc:62
bool SupportsTriangleFan() const override
Whether the primitive type TriangleFan is supported by the backend.
Definition: capabilities.cc:59
bool SupportsDecalSamplerAddressMode() const override
Whether the context backend supports SamplerAddressMode::Decal.
Definition: capabilities.cc:54
int32_t value
PixelFormat
The Pixel formats supported by Impeller. The naming convention denotes the usage of the component,...
Definition: formats.h:99
ISize64 ISize
Definition: size.h:174