sourcepp 2025.1.26.dev1__tar.gz → 2025.2.12.dev1__tar.gz

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/CMakeLists.txt

@@ -30,7 +30,7 @@ endif()
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 
 set(SOURCEPP_BUILD_PYTHON_WRAPPERS ON CACHE INTERNAL "" FORCE)
-set(SOURCEPP_PYTHON_VERSION "2025.01.26dev1")
+set(SOURCEPP_VERSION "2025.2.12dev1")
 
 # As weird as this looks, this is necessary for sdist wheel
 set(SOURCEPP_PYTHON_IS_SUBDIR OFF)
@@ -41,6 +41,6 @@ else()
     FetchContent_Declare(
             sourcepp
             GIT_REPOSITORY "https://github.com/craftablescience/sourcepp.git"
-            GIT_TAG "353aee7fa8f9760938a2ed3b92b7ee2d41386f77")
+            GIT_TAG "109a8cd7348af99447f9675c340df66cae2bf1b5")
     FetchContent_MakeAvailable(sourcepp)
 endif()

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sourcepp
-Version: 2025.1.26.dev1
+Version: 2025.2.12.dev1
 Summary: Several modern C++20 libraries for sanely parsing Valve formats.
 Home-page: https://github.com/craftablescience/sourcepp
 Author-Email: craftablescience <lauralewisdev@gmail.com>
@@ -46,10 +46,15 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="1"><code>bsppp</code><sup>*</sup></td>
-    <td><a href="https://developer.valvesoftware.com/wiki/BSP_(Source)">BSP</a> v17-27</td>
+    <td>
+      <a href="https://developer.valvesoftware.com/wiki/BSP_(Source)">BSP</a> v17-27
+      <br> &bull; Console modifications
+      <br> &bull; Left 4 Dead 2 modifications
+      <br> &bull; <a href="https://stratasource.org">Strata Source</a> modifications
+    </td>
     <td align="center">✅</td>
     <td align="center">✅</td>
-    <td rowspan="1" align="center"></td>
+    <td rowspan="1" align="center">Python</td>
   </tr>
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
@@ -62,7 +67,7 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="1"><code>fspp</code><sup>*</sup></td>
-    <td>(WIP) Source 1 filesystem accessor</td>
+    <td>Source 1 filesystem accessor</td>
     <td align="center">✅</td>
     <td align="center">✅</td>
     <td rowspan="1" align="center"></td>
@@ -110,6 +115,20 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
     <td align="center">❌</td>
   </tr>
   <tr><!-- empty row to disable github striped bg color --></tr>
+  <tr>
+    <td rowspan="3"><code>sndpp</code><sup>*</sup></td>
+    <td>WAV</td>
+    <td align="center">✅</td>
+    <td align="center">❌</td>
+    <td rowspan="3" align="center"></td>
+  </tr>
+  <tr><!-- empty row to disable github striped bg color --></tr>
+  <tr>
+    <td>XWV v4</td>
+    <td align="center">✅</td>
+    <td align="center">❌</td>
+  </tr>
+  <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="3"><code>steampp</code></td>
     <td>Find Steam install folder</td>
@@ -385,9 +404,11 @@ found on PyPI in the [sourcepp](https://pypi.org/project/sourcepp) package.
 
 A list of projects using the `sourcepp` parser set. If you'd like to see your project here, make a PR!
 
-- [VPKEdit](https://github.com/craftablescience/VPKEdit): An open source MIT-licensed tool that can create, extract from,
-  preview the contents of and write to several pack file formats. A CLI application is bundled with the program which replicates
+- [VPKEdit](https://github.com/craftablescience/VPKEdit): An open source MIT-licensed GUI tool that can create, extract from,
+  preview the contents of and write to several pack file formats. A CLI tool is bundled with the program which replicates
   the functionality of Valve's `vpk.exe`.
+- [MareTF](https://github.com/craftablescience/MareTF): An open source MIT-licensed CLI tool that can create VTFs, with more
+  features and a companion GUI tool planned. Replicates the functionality of Valve's `vtex.exe`.
 - [GodotSource](https://github.com/craftablescience/godotsource): A work-in-progress set of bindings to connect the `sourcepp`
   libraries to Godot. Allows GDScript to work with the libraries, and allows Godot to directly load Source engine assets from
   a user project or from installed Source games.

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/README.md

@@ -23,10 +23,15 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="1"><code>bsppp</code><sup>*</sup></td>
-    <td><a href="https://developer.valvesoftware.com/wiki/BSP_(Source)">BSP</a> v17-27</td>
+    <td>
+      <a href="https://developer.valvesoftware.com/wiki/BSP_(Source)">BSP</a> v17-27
+      <br> &bull; Console modifications
+      <br> &bull; Left 4 Dead 2 modifications
+      <br> &bull; <a href="https://stratasource.org">Strata Source</a> modifications
+    </td>
     <td align="center">✅</td>
     <td align="center">✅</td>
-    <td rowspan="1" align="center"></td>
+    <td rowspan="1" align="center">Python</td>
   </tr>
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
@@ -39,7 +44,7 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
   <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="1"><code>fspp</code><sup>*</sup></td>
-    <td>(WIP) Source 1 filesystem accessor</td>
+    <td>Source 1 filesystem accessor</td>
     <td align="center">✅</td>
     <td align="center">✅</td>
     <td rowspan="1" align="center"></td>
@@ -87,6 +92,20 @@ Several modern C++20 libraries for sanely parsing Valve formats, rolled into one
     <td align="center">❌</td>
   </tr>
   <tr><!-- empty row to disable github striped bg color --></tr>
+  <tr>
+    <td rowspan="3"><code>sndpp</code><sup>*</sup></td>
+    <td>WAV</td>
+    <td align="center">✅</td>
+    <td align="center">❌</td>
+    <td rowspan="3" align="center"></td>
+  </tr>
+  <tr><!-- empty row to disable github striped bg color --></tr>
+  <tr>
+    <td>XWV v4</td>
+    <td align="center">✅</td>
+    <td align="center">❌</td>
+  </tr>
+  <tr><!-- empty row to disable github striped bg color --></tr>
   <tr>
     <td rowspan="3"><code>steampp</code></td>
     <td>Find Steam install folder</td>
@@ -362,9 +381,11 @@ found on PyPI in the [sourcepp](https://pypi.org/project/sourcepp) package.
 
 A list of projects using the `sourcepp` parser set. If you'd like to see your project here, make a PR!
 
-- [VPKEdit](https://github.com/craftablescience/VPKEdit): An open source MIT-licensed tool that can create, extract from,
-  preview the contents of and write to several pack file formats. A CLI application is bundled with the program which replicates
+- [VPKEdit](https://github.com/craftablescience/VPKEdit): An open source MIT-licensed GUI tool that can create, extract from,
+  preview the contents of and write to several pack file formats. A CLI tool is bundled with the program which replicates
   the functionality of Valve's `vpk.exe`.
+- [MareTF](https://github.com/craftablescience/MareTF): An open source MIT-licensed CLI tool that can create VTFs, with more
+  features and a companion GUI tool planned. Replicates the functionality of Valve's `vtex.exe`.
 - [GodotSource](https://github.com/craftablescience/godotsource): A work-in-progress set of bindings to connect the `sourcepp`
   libraries to Godot. Allows GDScript to work with the libraries, and allows Godot to directly load Source engine assets from
   a user project or from installed Source games.

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/THIRDPARTY_LEGAL_NOTICES.txt

@@ -278,6 +278,40 @@ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
+---------------     SciPy      ---------------
+
+Copyright (c) 2001-2002 Enthought, Inc. 2003, SciPy Developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above
+   copyright notice, this list of conditions and the following
+   disclaimer in the documentation and/or other materials provided
+   with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
 ---------------      stb       ---------------
 
 Copyright (c) 2017 Sean Barrett

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/cfg/CMakeLists.txt

@@ -30,7 +30,7 @@ endif()
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 
 set(SOURCEPP_BUILD_PYTHON_WRAPPERS ON CACHE INTERNAL "" FORCE)
-set(SOURCEPP_PYTHON_VERSION "@SOURCEPP_PYTHON_VERSION@")
+set(SOURCEPP_VERSION "@SOURCEPP_VERSION@")
 
 # As weird as this looks, this is necessary for sdist wheel
 set(SOURCEPP_PYTHON_IS_SUBDIR OFF)

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/cfg/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "sourcepp"
-version = "${SOURCEPP_PYTHON_VERSION}"
+version = "${SOURCEPP_VERSION}"
 authors = [{ name = "craftablescience", email = "lauralewisdev@gmail.com" }]
 maintainers = [{ name = "craftablescience", email = "lauralewisdev@gmail.com" }]
 description = "Several modern C++20 libraries for sanely parsing Valve formats."

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "sourcepp"
-version = "2025.01.26dev1"
+version = "2025.2.12dev1"
 authors = [{ name = "craftablescience", email = "lauralewisdev@gmail.com" }]
 maintainers = [{ name = "craftablescience", email = "lauralewisdev@gmail.com" }]
 description = "Several modern C++20 libraries for sanely parsing Valve formats."

sourcepp-2025.2.12.dev1/src/bsppp.h

@@ -0,0 +1,315 @@
+#pragma once
+
+#include <nanobind/nanobind.h>
+#include <nanobind/stl/array.h>
+#include <nanobind/stl/optional.h>
+#include <nanobind/stl/string.h>
+#include <nanobind/stl/string_view.h>
+#include <nanobind/stl/vector.h>
+
+namespace py = nanobind;
+
+#include <bsppp/bsppp.h>
+
+namespace bsppp {
+
+inline void register_python(py::module_& m) {
+	auto bsppp = m.def_submodule("bsppp");
+	using namespace bsppp;
+
+	auto cBSP = py::class_<BSP>(bsppp, "BSP");
+
+	auto cBSPEntityKeyValues = py::class_<BSPEntityKeyValues>(cBSP, "EntityKeyValues");
+
+	py::class_<BSPEntityKeyValues::Element>(cBSPEntityKeyValues, "Element")
+		.def_prop_rw("key", &BSPEntityKeyValues::Element::getKey, &BSPEntityKeyValues::Element::setKey)
+		.def_prop_rw("value", &BSPEntityKeyValues::Element::getValue<std::string_view>, &BSPEntityKeyValues::Element::setValue<std::string_view>)
+		.def_prop_ro("invalid", &BSPEntityKeyValues::Element::isInvalid);
+
+	cBSPEntityKeyValues
+		.def(py::init<>())
+		.def("has_child", &BSPEntityKeyValues::hasChild, py::arg("child_key"))
+		.def_prop_ro("keyvalues_count", py::overload_cast<>(&BSPEntityKeyValues::getKeyValuesCount, py::const_))
+		.def("get_keyvalues_count_for_key", py::overload_cast<std::string_view>(&BSPEntityKeyValues::getKeyValuesCount, py::const_), py::arg("child_key"))
+		.def_prop_ro("keyvalues", &BSPEntityKeyValues::getKeyValues, py::rv_policy::reference_internal)
+		.def("at", py::overload_cast<unsigned int>(&BSPEntityKeyValues::operator[]), py::arg("n"), py::rv_policy::reference_internal)
+		.def("get", py::overload_cast<std::string_view>(&BSPEntityKeyValues::operator[]), py::arg("child_key"), py::rv_policy::reference_internal)
+		.def("__getitem__", py::overload_cast<std::string_view>(&BSPEntityKeyValues::operator[]), py::arg("child_key"), py::rv_policy::reference_internal, py::is_operator())
+		.def("get_n", py::overload_cast<std::string_view, unsigned int>(&BSPEntityKeyValues::operator()), py::arg("child_key"), py::arg("n"), py::rv_policy::reference_internal)
+		.def("add_keyvalue", &BSPEntityKeyValues::addKeyValue<std::string_view>, py::arg("child_key"), py::arg("value"))
+		.def("remove_keyvalue", &BSPEntityKeyValues::removeKeyValue, py::arg("child_key"), py::arg("n") = -1)
+		.def("bake", &BSPEntityKeyValues::bake, py::arg("use_escapes"));
+
+	py::class_<BSPPlane_v0>(cBSP, "Plane_v0")
+		.def(py::init<>())
+		.def_rw("normal", &BSPPlane_v0::normal)
+		.def_rw("dist", &BSPPlane_v0::dist)
+		.def_rw("type", &BSPPlane_v0::type);
+
+	py::class_<BSPTextureData_v0>(cBSP, "TextureData_v0")
+		.def(py::init<>())
+		.def_rw("reflectivity", &BSPTextureData_v0::reflectivity)
+		.def_rw("name_string_table_id", &BSPTextureData_v0::nameStringTableID)
+		.def_rw("width", &BSPTextureData_v0::width)
+		.def_rw("height", &BSPTextureData_v0::height)
+		.def_rw("view_width", &BSPTextureData_v0::width)
+		.def_rw("view_height", &BSPTextureData_v0::height);
+
+	py::class_<BSPVertex_v0>(cBSP, "Vertex_v0")
+		.def(py::init<>())
+		.def_rw("position", &BSPVertex_v0::position);
+
+	py::class_<BSPNode_v0>(cBSP, "Node_v0")
+		.def(py::init<>())
+		.def_rw("plane_num", &BSPNode_v0::planeNum)
+		.def_rw("children", &BSPNode_v0::children)
+		.def_rw("mins", &BSPNode_v0::mins)
+		.def_rw("maxs", &BSPNode_v0::maxs)
+		.def_rw("first_face", &BSPNode_v0::firstFace)
+		.def_rw("num_faces", &BSPNode_v0::numFaces)
+		.def_rw("area", &BSPNode_v0::area);
+
+	py::class_<BSPNode_v1>(cBSP, "Node_v1")
+		.def(py::init<>())
+		.def_rw("plane_num", &BSPNode_v1::planeNum)
+		.def_rw("children", &BSPNode_v1::children)
+		.def_rw("mins", &BSPNode_v1::mins)
+		.def_rw("maxs", &BSPNode_v1::maxs)
+		.def_rw("first_face", &BSPNode_v1::firstFace)
+		.def_rw("num_faces", &BSPNode_v1::numFaces)
+		.def_rw("area", &BSPNode_v1::area)
+		.def_static("upgrade", &BSPNode_v1::upgrade, py::arg("old"));
+
+	py::class_<BSPTextureInfo_v0>(cBSP, "TextureInfo_v0")
+		.def(py::init<>())
+		.def_rw("texture_vector1", &BSPTextureInfo_v0::textureVector1)
+		.def_rw("texture_vector2", &BSPTextureInfo_v0::textureVector2)
+		.def_rw("lightmap_vector1", &BSPTextureInfo_v0::lightmapVector1)
+		.def_rw("lightmap_vector2", &BSPTextureInfo_v0::lightmapVector2)
+		.def_rw("flags", &BSPTextureInfo_v0::flags)
+		.def_rw("texture_data", &BSPTextureInfo_v0::textureData);
+
+	py::class_<BSPFace_v1>(cBSP, "Face_v1")
+		.def(py::init<>())
+		.def_rw("plane_num", &BSPFace_v1::planeNum)
+		.def_rw("side", &BSPFace_v1::side)
+		.def_rw("on_node", &BSPFace_v1::onNode)
+		.def_rw("first_edge", &BSPFace_v1::firstEdge)
+		.def_rw("num_edges", &BSPFace_v1::numEdges)
+		.def_rw("tex_info", &BSPFace_v1::texInfo)
+		.def_rw("disp_info", &BSPFace_v1::dispInfo)
+		.def_rw("surface_fog_volume_id", &BSPFace_v1::surfaceFogVolumeID)
+		.def_rw("styles", &BSPFace_v1::styles)
+		.def_rw("light_offset", &BSPFace_v1::lightOffset)
+		.def_rw("area", &BSPFace_v1::area)
+		.def_rw("lightmap_texture_mins_in_luxels", &BSPFace_v1::lightmapTextureMinsInLuxels)
+		.def_rw("lightmap_texture_size_in_luxels", &BSPFace_v1::lightmapTextureSizeInLuxels)
+		.def_rw("original_face", &BSPFace_v1::originalFace)
+		.def_rw("num_prims", &BSPFace_v1::numPrims)
+		.def_rw("first_prim_id", &BSPFace_v1::firstPrimID)
+		.def_rw("smoothing_groups", &BSPFace_v1::smoothingGroups);
+
+	py::class_<BSPFace_v2>(cBSP, "Face_v2")
+		.def(py::init<>())
+		.def_rw("plane_num", &BSPFace_v2::planeNum)
+		.def_rw("side", &BSPFace_v2::side)
+		.def_rw("on_node", &BSPFace_v2::onNode)
+		.def_rw("first_edge", &BSPFace_v2::firstEdge)
+		.def_rw("num_edges", &BSPFace_v2::numEdges)
+		.def_rw("tex_info", &BSPFace_v2::texInfo)
+		.def_rw("disp_info", &BSPFace_v2::dispInfo)
+		.def_rw("surface_fog_volume_id", &BSPFace_v2::surfaceFogVolumeID)
+		.def_rw("styles", &BSPFace_v2::styles)
+		.def_rw("light_offset", &BSPFace_v2::lightOffset)
+		.def_rw("area", &BSPFace_v2::area)
+		.def_rw("lightmap_texture_mins_in_luxels", &BSPFace_v2::lightmapTextureMinsInLuxels)
+		.def_rw("lightmap_texture_size_in_luxels", &BSPFace_v2::lightmapTextureSizeInLuxels)
+		.def_rw("original_face", &BSPFace_v2::originalFace)
+		.def_prop_rw("enable_shadows", [](const BSPFace_v2& self) -> bool { return self.enableShadows; }, [](BSPFace_v2& self, bool enableShadows) { self.enableShadows = enableShadows; })
+		.def_prop_rw("num_prims", [](const BSPFace_v2& self) { return self.numPrims; }, [](BSPFace_v2& self, bool numPrims) { self.numPrims = numPrims; })
+		.def_rw("first_prim_id", &BSPFace_v2::firstPrimID)
+		.def_rw("smoothing_groups", &BSPFace_v2::smoothingGroups)
+		.def_static("upgrade", &BSPFace_v2::upgrade);
+
+	py::class_<BSPEdge_v0>(cBSP, "Edge_v0")
+		.def(py::init<>())
+		.def_rw("v0", &BSPEdge_v0::v0)
+		.def_rw("v1", &BSPEdge_v0::v1);
+
+	py::class_<BSPEdge_v1>(cBSP, "Edge_v1")
+		.def(py::init<>())
+		.def_rw("v0", &BSPEdge_v1::v0)
+		.def_rw("v1", &BSPEdge_v1::v1)
+		.def_static("upgrade", &BSPEdge_v1::upgrade);
+
+	py::class_<BSPSurfEdge_v0>(cBSP, "SurfEdge_v0")
+		.def(py::init<>())
+		.def_rw("surf_edge", &BSPSurfEdge_v0::surfEdge);
+
+	py::class_<BSPBrushModel_v0>(cBSP, "BrushModel_v0")
+		.def(py::init<>())
+		.def_rw("min", &BSPBrushModel_v0::min)
+		.def_rw("max", &BSPBrushModel_v0::max)
+		.def_rw("origin", &BSPBrushModel_v0::origin)
+		.def_rw("head_node", &BSPBrushModel_v0::headNode)
+		.def_rw("first_face", &BSPBrushModel_v0::firstFace)
+		.def_rw("num_faces", &BSPBrushModel_v0::numFaces);
+
+	auto cBSPGameLump = py::class_<BSPGameLump>(cBSP, "GameLump");
+
+	py::enum_<BSPGameLump::Signature>(cBSPGameLump, "Signature")
+		.value("STATIC_PROPS",             BSPGameLump::SIGNATURE_STATIC_PROPS)
+		.value("DETAIL_PROPS",             BSPGameLump::SIGNATURE_DETAIL_PROPS)
+		.value("DETAIL_PROP_LIGHTING_LDR", BSPGameLump::SIGNATURE_DETAIL_PROP_LIGHTING_LDR)
+		.value("DETAIL_PROP_LIGHTING_HDR", BSPGameLump::SIGNATURE_DETAIL_PROP_LIGHTING_HDR)
+		.export_values();
+
+	cBSPGameLump
+		.def_rw("signature", &BSPGameLump::signature)
+		.def_rw("is_compressed", &BSPGameLump::isCompressed)
+		.def_rw("version", &BSPGameLump::version)
+		.def_rw("offset", &BSPGameLump::offset)
+		.def_rw("uncompressed_length", &BSPGameLump::uncompressedLength)
+		.def_prop_rw("data", [](const BSPGameLump& self) {
+			return py::bytes{self.data.data(), self.data.size()};
+		}, [](BSPGameLump& self, const py::bytes& data) {
+			self.data = {reinterpret_cast<const std::byte*>(data.data()), reinterpret_cast<const std::byte*>(data.data()) + data.size()};
+		});
+
+	bsppp.attr("BSP_SIGNATURE") = BSP_SIGNATURE;
+	bsppp.attr("BSP_LUMP_COUNT") = BSP_LUMP_COUNT;
+	bsppp.attr("BSP_LUMP_ORDER") = BSP_LUMP_ORDER;
+
+	py::enum_<BSPLump>(cBSP, "Lump")
+		.value("UNKNOWN",                        BSPLump::UNKNOWN)
+		.value("ENTITIES",                       BSPLump::ENTITIES)
+		.value("PLANES",                         BSPLump::PLANES)
+		.value("TEXDATA",                        BSPLump::TEXDATA)
+		.value("VERTEXES",                       BSPLump::VERTEXES)
+		.value("VISIBILITY",                     BSPLump::VISIBILITY)
+		.value("NODES",                          BSPLump::NODES)
+		.value("TEXINFO",                        BSPLump::TEXINFO)
+		.value("FACES",                          BSPLump::FACES)
+		.value("LIGHTING",                       BSPLump::LIGHTING)
+		.value("OCCLUSION",                      BSPLump::OCCLUSION)
+		.value("LEAFS",                          BSPLump::LEAFS)
+		.value("FACEIDS",                        BSPLump::FACEIDS)
+		.value("EDGES",                          BSPLump::EDGES)
+		.value("SURFEDGES",                      BSPLump::SURFEDGES)
+		.value("MODELS",                         BSPLump::MODELS)
+		.value("WORLDLIGHTS",                    BSPLump::WORLDLIGHTS)
+		.value("LEAFFACES",                      BSPLump::LEAFFACES)
+		.value("LEAFBRUSHES",                    BSPLump::LEAFBRUSHES)
+		.value("BRUSHES",                        BSPLump::BRUSHES)
+		.value("BRUSHSIDES",                     BSPLump::BRUSHSIDES)
+		.value("AREAS",                          BSPLump::AREAS)
+		.value("AREAPORTALS",                    BSPLump::AREAPORTALS)
+		.value("S2004_PORTALS",                  BSPLump::S2004_PORTALS)
+		.value("UNUSED0",                        BSPLump::UNUSED0)
+		.value("SL4D2_PROPCOLLISION",            BSPLump::SL4D2_PROPCOLLISION)
+		.value("S2004_CLUSTERS",                 BSPLump::S2004_CLUSTERS)
+		.value("UNUSED1",                        BSPLump::UNUSED1)
+		.value("SL4D2_PROPHULLS",                BSPLump::SL4D2_PROPHULLS)
+		.value("S2004_PORTALVERTS",              BSPLump::S2004_PORTALVERTS)
+		.value("UNUSED2",                        BSPLump::UNUSED2)
+		.value("SL4D2_PROPHULLVERTS",            BSPLump::SL4D2_PROPHULLVERTS)
+		.value("S2004_CLUSTERPORTALS",           BSPLump::S2004_CLUSTERPORTALS)
+		.value("UNUSED3",                        BSPLump::UNUSED3)
+		.value("SL4D2_PROPTRIS",                 BSPLump::SL4D2_PROPTRIS)
+		.value("DISPINFO",                       BSPLump::DISPINFO)
+		.value("ORIGINALFACES",                  BSPLump::ORIGINALFACES)
+		.value("PHYSDISP",                       BSPLump::PHYSDISP)
+		.value("PHYSCOLLIDE",                    BSPLump::PHYSCOLLIDE)
+		.value("VERTNORMALS",                    BSPLump::VERTNORMALS)
+		.value("VERTNORMALINDICES",              BSPLump::VERTNORMALINDICES)
+		.value("S2004_DISP_LIGHTMAP_ALPHAS",     BSPLump::S2004_DISP_LIGHTMAP_ALPHAS)
+		.value("UNUSED4",                        BSPLump::UNUSED4)
+		.value("DISP_VERTS",                     BSPLump::DISP_VERTS)
+		.value("DISP_LIGHTMAP_SAMPLE_POSITIONS", BSPLump::DISP_LIGHTMAP_SAMPLE_POSITIONS)
+		.value("GAME_LUMP",                      BSPLump::GAME_LUMP)
+		.value("LEAFWATERDATA",                  BSPLump::LEAFWATERDATA)
+		.value("PRIMITIVES",                     BSPLump::PRIMITIVES)
+		.value("PRIMVERTS",                      BSPLump::PRIMVERTS)
+		.value("PRIMINDICES",                    BSPLump::PRIMINDICES)
+		.value("PAKFILE",                        BSPLump::PAKFILE)
+		.value("CLIPPORTALVERTS",                BSPLump::CLIPPORTALVERTS)
+		.value("CUBEMAPS",                       BSPLump::CUBEMAPS)
+		.value("TEXDATA_STRING_DATA",            BSPLump::TEXDATA_STRING_DATA)
+		.value("TEXDATA_STRING_TABLE",           BSPLump::TEXDATA_STRING_TABLE)
+		.value("OVERLAYS",                       BSPLump::OVERLAYS)
+		.value("LEAFMINDISTTOWATER",             BSPLump::LEAFMINDISTTOWATER)
+		.value("FACE_MACRO_TEXTURE_INFO",        BSPLump::FACE_MACRO_TEXTURE_INFO)
+		.value("DISP_TRIS",                      BSPLump::DISP_TRIS)
+		.value("S2004_PHYSCOLLIDESURFACE",       BSPLump::S2004_PHYSCOLLIDESURFACE)
+		.value("UNUSED5",                        BSPLump::UNUSED5)
+		.value("SL4D2_PROP_BLOB",                BSPLump::SL4D2_PROP_BLOB)
+		.value("WATEROVERLAYS",                  BSPLump::WATEROVERLAYS)
+		.value("S2006_XBOX_LIGHTMAPPAGES",       BSPLump::S2006_XBOX_LIGHTMAPPAGES)
+		.value("LEAF_AMBIENT_INDEX_HDR",         BSPLump::LEAF_AMBIENT_INDEX_HDR)
+		.value("S2006_XBOX_LIGHTMAPPAGEINFOS",   BSPLump::S2006_XBOX_LIGHTMAPPAGEINFOS)
+		.value("LEAF_AMBIENT_INDEX",             BSPLump::LEAF_AMBIENT_INDEX)
+		.value("LIGHTING_HDR",                   BSPLump::LIGHTING_HDR)
+		.value("WORLDLIGHTS_HDR",                BSPLump::WORLDLIGHTS_HDR)
+		.value("LEAF_AMBIENT_LIGHTING_HDR",      BSPLump::LEAF_AMBIENT_LIGHTING_HDR)
+		.value("LEAF_AMBIENT_LIGHTING",          BSPLump::LEAF_AMBIENT_LIGHTING)
+		.value("XBOX_XZIPPAKFILE",               BSPLump::XBOX_XZIPPAKFILE)
+		.value("FACES_HDR",                      BSPLump::FACES_HDR)
+		.value("MAP_FLAGS",                      BSPLump::MAP_FLAGS)
+		.value("OVERLAY_FADES",                  BSPLump::OVERLAY_FADES)
+		.value("L4D_OVERLAY_SYSTEM_LEVELS",      BSPLump::L4D_OVERLAY_SYSTEM_LEVELS)
+		.value("UNUSED6",                        BSPLump::UNUSED6)
+		.value("L4D2_PHYSLEVEL",                 BSPLump::L4D2_PHYSLEVEL)
+		.value("UNUSED7",                        BSPLump::UNUSED7)
+		.value("ASW_DISP_MULTIBLEND",            BSPLump::ASW_DISP_MULTIBLEND)
+		.value("UNUSED8",                        BSPLump::UNUSED8)
+		.export_values();
+
+	cBSP
+		.def(py::init<std::string, bool>(), py::arg("path"), py::arg("load_patch_files") = true)
+		.def("__bool__", &BSP::operator bool, py::is_operator())
+		.def_static("create", &BSP::create, py::arg("path"), py::arg("version") = 21, py::arg("map_revision") = 0)
+		.def_prop_rw("version", &BSP::getVersion, &BSP::setVersion)
+		.def_prop_rw("map_revision", &BSP::getMapRevision, &BSP::setMapRevision)
+		.def_prop_rw("l4d2", &BSP::isL4D2, &BSP::setL4D2)
+		.def_prop_rw("console", &BSP::isConsole, &BSP::setConsole)
+		.def("has_lump", &BSP::hasLump, py::arg("lump_index"))
+		.def("is_lump_compressed", &BSP::isLumpCompressed, py::arg("lump_index"))
+		.def("get_lump_version", &BSP::getLumpVersion, py::arg("lump_index"))
+		.def("get_lump_data", [](const BSP& self, BSPLump lumpIndex, bool noDecompression = false) -> py::object {
+			const auto d = self.getLumpData(lumpIndex, noDecompression);
+			return d ? py::bytes{d->data(), d->size()} : py::none();
+		}, py::arg("lump_index"), py::arg("no_decompression") = false)
+		.def("get_lump_data_for_entities", &BSP::getLumpData<BSPLump::ENTITIES>)
+		.def("get_lump_data_for_planes", &BSP::getLumpData<BSPLump::PLANES>)
+		.def("get_lump_data_for_texdata", &BSP::getLumpData<BSPLump::TEXDATA>)
+		.def("get_lump_data_for_vertexes", &BSP::getLumpData<BSPLump::VERTEXES>)
+		.def("get_lump_data_for_nodes", &BSP::getLumpData<BSPLump::NODES>)
+		.def("get_lump_data_for_texinfo", &BSP::getLumpData<BSPLump::TEXINFO>)
+		.def("get_lump_data_for_faces", &BSP::getLumpData<BSPLump::FACES>)
+		.def("get_lump_data_for_edges", &BSP::getLumpData<BSPLump::EDGES>)
+		.def("get_lump_data_for_surfedges", &BSP::getLumpData<BSPLump::SURFEDGES>)
+		.def("get_lump_data_for_models", &BSP::getLumpData<BSPLump::MODELS>)
+		.def("get_lump_data_for_originalfaces", &BSP::getLumpData<BSPLump::ORIGINALFACES>)
+		.def("get_lump_data_for_game_lump", &BSP::getLumpData<BSPLump::GAME_LUMP>)
+		.def("set_lump", [](BSP& self, BSPLump lumpIndex, uint32_t version, const py::bytes& data, uint8_t compressLevel = 0) {
+			self.setLump(lumpIndex, version, {reinterpret_cast<const std::byte*>(data.data()), data.size()}, compressLevel);
+		}, py::arg("lump_index"), py::arg("version"), py::arg("data"), py::arg("compress_level") = 0)
+		.def("set_lump_for_entities", [](BSP& self, uint32_t version, const std::vector<BSPEntityKeyValues>& data, uint8_t compressLevel = 0) {
+			self.setLump(version, data, compressLevel);
+		}, py::arg("version"), py::arg("data"), py::arg("compress_level"))
+		.def("is_game_lump_compressed", &BSP::isGameLumpCompressed, py::arg("signature"))
+		.def("get_game_lump_data", [](const BSP& self, BSPGameLump::Signature signature) -> py::object {
+			const auto d = self.getGameLumpData(signature);
+			return d ? py::bytes{d->data(), d->size()} : py::none();
+		}, py::arg("signature"))
+		.def("set_game_lump", &BSP::setGameLump, py::arg("signature"), py::arg("version"), py::arg("data"), py::arg("compress_level") = 0)
+		.def("reset_lump", &BSP::resetLump, py::arg("lump_index"))
+		.def("reset", &BSP::reset)
+		.def("create_lump_patch_file", &BSP::createLumpPatchFile, py::arg("lump_index"))
+		.def("set_lump_from_patch_file", &BSP::setLumpFromPatchFile, py::arg("lump_file_path"))
+		.def("bake", &BSP::bake, py::arg("output_path") = "");
+
+	// todo(python): PakLump.h (when vpkpp bindings are in)
+}
+
+} // namespace bsppp

sourcepp-2025.2.12.dev1/src/sourcepp/__init__.py

@@ -0,0 +1,5 @@
+from ._sourcepp_impl import __doc__, bsppp, gamepp, sourcepp, steampp, toolpp, vcryptpp, vtfpp
+
+__author__ = "craftablescience"
+__version__ = "2025.2.12dev1"
+__all__ = ['__author__', '__doc__', '__version__', 'bsppp', 'gamepp', 'sourcepp', 'steampp', 'toolpp', 'vcryptpp', 'vtfpp']

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/src/sourcepp.cpp

@@ -1,5 +1,9 @@
 #include "sourcepp.h"
 
+#ifdef BSPPP
+#include "bsppp.h"
+#endif
+
 #ifdef GAMEPP
 #include "gamepp.h"
 #endif
@@ -25,6 +29,12 @@ NB_MODULE(_sourcepp_impl, m) {
 
 	sourcepp::register_python(m);
 
+#ifdef BSPPP
+	bsppp::register_python(m);
+#else
+	m.def_submodule("bsppp");
+#endif
+
 #ifdef GAMEPP
 	gamepp::register_python(m);
 #else

{sourcepp-2025.1.26.dev1 → sourcepp-2025.2.12.dev1}/src/vtfpp.h

@@ -165,8 +165,10 @@ void register_python(py::module_& m) {
 			.value("BOX",           ResizeFilter::BOX)
 			.value("BILINEAR",      ResizeFilter::BILINEAR)
 			.value("CUBIC_BSPLINE", ResizeFilter::CUBIC_BSPLINE)
-			.value("CATMULLROM",    ResizeFilter::CATMULLROM)
+			.value("CATMULL_ROM",   ResizeFilter::CATMULL_ROM)
 			.value("MITCHELL",      ResizeFilter::MITCHELL)
+			.value("POINT_SAMPLE",  ResizeFilter::POINT_SAMPLE)
+			.value("KAISER",        ResizeFilter::KAISER)
 			.export_values();
 
 		py::enum_<ResizeMethod>(ImageConversion, "ResizeMethod")
@@ -235,11 +237,11 @@ void register_python(py::module_& m) {
 		.def("set_image", [](PPL& self, const py::bytes& imageData, ImageFormat format, uint32_t width, uint32_t height, uint32_t lod = 0) {
 			self.setImage({reinterpret_cast<const std::byte*>(imageData.data()), imageData.size()}, format, width, height, lod);
 		}, py::arg("imageData"), py::arg("format"), py::arg("width"), py::arg("height"), py::arg("lod") = 0)
-		.def("set_image_resized", [](PPL& self, const py::bytes& imageData, ImageFormat format, uint32_t width, uint32_t height, uint32_t resizedWidth, uint32_t resizedHeight, uint32_t lod = 0, ImageConversion::ResizeFilter filter = ImageConversion::ResizeFilter::BILINEAR) {
+		.def("set_image_resized", [](PPL& self, const py::bytes& imageData, ImageFormat format, uint32_t width, uint32_t height, uint32_t resizedWidth, uint32_t resizedHeight, uint32_t lod = 0, ImageConversion::ResizeFilter filter = ImageConversion::ResizeFilter::DEFAULT) {
 			self.setImage({reinterpret_cast<const std::byte*>(imageData.data()), imageData.size()}, format, width, height, resizedWidth, resizedHeight, lod, filter);
-		}, py::arg("imageData"), py::arg("format"), py::arg("width"), py::arg("height"), py::arg("resized_width"), py::arg("resized_height"), py::arg("lod") = 0, py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR)
+		}, py::arg("imageData"), py::arg("format"), py::arg("width"), py::arg("height"), py::arg("resized_width"), py::arg("resized_height"), py::arg("lod") = 0, py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT)
 		.def("set_image_from_file", py::overload_cast<const std::string&, uint32_t>(&PPL::setImage), py::arg("image_path"), py::arg("lod") = 0)
-		.def("set_image_resized_from_file", py::overload_cast<const std::string&, uint32_t, uint32_t, uint32_t, ImageConversion::ResizeFilter>(&PPL::setImage), py::arg("image_path"), py::arg("resized_width"), py::arg("resized_height"), py::arg("lod") = 0, py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR)
+		.def("set_image_resized_from_file", py::overload_cast<const std::string&, uint32_t, uint32_t, uint32_t, ImageConversion::ResizeFilter>(&PPL::setImage), py::arg("image_path"), py::arg("resized_width"), py::arg("resized_height"), py::arg("lod") = 0, py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT)
 		.def("save_image", [](const PPL& self, uint32_t lod = 0, ImageConversion::FileFormat fileFormat = ImageConversion::FileFormat::DEFAULT) {
 			const auto d = self.saveImageToFile(lod, fileFormat);
 			return py::bytes{d.data(), d.size()};
@@ -428,11 +430,12 @@ void register_python(py::module_& m) {
 		.def_prop_rw("flags", &VTF::getFlags, &VTF::setFlags)
 		.def("add_flags", &VTF::addFlags, py::arg("flags"))
 		.def("remove_flags", &VTF::removeFlags, py::arg("flags"))
+		.def_static("get_default_compressed_format", &VTF::getDefaultCompressedFormat, py::arg("input_format"), py::arg("major_version"), py::arg("minor_version"))
 		.def_prop_ro("format", &VTF::getFormat)
-		.def("set_format", &VTF::setFormat, py::arg("new_format"), py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR)
+		.def("set_format", &VTF::setFormat, py::arg("new_format"), py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT)
 		.def_prop_rw("mip_count", &VTF::getMipCount, &VTF::setMipCount)
 		.def("set_recommended_mip_count", &VTF::setRecommendedMipCount)
-		.def("compute_mips", &VTF::computeMips, py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR)
+		.def("compute_mips", &VTF::computeMips, py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT)
 		.def_prop_rw("frame_count", &VTF::getFrameCount, &VTF::setFrameCount)
 		.def_prop_ro("face_count", &VTF::getFaceCount)
 		.def("set_face_count", &VTF::setFaceCount, py::arg("is_cubemap"), py::arg("has_spheremap") = false)
@@ -488,10 +491,10 @@ void register_python(py::module_& m) {
 			const auto d = self.getImageDataAsRGBA8888(mip, frame, face, slice);
 			return py::bytes{d.data(), d.size()};
 		}, py::arg("mip") = 0, py::arg("frame") = 0, py::arg("face") = 0, py::arg("slice") = 0)
-		.def("set_image", [](VTF& self, const py::bytes& imageData, ImageFormat format, uint16_t width, uint16_t height, ImageConversion::ResizeFilter filter = ImageConversion::ResizeFilter::BILINEAR, uint8_t mip = 0, uint16_t frame = 0, uint8_t face = 0, uint16_t slice = 0) {
+		.def("set_image", [](VTF& self, const py::bytes& imageData, ImageFormat format, uint16_t width, uint16_t height, ImageConversion::ResizeFilter filter = ImageConversion::ResizeFilter::DEFAULT, uint8_t mip = 0, uint16_t frame = 0, uint8_t face = 0, uint16_t slice = 0) {
 			return self.setImage({reinterpret_cast<const std::byte*>(imageData.data()), imageData.size()}, format, width, height, filter, mip, frame, face, slice);
 		}, py::arg("image_data"), py::arg("format"), py::arg("width"), py::arg("height"), py::arg("filter"), py::arg("mip") = 0, py::arg("frame") = 0, py::arg("face") = 0, py::arg("slice") = 0)
-		.def("set_image_from_file", py::overload_cast<const std::string&, ImageConversion::ResizeFilter, uint8_t, uint16_t, uint8_t, uint16_t>(&VTF::setImage), py::arg("image_path"), py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR, py::arg("mip") = 0, py::arg("frame") = 0, py::arg("face") = 0, py::arg("slice") = 0)
+		.def("set_image_from_file", py::overload_cast<const std::string&, ImageConversion::ResizeFilter, uint8_t, uint16_t, uint8_t, uint16_t>(&VTF::setImage), py::arg("image_path"), py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT, py::arg("mip") = 0, py::arg("frame") = 0, py::arg("face") = 0, py::arg("slice") = 0)
 		.def("save_image", [](const VTF& self, uint8_t mip = 0, uint16_t frame = 0, uint8_t face = 0, uint16_t slice = 0, ImageConversion::FileFormat fileFormat = ImageConversion::FileFormat::DEFAULT) {
 			const auto d = self.saveImageToFile(mip, frame, face, slice, fileFormat);
 			return py::bytes{d.data(), d.size()};
@@ -513,7 +516,7 @@ void register_python(py::module_& m) {
 		.def("set_thumbnail", [](VTF& self, const py::bytes& imageData, ImageFormat format, uint16_t width, uint16_t height) {
 			return self.setThumbnail({reinterpret_cast<const std::byte*>(imageData.data()), imageData.size()}, format, width, height);
 		}, py::arg("image_data"), py::arg("format"), py::arg("width"), py::arg("height"))
-		.def("compute_thumbnail", &VTF::computeThumbnail, py::arg("filter") = ImageConversion::ResizeFilter::BILINEAR)
+		.def("compute_thumbnail", &VTF::computeThumbnail, py::arg("filter") = ImageConversion::ResizeFilter::DEFAULT)
 		.def("remove_thumbnail", &VTF::removeThumbnail)
 		.def("save_thumbnail", [](const VTF& self, ImageConversion::FileFormat fileFormat = ImageConversion::FileFormat::DEFAULT) {
 			const auto d = self.saveThumbnailToFile(fileFormat);

sourcepp-2025.1.26.dev1/src/sourcepp/__init__.py

@@ -1,5 +0,0 @@
-from ._sourcepp_impl import __doc__, gamepp, sourcepp, steampp, toolpp, vcryptpp, vtfpp
-
-__author__ = "craftablescience"
-__version__ = "2025.01.26dev1"
-__all__ = ['__author__', '__doc__', '__version__', 'gamepp', 'sourcepp', 'steampp', 'toolpp', 'vcryptpp', 'vtfpp']