diff --git a/docs/index.rst b/docs/index.rst index 8c3f0a13e3..04b0de7c9f 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -29,6 +29,7 @@ Tiled Documentation manual/automapping manual/export manual/keyboard-shortcuts + manual/preferences .. toctree:: :maxdepth: 2 diff --git a/docs/manual/images/preferences-general.png b/docs/manual/images/preferences-general.png new file mode 100644 index 0000000000..5aa604518c Binary files /dev/null and b/docs/manual/images/preferences-general.png differ diff --git a/docs/manual/preferences.rst b/docs/manual/preferences.rst new file mode 100644 index 0000000000..6a7c61c314 --- /dev/null +++ b/docs/manual/preferences.rst @@ -0,0 +1,132 @@ +User Preferences +================ + +There are only a few options located in the Preferences, accessible +though the menu via *Edit > Preferences*. Most other options, like +whether to draw the grid, what kind snapping to do or the last used +settings when creating a new map are simply remembered persistently. + +The preferences are stored in a system-dependent format and location: + ++-------------+-----------------------------------------------------------------+ +| **Windows** | Registry key ``HKEY_CURRENT_USER\SOFTWARE\mapeditor.org\Tiled`` | ++-------------+-----------------------------------------------------------------+ +| **macOS** | ``~/Library/Preferences/org.mapeditor.Tiled.plist`` | ++-------------+-----------------------------------------------------------------+ +| **Linux** | ``~/.config/mapeditor.org/tiled.conf`` | ++-------------+-----------------------------------------------------------------+ + + +General +------- + +.. figure:: images/preferences-general.png + :alt: General Preferences + :scale: 66 + :align: right + +Saving and Loading +~~~~~~~~~~~~~~~~~~ + +Include DTD reference in saved maps + This option is not enabled by default, since it is of very little + use whereas it can in some environments cause problems. Feel free to + enable it if it helps with validation for example, but note that the + referenced DTD is likely out of date (there is a somewhat more up-to-date + XSD file available in the repository). + +Reload tileset images when they change + This is very useful while working on the tiles or when the tiles + might change as a result of a source control system. + +Open last files on startup + Generally a useful thing to keep enabled. + +Use safe writing of files + This setting causes files to be written to a temporary file, and + when all went well, to be swapped with the target file. This avoids + data getting lost due to errors while saving or due to insufficient + disk space. Unfortunately, it is known to cause issues when saving + files to a Dropbox folder or a network drive, in which case it helps + to disable this feature. + +Interface +~~~~~~~~~ + +Language + By default the language tries to match that of the system, but if it + picks the wrong one you can change it here. + +Grid colour + Because black is not always the best color for the grid. + +Fine grid divisions + The tile grid can be divided further using this setting, which + affects the "Snap to Fine Grid" setting in the *View > Snapping* + menu. + +Object line width + Shapes are by default rendered with a 2 pixel wide line, but some + people like it thinner or even thicker. On some systems the DPI-based + scaling will affect this setting as well. + +Hardware accelerated drawing (OpenGL) + This enables a rather unoptimized way of rendering the map using + OpenGL. It's usually not an improvement and may lead to crashes, but + in some scenarios it can make editing more responsive. + +.. raw:: html + +