robin/vbsp-to-gltf
1
0
Fork 0
mirror of https://codeberg.org/icewind/vbsp-to-gltf.git synced 2026-06-03 10:14:08 +02:00
Code Issues Projects Releases Packages Wiki Activity

cleanup + formatting

Browse source
This commit is contained in:
Robin Appelman 2025-05-24 14:30:54 +02:00
commit 3ca086d8cd
3 changed files with 17 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

18
README.md
View file

@ -8,20 +8,24 @@ Convert Valve BSP files to GLTF files
vbsp-to-gltf input.bsp output.glb vbsp-to-gltf input.bsp output.glb
``` ```
Note that this requires TF2 to be installed to get the texture and props referenced in the map. Note that this requires TF2 to be installed to get the texture and props
referenced in the map.
It should be able to automatically detect the tf2 path or you can overwrite it by setting the `TF_DIR` environment It should be able to automatically detect the tf2 path or you can overwrite it
variable. by setting the `TF_DIR` environment variable.
## Model optimization ## Model optimization
The output for the converter isn't particularly optimized, it's strongly recommended to run the output The output for the converter isn't particularly optimized, it's strongly
through [gltfpack](https://github.com/zeux/meshoptimizer) before usage. recommended to run the output through
[gltfpack](https://github.com/zeux/meshoptimizer) before usage.
![screenshot of koth_bagel model](readme/bagel.webp) ![screenshot of koth_bagel model](readme/bagel.webp)
`koth_bagel` as viewed with the [PlayCanvas model viewer](https://playcanvas.com/viewer). `koth_bagel` as viewed with the
[PlayCanvas model viewer](https://playcanvas.com/viewer).
## Online converter ## Online converter
An online version of the convert can be found at [gltf.demos.tf](https://gltf.demos.tf/). An online version of the convert can be found at
[gltf.demos.tf](https://gltf.demos.tf/).

2
nix/viewer.nix
View file

@ -1,8 +1,6 @@
{ {
buildNpmPackage, buildNpmPackage,
importNpmLock, importNpmLock,
nodejs_20,
lib,
}: }:
buildNpmPackage rec { buildNpmPackage rec {
pname = "vbsp-server-viewer"; pname = "vbsp-server-viewer";

11
src/server/viewer/transcoders/README.md
View file

@ -2,20 +2,21 @@
Basis Universal is a "[supercompressed](http://gamma.cs.unc.edu/GST/gst.pdf)" Basis Universal is a "[supercompressed](http://gamma.cs.unc.edu/GST/gst.pdf)"
GPU texture and texture video compression system that outputs a highly GPU texture and texture video compression system that outputs a highly
compressed intermediate file format (.basis) that can be quickly transcoded to compressed intermediate file format (.basis) that can be quickly transcoded to a
a wide variety of GPU texture compression formats. wide variety of GPU texture compression formats.
[GitHub](https://github.com/BinomialLLC/basis_universal) [GitHub](https://github.com/BinomialLLC/basis_universal)
## Transcoders ## Transcoders
Basis Universal texture data may be used in two different file formats: Basis Universal texture data may be used in two different file formats: `.basis`
`.basis` and `.ktx2`, where `ktx2` is a standardized wrapper around basis texture data. and `.ktx2`, where `ktx2` is a standardized wrapper around basis texture data.
For further documentation about the Basis compressor and transcoder, refer to For further documentation about the Basis compressor and transcoder, refer to
the [Basis GitHub repository](https://github.com/BinomialLLC/basis_universal). the [Basis GitHub repository](https://github.com/BinomialLLC/basis_universal).
The folder contains two files required for transcoding `.basis` or `.ktx2` textures: The folder contains two files required for transcoding `.basis` or `.ktx2`
textures:
- `basis_transcoder.js` — JavaScript wrapper for the WebAssembly transcoder. - `basis_transcoder.js` — JavaScript wrapper for the WebAssembly transcoder.
- `basis_transcoder.wasm` — WebAssembly transcoder. - `basis_transcoder.wasm` — WebAssembly transcoder.