From 453c8ec64d6955e1e9b9826020e6ead49bb37f44 Mon Sep 17 00:00:00 2001
From: Andy Meneely <andy@se.rit.edu>
Date: Fri, 19 Oct 2018 16:13:53 -0400
Subject: [PATCH] svg: document rasterization on mask (#192)

---
 CHANGELOG.md     | 1 +
 docs/dsl/svg.rst | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c3e3182..1cb3841 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ Features:
 
 Docs:
 * Documented the n-sided-ness of polygons and stars
+* svg: document rasterization on mask (#192)
 
 Special thanks to @lcarlsen
 
diff --git a/docs/dsl/svg.rst b/docs/dsl/svg.rst
index 085e692..dff487d 100644
--- a/docs/dsl/svg.rst
+++ b/docs/dsl/svg.rst
@@ -66,6 +66,11 @@ mask
 
   if specified, the image will be used as a mask for the given color/gradient. Transparent pixels are ignored, opaque pixels are the given color. Note: the origin for gradient coordinates is at the given x,y, not at 0,0 as it is most other places.
 
+.. warning::
+
+    For implementation reasons, your vector image will be rasterized when mask is applied. If you use this with, say, PDF, the images will be embedded as rasters, not vectors.
+
+
 crop_x
   default: ``0``