1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
// File: basisu_transcoder_pybind11.cpp
// pybind11 native bindings for the transcoder's pure C API basisu_wasm_transcoder_api.h
#include <pybind11/pybind11.h>
#include <stdint.h>
#include "../encoder/basisu_wasm_transcoder_api.h"
namespace py = pybind11;
// wasm_bool_t is uint32_t convert to Python bool
static inline bool to_bool(wasm_bool_t v) { return v != 0; }
PYBIND11_MODULE(basisu_transcoder_python, m) {
m.doc() = "Native Basis Universal transcoder (pybind11 binding over basisu_wasm_transcoder_api)";
// ------------------------------------------------------------------------
// High-level functions
// ------------------------------------------------------------------------
m.def("get_version", &bt_get_version,
"Get BasisU transcoder version");
m.def("enable_debug_printf",
[](bool flag) { bt_enable_debug_printf(flag ? 1u : 0u); },
"Enable or disable debug printf output");
m.def("init", &bt_init,
"Initialize transcoder library");
m.def("alloc", &bt_alloc,
"Allocate a buffer, returns uint64 offset/pointer");
m.def("free", &bt_free,
"Free a buffer allocated by bt_alloc");
// ------------------------------------------------------------------------
// basis_tex_format helpers
// ------------------------------------------------------------------------
m.def("basis_tex_format_is_xuastc_ldr",
[](uint32_t fmt) { return to_bool(bt_basis_tex_format_is_xuastc_ldr(fmt)); });
m.def("basis_tex_format_is_astc_ldr",
[](uint32_t fmt) { return to_bool(bt_basis_tex_format_is_astc_ldr(fmt)); });
m.def("basis_tex_format_get_block_width",
&bt_basis_tex_format_get_block_width);
m.def("basis_tex_format_get_block_height",
&bt_basis_tex_format_get_block_height);
m.def("basis_tex_format_is_hdr",
[](uint32_t fmt) { return to_bool(bt_basis_tex_format_is_hdr(fmt)); });
m.def("basis_tex_format_is_ldr",
[](uint32_t fmt) { return to_bool(bt_basis_tex_format_is_ldr(fmt)); });
// ------------------------------------------------------------------------
// transcoder_texture_format helpers
// ------------------------------------------------------------------------
m.def("basis_get_bytes_per_block_or_pixel",
&bt_basis_get_bytes_per_block_or_pixel);
m.def("basis_transcoder_format_has_alpha",
[](uint32_t tfmt) { return to_bool(bt_basis_transcoder_format_has_alpha(tfmt)); });
m.def("basis_transcoder_format_is_hdr",
[](uint32_t tfmt) { return to_bool(bt_basis_transcoder_format_is_hdr(tfmt)); });
m.def("basis_transcoder_format_is_ldr",
[](uint32_t tfmt) { return to_bool(bt_basis_transcoder_format_is_ldr(tfmt)); });
m.def("basis_transcoder_texture_format_is_astc",
[](uint32_t tfmt) { return to_bool(bt_basis_transcoder_texture_format_is_astc(tfmt)); });
m.def("basis_transcoder_format_is_uncompressed",
[](uint32_t tfmt) { return to_bool(bt_basis_transcoder_format_is_uncompressed(tfmt)); });
m.def("basis_get_uncompressed_bytes_per_pixel",
&bt_basis_get_uncompressed_bytes_per_pixel);
m.def("basis_get_block_width",
&bt_basis_get_block_width);
m.def("basis_get_block_height",
&bt_basis_get_block_height);
m.def("basis_get_transcoder_texture_format_from_basis_tex_format",
&bt_basis_get_transcoder_texture_format_from_basis_tex_format);
m.def("basis_is_format_supported",
[](uint32_t tfmt, uint32_t basis_fmt) {
return to_bool(bt_basis_is_format_supported(tfmt, basis_fmt));
});
m.def("basis_compute_transcoded_image_size_in_bytes",
&bt_basis_compute_transcoded_image_size_in_bytes);
// ------------------------------------------------------------------------
// KTX2 open/close & basic info
// ------------------------------------------------------------------------
m.def("ktx2_open", &bt_ktx2_open,
"Open a KTX2 image from memory; returns handle");
m.def("ktx2_close", &bt_ktx2_close,
"Close a previously opened KTX2 handle");
m.def("ktx2_get_width", &bt_ktx2_get_width);
m.def("ktx2_get_height", &bt_ktx2_get_height);
m.def("ktx2_get_levels", &bt_ktx2_get_levels);
m.def("ktx2_get_faces", &bt_ktx2_get_faces);
m.def("ktx2_get_layers", &bt_ktx2_get_layers);
m.def("ktx2_get_basis_tex_format", &bt_ktx2_get_basis_tex_format);
m.def("ktx2_is_etc1s",
[](uint64_t h) { return to_bool(bt_ktx2_is_etc1s(h)); });
m.def("ktx2_is_uastc_ldr_4x4",
[](uint64_t h) { return to_bool(bt_ktx2_is_uastc_ldr_4x4(h)); });
m.def("ktx2_is_hdr",
[](uint64_t h) { return to_bool(bt_ktx2_is_hdr(h)); });
m.def("ktx2_is_hdr_4x4",
[](uint64_t h) { return to_bool(bt_ktx2_is_hdr_4x4(h)); });
m.def("ktx2_is_hdr_6x6",
[](uint64_t h) { return to_bool(bt_ktx2_is_hdr_6x6(h)); });
m.def("ktx2_is_ldr",
[](uint64_t h) { return to_bool(bt_ktx2_is_ldr(h)); });
m.def("ktx2_is_astc_ldr",
[](uint64_t h) { return to_bool(bt_ktx2_is_astc_ldr(h)); });
m.def("ktx2_is_xuastc_ldr",
[](uint64_t h) { return to_bool(bt_ktx2_is_xuastc_ldr(h)); });
m.def("ktx2_get_block_width", &bt_ktx2_get_block_width);
m.def("ktx2_get_block_height", &bt_ktx2_get_block_height);
m.def("ktx2_has_alpha",
[](uint64_t h) { return to_bool(bt_ktx2_has_alpha(h)); });
m.def("ktx2_get_dfd_color_model", &bt_ktx2_get_dfd_color_model);
m.def("ktx2_get_dfd_color_primaries", &bt_ktx2_get_dfd_color_primaries);
m.def("ktx2_get_dfd_transfer_func", &bt_ktx2_get_dfd_transfer_func);
m.def("ktx2_is_srgb",
[](uint64_t h) { return to_bool(bt_ktx2_is_srgb(h)); });
m.def("ktx2_get_dfd_flags", &bt_ktx2_get_dfd_flags);
m.def("ktx2_get_dfd_total_samples", &bt_ktx2_get_dfd_total_samples);
m.def("ktx2_get_dfd_channel_id0", &bt_ktx2_get_dfd_channel_id0);
m.def("ktx2_get_dfd_channel_id1", &bt_ktx2_get_dfd_channel_id1);
m.def("ktx2_is_video",
[](uint64_t h) { return to_bool(bt_ktx2_is_video(h)); });
m.def("ktx2_get_ldr_hdr_upconversion_nit_multiplier",
&bt_ktx2_get_ldr_hdr_upconversion_nit_multiplier);
// ------------------------------------------------------------------------
// KTX2 per-level info
// ------------------------------------------------------------------------
m.def("ktx2_get_level_orig_width",
&bt_ktx2_get_level_orig_width);
m.def("ktx2_get_level_orig_height",
&bt_ktx2_get_level_orig_height);
m.def("ktx2_get_level_actual_width",
&bt_ktx2_get_level_actual_width);
m.def("ktx2_get_level_actual_height",
&bt_ktx2_get_level_actual_height);
m.def("ktx2_get_level_num_blocks_x",
&bt_ktx2_get_level_num_blocks_x);
m.def("ktx2_get_level_num_blocks_y",
&bt_ktx2_get_level_num_blocks_y);
m.def("ktx2_get_level_total_blocks",
&bt_ktx2_get_level_total_blocks);
m.def("ktx2_get_level_alpha_flag",
[](uint64_t h, uint32_t level, uint32_t layer, uint32_t face) {
return to_bool(bt_ktx2_get_level_alpha_flag(h, level, layer, face));
});
m.def("ktx2_get_level_iframe_flag",
[](uint64_t h, uint32_t level, uint32_t layer, uint32_t face) {
return to_bool(bt_ktx2_get_level_iframe_flag(h, level, layer, face));
});
// ------------------------------------------------------------------------
// Transcoding state and operations
// ------------------------------------------------------------------------
m.def("ktx2_start_transcoding",
[](uint64_t h) { return to_bool(bt_ktx2_start_transcoding(h)); });
m.def("ktx2_create_transcode_state",
&bt_ktx2_create_transcode_state);
m.def("ktx2_destroy_transcode_state",
&bt_ktx2_destroy_transcode_state);
m.def("ktx2_transcode_image_level",
[](uint64_t ktx2_handle,
uint32_t level_index, uint32_t layer_index, uint32_t face_index,
uint64_t out_mem_ofs,
uint32_t out_blocks_or_pixels,
uint32_t transcoder_texture_format_u32,
uint32_t decode_flags,
uint32_t row_pitch_blocks_or_pixels,
uint32_t rows_in_pixels,
int channel0, int channel1,
uint64_t state_handle)
{
return to_bool(bt_ktx2_transcode_image_level(
ktx2_handle,
level_index, layer_index, face_index,
out_mem_ofs,
out_blocks_or_pixels,
transcoder_texture_format_u32,
decode_flags,
row_pitch_blocks_or_pixels,
rows_in_pixels,
channel0, channel1,
state_handle));
},
py::arg("ktx2_handle"),
py::arg("level_index"),
py::arg("layer_index"),
py::arg("face_index"),
py::arg("output_block_mem_ofs"),
py::arg("output_blocks_buf_size_in_blocks_or_pixels"),
py::arg("transcoder_texture_format_u32"),
py::arg("decode_flags"),
py::arg("output_row_pitch_in_blocks_or_pixels") = 0,
py::arg("output_rows_in_pixels") = 0,
py::arg("channel0") = -1,
py::arg("channel1") = -1,
py::arg("state_handle") = 0);
m.def("read_memory",
[](uint64_t ptr, uint32_t size) {
return py::bytes((const char*)ptr, size);
},
"Read `size` bytes starting at native memory address `ptr`");
m.def("write_memory",
[](uint64_t dest_ptr, py::buffer src) {
py::buffer_info info = src.request();
memcpy((void*)dest_ptr, info.ptr, info.size * info.itemsize);
},
"Write bytes/buffer-like object into native memory at address `ptr`");
}
|
