add (not that great) example using alice

examples/colored.py

+#!/usr/bin/env python2
+"""
+Masked wordcloud
+================
+Using a mask you can generate wordclouds in arbitrary shapes.
+"""
+
+from os import path
+from scipy.misc import imread
+import matplotlib.pyplot as plt
+
+from wordcloud import WordCloud, STOPWORDS
+from wordcloud.color_from_image import ImageColorGenerator
+
+d = path.dirname(__file__)
+
+# Read the whole text.
+text = open(path.join(d, 'alice.txt')).read()
+
+# read the mask / color image
+alice_coloring = imread(path.join(d, "alice_color.png"))
+
+wc = WordCloud(background_color="white", max_words=2000, mask=alice_coloring,
+               stopwords=STOPWORDS.add("said"),
+               max_font_size=40, random_state=42)
+# generate word cloud
+wc.generate(text)
+
+# create coloring from image
+image_colors = ImageColorGenerator(alice_coloring)
+
+# show
+plt.imshow(wc)
+plt.title("original")
+plt.axis("off")
+plt.figure()
+# recolor wordcloud and show
+# we could also give color_func=image_colors directly in the constructor
+plt.imshow(wc.recolor(color_func=image_colors))
+plt.title("recolored")
+plt.axis("off")
+plt.figure()
+plt.imshow(alice_coloring, cmap=plt.cm.gray)
+plt.axis("off")
+plt.show()