SkDashPathEffect.h revision 629ab540667422d3edcb97c51e9628b7051e1ba4
18a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com/* 2ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * Copyright 2006 The Android Open Source Project 38a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com * 4ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * Use of this source code is governed by a BSD-style license that can be 5ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * found in the LICENSE file. 68a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 78a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 88a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#ifndef SkDashPathEffect_DEFINED 98a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#define SkDashPathEffect_DEFINED 108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkPathEffect.h" 128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com/** \class SkDashPathEffect 148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDashPathEffect is a subclass of SkPathEffect that implements dashing 168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com*/ 177ffb1b21abcc7bbed5a0fc711f6dd7b9dbb4f577ctguil@chromium.orgclass SK_API SkDashPathEffect : public SkPathEffect { 188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.compublic: 1920bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com /** intervals: array containing an even number of entries (>=2), with 2020bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com the even indices specifying the length of "on" intervals, and the odd 2120bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com indices specifying the length of "off" intervals. 22fbfcd5602128ec010c82cb733c9cdc0a3254f9f3rmistry@google.com count: number of elements in the intervals array 2320bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com phase: offset into the intervals array (mod the sum of all of the 2420bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com intervals). 2520bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 2620bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com For example: if intervals[] = {10, 20}, count = 2, and phase = 25, 2720bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com this will set up a dashed path like so: 2820bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 5 pixels off 2920bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 10 pixels on 3020bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 20 pixels off 3120bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 10 pixels on 3220bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 20 pixels off 3320bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com ... 3420bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com A phase of -5, 25, 55, 85, etc. would all result in the same path, 3520bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com because the sum of all the intervals is 30. 3620bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com 3720bf4ca8f5a5c00d19d8474d40208e456ee26838epoger@google.com Note: only affects stroked paths. 388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDashPathEffect(const SkScalar intervals[], int count, SkScalar phase, bool scaleToFit = false); 408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual ~SkDashPathEffect(); 418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 42fd4be26c4202ae91f0f7cf2c03e44b5169d885ebreed@google.com virtual bool filterPath(SkPath* dst, const SkPath& src, SkStrokeRec*) SK_OVERRIDE; 438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 44629ab540667422d3edcb97c51e9628b7051e1ba4robertphillips@google.com virtual bool asPoints(PointData* results, const SkPath& src, 45629ab540667422d3edcb97c51e9628b7051e1ba4robertphillips@google.com const SkStrokeRec&, const SkMatrix&) const SK_OVERRIDE; 46629ab540667422d3edcb97c51e9628b7051e1ba4robertphillips@google.com 478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // overrides for SkFlattenable 488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // This method is not exported to java. 498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual Factory getFactory(); 506bac947cd5bc460dd9166ada6310d678fd2e39f8reed@google.com static SkFlattenable* CreateProc(SkFlattenableReadBuffer&); 516bac947cd5bc460dd9166ada6310d678fd2e39f8reed@google.com 528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comprotected: 538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDashPathEffect(SkFlattenableReadBuffer&); 5454924243c1b65b3ee6d8fa064b50a9b1bb2a19a5djsollen@google.com virtual void flatten(SkFlattenableWriteBuffer&) const SK_OVERRIDE; 55fbfcd5602128ec010c82cb733c9cdc0a3254f9f3rmistry@google.com 568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comprivate: 578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar* fIntervals; 588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int32_t fCount; 598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // computed from phase 608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar fInitialDashLength; 618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int32_t fInitialDashIndex; 628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar fIntervalLength; 638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool fScaleToFit; 648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com typedef SkPathEffect INHERITED; 668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com}; 678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#endif 69