From d13af3542798285892af5570f743315663a4fd18 Mon Sep 17 00:00:00 2001
From: Starbeamrainbowlabs <sbrl@starbeamrainbowlabs.com>
Date: Sat, 2 Jan 2016 15:25:48 +0000
Subject: [PATCH] Add imagemagick montage command to common

Polish examples & descriptions

Tweak to make it pass all the tests.

Reword example text

Improved descriptions thanks to @waldrious
---
 pages/common/montage.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 pages/common/montage.md

diff --git a/pages/common/montage.md b/pages/common/montage.md
new file mode 100644
index 000000000..a1eefecc2
--- /dev/null
+++ b/pages/common/montage.md
@@ -0,0 +1,24 @@
+# montage
+
+> Imagemagick image montage tool.
+> Tiles images into a customisable grid.
+
+- Tile images into a grid, automatically resizing images larger than the grid cell size:
+
+`montage {{image1.png}} {{image2.jpg}} {{imageN.png}} montage.jpg`
+
+- Tile images into a grid, automatically calculating the grid cell size from the largest image:
+
+`montage {{image1.png}} {{image2.jpg}} {{imageN.png}} -geometry +0+0 montage.jpg`
+
+- Set the grid cell size and resize images to fit before tiling:
+
+`montage {{image1.png}} {{image2.jpg}} {{imageN.png}} -geometry 640x480+0+0 montage.jpg`
+
+- Limit the number of rows and columns in the grid, causing input images to overflow into multiple output montages:
+
+`montage {{image1.png}} {{image2.jpg}} {{imageN.png}} -geometry +0+0 -tile 2x3 montage_%d.jpg`
+
+- Resize and crop images to completely fill their grid cells before tiling:
+
+`montage {{image1.png}} {{image2.jpg}} {{imageN.png}} -geometry +0+0 -resize 640x480^ -gravity center -crop 640x480+0+0 montage.jpg`