raylib_aop - GitLite

KO | EN

gitlite — search

#video #framework #nlp #sql #react #ios #artificial-intelligence #ai #computer-vision #tensorflow

raylib_aop

(★ 9)

Raylib Agentic Optimization

파일 탐색기

ZIP 다운로드

- - absolute-paths-in-background-commands.md
  - asm-flavor-state-and-loop.md
  - batch-builds-log-failures.md
  - bench-same-window-only.md
  - crashed-sessions-leave-live-background-jobs.md
  - derive-subsets-from-full-reads.md
  - empirical-bisection-first.md
  - gl-usage-hints-become-placement.md
  - gl-vk-driver-backend-gap.md
  - hard-requirements-are-portability-decisions.md
  - kosmickrisp-facts.md
  - macos-bringup-gotchas.md
  - macos-present-floor-and-acquire-late.md
  - metal-backend-lessons.md
  - parameterize-scripts-not-sed.md
  - perf-bench-methodology.md
  - perf-campaign-results.md
  - platform-stubs-return-zero-silently.md
  - port-dedup-when-replacing-paths.md
  - profile-with-counters-not-theory.md
  - raylib-matrix-field-order-trap.md
  - restore-user-working-state.md
  - revalidate-suppressions-after-pivots.md
  - run-a-same-backend-control-before-blaming-your-code.md
  - set0-size-is-a-per-draw-tax.md
  - ship-flags-before-code-tuning.md
  - spirv-opt-is-a-pixel-tradeoff.md
  - ssbo-placement-dominates-dispatch-cost.md
  - storeop-dontcare-is-real-on-tilers.md
  - style-corrections-are-a-class.md
  - taskstop-leaves-child-trees.md
  - trace-before-theorize.md
  - user-standards.md
  - validation-and-pixels-are-independent.md
  - verify-env-hooks-engage.md
  - verify-idle-before-benchmarking.md
  - vulkan-memory-floor-evidence.md
  - vulkan-skill-local-spec.md
  - win-getenv-is-slow.md
  - wip-commits-enable-recovery.md
- claude-consistency-audit.md
- claude-rldx12-tracker.md
- claude-rlmtl-tracker.md
- rlvk-early-tracker.md
- rlvk-plan.md
- 0001-backend-glue.patch
- - rlvk_default.frag
  - rlvk_default.vert
  - rlvk_merged.frag
  - rlvk_merged.vert
  - rlvk_resolve.frag
  - rlvk_resolve.vert
- rldx12.h
- rlmtl.h
- rlvk.h
- rlvk_shaders.h
- - build_mesa.sh
  - kosmicomp_workaround_mask.patch
  - nir2msl.py
  - README.md
.gitignore
build.sh
CLAUDE.md
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Drop-in **Vulkan**, **Metal**, and **Direct3D 12** backends for
[raylib](https://github.com/raysan5/raylib) — developed and validated agentically
(image-equivalence gated against the stock OpenGL backend, performance-campaigned per
platform).

This repo is an **optional add-on that lives entirely outside the raylib tree**. It builds
raylib with one of the optimized backends **without editing a single file in your raylib
checkout**: sources are staged and patched inside `raylib_aop/build/`, compiled there, and
only the finished `libraylib.a` is copied into `raylib/src/` — the location every raylib
example and consumer already expects. Your raylib clone stays pristine and fully revertible.

Each backend is a single-header sibling of `rlgl.h` implementing the exact same `rlgl` API,
so **every raylib program and stock GLSL shader works unmodified**:

| Backend | Header | Platform | Status |
|---|---|---|---|
| Vulkan 1.3+ | `src/rlvk.h` | Windows / Linux / macOS (MoltenVK or KosmicKrisp) | Image gate green vs GL on all three OSes; beats GL on most scenes (up to 7.5× NVIDIA, 6.4× RADV) |
| Metal | `src/rlmtl.h` | macOS | Image gate green (most bit-exact backend); beats GL on 18/19 scenes (up to 16.8× draw calls) |
| Direct3D 12 | `src/rldx12.h` | Windows | Image gate green; wins every heavy scene vs both GL and Vulkan |

Details, architecture decisions, and full campaign logs: [`CLAUDE.md`](CLAUDE.md) and [`docs/`](docs/).

## Requirements

- A raylib checkout (stock upstream `master`; this repo was developed against raylib v6.0-dev)
- **vulkan**: Vulkan SDK (Windows: `VULKAN_SDK` set) or system loader (Linux: `libvulkan`,
  macOS: Homebrew `vulkan-loader` + `molten-vk`). Runtime GLSL needs `shaderc_shared`
  (dlopen'd, optional — without it only the embedded default shader is available).
- **metal**: macOS with Homebrew `spirv-cross` (static-linked); `shaderc` for runtime GLSL (dlopen'd).
- **dx12**: Windows (MSYS2/MinGW shell), inbox d3d12/dxgi/d3dcompiler; Vulkan SDK recommended
  for shaderc + spirv-cross DLLs (runtime-loaded).

## Usage

Clone next to your raylib checkout:

```
Developer/
  raylib/       <- stock raylib (untouched)
  raylib_aop/   <- this repo
```

Then:

```sh
cd raylib_aop
./build.sh metal          # or: vulkan | dx12
```

That's it. The script:

1. copies `raylib/src` into `raylib_aop/build/<backend>/src` (fresh each run),
2. overlays the backend headers and applies `patches/` **to the staged copy only**,
3. builds `libraylib.a` there (`make GRAPHICS=<backend> RAYLIB_LIBTYPE=STATIC`),
4. copies the result to `raylib/src/libraylib.a`.

Options:

```sh
./build.sh vulkan /path/to/raylib              # explicit raylib location
./build.sh metal ../raylib CUSTOM_CFLAGS=-g    # extra args pass through to make
./build.sh clean                               # drop the staging trees
```

On Windows, run from an MSYS2/MinGW shell (`mingw32-make` is used automatically).

## Linking your program / the raylib examples

The produced `libraylib.a` replaces the OpenGL dependency with the backend's own. Link with
the backend libs instead of GL:

- **vulkan** — Windows: `-lraylib -lvulkan-1 -lgdi32 -lwinmm`; Linux: `-lraylib -lvulkan -lX11
  -lm -lpthread -ldl -lrt` (`-lX11` is required: nothing pulls it in transitively without
  `-lGL`); macOS: `-lraylib -L/opt/homebrew/lib -lvulkan` + the usual Cocoa frameworks.
- **metal** — `-lraylib -L/opt/homebrew/lib -lspirv-cross-c -lspirv-cross-msl -lspirv-cross-hlsl
  -lspirv-cross-glsl -lspirv-cross-cpp -lspirv-cross-reflect -lspirv-cross-util
  -lspirv-cross-core -lc++ -framework Cocoa -framework IOKit -framework CoreAudio
  -framework CoreVideo -framework Metal -framework QuartzCore -framework Foundation -framework AppKit`
- **dx12** — `-lraylib -ld3d12 -ldxgi -ldxguid -ld3dcompiler -lgdi32 -lwinmm`

Example (raylib examples dir, macOS Metal):

```sh
cd ../raylib/examples
make core/core_basic_window LDLIBS="<metal libs above>"
```

## What the patches change

`patches/` contains only what is strictly necessary to build raylib with these backends —
no general optimizations or fixes to raylib itself.

- [`patches/0001-backend-glue.patch`](patches/0001-backend-glue.patch) — the three integration
  points a non-GL backend needs, all compile-time-gated so a build without `GRAPHICS=...`
  is bit-identical to stock: `src/rcore.c` selects the backend implementation header and
  attaches the window surface after `rlglInit`; `src/platforms/rcore_desktop_glfw.c` creates
  the surface (`GLFW_NO_API`, per-backend present); `src/Makefile` gains the three
  `GRAPHICS=` sections and their link lines.

## Testing

The image-equivalence and performance suites live in the sibling
[`raylib_tests`](../raylib_tests) repo. Their capture hooks are separate raylib patches
(`raylib_tests/patches/`) that compose cleanly with this repo's patches in either order.
To prepare an in-place tree for the test scripts (which build inside the raylib tree):

```sh
./build.sh overlay /path/to/raylib-test-clone      # explicitly modifies THAT tree
cd /path/to/raylib-test-clone && git apply ../raylib_tests/patches/*.patch
```

Use a throwaway clone for that — the whole point of this repo is that your working raylib
stays stock.

## Repo layout

```
src/            rlvk.h, rlmtl.h, rldx12.h, rlvk_shaders.h (embedded SPIR-V), shaders/ (GLSL sources)
patches/        backend glue + core optimizations, applied to staged raylib sources
tools/nir2msl/  offline GLSL->NIR->MSL precompiler (Mesa kosmicomp) for RLMTL_MSL_OVERRIDE
docs/           design trackers, plans, and the API consistency audit
build/          staging + build output (gitignored)
CLAUDE.md       agent instructions + full backend architecture documentation
```