From 7278a5078466ee681de105c388f352313c5a6cbb Mon Sep 17 00:00:00 2001 From: "commit-bot@chromium.org" Date: Thu, 10 Apr 2014 23:30:59 +0000 Subject: Add a focused public API for src/record. BUG=skia:2378 R=reed@google.com, robertphillips@google.com, mtklein@google.com, fmalita@chromium.org Author: mtklein@chromium.org Review URL: https://codereview.chromium.org/233053005 git-svn-id: http://skia.googlecode.com/svn/trunk/include@14146 2bbb7eff-a529-9590-31e7-b0007b416f81 --- record/SkRecording.h | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 record/SkRecording.h (limited to 'record') diff --git a/record/SkRecording.h b/record/SkRecording.h new file mode 100644 index 0000000..7024e17 --- /dev/null +++ b/record/SkRecording.h @@ -0,0 +1,67 @@ +#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 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; + const SkRecord* fRecord; +}; + +} // namespace EXPERIMENTAL + +#endif//SkRecording_DEFINED -- cgit v1.2.3