Wuzzy/libpov_2025
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update manual for new biome coordinates mode

Browse Source
This commit is contained in:
Wuzzy 2024-11-30 15:43:45 +01:00
parent 05518ffb8f
commit 68ecd7906b
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
manual.html
View File

@ -18,7 +18,7 @@
<ul>
<li><b>Add</b> the heat and humidity points of biomes</li>
<li><b>Visualize</b> the biomes on a <a title="Wikipedia: Voronoi diagram" href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</a></li>
<li>Show biomes for a given <b>Y altitude</b> only</li>
<li>Show biomes for given <b>world coordinates</b> only</li>
<li>Modify the <b>noise parameters</b> of the heat and humidity Perlin noises used by the mapgen</li>
<li>Visualize the biomes of the <b>v6 mapgen</b> in a special diagram</li>
</ul>
@ -45,7 +45,7 @@
<p>By default, a <b>grid</b> is displayed. A grid line is shown for every 10 units in “biome points” mode and 0.1 units in “v6 biomes” mode. Note: The grid lines may disappear if there would be too many of them.</p>
<p>Below the diagram, a couple of <b>status information</b> is shown: The current altitude (Y coordinate), the heat and humidity range of the current diagram and your cursor position (if it is on the diagram).</p>
<p>Below the diagram, a couple of <b>status information</b> is shown: The current world coordinates (this is for biomes that <i>could</i> appear at these coordinates, applying min./max. X/Y/Z biome limits), the heat and humidity range of the current diagram and your cursor position (if it is on the diagram).</p>
<h3>An example</h3>
<p>Let’s say in the “biome points” mode there are 2 biomes at the (heat, humidity) coordinates (10, 10) and (90, 90). This will divide the diagram in 2 sections. Each of these sections is a Voronoi cell, or the set of all (heat, humidity) value pairs of that biome.</p>
@ -79,7 +79,7 @@
<p>The “Add” button adds a new biome with a random heat and humidity. “Remove” removes the currently selected biome.</p>
<p>Once you’ve selected a biome in the list, the fields in “Selected biome” will activate. Here, you can <b>edit</b> the selected biome’s heat and humidity point (corresponds to <code>heat_point</code> and <code>humidity_point</code> in the Lua API). You can also edit the <b>minimum and maximum Y altitude</b> this biome will be generated in (corresponds to <code>y_min</code> and <code>y_max</code>).</p>
<p>Once you’ve selected a biome in the list, the fields in “Selected biome” will activate. Here, you can <b>edit</b> the selected biome’s heat and humidity point (corresponds to <code>heat_point</code> and <code>humidity_point</code> in the Lua API). You can also edit the <b>minimum and maximum X/Y/Z positions</b> this biome will be generated in (corresponds to <code>min_pos</code>/<code>max_pos</code> in the Lua biome definition).</p>
<p>Each biome has a <b>name</b> and a <b>color</b> which can be changed, too. These are only used for display purposes and don’t affect the calculations.</p>
@ -99,9 +99,9 @@
<p>You can’t add any custom biomes.</p>
<h3>Diagram view settings</h3>
<p>These settings only affect the <b>visual representation</b> and not the data. The checkboxes can be used to hide several things in the diagram, like the grid. The altitude setting changes at which altitude (Y world coordinate) the diagram “looks” at. The diagram will only show biomes that would generate in this altitude, applying the biome’s Min. Y and Max. Y settings.</p>
<p>These settings only affect the <b>visual representation</b> and not the data. The checkboxes can be used to hide several things in the diagram, like the grid.</p>
<p>In “v6 biomes” mode, the Y altitude has no effect.</p>
<p>The world position setting changes at which world coordinates (XYZ) the diagram “looks” at. The diagram will only show biomes that would generate at these coordinates, applying the biome’s Min./Max. X/Y/Z settings. In “v6 biomes” mode, the world position has no effect.</p>
<p>Note: If you hide the points, you can no longer select them in the diagram. You can still select them in the biome list, however.</p>
@ -124,7 +124,7 @@
<p>This allows you to export the current biomes into a text. You can choose to export them in one of various formats. Only biome information is included, not the display settings or noise parameters.</p>
<p>The <b>Lua</b> export gives you a very basic Lua code that can be pasted into an actual Lua mod. The code is very basic and does not include the “landscape materials”, like what the surface is made of (dirt, stone, sand, etc.). Biome coordinate limits (`y_min`/`y_max` or `min_pos`/`max_pos`) are added to the export only if they differ from the default values -31000 and 31000.</p>
<p>The <b>Lua</b> export gives you a very basic Lua code that can be pasted into an actual Lua mod. The code is very basic and does not include the “landscape materials”, like what the surface is made of (dirt, stone, sand, etc.). Biome coordinate limits (<code>y_min</code>/<code>y_max</code> or <code>min_pos</code>/<code>max_pos</code>) are added to the export only if they differ from the default values -31000 and 31000.</p>
<p>The <b>JSON</b> export is a text you can use to import the biomes in LiBPoV later. You may want to copy this into a text file.</p>