optic-engine 0.0.3

Optic game engine — facade crate with feature-gated re-exports
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Optic Engine

A modular Rust game engine composed of independently-compilable sub-crates.

`optic-engine` is the **facade crate** — add it to `Cargo.toml` and enable
the features you need. All public items from sub-crates are re-exported.

## Feature flags

| Feature | Crate | Description |
|---|---|---|
| `core` | [`optic_core`] | Shared types, math, colours, logging |
| `file` | [`optic_file`] | Asset file I/O and cached paths |
| `render` | [`optic_render`] | OpenGL 4.6 rendering (EGL, shaders, meshes) |
| `window` | [`optic_window`] | Windowing, input, gamepad (winit + gilrs) |
| `minimal` | [`optic_loop`] | Game loop + [`Runtime`] trait |
| `online` | [`optic_online`] | UDP networking |

## Quick start

```toml
[dependencies]
optic-engine = { version = "0.0", features = ["minimal"] }
```

```rust,no_run
use optic_engine::{Game, Runtime};

struct App;
impl Runtime for App {
    fn update(&mut self) { /* game logic */ }
}

fn main() {
    Game::new("My Game", (800, 600), App).unwrap().run();
}
```

## Architecture

```text
┌──────────────┐
│ optic-engine │  facade (re-exports everything)
├──────────────┤
│  optic_core   │  base types, math, colour
│  optic_file   │  asset I/O
│  optic_render │  GPU / GL rendering
│  optic_window │  winit windowing + input
│  optic_loop   │  game loop + Runtime
│  optic_online │  UDP networking
└──────────────┘
```

[`optic_core`]: https://docs.rs/optic-core
[`optic_file`]: https://docs.rs/optic-file
[`optic_render`]: https://docs.rs/optic-render
[`optic_window`]: https://docs.rs/optic-window
[`optic_loop`]: https://docs.rs/optic-loop
[`optic_online`]: https://docs.rs/optic-online
[`Runtime`]: https://docs.rs/optic-loop/latest/optic_loop/runtime/trait.Runtime.html