Add ktx

2026-06-14 19:09:18 +01:00
parent 14bd1a9271
commit 13fa90a0e9
3958 changed files with 999286 additions and 4 deletions
@@ -0,0 +1,35 @@
+Copyright (c) 2023, Shukant Pal and Contributors \
+SPDX-License-Identifier: Apache-2.0
+
+Made with love by [Shukant Pal](https://www.shukantpal.com/about) on his way to learning Python.
+
+# pyktx
+
+This Python package provides a Pythonic interface to libktx. It uses CFFI to generate the C bindings.
+
+## Usage
+
+**You must have libktx installed on your system to use pyktx ordinarily. You can configure where libktx is installed using the `LIBKTX_INCLUDE_DIR` and `LIBKTX_LIB_DIR` environment variables too.**
+
+To install libktx, download and run the appropriate installer from [our releases](https://github.com/KhronosGroup/KTX-Software/releases).
+
+## Building
+
+To build and test pyktx,
+
+```bash
+# Set LIBKTX_INSTALL_DIR if you've installed libktx at the default system location.
+# Otherwise set LIBKTX_INCLUDE_DIR, LIBKTX_LIB_DIR to wherever you've built libktx.
+cd ${PROJECT_DIR}/interface/python_binding
+KTX_RUN_TESTS=ON python3 buildscript.py
+```
+
+If you are on a POSIX system (macOS or Linux), make sure libktx is on your `DYLD_LIBRARY_PATH` and `LD_LIBRARY_PATH`.
+
+> When building on macOS against a universal CPython binary, such as that installed with the Xcode command-line tools (/usr/bin/python3), ld will issue a warning
+>
+> ```
+> ld: warning: ignoring file '/usr/local/lib/libktx.4.3.0.dylib': found architecture 'arm64', required architecture 'x86_64'
+> ```
+>
+> 'arm64' and 'x86_64' may be reversed depending on the build machine architecture. This happens because libktx is not a universal binary so only supports the current platform architecture. The message can be ignored.