2022-07-10 00:01:46 -06:00
|
|
|
stonesense
|
|
|
|
|
==========
|
sync tags spreadsheet to git
spreadsheet - https://docs.google.com/spreadsheets/d/1hiDlo8M_bB_1jE-5HRs2RrrA_VZ4cRu9VXaTctX_nwk/edit#gid=170388995
sync command - for fname in *rst; do name=$(echo $fname | sed 's/[.]rst//'); tagline=$(egrep ",$name," ~/Downloads/DFHack\ taxonomy\ -\ Tool\ tags.csv | ~/Downloads/csvtotags.sh); sed -ri "s;[*]*Tags:.*;$tagline;" $fname; done
contents of csvtotags.sh -
fgrep . | sed -r 's/^[^,]+,([^,]+),[^.]+[.]"?,/\1,/' | awk -F, '
function tag(idx, tagname) {
if ($idx == "TRUE") {
if (hastag == 1) {printf(", ")}
printf("`tag/%s`", tagname)
hastag = 1
}
}
{
printf("%s", "**Tags:** ")
hastag = 0
tag(2, "adventure")
tag(3, "fort")
tag(4, "legends")
tag(5, "embark")
tag(6, "system")
tag(7, "dev")
tag(8, "auto")
tag(9, "productivity")
tag(10, "inspection")
tag(11, "design")
tag(12, "quickfort")
tag(13, "interface")
tag(14, "fps")
tag(15, "fix")
tag(16, "mod")
tag(17, "armok")
tag(18, "animals")
tag(19, "buildings")
tag(20, "items")
tag(21, "jobs")
tag(22, "map")
tag(23, "labors")
tag(24, "units")
tag(25, "stockpiles")
tag(26, "trees")
printf("\n")
}
'
2022-08-05 18:55:33 -06:00
|
|
|
**Tags:** `tag/adventure`, `tag/fort`, `tag/interface`, `tag/map`
|
2022-07-31 14:30:19 -06:00
|
|
|
:dfhack-keybind:`stonesense`
|
|
|
|
|
:dfhack-keybind:`ssense`
|
|
|
|
|
|
|
|
|
|
A 3D isometric visualizer that runs in a second window.
|
|
|
|
|
|
|
|
|
|
Usage:
|
|
|
|
|
|
|
|
|
|
``stonesense`` or ``ssense``
|
|
|
|
|
Open the visualiser in a new window.
|
|
|
|
|
``ssense overlay``
|
|
|
|
|
Overlay DF window, replacing the map area.
|
|
|
|
|
|
|
|
|
|
The viewer window has read-only access to the game, and can follow the game view
|
|
|
|
|
or be moved independently. Configuration for stonesense can be set in the
|
|
|
|
|
``stonesense/init.txt`` file in your DF game directory. If the window refresh
|
|
|
|
|
rate is too low, change ``SEGMENTSIZE_Z`` to ``2`` in this file, and if you are
|
|
|
|
|
unable to see the edges of the map with the overlay active, try decreasing the
|
|
|
|
|
value for ``SEGMENTSIZE_XY`` -- normal values are ``50`` to ``80``, depending
|
|
|
|
|
on your screen resolution.
|
|
|
|
|
|
|
|
|
|
If you replace the map section of your DF window with ``ssense overlay``, be
|
|
|
|
|
aware that it's not (yet) suitable for use as your only interface. Use DF's
|
|
|
|
|
``[PRINT_MODE:2D]`` init option (in ``data/init/init.txt``) for stability.
|
|
|
|
|
|
|
|
|
|
.. figure:: ../images/stonesense-roadtruss.jpg
|
|
|
|
|
:align: center
|
|
|
|
|
:target: http://www.bay12forums.com/smf/index.php?topic=48172.msg3198664#msg3198664
|
|
|
|
|
|
|
|
|
|
The above-ground part of the fortress *Roadtruss*.
|
|
|
|
|
|
|
|
|
|
Controls
|
|
|
|
|
--------
|
|
|
|
|
Mouse controls are hard-coded and cannot be changed.
|
|
|
|
|
|
|
|
|
|
:Left click: Move debug cursor (if available)
|
|
|
|
|
:Right click: Recenter screen
|
|
|
|
|
:Scrollwheel: Move up and down
|
|
|
|
|
:Ctrl-Scroll: Increase/decrease Z depth shown
|
|
|
|
|
|
|
|
|
|
Follow mode makes the Stonesense view follow the location of the DF
|
|
|
|
|
window. The offset can be adjusted by holding :kbd:`Ctrl` while using the
|
|
|
|
|
keyboard window movement keys. When you turn on cursor follow mode, the
|
|
|
|
|
Stonesense debug cursor will follow the DF cursor when the latter exists.
|
|
|
|
|
|
|
|
|
|
You can take screenshots with :kbd:`F5`, larger screenshots with
|
|
|
|
|
:kbd:`Ctrl`:kbd:`F5`, and screenshot the whole map at full resolution with
|
|
|
|
|
:kbd:`Ctrl`:kbd:`Shift`:kbd:`F5`. Screenshots are saved to the DF directory.
|
|
|
|
|
Note that feedback is printed to the DFHack console, and you may need
|
|
|
|
|
to zoom out before taking very large screenshots.
|
|
|
|
|
|
|
|
|
|
See ``stonesense/keybinds.txt`` to learn or set keybindings, including
|
|
|
|
|
zooming, changing the dimensions of the rendered area, toggling various
|
|
|
|
|
views, fog, and rotation. Here's the important section:
|
|
|
|
|
|
|
|
|
|
.. include:: ../../plugins/stonesense/resources/keybinds.txt
|
|
|
|
|
:literal:
|
|
|
|
|
:end-before: VALID ACTIONS:
|
|
|
|
|
|
|
|
|
|
Known Issues
|
|
|
|
|
------------
|
|
|
|
|
If Stonesense gives an error saying that it can't load
|
|
|
|
|
:file:`creatures/large_256/*.png`, your video card cannot handle the high
|
|
|
|
|
detail sprites used. Either open :file:`creatures/init.txt` and remove the
|
|
|
|
|
line containing that folder, or :dffd:`use these smaller sprites <6096>`.
|
2022-07-10 00:01:46 -06:00
|
|
|
|
2022-07-31 14:30:19 -06:00
|
|
|
Stonesense requires working graphics acceleration, and we recommend
|
|
|
|
|
at least a dual core CPU to avoid slowing down your game of DF.
|
2022-07-10 00:01:46 -06:00
|
|
|
|
2022-07-31 14:30:19 -06:00
|
|
|
Useful links
|
|
|
|
|
------------
|
|
|
|
|
- :forums:`Official Stonesense thread <106497>` for feedback,
|
|
|
|
|
questions, requests or bug reports
|
|
|
|
|
- :forums:`Screenshots thread <48172>`
|
|
|
|
|
- :wiki:`Main wiki page <Utility:Stonesense>`
|
|
|
|
|
- :wiki:`How to add content <Utility:Stonesense/Adding_Content>`
|
|
|
|
|
- `Stonesense on Github <https://github.com/DFHack/stonesense>`_
|