v0.9.1

Control!
With the addition of the ability to stream the Dwarf Fortress screen to Armok Vision, you no longer strictly need to keep alt-tabbing between Dwarf Fortress and Armok Vision, though you may want to anyway because it's still pretty buggy.
Just press the ` key (the one to the left of number 1) to toggle the DF screen.
While the DF screen is being shown, Armok Vision itself will not accept any keyboard input, instead passing it along directly to DF.

There's a known issue that the key repeat rates are completely borked. I'm not sure how to fix this.

Changelog:

• Fixed tree foliage textures.
• Fixed keyboard not responding on startup.
• Made all debug stuff off by default. You can turn it on in the config json file.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
L: Toggle scaling of creatures based on their size.
`: Toggle showing the Dwarf Fortress screen.
F: Toggle following the center of the dwarf fortress screen.
Ctrl+M: Exports the map as a Collada file.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
At a minimum, Armok Vision needs a copy of Dwarf Fortress with a recent build of DFHack installed on top of it.
For a complete experience, you either need a copy of DFHack built after the current version of Armok Vision was released, or an updated RemoteFortressReader plugin for your platform. If none is available, you can follow the instructions at https://github.com/DFHack/dfhack/blob/master/docs/Compile.rst to build your own. You will need to build from the develop branch of DFHack.
Then just run Armok Vision from anywhere with any save loaded in Dwarf Fortress.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.9.0

Contro!
With the addition of the ability to stream the Dwarf Fortress screen to Armok Vision, you no longer strictly need to keep alt-tabbing between Dwarf Fortress and Armok Vision, though you may want to anyway because it's still pretty buggy.
Just press the ` key (the one to the left of number 1) to toggle the DF screen.
While the DF screen is being shown, Armok Vision itself will not accept any keyboard input, instead passing it along directly to DF.

There's a known issue that the key repeat rates are completely borked. I'm not sure how to fix this.

Changelog:

• Added a toggle to follow the DF screen. Press F to activate.
• You can now press ` to bring in the screen from Dwarf Fortress. Currently rather buggy.
• Hidden map tiles are now invisible in Armok Vision. TODO: Make them black.
• Models can now have metallic and self illumination maps. Beds temporarily have both.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
L: Toggle scaling of creatures based on their size.
`: Toggle showing the Dwarf Fortress screen.
F: Toggle following the center of the dwarf fortress screen.
Ctrl+M: Exports the map as a Collada file.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R5 installed, with RemoteFortressReader-windows-0-40-24-r5.plug.zip extracted into your Dwarf-Fortress/hack/plugins directory.
Then just run Armok Vision from anywhere with any save loaded in Dwarf Fortress.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.8.0

Trees!

Changelog:

• Fixed units showing up when they're caged or off the map
• Added creature names above sprites
• Added option to export the generated map to collada file, using Ctrl+M. Quite crashy.
• Made clouds and distant terrain optional
• Trees now show leaves, flowers, and fruits, in their proper times and colors.
• Backend stuff related to creatures. Not usable yet.
• Performance improvements by Kazimuth
• Save various settings to a JSON file that is created on first run.
• Remodel tree branches
• Added palm leaves to trees that can use them.
• Made the sun angle change according to season.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
L: Toggle scaling of creatures based on their size.
Ctrl+M: Exports the map as a Collada file.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R5 installed, with RemoteFortressReader-windows-0-40-24-r5.plug.zip extracted into your Dwarf-Fortress/hack/plugins directory.
Then just run Armok Vision from anywhere with any save loaded in Dwarf Fortress.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.7.2

More Bugfix!

v0.7.1 broke the user-settable time-of-day. This release fixes it.
It also fixes some animals that weren't supposed to show up that did.

Changelog:

• Fixed time-of-day changing that 0.7.1 broke.
• Fixed caged and gone creatures showing up where they're not supposed to.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
L: Toggle scaling of creatures based on their size.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R4 installed. Nothing else needed for this release.
Then just run Armok Vision from anywhere.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.7.1

Bugfix!

This is a bugfix release. v0.7 failed rendering every time the adventurer made a step, and also had some pretty heavy performance issues. This release fixes those. Following is the release text for 0.7:

The primary focus of this release is, as mentioned, buildings. And furniture. Tables, chairs, waterwheels, etc.

There's quite a lot of stuff that doesn't have a model yet, and even more with only placeholder models, but since it's been a while since the last release, and there's a new DFhack release, I figured I'd release what I have so far.
I also added in sun movement that matches your fortress time, but it's really fast, because of the fortress timescales.

Changelog:
v0.7.1:

• Fixed a bug that caused the landscape to not render whenever you moved as an adventurer.
• Various performance improvements.
  v0.7:
• Allowed loading up a DF world without a fort loaded, like on the embark screen.
• Added support for adventure mode entering and leaving fast travel.
• Changed how textures are loded. Alpha maps now go into texture shape, and specular smoothness maps go into the material texture.
• Added building support.
• Added basic meshes for many, but not all, buildings.
• Added support for semitransparent meshes, like glass.
• Added a day/night system. Time can be paused by pressing P, and can be moved forward and back with [ and ].
• Added optional scaling of unit sprites. Can be toggled with L.
• Added ability to toggle shadows from overhead hidden geometry by pressing O.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
S: Toggle scaling of creatures based on their size.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R4 installed. Nothing else needed for this release.
Then just run Armok Vision from anywhere.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.7

Buildings!

The primary focus of this release is, as mentioned, buildings. And furniture. Tables, chairs, waterwheels, etc.

There's quite a lot of stuff that doesn't have a model yet, and even more with only placeholder models, but since it's been a while since the last release, and there's a new DFhack release, I figured I'd release what I have so far.
I also added in sun movement that matches your fortress time, but it's really fast, because of the fortress timescales.

Changelog:

• Allowed loading up a DF world without a fort loaded, like on the embark screen.
• Added support for adventure mode entering and leaving fast travel.
• Changed how textures are loded. Alpha maps now go into texture shape, and specular smoothness maps go into the material texture.
• Added building support.
• Added basic meshes for many, but not all, buildings.
• Added support for semitransparent meshes, like glass.
• Added a day/night system. Time can be paused by pressing P, and can be moved forward and back with [ and ].
• Added optional scaling of unit sprites. Can be toggled with L.
• Added ability to toggle shadows from overhead hidden geometry by pressing O.

Controls:
W, A, S, D, and middle click drag: Move horizontally.
Q, E: Move up and down.
P: Pause and resume sun movement.
[, ]: Change time of day. This automatically pauses the sun movement.
O: Toggle shadows being casted from hidden Z-levels.
S: Toggle scaling of creatures based on their size.
Mouse wheel zooms in and out.
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R4 installed. Nothing else needed for this release.
Then just run Armok Vision from anywhere.

Support Me
If you'd like to support my efforts, you can become my patron at https://www.patreon.com/japamala

v0.6a

This is a hotfix release. The only change from 0.6 is how it handles an out of date Remotefortressreader plugin:
v0.6: Empty sky.
v0.6a: New features are not used, but old features still work as they did before. This means no sky, distant landscapes, units, or item-based textures on constructions.

The release is also much smaller because of some optimizations.

If you already have a working v0.6 release, you don't need to download this.

Controls:
WASD, and middle click drag, move horizontally
QE move up and down
Mouse wheel zooms in and out
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R3 installed.
The remotefortressreader plugin that comes with DFHack in the hack/plugins directory must be overwritten with the one provided below for your operating system if you want newer features. Linux users need to compile their own plugin, for now.
Then just run Armok Vision from anywhere.

Support Me
If you'd like to support my efforts, you can become my patreon at https://www.patreon.com/japamala

v0.6

This release adds horizon and clouds, and the ability to look upwards at them!

Changelog:

• improved ramp joining at block borders. Still not fully working.
• Added distant terrain and clouds
• Fixes for normal map loading
• Show basic units, only ascii for now.
• Add first person camera mode.

Controls:
WASD, and middle click drag, move horizontally
QE move up and down
Mouse wheel zooms in and out
Right click drag rotates the view.

Installation:
You must already have Dwarf Fortress 0.40.24 with DFHack R3 installed.
The included remotefortressreader.dll in the /hack/plugins directory must be over-written with the one provided below, matching your operating system, or it will not work.
Then just run Armok Vision from anywhere.

Support Me
If you'd like to support my efforts, you can become my patreon at https://www.patreon.com/japamala

v0.5

Biggest change in this release is loading textures from xml files. Have a look in "Armok Vision_Data/StreamingAssets/MaterialTextures" to see some examples, and maybe make your own.

There's two texture folders, each used independently.

• The MaterialTextures folder is the color pattern, which is combined with a material color from the colors folder to make the final texture. Black on the texture will be black, white on the texture will be white, and grey will become the color. This way you can have both shadows and highlights in your texture, and they will both show up after it's colored.
  This is most commonly used for setting the material of the object.
• The TileTextures folder sets the surface shape. Most commonly according to filetype, but in some cases, using the material as well.
  There are three textures here that get configured at once:
  ** Normal Map: This will set how the surface is shaded. Use google if you want to know more about how it works.
  ** Specular Map: Usually just one of the three flat textures there, unless you have special requirements. This sets the smoothness of the surface. Darker greys and black will result in a more matte finish, while lighter greys and white will produce shinier and more distinct reflections.
  ** Occlusion Map: Generally generated at the same time as the normal map, this just sets which parts of the object receive less ambient lighting, due to the surface shape.

I've also added screen space reflections, which look pretty nice, though the quality isn't configurable right now.

Install Note: Windows and OS X versions of the remotefortressreader plugin compiled against DFHack 0.40.24-r3 are distributed separately here, and are needed for Armok Vision to function.
There is also a 0.34.11 Windows plugin for older fortresses provided here, which requires DFHack 0.34.11-r5 found here: http://dffd.bay12games.com/file.php?id=8682
Linux users will have to compile it themselves, or wait for a new DFHack release.

v0.4

Many improvements, mostly by Kazimuth, resulting in huge speedups.

Also much improved the camera. Now you can fully move it around from within armok vision.

Controls are:

wasd: horizontal movement

qe: vertical movement

right click: camera angle

mouse wheel: zoom

middle click: pan

We have a cursor now, but it doesn't do much just yet.