summaryrefslogtreecommitdiff
path: root/FETCH_DEPS.md
blob: ce62db24ad92b97b949cb94f3639b03d64555b99 (plain)
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
61
62
63
64
65
66
67
68
# Fetching Third-Party Dependencies

This project intentionally does NOT vendor large third-party libraries.

Currently required:

## miniaudio

Single-header audio library.

Source:
https://github.com/mackron/miniaudio

Required file:
- miniaudio.h

Expected location:
third_party/miniaudio.h

### Automatic fetch

Use one of the provided scripts:
- scripts/project_init.sh
- scripts/project_init.bat

### Manual fetch

Download miniaudio.h from:
https://raw.githubusercontent.com/mackron/miniaudio/master/miniaudio.h

and place it into:
third_party/miniaudio.h

## wgpu-native

WebGPU implementation via wgpu-native.

### Installation

**macOS:**
```bash
brew install wgpu-native
```

**Other platforms:**
Please install `wgpu-native` such that `libwgpu_native` (static or shared) is in your library path and headers are in your include path (under `webgpu/`).

## glfw3webgpu

Helper library for creating WebGPU surfaces from GLFW windows.

### Automatic fetch

Use one of the provided scripts:
- scripts/project_init.sh
- scripts/project_init.bat

These scripts will download `glfw3webgpu.h` and `glfw3webgpu.c` into `third_party/glfw3webgpu`.

## UPX

Executable packer for binary compression (Linux/Windows only).
On macOS, the build script defaults to `strip` and `gzexe` due to UPX compatibility issues.

### Installation

**Linux/Windows:**
Download the appropriate release from https://github.com/upx/upx/releases and ensure the `upx` executable is in your PATH.