robin/vbsp-to-gltf
1
0
Fork 0
mirror of https://codeberg.org/icewind/vbsp-to-gltf.git synced 2026-06-03 18:24:07 +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
```
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
variable.
It should be able to automatically detect the tf2 path or you can overwrite it
by setting the `TF_DIR` environment variable.
## Model optimization
The output for the converter isn't particularly optimized, it's strongly recommended to run the output
through [gltfpack](https://github.com/zeux/meshoptimizer) before usage.
The output for the converter isn't particularly optimized, it's strongly
recommended to run the output through
[gltfpack](https://github.com/zeux/meshoptimizer) before usage.
![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
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,
importNpmLock,
nodejs_20,
lib,
}:
buildNpmPackage rec {
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)"
GPU texture and texture video compression system that outputs a highly
compressed intermediate file format (.basis) that can be quickly transcoded to
a wide variety of GPU texture compression formats.
compressed intermediate file format (.basis) that can be quickly transcoded to a
wide variety of GPU texture compression formats.
[GitHub](https://github.com/BinomialLLC/basis_universal)
## Transcoders
Basis Universal texture data may be used in two different file formats:
`.basis` and `.ktx2`, where `ktx2` is a standardized wrapper around basis texture data.
Basis Universal texture data may be used in two different file formats: `.basis`
and `.ktx2`, where `ktx2` is a standardized wrapper around basis texture data.
For further documentation about the Basis compressor and transcoder, refer to
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.wasm` — WebAssembly transcoder.