3. Commands

1. Commands list (for specific file type)

--i        --input=VALUE              input mandatory file
--o        --output=VALUE             output mandatory file
--s        --shaders=VALUE            input shader path
--c        --color                    enable color when generating heightmap
--cl       --color-limit=VALUE        set the maximal number of colors for the palette
--cm       --color-from-file=VALUE    load color from another file
--cs       --chunk-size=VALUE         set the chunk size (default: 128, min: 11, max: 256)
--e        --excavate                 delete all voxels which doesn't have at least one face connected with air
--msx      --mesh-segment-x=VALUE     set the number of segment in X axis (for MeshSampler)
--msy      --mesh-segment-Y=VALUE     set the number of segment in Y axis (for MeshSampler)
--msub     --mesh-subsample           set the number of subsample (for MeshSampler)
--mskip                               skip the capturing points part and load the previous PLY (for MeshSampler)
--h        --help                     help informations
--hm       --heightmap=VALUE          create voxels terrain from heightmap with the specified height
--p        --palette=VALUE            set the palette
--si       --slice                    flag the current input folder as slice
--sc       --scale=VALUE              set the scale
--v,       --verbose                  enable the verbose mode

2. Commands compatibility

Command	.asc	.binvox	.csv	.fbx	.obj	.ply	.png	.qb	.schematic	.tif	.xyz
--color	❌	❌	❌	❌	❌	❌	✅	❌	❌	✅	❌
--color-limit	❌	❌	❌	✅	✅	✅	✅	❌	❌	✅	✅
--color-from-file	❌	❌	❌	❌	❌	❌	✅	❌	❌	✅	❌
--chunk-size	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
--excavate	❌	❌	❌	❌	❌	❌	✅	❌	✅	✅	❌
--heightmap	❌	❌	❌	❌	❌	❌	✅	❌	❌	✅	❌
--mesh-segment-x	❌	❌	❌	✅	✅	❌	✅	❌	❌	✅	❌
--mesh-segment-y	❌	❌	❌	✅	✅	❌	✅	❌	❌	✅	❌
--mesh-subsample	❌	❌	❌	✅	✅	❌	✅	❌	❌	✅	❌
--mskip	❌	❌	❌	✅	✅	❌	✅	❌	❌	✅	❌
--heightmap	❌	❌	❌	❌	❌	❌	✅	❌	❌	✅	❌
--palette	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
--slice	❌	❌	❌	❌	❌	❌	✅	❌	❌	❌	❌
--scale	❌	❌	❌	✅	✅	✅	❌	❌	✅	❌	✅

3. Batching

You can process multiple files at once. To do such operation, all your files must be in a folder: ./FileToVox.exe --i [FOLDER] --o [OUTPUT]

Note : you can also add argument to the conversion but the argument will be applied to all files.

4. Slice

You can process a folder of pictures (all must be .PNG). This is usefull when you import export slices of fractal from program like Mandelbulb3D. To indicate to FileToVox that each picture in your folder is a slice, add the argument --slice.

5. Shaders

You can apply shaders on your model. This is like a "post-process" operation. More details for each shaders in the JSON wiki page. ./FileToVox.exe --i [FOLDER] --o [OUTPUT] --shaders [PATH_SHADER.json]