1use wgt::TextureFormatFeatures;
2
3use crate::resource::{self, TextureDescriptor};
4
5#[cfg_attr(any(not(webgl)), expect(unused))]
9pub fn is_valid_external_image_copy_dst_texture_format(format: wgt::TextureFormat) -> bool {
10 use wgt::TextureFormat as Tf;
11 match format {
12 Tf::R8Unorm
13 | Tf::R16Float
14 | Tf::R32Float
15 | Tf::Rg8Unorm
16 | Tf::Rg16Float
17 | Tf::Rg32Float
18 | Tf::Rgba8Unorm
19 | Tf::Rgba8UnormSrgb
20 | Tf::Bgra8Unorm
21 | Tf::Bgra8UnormSrgb
22 | Tf::Rgb10a2Unorm
23 | Tf::Rgba16Float
24 | Tf::Rgba32Float => true,
25 _ => false,
26 }
27}
28
29pub fn map_buffer_usage(usage: wgt::BufferUsages) -> wgt::BufferUses {
30 let mut u = wgt::BufferUses::empty();
31 u.set(
32 wgt::BufferUses::MAP_READ,
33 usage.contains(wgt::BufferUsages::MAP_READ),
34 );
35 u.set(
36 wgt::BufferUses::MAP_WRITE,
37 usage.contains(wgt::BufferUsages::MAP_WRITE),
38 );
39 u.set(
40 wgt::BufferUses::COPY_SRC,
41 usage.contains(wgt::BufferUsages::COPY_SRC),
42 );
43 u.set(
44 wgt::BufferUses::COPY_DST,
45 usage.contains(wgt::BufferUsages::COPY_DST),
46 );
47 u.set(
48 wgt::BufferUses::INDEX,
49 usage.contains(wgt::BufferUsages::INDEX),
50 );
51 u.set(
52 wgt::BufferUses::VERTEX,
53 usage.contains(wgt::BufferUsages::VERTEX),
54 );
55 u.set(
56 wgt::BufferUses::UNIFORM,
57 usage.contains(wgt::BufferUsages::UNIFORM),
58 );
59 u.set(
60 wgt::BufferUses::STORAGE_READ_ONLY | wgt::BufferUses::STORAGE_READ_WRITE,
61 usage.contains(wgt::BufferUsages::STORAGE),
62 );
63 u.set(
64 wgt::BufferUses::INDIRECT,
65 usage.contains(wgt::BufferUsages::INDIRECT),
66 );
67 u.set(
68 wgt::BufferUses::QUERY_RESOLVE,
69 usage.contains(wgt::BufferUsages::QUERY_RESOLVE),
70 );
71 u.set(
72 wgt::BufferUses::BOTTOM_LEVEL_ACCELERATION_STRUCTURE_INPUT,
73 usage.contains(wgt::BufferUsages::BLAS_INPUT),
74 );
75 u.set(
76 wgt::BufferUses::TOP_LEVEL_ACCELERATION_STRUCTURE_INPUT,
77 usage.contains(wgt::BufferUsages::TLAS_INPUT),
78 );
79 u
80}
81
82pub fn map_texture_usage(
83 usage: wgt::TextureUsages,
84 aspect: hal::FormatAspects,
85 flags: wgt::TextureFormatFeatureFlags,
86) -> wgt::TextureUses {
87 let mut u = wgt::TextureUses::empty();
88 u.set(
89 wgt::TextureUses::COPY_SRC,
90 usage.contains(wgt::TextureUsages::COPY_SRC),
91 );
92 u.set(
93 wgt::TextureUses::COPY_DST,
94 usage.contains(wgt::TextureUsages::COPY_DST),
95 );
96 u.set(
97 wgt::TextureUses::RESOURCE,
98 usage.contains(wgt::TextureUsages::TEXTURE_BINDING),
99 );
100 if usage.contains(wgt::TextureUsages::STORAGE_BINDING) {
101 u.set(
102 wgt::TextureUses::STORAGE_READ_ONLY,
103 flags.contains(wgt::TextureFormatFeatureFlags::STORAGE_READ_ONLY),
104 );
105 u.set(
106 wgt::TextureUses::STORAGE_WRITE_ONLY,
107 flags.contains(wgt::TextureFormatFeatureFlags::STORAGE_WRITE_ONLY),
108 );
109 u.set(
110 wgt::TextureUses::STORAGE_READ_WRITE,
111 flags.contains(wgt::TextureFormatFeatureFlags::STORAGE_READ_WRITE),
112 );
113 }
114 let is_color = aspect.contains(hal::FormatAspects::COLOR);
115 u.set(
116 wgt::TextureUses::COLOR_TARGET,
117 usage.contains(wgt::TextureUsages::RENDER_ATTACHMENT) && is_color,
118 );
119 u.set(
120 wgt::TextureUses::DEPTH_STENCIL_READ | wgt::TextureUses::DEPTH_STENCIL_WRITE,
121 usage.contains(wgt::TextureUsages::RENDER_ATTACHMENT) && !is_color,
122 );
123 u.set(
124 wgt::TextureUses::STORAGE_ATOMIC,
125 usage.contains(wgt::TextureUsages::STORAGE_ATOMIC),
126 );
127 u
128}
129
130pub fn map_texture_usage_for_texture(
131 desc: &TextureDescriptor,
132 format_features: &TextureFormatFeatures,
133) -> wgt::TextureUses {
134 map_texture_usage(desc.usage, desc.format.into(), format_features.flags)
137 | if desc.format.is_depth_stencil_format() {
138 wgt::TextureUses::DEPTH_STENCIL_WRITE
139 } else if desc.usage.contains(wgt::TextureUsages::COPY_DST) {
140 wgt::TextureUses::COPY_DST } else {
142 if format_features
144 .allowed_usages
145 .contains(wgt::TextureUsages::RENDER_ATTACHMENT)
146 && desc.dimension == wgt::TextureDimension::D2
147 {
149 wgt::TextureUses::COLOR_TARGET
150 } else {
151 wgt::TextureUses::COPY_DST
152 }
153 }
154}
155
156pub fn map_texture_usage_from_hal(uses: wgt::TextureUses) -> wgt::TextureUsages {
157 let mut u = wgt::TextureUsages::empty();
158 u.set(
159 wgt::TextureUsages::COPY_SRC,
160 uses.contains(wgt::TextureUses::COPY_SRC),
161 );
162 u.set(
163 wgt::TextureUsages::COPY_DST,
164 uses.contains(wgt::TextureUses::COPY_DST),
165 );
166 u.set(
167 wgt::TextureUsages::TEXTURE_BINDING,
168 uses.contains(wgt::TextureUses::RESOURCE),
169 );
170 u.set(
171 wgt::TextureUsages::STORAGE_BINDING,
172 uses.intersects(
173 wgt::TextureUses::STORAGE_READ_ONLY
174 | wgt::TextureUses::STORAGE_WRITE_ONLY
175 | wgt::TextureUses::STORAGE_READ_WRITE,
176 ),
177 );
178 u.set(
179 wgt::TextureUsages::RENDER_ATTACHMENT,
180 uses.contains(wgt::TextureUses::COLOR_TARGET),
181 );
182 u.set(
183 wgt::TextureUsages::STORAGE_ATOMIC,
184 uses.contains(wgt::TextureUses::STORAGE_ATOMIC),
185 );
186 u
187}
188
189pub fn check_texture_dimension_size(
190 dimension: wgt::TextureDimension,
191 wgt::Extent3d {
192 width,
193 height,
194 depth_or_array_layers,
195 }: wgt::Extent3d,
196 sample_size: u32,
197 limits: &wgt::Limits,
198) -> Result<(), resource::TextureDimensionError> {
199 use resource::{TextureDimensionError as Tde, TextureErrorDimension as Ted};
200 use wgt::TextureDimension::*;
201
202 let (extent_limits, sample_limit) = match dimension {
203 D1 => ([limits.max_texture_dimension_1d, 1, 1], 1),
204 D2 => (
205 [
206 limits.max_texture_dimension_2d,
207 limits.max_texture_dimension_2d,
208 limits.max_texture_array_layers,
209 ],
210 32,
211 ),
212 D3 => (
213 [
214 limits.max_texture_dimension_3d,
215 limits.max_texture_dimension_3d,
216 limits.max_texture_dimension_3d,
217 ],
218 1,
219 ),
220 };
221
222 for (&dim, (&given, &limit)) in [Ted::X, Ted::Y, Ted::Z].iter().zip(
223 [width, height, depth_or_array_layers]
224 .iter()
225 .zip(extent_limits.iter()),
226 ) {
227 if given == 0 {
228 return Err(Tde::Zero(dim));
229 }
230 if given > limit {
231 return Err(Tde::LimitExceeded { dim, given, limit });
232 }
233 }
234 if sample_size == 0 || sample_size > sample_limit || !sample_size.is_power_of_two() {
235 return Err(Tde::InvalidSampleCount(sample_size));
236 }
237
238 Ok(())
239}
240
241pub fn bind_group_layout_flags(features: wgt::Features) -> hal::BindGroupLayoutFlags {
242 let mut flags = hal::BindGroupLayoutFlags::empty();
243 flags.set(
244 hal::BindGroupLayoutFlags::PARTIALLY_BOUND,
245 features.contains(wgt::Features::PARTIALLY_BOUND_BINDING_ARRAY),
246 );
247 flags
248}