Skip to content

Commit

Permalink
move project to hexops-graveyard
Browse files Browse the repository at this point in the history
Signed-off-by: Stephen Gutekanst <[email protected]>
  • Loading branch information
emidoots committed Dec 31, 2024
1 parent e85bc63 commit 815e2c9
Showing 1 changed file with 3 additions and 44 deletions.
47 changes: 3 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,5 @@
# direct3d-headers - updated DirectX headers for Zig
## Deprecated

This repository provides some updated `include/` and `x86_64/` libraries for Zig/MinGW that enable the use of the latest Direct3D functionality.
This project has been deprecated and is no longer maintained.

## Headers

We have a small fork of the win32metadata repository which contains the IDL files for Windows SDK:

https://github.com/slimsag/win32metadata

This fork has changes which enable at least the DirectX headers to be compiled with the Wine WIDL compiler. See that repository's commit history for details on what that involves.

Also see this detailed write-up: https://github.com/ziglang/zig/issues/9998#issuecomment-997088467

The files are then copied into this repository:

```sh
rm -rf include/*
cp -R win32metadata/generation/WinSDK/RecompiledIdlHeaders/**/d3d*.h include/
cp -R win32metadata/generation/WinSDK/RecompiledIdlHeaders/**/dx*.h include/
rm include/dxgi*
cp win32metadata/generation/WinSDK/RecompiledIdlHeaders/shared/rpcndr.h include/
```

`rpcndr.h` has a single `#include "rpcndr_hack.h"` line applied which adds a few missing defines.

## Libraries

`x86_64/` contains runtime libraries from the MinGW-w64 project, namely this release:

* https://github.com/niXman/mingw-builds-binaries/releases/tag/13.1.0-rt_v11-rev1
* `x86_64-13.1.0-release-posix-seh-ucrt-rt_v11-rev1.7z`

```
cp ~/Downloads/mingw64/x86_64-w64-mingw32/lib/libdxgi.a ./x86_64
cp ~/Downloads/mingw64/x86_64-w64-mingw32/lib/libdxguid.a ./x86_64
```

## LICENSE

* `include/` contains files generated from the [microsoft/win32metadata](https://github.com/microsoft/win32metadata/tree/master/generation/WinSDK/RecompiledIdlHeaders) repository, which are [not open source](https://github.com/microsoft/win32metadata/issues/766). The files are fed through Wine's WIDL header generator, which produces new files (arguably we are allowed to MIT license the result, but you may want to presume they are proprietary.)
* `x86_64/` is licensed under the MinGW-w64-runtime licenses, a copy of which is provided in `COPYING.MinGW-w64-runtime.txt`

## Issues

Issues are tracked in the [main Mach repository](https://github.com/hexops/mach/issues?q=is%3Aissue+is%3Aopen+label%3Adirect3d-headers).
Consider using https://github.com/hexops/directx-headers instead.

0 comments on commit 815e2c9

Please sign in to comment.