lu15w1r7h / eww

NOT MAINTAINED: egui + winit + wgpu

eww

eww (egui + winit + wgpu) is a egui backend with a winit platform and a wgpu renderer.

This repository contains:

• the eww crate, which builds on top of the egui-{winit, wgpu}.

eww crate

The eww crate is build on top of egui-winit and egui-wgpu and provides a more convenient API, since it handles their interactions.

For just using the winit-wgpu combination, eww is recommended.

You can find a basic usage example under eww/examples/basic.

egui-{winit, wgpu} crates

If you're intrested in building your own backend then you can either use the

• egui-winit combined with a different renderer, or
• egui-wgpu combined with a different platform.

Contribution

Feel free to contribute to this project. Just keep the guidelines in mind.

Guidelines

eww should be simple-to-use and handle the interaction between winit and wgpu.

eww's Issues

Missing Example(s)

Having an example to start using this library would be very helpful. It's the first thing I looked for and couldn't find.

Love the name of this by the way.

Example crashing on startup on Ubuntu 20.04

When trying to run the example on my computer, before the first frame, I'm getting:

thread 'main' panicked at 'wgpu error: Validation Error

Caused by:
    In Device::create_render_pipeline
      note: label = `egui_wgpu_pipeline`
    parent device is lost

The Wgpu examples run just fine, I could not find a cause to this error

Example does not build (Windows)

When cargo running the eww example, these are the errors shown by the compiler

error[E0433]: failed to resolve: could not find `BackendBit` in `wgpu`
  --> eww\examples\basic.rs:93:50
   |
93 |         let instance = wgpu::Instance::new(wgpu::BackendBit::PRIMARY);
   |                                                  ^^^^^^^^^^ could not find `BackendBit` in `wgpu`

error[E0433]: failed to resolve: could not find `TextureUsage` in `wgpu`
   --> eww\examples\basic.rs:118:26
    |
118 |             usage: wgpu::TextureUsage::RENDER_ATTACHMENT,
    |                          ^^^^^^^^^^^^ could not find `TextureUsage` in `wgpu`

error[E0412]: cannot find type `SwapChain` in crate `wgpu`
  --> eww\examples\basic.rs:88:23
   |
88 |     swap_chain: wgpu::SwapChain,
   |                       ^^^^^^^^^ not found in `wgpu`

error[E0422]: cannot find struct, variant or union type `SwapChainDescriptor` in crate `wgpu`
   --> eww\examples\basic.rs:117:29
    |
117 |         let sc_desc = wgpu::SwapChainDescriptor {
    |                             ^^^^^^^^^^^^^^^^^^^ not found in `wgpu`

error[E0599]: no method named `create_swap_chain` found for struct `Device` in the current scope
   --> eww\examples\basic.rs:125:33
    |
125 |         let swap_chain = device.create_swap_chain(&surface, &sc_desc);
    |                                 ^^^^^^^^^^^^^^^^^ method not found in `Device`