Add PlatformPictureSkia and RecordingPlatformDeviceSkia.

skia/ext/platform_device.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef SKIA_EXT_PLATFORM_DEVICE_H_
 #define SKIA_EXT_PLATFORM_DEVICE_H_
 
 #include "build/build_config.h"
 
 #if defined(OS_WIN)
@@ skipping 78 matching lines @@
 // A SkDevice is basically a wrapper around SkBitmap that provides a surface for
 // SkCanvas to draw into. PlatformDevice provides a surface Windows can also
 // write to. It also provides functionality to play well with GDI drawing
 // functions. This class is abstract and must be subclassed. It provides the
 // basic interface to implement it either with or without a bitmap backend.
 //
 // PlatformDevice provides an interface which sub-classes of SkDevice can also
 // provide to allow for drawing by the native platform into the device.
 class SK_API PlatformDevice {
  public:
+  enum PlatformPaint {
+    //
+    // PlatformPaint Support
+    //
+    // Platform specific paint operations can not be used to draw on the
+    // given canvas. BeginPlatformPaint will return NULL PlatformSurface.
+    PLATFORM_PAINT_UNSUPPORTED,
+
+    // Platform specific paint operations can be used to draw on the given
+    // canvas without causing an intermediate bitmap to be created.
+    PLATFORM_PAINT_DIRECT,
+
+    // Platform specific paint operations can be used to draw on the given
+    // canvas but it might cause an intermediate bitmap to be created.
+    // Allocating and setting up an intermediate bitmap can be expensive.
+    // It is recommended to avoid using platform paint if possible when
+    // platform paint support is indirect.
+    PLATFORM_PAINT_INDIRECT
+  };
+
   virtual ~PlatformDevice() {}
 
 #if defined(OS_MACOSX)
   // The CGContext that corresponds to the bitmap, used for CoreGraphics
   // operations drawing into the bitmap. This is possibly heavyweight, so it
   // should exist only during one pass of rendering.
   virtual CGContextRef GetBitmapContext() = 0;
 #endif
 
   // The DC that corresponds to the bitmap, used for GDI operations drawing
   // into the bitmap. This is possibly heavyweight, so it should be existant
   // only during one pass of rendering.
   virtual PlatformSurface BeginPlatformPaint();
 
   // Finish a previous call to beginPlatformPaint.
   virtual void EndPlatformPaint();
 
   // Draws to the given screen DC, if the bitmap DC doesn't exist, this will
   // temporarily create it. However, if you have created the bitmap DC, it will
   // be more efficient if you don't free it until after this call so it doesn't
   // have to be created twice.  If src_rect is null, then the entirety of the
   // source device will be copied.
   virtual void DrawToNativeContext(PlatformSurface surface, int x, int y,
                                    const PlatformRect* src_rect) = 0;
 
-  // Returns true if GDI operations can be used for drawing into the bitmap.
-  virtual bool SupportsPlatformPaint();
+  // Returns support for platform specific paint operations.
+  virtual PlatformPaint PlatformPaintSupport();
 
 #if defined(OS_WIN)
   // Loads a SkPath into the GDI context. The path can there after be used for
   // clipping or as a stroke. Returns false if the path failed to be loaded.
   static bool LoadPathToDC(HDC context, const SkPath& path);
 
   // Loads a SkRegion into the GDI context.
   static void LoadClippingRegionToDC(HDC context, const SkRegion& region,
                                      const SkMatrix& transformation);
 #elif defined(OS_MACOSX)
@@ skipping 28 matching lines @@
 #elif defined(OS_MACOSX)
   // Loads the specified Skia transform into the device context
   static void LoadTransformToCGContext(CGContextRef context,
                                        const SkMatrix& matrix);
 #endif
 };
 
 }  // namespace skia
 
 #endif  // SKIA_EXT_PLATFORM_DEVICE_H_