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

Author: cwfitzgerald

doc/search-index.js

@@ -430,7 +430,7 @@
     /// If no backend feature for the active target platform is enabled,
     /// this method will panic, see [`Instance::enabled_backend_features()`].
     </span><span class="kw">fn </span>default() -&gt; <span class="self">Self </span>{
-        <span class="self">Self</span>::new(InstanceDescriptor::default())
+        <span class="self">Self</span>::new(<span class="kw-2">&amp;</span>InstanceDescriptor::default())
     }
 }
 
@@ -512,7 +512,7 @@
     /// If no backend feature for the active target platform is enabled,
     /// this method will panic, see [`Instance::enabled_backend_features()`].
     </span><span class="attr">#[allow(unreachable_code)]
-    </span><span class="kw">pub fn </span>new(_instance_desc: InstanceDescriptor) -&gt; <span class="self">Self </span>{
+    </span><span class="kw">pub fn </span>new(_instance_desc: <span class="kw-2">&amp;</span>InstanceDescriptor) -&gt; <span class="self">Self </span>{
         <span class="kw">if </span><span class="self">Self</span>::enabled_backend_features().is_empty() {
             <span class="macro">panic!</span>(
                 <span class="string">"No wgpu backend feature that is implemented for the target platform was enabled. \

doc/src/wgpu/api/instance.rs.html

@@ -4313,7 +4313,7 @@
 }
 
 <span class="kw">impl </span>dispatch::InstanceInterface <span class="kw">for </span>ContextWgpuCore {
-    <span class="kw">fn </span>new(desc: wgt::InstanceDescriptor) -&gt; <span class="self">Self
+    <span class="kw">fn </span>new(desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor) -&gt; <span class="self">Self
     </span><span class="kw">where
         </span><span class="self">Self</span>: Sized,
     {

doc/src/wgpu/backend/wgpu_core.rs.html

@@ -821,7 +821,7 @@
 }
 
 <span class="kw">pub trait </span>InstanceInterface: CommonTraits {
-    <span class="kw">fn </span>new(desc: <span class="kw">crate</span>::InstanceDescriptor) -&gt; <span class="self">Self
+    <span class="kw">fn </span>new(desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor) -&gt; <span class="self">Self
     </span><span class="kw">where
         </span><span class="self">Self</span>: Sized;
 

doc/src/wgpu/dispatch.rs.html

@@ -212,6 +212,7 @@
 <a href="#211" id="211">211</a>
 <a href="#212" id="212">212</a>
 <a href="#213" id="213">213</a>
+<a href="#214" id="214">214</a>
 </pre></div><pre class="rust"><code><span class="kw">use </span>wgt::{Backends, PowerPreference, RequestAdapterOptions};
 
 <span class="kw">use crate</span>::{Adapter, Instance, Surface};
@@ -413,8 +414,9 @@
 /// this method will panic, see [`Instance::enabled_backend_features()`].
 </span><span class="attr">#[allow(unused_mut)]
 </span><span class="kw">pub async fn </span>new_instance_with_webgpu_detection(
-    <span class="kw-2">mut </span>instance_desc: wgt::InstanceDescriptor,
+    instance_desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor,
 ) -&gt; <span class="kw">crate</span>::Instance {
+    <span class="kw">let </span><span class="kw-2">mut </span>instance_desc = instance_desc.clone();
     <span class="kw">if </span>instance_desc
         .backends
         .contains(wgt::Backends::BROWSER_WEBGPU)
@@ -423,6 +425,6 @@
         instance_desc.backends.remove(wgt::Backends::BROWSER_WEBGPU);
     }
 
-    <span class="kw">crate</span>::Instance::new(instance_desc)
+    <span class="kw">crate</span>::Instance::new(<span class="kw-2">&amp;</span>instance_desc)
 }
 </code></pre></div></section></main></body></html>

doc/src/wgpu/util/init.rs.html

@@ -137,7 +137,7 @@
 }
 
 <span class="kw">impl </span>Global {
-    <span class="kw">pub fn </span>new(name: <span class="kw-2">&amp;</span>str, instance_desc: wgt::InstanceDescriptor) -&gt; <span class="self">Self </span>{
+    <span class="kw">pub fn </span>new(name: <span class="kw-2">&amp;</span>str, instance_desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor) -&gt; <span class="self">Self </span>{
         <span class="macro">profiling::scope!</span>(<span class="string">"Global::new"</span>);
         <span class="self">Self </span>{
             instance: Instance::new(name, instance_desc),

doc/src/wgpu_core/global.rs.html

@@ -1070,7 +1070,7 @@
 }
 
 <span class="kw">impl </span>Instance {
-    <span class="kw">pub fn </span>new(name: <span class="kw-2">&amp;</span>str, instance_desc: wgt::InstanceDescriptor) -&gt; <span class="self">Self </span>{
+    <span class="kw">pub fn </span>new(name: <span class="kw-2">&amp;</span>str, instance_desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor) -&gt; <span class="self">Self </span>{
         <span class="kw">fn </span>init&lt;A: HalApi&gt;(
             <span class="kw">_</span>: A,
             instance_desc: <span class="kw-2">&amp;</span>wgt::InstanceDescriptor,
@@ -1106,13 +1106,13 @@
         <span class="kw">let </span><span class="kw-2">mut </span>instance_per_backend = Vec::new();
 
         <span class="attr">#[cfg(vulkan)]
-        </span>init(hal::api::Vulkan, <span class="kw-2">&amp;</span>instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
+        </span>init(hal::api::Vulkan, instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
         <span class="attr">#[cfg(metal)]
-        </span>init(hal::api::Metal, <span class="kw-2">&amp;</span>instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
+        </span>init(hal::api::Metal, instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
         <span class="attr">#[cfg(dx12)]
-        </span>init(hal::api::Dx12, <span class="kw-2">&amp;</span>instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
+        </span>init(hal::api::Dx12, instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
         <span class="attr">#[cfg(gles)]
-        </span>init(hal::api::Gles, <span class="kw-2">&amp;</span>instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
+        </span>init(hal::api::Gles, instance_desc, <span class="kw-2">&amp;mut </span>instance_per_backend);
 
         <span class="self">Self </span>{
             name: name.to_string(),

doc/src/wgpu_core/instance.rs.html

@@ -880,7 +880,7 @@
     </span><span class="kw">async fn </span>init_async&lt;E: Example&gt;(surface: <span class="kw-2">&amp;mut </span>SurfaceWrapper, window: Arc&lt;Window&gt;) -&gt; <span class="self">Self </span>{
         <span class="macro">log::info!</span>(<span class="string">"Initializing wgpu..."</span>);
 
-        <span class="kw">let </span>instance = wgpu::Instance::new(wgpu::util::instance_descriptor_from_env());
+        <span class="kw">let </span>instance = wgpu::Instance::new(<span class="kw-2">&amp;</span>wgpu::util::instance_descriptor_from_env());
         surface.pre_adapter(<span class="kw-2">&amp;</span>instance, window);
 
         <span class="kw">let </span>adapter = get_adapter_with_capabilities_or_from_env(

doc/src/wgpu_examples/framework.rs.html

@@ -190,7 +190,7 @@
     size.width = size.width.max(<span class="number">1</span>);
     size.height = size.height.max(<span class="number">1</span>);
 
-    <span class="kw">let </span>instance = wgpu::Instance::new(wgpu::util::instance_descriptor_from_env());
+    <span class="kw">let </span>instance = wgpu::Instance::new(<span class="kw-2">&amp;</span>wgpu::util::instance_descriptor_from_env());
 
     <span class="kw">let </span>surface = instance.create_surface(<span class="kw-2">&amp;</span>window).unwrap();
     <span class="kw">let </span>adapter = instance

doc/src/wgpu_examples/hello_triangle/mod.rs.html

@@ -713,7 +713,7 @@
 </span><span class="kw">async fn </span>run() {
     <span class="comment">// Instantiates instance of wgpu
     </span><span class="kw">let </span>backends = wgpu::util::backend_bits_from_env().unwrap_or_default();
-    <span class="kw">let </span>instance = wgpu::Instance::new(wgpu::InstanceDescriptor {
+    <span class="kw">let </span>instance = wgpu::Instance::new(<span class="kw-2">&amp;</span>wgpu::InstanceDescriptor {
         backends,
         flags: wgpu::InstanceFlags::from_build_config().with_env(),
         dx12_shader_compiler: wgpu::Dx12Compiler::default(),