Zarbuz / Filetovox
Projects that are alternatives of or similar to Filetovox
What is FileToVox ?
FileToVox is a console program which allow you to convert a file into a vox file (Magicavoxel).
Current files support:
- .asc (Esri ASCII raster format)
- .binvox
- .csv
- .obj
- .ply (Binary and ASCII)
- .png
- .schematic
- .tif
- .qb (Qubicle)
- .xyz (X Y Z R G B)
- folder (of .PNG)
FileToVox can import a folder of images (.PNG) where each image is a layer. (Useful for import fractals from Mandelbulb3D)
It support world region, so you can convert a terrain bigger than 126^3 voxels !
How use it ?
- You need to open a console (like cmd or Powershell in Windows)
- Go to the emplacement of FileToVox.exe
- Launch the command :
./FileToVox.exe --i [INPUT] --o [OUTPUT] - [INPUT] refer to a input filepath (mandatory)
- [OUTPUT] refer to the destination path (mandatory)
Installation
Go to the release page and download the lastest version of FileToVox. Be sure to download the binary and not the source code.
You need to install the .NET Core Runtime Library : https://dotnet.microsoft.com/download/dotnet-core/current/runtime Then extract the content of the zip file in the folder of your choice.
MacOS or Linux
You should install .NET Core Runtime : https://docs.microsoft.com/en-us/dotnet/core/install/macos
If you have an error like 'Unable to load DLL 'libgdiplus', try this command : brew install mono-libgdiplus
If you have this error : 'brew command not found'.
Install first : /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Commands list
--i --input=VALUE input mandatory file
--o --output=VALUE output mandatory file
--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
--fl --flood fill all invisibles voxels
--flo --fix-lonely delete all voxels where all connected voxels are air
--fh --fix-holes fix holes
--gs --grid-size=VALUE set the grid size
--h --help help informations
--hm --heightmap=VALUE create voxels terrain from heightmap with the specified height
--iminy --ignore-min-y=VALUE ignore voxels below the specified layer
--imaxy --ignore-max-y=VALUE ignore voxels above the specified layer
--p --palette=VALUE set the palette
--si --slice flag the current input folder as slice
--sc --scale=VALUE set the scale
--sl --slow=VALUE use a slower algorithm (use all cores) to generate voxels from OBJ but best result (value should be enter 0.0 and 1.0 (0.5 is recommended)
--t, --top create voxels only at the top of the heightmap
--v, -verbose enable the verbose mode
Command compatibility
1. General
| Command | .asc | .binvox | .csv | .obj | .ply | .png | .qb | .schematic | .tif | .xyz |
|---|---|---|---|---|---|---|---|---|---|---|
--color |
❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
--color-limit |
❌ | ❌ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ |
--color-from-file |
❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
--chunk_size |
✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
--excavate |
❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ | ❌ |
--flood |
❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |
--fix-lonely |
❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |
--fix-holes |
❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |
--grid-size |
❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
--heightmap |
❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
--ignore-min-y |
❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
--ignore-max-y |
❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
--palette |
✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
--slice |
❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
--scale |
❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ |
--slow |
❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
--top |
❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |
2. 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 converted
Note : you can also add argument to the conversion but the argument will be applied to all files.
3. 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.
config.txt
You can edit the colors of the palette used when generating from schematic file in schematics/config.txt
Examples
./FileToVox.exe --i heightmap.png --o heightmap --hm 100
./FileToVox.exe --i heightmap.png --o heightmap --hm 100 --e --cm colors.png
./FileToVox.exe --i cloud.ply --o cloud --scale 20
Video Tutorials
Notes
For PNG files, you can't load pictures bigger than 2000x2000 px
Input file
Ouput file
Renders
