Name

vtestbed-convert - convert three-dimensional ship models between different file formats

Synopsis

vtestbed-convert [-f from] [-t to] [-o file] [-d directory] [-O option] [-j jobs] [-hv] file...

Description

vtestbed-convert is a command line interface to Virtual Testbed asset conversion functions that allow to convert between popular 3-d model file formats and file formats that Virtual Testbed understands. Supported file formats: vsl, obj, stl, igs, rms, bsp.

-f formatinput file format.
-t formatoutput file format.
-o pathoutput file path.
-d pathoutput directory.
-O 'option value'import/export/conversion options.
-j nthe number of parallel threads.
-vshow input/output formats and file paths.
-hshow help message.

Options

Common options:

gnuplotOutput as Gnuplot script. This option works for any asset internal representation of which is polyhedron. Default value is 0 (false).
input-formatInput format. Can be one of the following: obj, stl, vsl, bsp, igs, rms.
output-formatOutput format. Can be one of the following: obj, stl, vsl, bsp, igs, rms.
input-pathInput file path.
output-pathOutput file path.

VSL options:

close-topDo not remove the main deck. Default value is 1 (true).
close-bottomDo not remove the bottom. Default value is 1 (true).
step-zVertical distance between points in metres. Default value is computed automatically as the average vertical distance between spline points.

BSP options:

resolution-uThe number of points for segment in U dimension. Default value is 2.
resolution-vThe number of points for segment in V dimension. Default value is 2.

Examples

The following command converts all the files in my-bsp-files directory from bsp to obj format and puts the result in my-obj-files directory using 4 threads.

vtestbed-convert -v -j 4 -f bsp -t obj -d my-obj-files my-bsp-files/*.bsp

Copyright

Copyright © 2018-2020 Andrei Ivashchenko, Anton Gavrikov, Artemii Grigorev, Denis Egorov, Dmitry Tereschenko, Ivan Gankevich, Ivan Petriakov.

Virtual Testbed is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Virtual Testbed is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Virtual Testbed. If not, see <https://www.gnu.org/licenses/>.

See Also

vtestbed(1), vtestbed-convert(1), guile(1).

Full documentation is available online.