tech
/
vvmtool
2
0
Fork 0
Code Issues 1 Pull Requests Projects Releases Wiki Activity

Added README.md

This commit is contained in:
Marco Cawthorne 2021-08-09 10:15:24 +02:00
parent 2b19f63cb5
commit 83b7625f1a
1 changed files with 58 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
README.md Normal file
View File

@ -0,0 +1,58 @@
# vvmtool
This is the exporter for our extended model format (**VVM**). It's based off IQM and to
some extent is backwards compatible (this was done so that editors capable of
displaying IQM files would *just work*, however it depends on how the loader is written.
These days, you can find an updated version of this tool inside the [FTE SRC](https://sourceforge.net/p/fteqw/code/HEAD/tree/), however
it has grown to become much more than a model exporter and become less portable as a result.
For those reasons, we are preserving our version of the original, extended tool here.
It exports plain .IQM files, as well as .VVM files.
Extra resources, such as the pre-release files we shared on inside3d.com:
* [vvm docs](vera-visions.com/dev/vvm-docs-1.zip)
* [vvm example model sources](vera-visions.com/dev/vvm_example.zip)
* [July 2017: old sources dated](vera-visions.com/dev/vvm-src-1.zip)
* [July 2017: old win32 binary](vera-visions.com/dev/vvm-w32-1.zip)
# History
In 2016 when we had our first prototype of The Wastes, we started out using DPM for
toolchain related reasons and quickly migrated to IQM. However we needed a better
system for handling reproducible output files. The original tool only handled
compilation via plain command-line parameters which was not good enough.
The input command file (.qc) syntax is obviously inspired by qdata and other tools
such as studiomdl. So if you're familar with those tools you know exactly what to expect.
We then went on and designed extensions that we needed to make the game work,
for example a generic model-events system that'd call events in the game-logic
when a certain keyframe in the model is displayed.
More complicated things were hitmeshes, for more accurate hit detection of body
parts as well as submodels that made the action of shooting body-parts off possible.
We developed this together with David of FTEQW, since this had to be developed
in conjunction with the FTEQW builtins that'd later be exposed to the game-logic.
However, the initial extensions to the IQM format in FTE were designed by us; and this
is the exporter that was used to make our game.
# Building
Make sure you have a C++ compiler installed and issue:
```make```
# LICENSE
Copyright (c) 2010-2016 Lee Salzman
Copyright (c) 2016-2017 Vera Visions
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.