Updated HD Map Configuration (markdown)

mikeprimm 2011-09-12 13:12:20 -07:00
parent b01a671225
commit e2320101ea
1 changed files with 4 additions and 4 deletions

@ -2,13 +2,13 @@ With their introduction in v0.20, the HDMap map type provides a new, more flexib
## Getting Started Quickly: Enabling the default HD templates
Dynmap includes 3 sets of templates, each providing map definitions for the various types of worlds (normal, nether, and skylands). To select between the three template sets, edit the _configuration.txt_ file, and change the setting of the _deftemplatesuffix_ setting (found near the top of the default _configuration.txt_ file). The currently defined values for this setting include:
Dynmap includes 3 sets of templates, each providing map definitions for the various types of worlds (normal, nether, and skylands). To select between the three template sets, edit the **configuration.txt** file, and change the setting of the _deftemplatesuffix_ setting (found near the top of the default **configuration.txt** file). The currently defined values for this setting include:
* _deftemplatesuffix: ""_ : This is the default, and causes dynmap to use the 'classic' default templates - these are low resolution and very quick to render, but are far from the most attractive maps. The template files used for this mode are _templates/normal.txt_, _templates/nether.txt_, and _templates/skylands.txt_.
* _deftemplatesuffix: ""_ : This is the default, and causes dynmap to use the 'classic' default templates - these are low resolution and very quick to render, but are far from the most attractive maps. The template files used for this mode are **templates/normal.txt**, **templates/nether.txt**, and **templates/skylands.txt**.
* _deftemplatesuffix: lowres_ : this selects the "low-res" HD maps. These maps are similar to the 'classic' defaults (a surface map, an isometric view from the south-east, and a cave map), but they are rendered using the HD renderer with about 2-3x the resolution of the "classic" maps. Also, by default the standard Minecraft texture pack will be used to color the blocks, yielding a much more accurate representation of the map. Rendering these maps will take 4-6 times as long as the default 'classic' maps, and about 4x the disk space. The template files used for this mode are in _templates/normal-lowres.txt_, _templates/nether-lowres.txt_, and _templates/skylands-lowres.txt_.
* _deftemplatesuffix: lowres_ : this selects the "low-res" HD maps. These maps are similar to the 'classic' defaults (a surface map, an isometric view from the south-east, and a cave map), but they are rendered using the HD renderer with about 2-3x the resolution of the "classic" maps. Also, by default the standard Minecraft texture pack will be used to color the blocks, yielding a much more accurate representation of the map. Rendering these maps will take 4-6 times as long as the default 'classic' maps, and about 4x the disk space. The template files used for this mode are in **templates/normal-lowres.txt**, **templates/nether-lowres.txt**, and **templates/skylands-lowres.txt**.
* _deftemplatesuffix: hires_ : this selects the "high-res" HD maps. These maps are the same as the _lowres_ HD maps, except that the _surface_ map (the isometric map) is much higher resolution (4x higher than on _lowres_, about 8x higher than _classic_), and rendered from a lower view angle (30 degrees from horizontal versus 60 degrees). The resulting view is VERY nice, but will take quite some time to render (approximately 16x the render time of the _lowres_ map, and about 64x that of the _classic_ map), and much more space (about 16x that of _lowres_, 64x that of _classic_). The template files used for this mode are in _templates/normal-hires.txt_, _templates/nether-hires.txt_, and _templates/skylands-hires.txt_.
* _deftemplatesuffix: hires_ : this selects the "high-res" HD maps. These maps are the same as the _lowres_ HD maps, except that the _surface_ map (the isometric map) is much higher resolution (4x higher than on _lowres_, about 8x higher than _classic_), and rendered from a lower view angle (30 degrees from horizontal versus 60 degrees). The resulting view is VERY nice, but will take quite some time to render (approximately 16x the render time of the _lowres_ map, and about 64x that of the _classic_ map), and much more space (about 16x that of _lowres_, 64x that of _classic_). The template files used for this mode are in **templates/normal-hires.txt**, **templates/nether-hires.txt**, and **templates/skylands-hires.txt**.
Once a template set has been selected, the maps can be further customized by editing the template files in use. The following sections describe all the details needed to fully control the map definitions.