Merge pull request #74 from rozukke/add/first-example

Add pyramid example

example/README.md

@@ -0,0 +1,7 @@
+## Examples
+A few small examples to show the capabilities of `mcpp`.
+
+They should be compilable with something along the lines of `g++ -std=c++17 -o example example.cpp -lmcpp`  
+after you have installed the library.
+
+Feel free to open a PR if you have an interesting usecase to include as part of the examples.

example/pyramid.cpp

@@ -0,0 +1,43 @@
+#include <algorithm>
+#include <mcpp/block.h>
+#include <mcpp/mcpp.h>
+#include <mcpp/util.h>
+
+// Change location here
+mcpp::Coordinate ORIGIN{0, 0, 0};
+int PYRAMID_HEIGHT = 50;
+
+// Can declare globally
+mcpp::MinecraftConnection mc;
+
+void make_ring(mcpp::Coordinate base_pt, int side_len) {
+    // Flat plane
+    mc.setBlocks(base_pt, base_pt + mcpp::Coordinate(side_len, 0, side_len),
+                 mcpp::Blocks::SANDSTONE);
+
+    // Air inside to make border
+    base_pt = base_pt + mcpp::Coordinate(1, 0, 1);
+    mc.setBlocks(base_pt,
+                 base_pt + mcpp::Coordinate(side_len - 2, 0, side_len - 2),
+                 mcpp::Blocks::AIR);
+}
+
+int main() {
+    int pyramid_base_len = PYRAMID_HEIGHT * 2;
+
+    // Get heights of build area
+    mcpp::HeightMap heights =
+        mc.getHeights(ORIGIN, ORIGIN + mcpp::Coordinate(pyramid_base_len, 0,
+                                                        pyramid_base_len));
+
+    // Use minimum height of the area as the lowest point on the pyramid
+    int min_height = *std::min_element(heights.begin(), heights.end());
+
+    // Build rings, diminishing up to pyramid height
+    mcpp::Coordinate base_pt = heights.base_pt();
+    base_pt.y = min_height;
+    int side_len = pyramid_base_len;
+    for (int i = 0; i < PYRAMID_HEIGHT; i++) {
+        make_ring(base_pt + mcpp::Coordinate(i, i, i), side_len - (i * 2));
+    }
+}