Skip to content

Latest commit

 

History

History
35 lines (24 loc) · 1.55 KB

README.md

File metadata and controls

35 lines (24 loc) · 1.55 KB

Copyright (c) 2023, Shukant Pal and Contributors
SPDX-License-Identifier: Apache-2.0

Made with love by Shukant Pal 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.

Building

To build and test pyktx,

# 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.