Skip to content

Commit

Permalink
0.0.8 with more-top-down 8-way renders
Browse files Browse the repository at this point in the history
  • Loading branch information
tommyettinger committed Mar 2, 2017
1 parent a85d644 commit a85f1c1
Show file tree
Hide file tree
Showing 6 changed files with 832 additions and 169 deletions.
968 changes: 810 additions & 158 deletions IsoVoxel/PaletteDraw.cs

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion IsoVoxel/Properties/AssemblyInfo.cs
Expand Up @@ -32,5 +32,5 @@
// You can specify all the values or you can default the Build and Revision Numbers
// by using the '*' as shown below:
// [assembly: AssemblyVersion("1.0.*")]
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyVersion("0.0.8.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]
Binary file modified IsoVoxel/cube_ortho.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified IsoVoxel/cube_soft.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
19 changes: 14 additions & 5 deletions README.md
Expand Up @@ -6,9 +6,17 @@ Generates isometric pixel art from MagicaVoxel .vox files.
Usage
=====

IsoVoxel is a command-line program (though you don't need to be familiar with the command line to use it), and can be downloaded from this project's [Releases section](https://github.com/tommyettinger/IsoVoxel/releases).
The simplest way to make a bunch of renders (at least on Windows) is to drag and drop a MagicaVoxel .vox file onto `IsoVoxel.exe` in the File Explorer, which will make a new folder that shares a name with the .vox file.
MagicaVoxel saves its .vox files in the vox/ subfolder of the MagicaVoxel install directory. You should, of course, have unzipped IsoVoxel.exe from the .zip it is distriibuted inside before running it.
IsoVoxel is a command-line program (though you don't need to be familiar with the command line to use it), and
can be downloaded from this project's [Releases section](https://github.com/tommyettinger/IsoVoxel/releases).

The simplest way to make a bunch of renders (at least on Windows) is to drag and drop a MagicaVoxel .vox file
onto `IsoVoxel.exe` in the File Explorer, which will make a new folder that shares a name with the .vox file.
There will be 44 images in that folder once the program finishes rendering in a few seconds. They will all use
"light" outlining, where there is an outline around the image's silhouette and between gaps in space inside the
image, but the color is not a cartoon-style black and is instead a darker version of the nearby voxel color.

MagicaVoxel saves its .vox files in the vox/ subfolder of the MagicaVoxel install directory. You should, of
course, have unzipped IsoVoxel.exe from the .zip it is distributed inside before running it.

Alternatively, you can customize the rendering somewhat from the command line. For this, use `IsoVoxel.exe file.vox x y z o`, where the arguments are:
- file.vox was saved from MagicaVoxel, in the vox/ subfolder usually as mentioned before
Expand All @@ -20,12 +28,13 @@ Alternatively, you can customize the rendering somewhat from the command line. F
- `outline=none` (which has no inner or outer outlines).
- if you don't include x y z it will use the size of the model as set in MagicaVoxel
- if you don't give a .vox file it defaults to Zombie.vox , which is included
- if you don't include o it will use full outlining.
- if you don't include o it will use light outlining.
- o can be placed as the last argument even if some or all of x y z have not been included.

IsoVoxel will create a subdirectory named after the model (running on Truck.vox will create a folder called Truck, or on Zombie.vox will make a folder calld Zombie) and fill it with 36 images:
IsoVoxel will create a subdirectory named after the model (running on Truck.vox will create a folder called Truck, or on Zombie.vox will make a folder called Zombie) and fill it with 44 images:
- four for north/south/east/west
- four for the diagonals between them, rendered at a slightly different perspective (isometric)
- eight more for a mostly-top-down view of all eight directions, rendered at close to a 45 degree oblique angle as opposed to the "standard isometric pixel art" 26.565 degree angle; an advantage here is that all directions are about the same size and perspective
- eight images that are each double-sized versions of one of the original eight, with some extra voxels added to smooth jagged areas; these have Big in their name
- twelve images that are specially-smoothed versions of the N/S/E/W renders at 3 sizes, with Size1, Size2, or Size3 in the name
- four diagonal-direction (isometric) renders at the normal size but with sloped voxels used to make the hard edges seem softer
Expand Down
12 changes: 7 additions & 5 deletions Usage.txt
Expand Up @@ -5,13 +5,14 @@ Generates isometric pixel art from MagicaVoxel .vox files.
Usage

IsoVoxel is a command-line program (though you don't need to be familiar with the command line to use it).

The simplest way to make a bunch of renders (at least on Windows) is to drag and drop a MagicaVoxel .vox file
onto `IsoVoxel.exe` in the File Explorer, which will make a new folder that shares a name with the .vox file.
There will be 36 images in that folder once the program finishes rendering in a few seconds.
There will be 44 images in that folder once the program finishes rendering in a few seconds. They will all use
"light" outlining, where there is an outline around the image's silhouette and between gaps in space inside the
image, but the color is not a cartoon-style black and is instead a darker version of the nearby voxel color.

MagicaVoxel saves its .vox files in the vox/ subfolder of the MagicaVoxel install directory.
You should, of course, have unzipped IsoVoxel.exe from the .zip it is distriibuted inside before running it.
You should, of course, have unzipped IsoVoxel.exe from the .zip it is distributed inside before running it.

Alternatively, you can customize the rendering somewhat from the command line.
For this, use `IsoVoxel.exe file.vox x y z o`, where the arguments are:
Expand All @@ -25,13 +26,14 @@ For this, use `IsoVoxel.exe file.vox x y z o`, where the arguments are:
- `outline=none` (which has no inner or outer outlines).
- if you don't include x y z it will use the size of the model as set in MagicaVoxel
- if you don't give a .vox file it defaults to Zombie.vox , which is included
- if you don't include o it will use full outlining.
- if you don't include o it will use light outlining.
- o can be placed as the last argument even if some or all of x y z have not been included.

IsoVoxel will create a subdirectory named after the model (running on Truck.vox will create a folder called Truck, or on
Zombie.vox will make a folder calld Zombie) and fill it with 36 images:
Zombie.vox will make a folder called Zombie) and fill it with 44 images:
- four for north/south/east/west
- four for the diagonals between them, rendered at a slightly different perspective (isometric)
- eight more for a mostly-top-down view of all eight directions, rendered at close to a 45 degree oblique angle as opposed to the "standard isometric pixel art" 26.565 degree angle; an advantage here is that all directions are about the same size and perspective
- eight images that are each double-sized versions of one of the original eight, with some extra voxels added to smooth jagged areas; these have Big in their name
- twelve images that are specially-smoothed versions of the N/S/E/W renders at 3 sizes, with Size1, Size2, or Size3 in the name
- four diagonal-direction (isometric) renders at the normal size but with sloped voxels used to make the hard edges seem softer
Expand Down

0 comments on commit a85f1c1

Please sign in to comment.