Gears

A 3D game engine written in Rust using wgpu for rendering.

Goals

• Ease of use
• Cross platform compatibility
• Parallel execution where possible

Current progress

• Load 3D objects
• Generic lights
• Shadows
• Player
• Movement and View controllers
• Rigidbody physics

Examples

You can try it with cargo run --bin minimal or run a more complex example with cargo run --bin sandbox. When creating components you can use a macro or an entity builder as well.

Creating entities

    let mut app = GearsApp::default();

    let red_light = new_entity!(
        app,
        LightMarker,
        components::Pos3::new(cgmath::Vector3::new(15.0, 5.0, 0.0))
        components::Name("Red Light"),
        components::Light::PointColoured {
            radius: 10.0,
            color: [0.8, 0.0, 0.0],
            intensity: 1.0,
        },
    );

Add a custom window

   app.add_window(Box::new(move |ui| {
        egui::Window::new("Window")
            .default_open(true)
            .max_width(1000.0)
            .max_height(800.0)
            .default_width(800.0)
            .resizable(true)
            .default_pos([0.5, 0.5])
            .show(ui, |ui| {
                if ui.add(egui::Button::new("Click me")).clicked() {
                    warn!("Button clicked in the custom window!");
                }
                ui.end_row();
            });
    }));

Update entities

 app.update_loop(move |ecs, dt| {
        // ! Here we are inside a loop, so this has to lock on all iterations.
        let ecs = ecs.lock().unwrap();
        let circle_speed = 8.0f32;
        let light_speed_multiplier = 3.0f32;

        if let Some(pos3) = ecs.get_component_from_entity::<Pos3>(red_light) {
            let mut wlock_pos3 = pos3.write().unwrap();

            wlock_pos3.pos = cgmath::Quaternion::from_axis_angle(
                (0.0, 1.0, 0.0).into(),
                cgmath::Deg(PI * dt.as_secs_f32() * circle_speed * light_speed_multiplier),
            ) * wlock_pos3.pos;
        }
    })
    .await?;