blob: e78aa91d4a1c1611d9f51f157e42d18586bbfa03 (
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
# Build Instructions
Debug build:
cmake -S . -B build
cmake --build build
Size-optimized build:
cmake -S . -B build -DDEMO_SIZE_OPT=ON
cmake --build build
## Windows Cross-Compilation (from macOS)
Requires `mingw-w64` and `wine-stable` (for testing).
1. Fetch Windows binaries:
```bash
./scripts/fetch_win_deps.sh
```
2. Build for Windows:
```bash
./scripts/build_win.sh
```
This will produce `build_win/demo64k_packed.exe`.
3. Run with Wine:
```bash
./scripts/run_win.sh
```
# Building the Project with Xcode
This document provides instructions for building the 64k Demo project using Xcode on macOS.
## Prerequisites
- **Xcode:** Ensure you have Xcode installed. You can download it from the Mac App Store.
- **CMake:** This project uses CMake as its build system. Ensure CMake is installed on your system.
## Build Steps
1. **Open Terminal:** Navigate to the root directory of the project (`/Users/skal/demo`).
2. **Create Build Directory:** It is recommended to build out-of-source. Create a build directory:
```bash
mkdir build
cd build
```
3. **Configure with CMake for Xcode:** Generate the Xcode project files using CMake. For Xcode, you typically specify the generator as `Xcode`.
```bash
cmake .. -G "Xcode"
```
This command will configure the project and create an `.xcodeproj` file within the `build` directory.
4. **Open Xcode Project:** Open the generated `.xcodeproj` file in Xcode:
```bash
open YourProjectName.xcodeproj
```
(Replace `YourProjectName.xcodeproj` with the actual name of the generated project file, usually `demo.xcodeproj` or similar).
5. **Build and Run in Xcode:**
* Select your desired target (e.g., `demo64k`, `test_3d_render`).
* Choose a build scheme (e.g., `Debug` or `Release`)
* Click the "Run" button (or press `Cmd+R`) to build and launch the application.
## GPU Performance Capture (Future Task)
To enable future GPU performance analysis, a conditional compilation macro `ENABLE_GPU_PERF_CAPTURE` can be defined. This can be controlled via CMake build types or specific flags when configuring the project:
```bash
# Example of defining the macro via CMake (add to CMakeLists.txt)
# if (MY_GPU_PERF_BUILD)
# target_compile_definitions(demo64k PRIVATE ENABLE_GPU_PERF_CAPTURE=1)
# endif
```
This macro can then be used within the code (e.g., in `gpu.h` or `platform.h`) to conditionally compile performance monitoring or capture code.
## Shader Performance Analysis Task
For detailed shader performance analysis on macOS, **Xcode's Metal debugger** is the recommended tool. A task has been added to `TODO.md` to integrate this into our workflow for future optimization efforts.
|
