1 /* 2 * Copyright 2011 Google Inc. 3 * 4 * Use of this source code is governed by a BSD-style license that can be 5 * found in the LICENSE file. 6 */ 7 8 #ifndef skiagm_DEFINED 9 #define skiagm_DEFINED 10 11 #include "SkBitmap.h" 12 #include "SkCanvas.h" 13 #include "SkPaint.h" 14 #include "SkSize.h" 15 #include "SkString.h" 16 #include "SkTRegistry.h" 17 #include "sk_tool_utils.h" 18 19 class SkAnimTimer; 20 struct GrContextOptions; 21 22 #define DEF_GM(code) \ 23 static skiagm::GM* SK_MACRO_APPEND_LINE(F_)(void*) { code; } \ 24 static skiagm::GMRegistry SK_MACRO_APPEND_LINE(R_)(SK_MACRO_APPEND_LINE(F_)); 25 26 // a Simple GM is a rendering test that does not store state between 27 // rendering calls or make use of the onOnceBeforeDraw() virtual; it 28 // consists of: 29 // * A single void(*)(SkCanvas*) function. 30 // * A name. 31 // * Prefered width and height. 32 // * Optionally, a background color (default is white). 33 #define DEF_SIMPLE_GM(NAME, CANVAS, W, H) \ 34 DEF_SIMPLE_GM_BG_NAME(NAME, CANVAS, W, H, SK_ColorWHITE, SkString(#NAME)) 35 #define DEF_SIMPLE_GM_BG(NAME, CANVAS, W, H, BGCOLOR)\ 36 DEF_SIMPLE_GM_BG_NAME(NAME, CANVAS, W, H, BGCOLOR, SkString(#NAME)) 37 #define DEF_SIMPLE_GM_BG_NAME(NAME, CANVAS, W, H, BGCOLOR, NAME_STR) \ 38 static void SK_MACRO_CONCAT(NAME, _GM)(SkCanvas * CANVAS); \ 39 DEF_GM(return new skiagm::SimpleGM(NAME_STR, SK_MACRO_CONCAT(NAME, _GM), \ 40 SkISize::Make(W, H), BGCOLOR);) \ 41 void SK_MACRO_CONCAT(NAME, _GM)(SkCanvas * CANVAS) 42 43 namespace skiagm { 44 45 class GM { 46 public: 47 GM(); 48 virtual ~GM(); 49 50 enum Mode { 51 kGM_Mode, 52 kSample_Mode, 53 kBench_Mode, 54 }; 55 setMode(Mode mode)56 void setMode(Mode mode) { fMode = mode; } getMode()57 Mode getMode() const { return fMode; } 58 59 void draw(SkCanvas*); 60 void drawBackground(SkCanvas*); 61 void drawContent(SkCanvas*); 62 getISize()63 SkISize getISize() { return this->onISize(); } 64 const char* getName(); 65 runAsBench()66 virtual bool runAsBench() const { return false; } 67 width()68 SkScalar width() { 69 return SkIntToScalar(this->getISize().width()); 70 } height()71 SkScalar height() { 72 return SkIntToScalar(this->getISize().height()); 73 } 74 75 // TODO(vandebo) Instead of exposing this, we should run all the GMs 76 // with and without an initial transform. 77 // Most GMs will return the identity matrix, but some PDFs tests 78 // require setting the initial transform. getInitialTransform()79 SkMatrix getInitialTransform() const { 80 SkMatrix matrix = fStarterMatrix; 81 matrix.preConcat(this->onGetInitialTransform()); 82 return matrix; 83 } 84 getBGColor()85 SkColor getBGColor() const { return fBGColor; } 86 void setBGColor(SkColor); 87 88 // helper: fill a rect in the specified color based on the 89 // GM's getISize bounds. 90 void drawSizeBounds(SkCanvas*, SkColor); 91 isCanvasDeferred()92 bool isCanvasDeferred() const { return fCanvasIsDeferred; } setCanvasIsDeferred(bool isDeferred)93 void setCanvasIsDeferred(bool isDeferred) { 94 fCanvasIsDeferred = isDeferred; 95 } 96 getStarterMatrix()97 const SkMatrix& getStarterMatrix() { return fStarterMatrix; } setStarterMatrix(const SkMatrix & matrix)98 void setStarterMatrix(const SkMatrix& matrix) { 99 fStarterMatrix = matrix; 100 } 101 102 bool animate(const SkAnimTimer&); 103 modifyGrContextOptions(GrContextOptions * options)104 virtual void modifyGrContextOptions(GrContextOptions* options) {} 105 106 /** draws a standard message that the GM is only intended to be used with the GPU.*/ 107 static void DrawGpuOnlyMessage(SkCanvas*); 108 109 protected: onOnceBeforeDraw()110 virtual void onOnceBeforeDraw() {} 111 virtual void onDraw(SkCanvas*) = 0; 112 virtual void onDrawBackground(SkCanvas*); 113 virtual SkISize onISize() = 0; 114 virtual SkString onShortName() = 0; 115 onAnimate(const SkAnimTimer &)116 virtual bool onAnimate(const SkAnimTimer&) { return false; } onGetInitialTransform()117 virtual SkMatrix onGetInitialTransform() const { return SkMatrix::I(); } 118 119 private: 120 Mode fMode; 121 SkString fShortName; 122 SkColor fBGColor; 123 bool fCanvasIsDeferred; // work-around problem in srcmode.cpp 124 bool fHaveCalledOnceBeforeDraw; 125 SkMatrix fStarterMatrix; 126 }; 127 128 typedef SkTRegistry<GM*(*)(void*)> GMRegistry; 129 130 class SimpleGM : public skiagm::GM { 131 public: SimpleGM(const SkString & name,void (* drawProc)(SkCanvas *),const SkISize & size,SkColor backgroundColor)132 SimpleGM(const SkString& name, 133 void (*drawProc)(SkCanvas*), 134 const SkISize& size, 135 SkColor backgroundColor) 136 : fName(name), fDrawProc(drawProc), fSize(size) { 137 if (backgroundColor != SK_ColorWHITE) { 138 this->setBGColor(backgroundColor); 139 } 140 } 141 protected: 142 void onDraw(SkCanvas* canvas) override; 143 SkISize onISize() override; 144 SkString onShortName() override; 145 private: 146 SkString fName; 147 void (*fDrawProc)(SkCanvas*); 148 SkISize fSize; 149 }; 150 } 151 152 #endif 153