GitHub - DFHack/stonesense at cfcf9926f6bef435905768d6e0c1b7c1ebcbf0e9

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 937 Commits
CMake/Modules		CMake/Modules
materials_info		materials_info
resources		resources
utilities		utilities
.gitignore		.gitignore
BuildingConfiguration.cpp		BuildingConfiguration.cpp
BuildingConfiguration.h		BuildingConfiguration.h
CMakeLists.txt		CMakeLists.txt
Changelog.txt		Changelog.txt
ColorConfiguration.cpp		ColorConfiguration.cpp
ColorConfiguration.h		ColorConfiguration.h
ConditionalSprite.cpp		ConditionalSprite.cpp
ConditionalSprite.h		ConditionalSprite.h
Config.cpp		Config.cpp
Constructions.cpp		Constructions.cpp
Constructions.h		Constructions.h
ContentBuildingReader.cpp		ContentBuildingReader.cpp
ContentBuildingReader.h		ContentBuildingReader.h
ContentLoader.cpp		ContentLoader.cpp
ContentLoader.h		ContentLoader.h
Contributions.txt		Contributions.txt
CreatureConfiguration.cpp		CreatureConfiguration.cpp
CreatureConfiguration.h		CreatureConfiguration.h
Creatures.cpp		Creatures.cpp
Creatures.h		Creatures.h
DumpInfo.cpp		DumpInfo.cpp
DumpInfo.h		DumpInfo.h
DwarfIso.vcxproj		DwarfIso.vcxproj
FluidConfiguration.cpp		FluidConfiguration.cpp
FluidConfiguration.h		FluidConfiguration.h
GUI.cpp		GUI.cpp
GUI.h		GUI.h
GameBuildings.cpp		GameBuildings.cpp
GameBuildings.h		GameBuildings.h
GroundMaterialConfiguration.cpp		GroundMaterialConfiguration.cpp
GroundMaterialConfiguration.h		GroundMaterialConfiguration.h
ItemConfiguration.cpp		ItemConfiguration.cpp
ItemConfiguration.h		ItemConfiguration.h
MapLoading.cpp		MapLoading.cpp
MapLoading.h		MapLoading.h
ON COMPILING.txt		ON COMPILING.txt
OcclusionTest.cpp		OcclusionTest.cpp
OcclusionTest.h		OcclusionTest.h
README.txt		README.txt
SpriteColors.cpp		SpriteColors.cpp
SpriteColors.h		SpriteColors.h
SpriteMaps.cpp		SpriteMaps.cpp
SpriteMaps.h		SpriteMaps.h
SpriteObjects.cpp		SpriteObjects.cpp
SpriteObjects.h		SpriteObjects.h
StonesenseSolution.sln		StonesenseSolution.sln
TODO.txt		TODO.txt
Tile.cpp		Tile.cpp
Tile.h		Tile.h
TileCondition.cpp		TileCondition.cpp
TileCondition.h		TileCondition.h
TileTree.cpp		TileTree.cpp
TileTree.h		TileTree.h
UserInput.cpp		UserInput.cpp
VegetationConfiguration.cpp		VegetationConfiguration.cpp
VegetationConfiguration.h		VegetationConfiguration.h
WorldSegment.cpp		WorldSegment.cpp
WorldSegment.h		WorldSegment.h
common.h		common.h
commonTypes.h		commonTypes.h
main.cpp		main.cpp
res.rc		res.rc
stonesense.ico		stonesense.ico
stonesense.xpm		stonesense.xpm

Repository files navigation

Welcome to Stonesense Felsite(3.1)

Thank you for trying out our little visualizer,
as always, we appreciate any feedback.

Please note that stonesense is tightly bound to DFHack, and so only works for the version that
the accompanying DFHack is built for.

To run stonesense, Copy DFHack into the dwarf fortress folder, and run DwarfFortress.exe.
When DFHack console appears, type in stonesense and press enter.

--== Configuration ==--

Application options are set and documented in the init.txt file

--== Controls ==--

-- Mouse --
Left click: Move debug cursor (if available)
Right click: Recenter screen
Scrollwheel: Move up and down
Ctrl-Scrollwheel: Increase/decrease Z depth shown

-- Keyboard --
Arrow keys: Move around (hold shift for large moves)
PG UP/PG Down: Move up and down
9 and 0: Alternative move up and down
1 and 2: Increase/decrease Z depth shown
Enter: Rotate view 90 degrees
ESC: Exit program
U: Toggle stockpiles.
I: Toggle zones.
C: Toggle truncated walls.
F: Toggle follow mode.
H: Toggle hidden tiles.
B: Toggle blacked out areas.
S: Toggle single layer view.
N: Toggle creature names.
M: Toggle creature emotion icons.
O: Toggle occlusion culling.
F2: Screenshot mode/hide display overlays
F5: Save Screenshot
CTRL + F5: Save Screenshot of entire fortress with the current Z level settings.
CTRL + SHIFT + F5: Save a screenshot of the entire fortress from the current top Z level down to the bottom of the map.
ALT + F5: Save a volumetric thing I'm testing out.
Numpad + and -: Increase/Decrease AutoReload Rate
CTRL + navigation: Adjusts follow mode offset
,: Zoom out.
.: Zoom in.

-- Debug Keys --
(prolly not useful for you guys)
D: redraw screen
R: reload memory from DF
G: reload sprites & config from disk
F10: display available sprites
Numpad numbers: Move debug cursor (if available)
Ctrl+F: Toggle Cursor Follow Mode

-- Follow mode --
When you turn on follow mode, the screen will jump to the location of the DF window.
You can adjust the position of the follow mode relative to the DF window by
holding Ctrl while using the keyboard window movement keys.

When you turn on cursor follow mode, the debug cursor will follow the DF cursor when it exists.

-- Occlusion Culling --
There is an experimental feature that hides tiles that are not visible, for a speed increase.
This is a work in progress, and very buggy. It can be turned off with 'o', if something is missing.

--== Contacts ==--

Stonesense mailing list:
http://groups.google.com/group/stonesense

Stonesense on Bay12Games forums:
http://www.bay12games.com/forum/index.php?topic=43260.0

--== Known Issues ==--

We have seen some crash bugs from time to times.

Good Luck!
- The Stonesense Crew