summaryrefslogtreecommitdiffstats
path: root/graphics
diff options
context:
space:
mode:
authorSvetoslav Ganov <svetoslavganov@google.com>2013-10-30 20:52:04 -0700
committerScott Main <smain@google.com>2013-10-31 23:05:55 +0000
commit78da147d426c80baac63aeaf521f112d8c4c1d2d (patch)
treeb1713593bc4f186810bded596db06018781ca006 /graphics
parent73b5572f374d6c0e8e69f7387da9d1ff6ce144b8 (diff)
downloadframeworks_base-78da147d426c80baac63aeaf521f112d8c4c1d2d.zip
frameworks_base-78da147d426c80baac63aeaf521f112d8c4c1d2d.tar.gz
frameworks_base-78da147d426c80baac63aeaf521f112d8c4c1d2d.tar.bz2
Update the PdfDocument docs with unsupported operations.
The PDF generating canvas we use does not yet support all drawing operations. This change adds docs which operations are not yet supported. Change-Id: I8d5ee8c1e2a473ba783b5e62f23ab90a54bbf106 (cherry picked from commit 8db45b844b5482cf61839404c0f6847e053de817)
Diffstat (limited to 'graphics')
-rw-r--r--graphics/java/android/graphics/pdf/PdfDocument.java25
1 files changed, 25 insertions, 0 deletions
diff --git a/graphics/java/android/graphics/pdf/PdfDocument.java b/graphics/java/android/graphics/pdf/PdfDocument.java
index 066ae2b..81e523d 100644
--- a/graphics/java/android/graphics/pdf/PdfDocument.java
+++ b/graphics/java/android/graphics/pdf/PdfDocument.java
@@ -391,6 +391,31 @@ public class PdfDocument {
/**
* Gets the {@link Canvas} of the page.
*
+ * <p>
+ * <strong>Note: </strong> There are some draw operations that are
+ * not yet supported by the canvas returned by this method. More
+ * specifically:
+ * <ul>
+ * <li>{@link Canvas#clipPath(android.graphics.Path)
+ * Canvas.clipPath(android.graphics.Path)}</li>
+ * <li>All flavors of {@link Canvas#drawText(String, float, float,
+ * android.graphics.Paint) Canvas.drawText(String, float, float,
+ * android.graphics.Paint)}</li>
+ * <li>All flavors of {@link Canvas#drawPosText(String, float[],
+ * android.graphics.Paint) Canvas.drawPosText(String, float[],
+ * android.graphics.Paint)}</li>
+ * <li>{@link Canvas#drawVertices(android.graphics.Canvas.VertexMode, int,
+ * float[], int, float[], int, int[], int, short[], int, int,
+ * android.graphics.Paint) Canvas.drawVertices(
+ * android.graphics.Canvas.VertexMode, int, float[], int, float[],
+ * int, int[], int, short[], int, int, android.graphics.Paint)}</li>
+ * <li>{@link android.graphics.PorterDuff.Mode#SRC_ATOP PorterDuff.Mode SRC},
+ * {@link android.graphics.PorterDuff.Mode#DST_ATOP PorterDuff.DST_ATOP},
+ * {@link android.graphics.PorterDuff.Mode#XOR PorterDuff.XOR},
+ * {@link android.graphics.PorterDuff.Mode#ADD PorterDuff.ADD}</li>
+ * <li>Perspective transforms</li>
+ * </ul>
+ *
* @return The canvas if the page is not finished, null otherwise.
*
* @see PdfDocument#finishPage(Page)