Index: src/utils/SkDashPathPriv.h |
diff --git a/src/utils/SkDashPathPriv.h b/src/utils/SkDashPathPriv.h |
index 54bf9a487098c118f2e0cdcdd08cb9594d7bc931..115128131f6e810c2f77b8aaeac7dcc97f939655 100644 |
--- a/src/utils/SkDashPathPriv.h |
+++ b/src/utils/SkDashPathPriv.h |
@@ -11,7 +11,7 @@ |
#include "SkPathEffect.h" |
namespace SkDashPath { |
- /* |
+ /** |
* Calculates the initialDashLength, initialDashIndex, and intervalLength based on the |
* inputed phase and intervals. If adjustedPhase is passed in, then the phase will be |
* adjusted to be between 0 and intervalLength. The result will be stored in adjustedPhase. |
@@ -26,13 +26,23 @@ namespace SkDashPath { |
bool FilterDashPath(SkPath* dst, const SkPath& src, SkStrokeRec*, const SkRect*, |
const SkPathEffect::DashInfo& info); |
- /* |
- * Caller should have already used ValidDashPath to exclude invalid data. |
+ /** See comments for InternalFilter */ |
+ enum class StrokeRecApplication { |
+ kDisallow, |
+ kAllow, |
+ }; |
+ |
+ /** |
+ * Caller should have already used ValidDashPath to exclude invalid data. Typically, this leaves |
+ * the strokeRec unmodified. However, for some simple shapes (e.g. a line) it may directly |
+ * evaluate the dash and stroke to produce a stroked output path with a fill strokeRec. Passing |
+ * true for disallowStrokeRecApplication turns this behavior off. |
*/ |
bool InternalFilter(SkPath* dst, const SkPath& src, SkStrokeRec* rec, |
const SkRect* cullRect, const SkScalar aIntervals[], |
int32_t count, SkScalar initialDashLength, int32_t initialDashIndex, |
- SkScalar intervalLength); |
+ SkScalar intervalLength, |
+ StrokeRecApplication = StrokeRecApplication::kAllow); |
bool ValidDashPath(SkScalar phase, const SkScalar intervals[], int32_t count); |
} |