summaryrefslogtreecommitdiff
path: root/record/SkRecording.h
blob: 0d04b90ca05f719bb884e872ee8a6e9972a6adf8 (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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
/*
 * Copyright 2014 Google Inc.
 *
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */

#ifndef SkRecording_DEFINED
#define SkRecording_DEFINED

#include "SkCanvas.h"  // SkCanvas
#include "SkTypes.h"   // SkNoncopyable

// These are intentionally left opaque.
class SkRecord;
class SkRecorder;

namespace EXPERIMENTAL {

/** Easy mode interface to SkRecord-based SkCanvas recording.
 *
 *  SkRecording* recording = SkRecording::Create(1920, 1080);
 *
 *  SkCanvas* canvas = recording->canvas();
 *  canvas->drawThis();
 *  canvas->clipThat();
 *  ...
 *
 *  scoped_ptr<const SkPlayback> playback(SkRecording::Delete(recording));
 *  playback->draw(&someCanvas);
 *  playback->draw(&someOtherCanvas);
 *
 *  SkPlayback is thread safe; SkRecording is not.
 */

class SkPlayback : SkNoncopyable {
public:
    // Remember, if you've got an SkPlayback*, you probably own it.  Don't forget to delete it!
    ~SkPlayback();

    // Draw recorded commands into a canvas.
    void draw(SkCanvas*) const;

private:
    explicit SkPlayback(const SkRecord*);

    const SkRecord* fRecord;

    friend class SkRecording;
};

class SkRecording : SkNoncopyable {
public:
    // Result must be returned via SkRecording::Delete.
    static SkRecording* Create(int width, int height);

    // Caller takes ownership of SkPlayback.
    static const SkPlayback* Delete(SkRecording*);

    // Draws issued to this canvas will be replayed by SkPlayback::draw().
    // This pointer is owned by the SkRecording; the caller must not take ownership.
    SkCanvas* canvas();

private:
    SkRecording(int width, int height);
    ~SkRecording();

    SkRecorder* fRecorder;
    SkRecord* fRecord;
};

}  // namespace EXPERIMENTAL

#endif//SkRecording_DEFINED