/* * Copyright 2012 Google Inc. * * Use of this source code is governed by a BSD-style license that can be * found in the LICENSE file. */ #ifndef PictureRenderer_DEFINED #define PictureRenderer_DEFINED #include "SkCountdown.h" #include "SkDrawFilter.h" #include "SkMath.h" #include "SkPaint.h" #include "SkPicture.h" #include "SkRect.h" #include "SkRefCnt.h" #include "SkRunnable.h" #include "SkString.h" #include "SkTDArray.h" #include "SkThreadPool.h" #include "SkTypes.h" #if SK_SUPPORT_GPU #include "GrContextFactory.h" #include "GrContext.h" #endif class SkBitmap; class SkCanvas; class SkGLContext; class SkThread; namespace sk_tools { class PictureRenderer : public SkRefCnt { public: enum SkDeviceTypes { kBitmap_DeviceType, #if SK_SUPPORT_GPU kGPU_DeviceType #endif }; enum BBoxHierarchyType { kNone_BBoxHierarchyType = 0, kRTree_BBoxHierarchyType, kTileGrid_BBoxHierarchyType, }; // this uses SkPaint::Flags as a base and adds additional flags enum DrawFilterFlags { kNone_DrawFilterFlag = 0, kBlur_DrawFilterFlag = 0x4000, // toggles between blur and no blur kLowBlur_DrawFilterFlag = 0x8000, // toggles between low and high quality blur kHinting_DrawFilterFlag = 0x10000, // toggles between no hinting and normal hinting kSlightHinting_DrawFilterFlag = 0x20000, // toggles between slight and normal hinting kAAClip_DrawFilterFlag = 0x40000, // toggles between soft and hard clip }; SK_COMPILE_ASSERT(!(kBlur_DrawFilterFlag & SkPaint::kAllFlags), blur_flag_must_be_greater); SK_COMPILE_ASSERT(!(kHinting_DrawFilterFlag & SkPaint::kAllFlags), hinting_flag_must_be_greater); SK_COMPILE_ASSERT(!(kSlightHinting_DrawFilterFlag & SkPaint::kAllFlags), slight_hinting_flag_must_be_greater); /** * Called with each new SkPicture to render. */ virtual void init(SkPicture* pict); /** * Perform any setup that should done prior to each iteration of render() which should not be * timed. */ virtual void setup() {} /** * Perform work that is to be timed. Typically this is rendering, but is also used for recording * and preparing picture for playback by the subclasses which do those. * If path is non-null, subclass implementations should call write(). * @param path If non-null, also write the output to the file specified by path. path should * have no extension; it will be added by write(). * @return bool True if rendering succeeded and, if path is non-null, the output was * successfully written to a file. */ virtual bool render(const SkString* path) = 0; /** * Called once finished with a particular SkPicture, before calling init again, and before * being done with this Renderer. */ virtual void end(); void resetState(); void setDeviceType(SkDeviceTypes deviceType) { fDeviceType = deviceType; } void setDrawFilters(DrawFilterFlags const * const filters, const SkString& configName) { memcpy(fDrawFilters, filters, sizeof(fDrawFilters)); fDrawFiltersConfig = configName; } void setBBoxHierarchyType(BBoxHierarchyType bbhType) { fBBoxHierarchyType = bbhType; } void setGridSize(int width, int height) { fGridWidth = width; fGridHeight = height; } bool isUsingBitmapDevice() { return kBitmap_DeviceType == fDeviceType; } virtual SkString getPerIterTimeFormat() { return SkString("%.2f"); } virtual SkString getNormalTimeFormat() { return SkString("%6.2f"); } /** * Reports the configuration of this PictureRenderer. */ SkString getConfigName() { SkString config = this->getConfigNameInternal(); if (kRTree_BBoxHierarchyType == fBBoxHierarchyType) { config.append("_rtree"); } else if (kTileGrid_BBoxHierarchyType == fBBoxHierarchyType) { config.append("_grid"); } #if SK_SUPPORT_GPU if (this->isUsingGpuDevice()) { config.append("_gpu"); } #endif config.append(fDrawFiltersConfig.c_str()); return config; } #if SK_SUPPORT_GPU bool isUsingGpuDevice() { return kGPU_DeviceType == fDeviceType; } SkGLContext* getGLContext() { if (this->isUsingGpuDevice()) { return fGrContextFactory.getGLContext(GrContextFactory::kNative_GLContextType); } else { return NULL; } } GrContext* getGrContext() { return fGrContext; } #endif PictureRenderer() : fPicture(NULL) , fDeviceType(kBitmap_DeviceType) , fBBoxHierarchyType(kNone_BBoxHierarchyType) , fGridWidth(0) , fGridHeight(0) #if SK_SUPPORT_GPU , fGrContext(fGrContextFactory.get(GrContextFactory::kNative_GLContextType)) #endif { sk_bzero(fDrawFilters, sizeof(fDrawFilters)); } protected: void buildBBoxHierarchy(); SkPicture* createPicture(); uint32_t recordFlags(); SkCanvas* setupCanvas(); virtual SkCanvas* setupCanvas(int width, int height); SkAutoTUnref fCanvas; SkPicture* fPicture; SkDeviceTypes fDeviceType; BBoxHierarchyType fBBoxHierarchyType; DrawFilterFlags fDrawFilters[SkDrawFilter::kTypeCount]; SkString fDrawFiltersConfig; int fGridWidth, fGridHeight; // used when fBBoxHierarchyType is TileGrid #if SK_SUPPORT_GPU GrContextFactory fGrContextFactory; GrContext* fGrContext; #endif private: virtual SkString getConfigNameInternal() = 0; typedef SkRefCnt INHERITED; }; /** * This class does not do any rendering, but its render function executes recording, which we want * to time. */ class RecordPictureRenderer : public PictureRenderer { virtual bool render(const SkString*) SK_OVERRIDE; virtual SkString getPerIterTimeFormat() SK_OVERRIDE { return SkString("%.4f"); } virtual SkString getNormalTimeFormat() SK_OVERRIDE { return SkString("%6.4f"); } protected: virtual SkCanvas* setupCanvas(int width, int height) SK_OVERRIDE; private: virtual SkString getConfigNameInternal() SK_OVERRIDE; }; class PipePictureRenderer : public PictureRenderer { public: virtual bool render(const SkString*) SK_OVERRIDE; private: virtual SkString getConfigNameInternal() SK_OVERRIDE; typedef PictureRenderer INHERITED; }; class SimplePictureRenderer : public PictureRenderer { public: virtual void init(SkPicture* pict) SK_OVERRIDE; virtual bool render(const SkString*) SK_OVERRIDE; private: virtual SkString getConfigNameInternal() SK_OVERRIDE; typedef PictureRenderer INHERITED; }; class TiledPictureRenderer : public PictureRenderer { public: TiledPictureRenderer(); virtual void init(SkPicture* pict) SK_OVERRIDE; /** * Renders to tiles, rather than a single canvas. If a path is provided, a separate file is * created for each tile, named "path0.png", "path1.png", etc. * Multithreaded mode currently does not support writing to a file. */ virtual bool render(const SkString* path) SK_OVERRIDE; virtual void end() SK_OVERRIDE; void setTileWidth(int width) { fTileWidth = width; } int getTileWidth() const { return fTileWidth; } void setTileHeight(int height) { fTileHeight = height; } int getTileHeight() const { return fTileHeight; } void setTileWidthPercentage(double percentage) { fTileWidthPercentage = percentage; } double getTileWidthPercentage() const { return fTileWidthPercentage; } void setTileHeightPercentage(double percentage) { fTileHeightPercentage = percentage; } double getTileHeightPercentage() const { return fTileHeightPercentage; } void setTileMinPowerOf2Width(int width) { SkASSERT(SkIsPow2(width) && width > 0); if (!SkIsPow2(width) || width <= 0) { return; } fTileMinPowerOf2Width = width; } int getTileMinPowerOf2Width() const { return fTileMinPowerOf2Width; } protected: SkTDArray fTileRects; virtual SkCanvas* setupCanvas(int width, int height) SK_OVERRIDE; virtual SkString getConfigNameInternal() SK_OVERRIDE; private: int fTileWidth; int fTileHeight; double fTileWidthPercentage; double fTileHeightPercentage; int fTileMinPowerOf2Width; void setupTiles(); void setupPowerOf2Tiles(); typedef PictureRenderer INHERITED; }; class CloneData; class MultiCorePictureRenderer : public TiledPictureRenderer { public: explicit MultiCorePictureRenderer(int threadCount); ~MultiCorePictureRenderer(); virtual void init(SkPicture* pict) SK_OVERRIDE; /** * Behaves like TiledPictureRenderer::render(), only using multiple threads. */ virtual bool render(const SkString* path) SK_OVERRIDE; virtual void end() SK_OVERRIDE; private: virtual SkString getConfigNameInternal() SK_OVERRIDE; const int fNumThreads; SkTDArray fCanvasPool; SkThreadPool fThreadPool; SkPicture* fPictureClones; CloneData** fCloneData; SkCountdown fCountdown; typedef TiledPictureRenderer INHERITED; }; /** * This class does not do any rendering, but its render function executes turning an SkPictureRecord * into an SkPicturePlayback, which we want to time. */ class PlaybackCreationRenderer : public PictureRenderer { public: virtual void setup() SK_OVERRIDE; virtual bool render(const SkString*) SK_OVERRIDE; virtual SkString getPerIterTimeFormat() SK_OVERRIDE { return SkString("%.4f"); } virtual SkString getNormalTimeFormat() SK_OVERRIDE { return SkString("%6.4f"); } private: SkAutoTUnref fReplayer; virtual SkString getConfigNameInternal() SK_OVERRIDE; typedef PictureRenderer INHERITED; }; extern PictureRenderer* CreateGatherPixelRefsRenderer(); extern PictureRenderer* CreatePictureCloneRenderer(); } #endif // PictureRenderer_DEFINED