gfx-rs/wgpu · error

Ray tracing is unsupported on GL

Error message

Ray tracing is unsupported on GL

What it means

Panic from the GLES backend's create_ray_tracing_pipeline stub: OpenGL/GLES has no ray tracing pipeline equivalent, so the trait method is unimplemented and any call aborts. The faulty input is the ray-tracing pipeline descriptor on a GL device.

Source

Thrown at wgpu-hal/src/gles/device.rs:1740

            program_cache.retain(|_, v| match *v {
                Ok(ref p) => p.program != pipeline.inner.program,
                Err(_) => false,
            });
            unsafe { gl.delete_program(pipeline.inner.program) };
        }

        self.counters.compute_pipelines.sub(1);
    }

    unsafe fn create_ray_tracing_pipeline(
        &self,
        _desc: &crate::RayTracingPipelineDescriptor<
            super::PipelineLayout,
            super::ShaderModule,
            super::PipelineCache,
        >,
    ) -> Result<super::RayTracingPipeline, crate::PipelineError> {
        unimplemented!("Ray tracing is unsupported on GL")
    }

    unsafe fn destroy_ray_tracing_pipeline(&self, _pipeline: super::RayTracingPipeline) {
        unimplemented!("Ray tracing is unsupported on GL")
    }

    unsafe fn get_raytracing_pipeline_group_data(
        &self,
        _pipeline: &super::RayTracingPipeline,
        _groups: core::ops::Range<u32>,
    ) -> Result<Vec<u8>, crate::DeviceError> {
        unimplemented!("Ray tracing is unsupported on GL")
    }

    unsafe fn create_pipeline_cache(
        &self,
        _: &crate::PipelineCacheDescriptor<'_>,
    ) -> Result<super::PipelineCache, crate::PipelineCacheError> {

View on GitHub (pinned to 3e11ff59bf)

Solutions

1. Use a backend that supports ray tracing (Vulkan) for ray tracing pipelines
2. Check adapter features before attempting to create ray tracing pipelines

When it happens

Trigger: Thrown at wgpu-hal/src/gles/device.rs:1740 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gfx-rs/wgpu@3e11ff59bf (2026-09-03). Data as JSON: /api/errors/61709069f6cef993. Report an issue: GitHub.