Deploying to master from @ gfx-rs/wgpu@a6d7e0d 🚀

Author: ErichDonGubler

doc/search-index.js

@@ -7613,7 +7613,48 @@
 <a href="#7612" id="7612">7612</a>
 <a href="#7613" id="7613">7613</a>
 <a href="#7614" id="7614">7614</a>
-<a href="#7615" id="7615">7615</a></pre></div><pre class="rust"><code><span class="doccomment">//! This library describes the API surface of WebGPU that is agnostic of the backend.
+<a href="#7615" id="7615">7615</a>
+<a href="#7616" id="7616">7616</a>
+<a href="#7617" id="7617">7617</a>
+<a href="#7618" id="7618">7618</a>
+<a href="#7619" id="7619">7619</a>
+<a href="#7620" id="7620">7620</a>
+<a href="#7621" id="7621">7621</a>
+<a href="#7622" id="7622">7622</a>
+<a href="#7623" id="7623">7623</a>
+<a href="#7624" id="7624">7624</a>
+<a href="#7625" id="7625">7625</a>
+<a href="#7626" id="7626">7626</a>
+<a href="#7627" id="7627">7627</a>
+<a href="#7628" id="7628">7628</a>
+<a href="#7629" id="7629">7629</a>
+<a href="#7630" id="7630">7630</a>
+<a href="#7631" id="7631">7631</a>
+<a href="#7632" id="7632">7632</a>
+<a href="#7633" id="7633">7633</a>
+<a href="#7634" id="7634">7634</a>
+<a href="#7635" id="7635">7635</a>
+<a href="#7636" id="7636">7636</a>
+<a href="#7637" id="7637">7637</a>
+<a href="#7638" id="7638">7638</a>
+<a href="#7639" id="7639">7639</a>
+<a href="#7640" id="7640">7640</a>
+<a href="#7641" id="7641">7641</a>
+<a href="#7642" id="7642">7642</a>
+<a href="#7643" id="7643">7643</a>
+<a href="#7644" id="7644">7644</a>
+<a href="#7645" id="7645">7645</a>
+<a href="#7646" id="7646">7646</a>
+<a href="#7647" id="7647">7647</a>
+<a href="#7648" id="7648">7648</a>
+<a href="#7649" id="7649">7649</a>
+<a href="#7650" id="7650">7650</a>
+<a href="#7651" id="7651">7651</a>
+<a href="#7652" id="7652">7652</a>
+<a href="#7653" id="7653">7653</a>
+<a href="#7654" id="7654">7654</a>
+<a href="#7655" id="7655">7655</a>
+<a href="#7656" id="7656">7656</a></pre></div><pre class="rust"><code><span class="doccomment">//! This library describes the API surface of WebGPU that is agnostic of the backend.
 //! This API is used for targeting both Web and Native.
 
 </span><span class="attr">#![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
@@ -11155,6 +11196,47 @@
     </span><span class="kw">pub fn </span>is_srgb(<span class="kw-2">&amp;</span><span class="self">self</span>) -&gt; bool {
         <span class="kw-2">*</span><span class="self">self </span>!= <span class="self">self</span>.remove_srgb_suffix()
     }
+
+    <span class="doccomment">/// Returns the theoretical memory footprint of a texture with the given format and dimensions.
+    ///
+    /// Actual memory usage may greatly exceed this value due to alignment and padding.
+    </span><span class="attr">#[must_use]
+    </span><span class="kw">pub fn </span>theoretical_memory_footprint(<span class="kw-2">&amp;</span><span class="self">self</span>, size: Extent3d) -&gt; u64 {
+        <span class="kw">let </span>(block_width, block_height) = <span class="self">self</span>.block_dimensions();
+
+        <span class="kw">let </span>block_size = <span class="self">self</span>.block_copy_size(<span class="prelude-val">None</span>);
+
+        <span class="kw">let </span>approximate_block_size = <span class="kw">match </span>block_size {
+            <span class="prelude-val">Some</span>(size) =&gt; size,
+            <span class="prelude-val">None </span>=&gt; <span class="kw">match </span><span class="self">self </span>{
+                <span class="comment">// One f16 per pixel
+                </span><span class="self">Self</span>::Depth16Unorm =&gt; <span class="number">2</span>,
+                <span class="comment">// One u24 per pixel, padded to 4 bytes
+                </span><span class="self">Self</span>::Depth24Plus =&gt; <span class="number">4</span>,
+                <span class="comment">// One u24 per pixel, plus one u8 per pixel
+                </span><span class="self">Self</span>::Depth24PlusStencil8 =&gt; <span class="number">4</span>,
+                <span class="comment">// One f32 per pixel
+                </span><span class="self">Self</span>::Depth32Float =&gt; <span class="number">4</span>,
+                <span class="comment">// One f32 per pixel, plus one u8 per pixel, with 3 bytes intermediary padding
+                </span><span class="self">Self</span>::Depth32FloatStencil8 =&gt; <span class="number">8</span>,
+                <span class="comment">// One u8 per pixel
+                </span><span class="self">Self</span>::Stencil8 =&gt; <span class="number">1</span>,
+                <span class="comment">// Two chroma bytes per block, one luma byte per block
+                </span><span class="self">Self</span>::NV12 =&gt; <span class="number">3</span>,
+                f =&gt; {
+                    <span class="macro">log::warn!</span>(<span class="string">"Memory footprint for format {:?} is not implemented"</span>, f);
+                    <span class="number">0
+                </span>}
+            },
+        };
+
+        <span class="kw">let </span>width_blocks = size.width.div_ceil(block_width) <span class="kw">as </span>u64;
+        <span class="kw">let </span>height_blocks = size.height.div_ceil(block_height) <span class="kw">as </span>u64;
+
+        <span class="kw">let </span>total_blocks = width_blocks * height_blocks * size.depth_or_array_layers <span class="kw">as </span>u64;
+
+        total_blocks * approximate_block_size <span class="kw">as </span>u64
+    }
 }
 
 <span class="attr">#[test]