1 /* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef SkDrawLooper_DEFINED 18 #define SkDrawLooper_DEFINED 19 20 #include "SkFlattenable.h" 21 22 class SkCanvas; 23 class SkPaint; 24 25 /** \class SkDrawLooper 26 Subclasses of SkDrawLooper can be attached to a SkPaint. Where they are, 27 and something is drawn to a canvas with that paint, the looper subclass will 28 be called, allowing it to modify the canvas and/or paint for that draw call. 29 More than that, via the next() method, the looper can modify the draw to be 30 invoked multiple times (hence the name loop-er), allow it to perform effects 31 like shadows or frame/fills, that require more than one pass. 32 */ 33 class SK_API SkDrawLooper : public SkFlattenable { 34 public: 35 /** 36 * Called right before something is being drawn. This will be followed by 37 * calls to next() until next() returns false. 38 */ 39 virtual void init(SkCanvas*) = 0; 40 41 /** 42 * Called in a loop (after init()). Each time true is returned, the object 43 * is drawn (possibly with a modified canvas and/or paint). When false is 44 * finally returned, drawing for the object stops. 45 * 46 * On each call, the paint will be in its original state, but the canvas 47 * will be as it was following the previous call to next() or init(). 48 * 49 * The implementation must ensure that, when next() finally returns false, 50 * that the canvas has been restored to the state it was initially, before 51 * init() was first called. 52 */ 53 virtual bool next(SkCanvas*, SkPaint* paint) = 0; 54 55 protected: SkDrawLooper()56 SkDrawLooper() {} SkDrawLooper(SkFlattenableReadBuffer & buffer)57 SkDrawLooper(SkFlattenableReadBuffer& buffer) : INHERITED(buffer) {} 58 59 private: 60 typedef SkFlattenable INHERITED; 61 }; 62 63 #endif 64