aboutsummaryrefslogtreecommitdiffhomepage
path: root/include/core/SkTileGridPicture.h
blob: 28d545a467ebceb17c84420f6753a941732f8ab5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/*
 * 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 SkTileGridPicture_DEFINED
#define SkTileGridPicture_DEFINED

#include "SkPicture.h"

/**
 * Subclass of SkPicture that override the behavior of the
 * kOptimizeForClippedPlayback_RecordingFlag by creating an SkTileGrid
 * structure rather than an R-Tree. The tile grid has lower recording
 * and playback costs, but is less effective at eliminating extraneous
 * primitives for arbitrary query rectangles. It is most effective for
 * tiled playback when the tile structure is known at record time.
 */
class SK_API SkTileGridPicture : public SkPicture {
public:
    /**
     * Constructor
     * @param tileWidth horizontal stride between consecutive tiles
     * @param tileHeight vertical stride between consecutive tiles
     * @param width recording canvas width in device pixels
     * @param height recording canvas height in device pixels
     * @param borderPixels pixels of overlap between adjacent tiles. Set this
     *  value to match the border overlap that is applied to tiles by user
     *  code. Properly setting this value will help improve performance
     *  when performing tile-aligned playbacks with query regions that
     *  match tile bounds outset by borderPixels pixels. Such outsets
     *  are often used to prevent filtering artifacts at tile boundaries.
     */
    SkTileGridPicture(int tileWidth, int tileHeight, int width, int height, int borderPixels = 0);
    virtual SkBBoxHierarchy* createBBoxHierarchy() const SK_OVERRIDE;
private:
    int fTileWidth, fTileHeight, fXTileCount, fYTileCount, fBorderPixels;
};

#endif