mirror of
https://github.com/BinomialLLC/basis_universal.git
synced 2026-06-13 10:49:14 +00:00
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
Python support is still new and coming online, but is entirely functional.
|
|
The library's pure C (WASM friendly) API's are completely exposed to Python.
|
|
|
|
The Python integration first tries to use native .so's in the basisu_py
|
|
directory. If they don't exist, it tries the slower and single threaded WASM
|
|
fallbacks under basisu_py/wasm, which requires wasmtime for Python to be
|
|
installed. Some tests require an input.ktx2 or test.ktx2 to be in the current
|
|
directory.
|
|
|
|
Building:
|
|
|
|
Under the repo's root directory - build the native SO's:
|
|
|
|
```
|
|
mkdir build_python
|
|
cd build_python
|
|
cmake -DBASISU_BUILD_PYTHON=ON ..
|
|
make
|
|
```
|
|
|
|
Build the WASM modules (see README_WASI.md file for instructions on how to
|
|
install the WASI SDK, which is required):
|
|
|
|
```
|
|
mkdir build_wasm_st
|
|
cd build_wasm_st
|
|
cmake .. -DCMAKE_TOOLCHAIN_FILE=$WASI_SDK_PATH/share/cmake/wasi-sdk.cmake -DCMAKE_BUILD_TYPE=Release -DBASISU_WASM_THREADING=OFF
|
|
make
|
|
```
|
|
|
|
Running tests:
|
|
|
|
The tests assume the current directory is "python". Run them like this:
|
|
|
|
Higher-level tests:
|
|
|
|
python3 -m tests.test_backend_loading
|
|
python3 -m tests.test_basic_wasm_selection
|
|
python3 -m tests.test_basic_backend_selection
|
|
python3 -m tests.test_basic_decode
|
|
python3 -m tests.test_basic_transcode
|
|
python3 -m tests.test_compress_swirl
|
|
python3 -m tests.test_compress_swirl_hdr
|
|
python3 -m tests.test_transcoder_astc
|
|
python3 -m tests.test_transcoder_backend_loading
|
|
python3 -m tests.test_transcoder_end_to_end
|
|
python3 -m tests.test_transcoder_end_to_end_hdr
|
|
python3 -m tests.test_transcoder_helpers
|
|
|
|
Low-level tests (used while bringing up the codec):
|
|
|
|
python3 -m lowlevel_test_native.basic_test
|
|
python3 -m lowlevel_test_native.test_transcoder_basic
|
|
python3 -m lowlevel_test_native.example_capi_python
|
|
|
|
python3 -m lowlevel_test_wasm.basic_test
|
|
python3 -m lowlevel_test_wasm.compress_test
|
|
python3 -m lowlevel_test_wasm.compress_test_float
|
|
|