From 8cfe6c973c21a10d6e2371917058f241e2679945 Mon Sep 17 00:00:00 2001
From: madmaxoft
Date: Mon, 9 Jun 2014 01:42:03 +0200
Subject: [PATCH] docs/Generator: Added SmallFoliage illlustrations.
---
docs/Generator.html | 4 ++++
docs/img/gaussprobability.jpg | Bin 0 -> 12994 bytes
docs/img/roofprobability.jpg | Bin 0 -> 16679 bytes
docs/img/smallfoliageclumps.jpg | Bin 0 -> 15867 bytes
4 files changed, 4 insertions(+)
create mode 100644 docs/img/gaussprobability.jpg
create mode 100644 docs/img/roofprobability.jpg
create mode 100644 docs/img/smallfoliageclumps.jpg
diff --git a/docs/Generator.html b/docs/Generator.html
index 0fbc2f436..7b70033cb 100644
--- a/docs/Generator.html
+++ b/docs/Generator.html
@@ -483,6 +483,10 @@ height to find the third coord. If we want to generate clumps of mushrooms in th
generate the clump center coords in 3D and either use 3 offsets for the mushrooms, or use 2 offsets plus
searching for the closest opening Y-wise in the terrain.
+Note that the clumps generated by this scheme may overlap several chunks. Therefore it's crucial to
+actually check the surrounding chunks if their clumps overlap into the currently generated chunk, and apply
+those as well, otherwise there will be visible cuts in the foliage along the chunks borders.
+
Springs
Water and lava springs are essential for making the underground quite a lot more interesting. They are
rather easy to generate, but a bit more difficult to get right. Generating simply means that a few random
diff --git a/docs/img/gaussprobability.jpg b/docs/img/gaussprobability.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..77da24748102dac8d999260bcc16c6ecf648c567
GIT binary patch
literal 12994
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
dN7`aZPSwYXA5iD
literal 0
HcmV?d00001
diff --git a/docs/img/roofprobability.jpg b/docs/img/roofprobability.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e7a155113398e305b8dd23ef7539949d8ecda97a
GIT binary patch
literal 16679
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
C>b1TA
literal 0
HcmV?d00001
diff --git a/docs/img/smallfoliageclumps.jpg b/docs/img/smallfoliageclumps.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4cc6cbc009dd496b06c962a76d8e5ff1c38be35f
GIT binary patch
literal 15867
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
literal 0
HcmV?d00001