Add asADash entry point into SkPathEffect to allow extracting Dash info from PathEffects

include/core/SkPathEffect.h

 
 /*
  * Copyright 2006 The Android Open Source Project
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 
 #ifndef SkPathEffect_DEFINED
@@ skipping 86 matching lines @@
     };
 
     /**
      *  Does applying this path effect to 'src' yield a set of points? If so,
      *  optionally return the points in 'results'.
      */
     virtual bool asPoints(PointData* results, const SkPath& src,
                           const SkStrokeRec&, const SkMatrix&,
                           const SkRect* cullR) const;
 
+    /**
+     *  If the PathEffect is a DashedPath effect asADash will return TwoInterval if there is a
+     *  single on and a single off interval. If there are additional intervals in the dash then
+     *  it will return Other. If a non NULL info is passed in the various DashInfo will be filled

[reed1, 2014/03/27 15:56:07]

s/Other/MultipleInterval

+     *  in if the PathEffect is a DashedPathEffect. If passed in info has an fCount equal or
+     *  greater to that of the effect, it will memcpy the values of fIntervals into the info.
+     *  Thus the general approach will be call asADash once with default info to get DashType
+     *  and fCount. If it is a DashPathEffect, allocate space for the intervals in info, then call
+     *  asAGradient again with the same info and fIntervals will get copied in.
+     *
+     *  None:
+     *      info is ignored.
+     *  TwoInterval:
+     *      uses all info.
+     *  MultipleInterval:
+     *      uses all info.
+     */
+
+    enum DashType {
+        kNone_DashType,
+        kTwoInterval_DashType,
+        kMultipleInterval_DashType,
+    };
+
+    struct DashInfo {
+        SkScalar*   fIntervals;         //!< Length of on/off intervals for dashed lines
+                                        //   Even values represent ons, and odds offs
+        int32_t     fCount;             //!< Number of intervals in the dash. Should be even number
+        SkScalar    fInitialDashLength; //!< Length of possibly shortened initial interval
+        int32_t     fInitialDashIndex;  //!< Which interval in fIntervals are we starting at
+        SkScalar    fIntervalLength;    //!< Length of all intervals
+        bool        fScaleToFit;
+    };
+
+    virtual DashType asADash(DashInfo* info) const;
+
     SK_DEFINE_FLATTENABLE_TYPE(SkPathEffect)
 
 protected:
     SkPathEffect() {}
     SkPathEffect(SkReadBuffer& buffer) : INHERITED(buffer) {}
 
 private:
     // illegal
     SkPathEffect(const SkPathEffect&);
     SkPathEffect& operator=(const SkPathEffect&);
@@ skipping 93 matching lines @@
 
 private:
     // illegal
     SkSumPathEffect(const SkSumPathEffect&);
     SkSumPathEffect& operator=(const SkSumPathEffect&);
 
     typedef SkPairPathEffect INHERITED;
 };
 
 #endif