diff options
author | djsollen@google.com <djsollen@google.com@2bbb7eff-a529-9590-31e7-b0007b416f81> | 2013-08-29 19:41:56 +0000 |
---|---|---|
committer | djsollen@google.com <djsollen@google.com@2bbb7eff-a529-9590-31e7-b0007b416f81> | 2013-08-29 19:41:56 +0000 |
commit | 16b86ced1f43d61e7216b878c87e5e86947404bb (patch) | |
tree | ccf2e9cc01937ab79e10499c11829a096e97dcfd /include/utils/SkCanvasStateUtils.h | |
parent | 2ce9fce145c0b6cc80a02bf534fdea2798936265 (diff) |
Revert "Create a semi-stable API for capturing the state of an SkCanvas and reconstructing that state across different versions of Skia."
This reverts r11010.
Review URL: https://codereview.chromium.org/23757008
git-svn-id: http://skia.googlecode.com/svn/trunk@11011 2bbb7eff-a529-9590-31e7-b0007b416f81
Diffstat (limited to 'include/utils/SkCanvasStateUtils.h')
-rw-r--r-- | include/utils/SkCanvasStateUtils.h | 76 |
1 files changed, 0 insertions, 76 deletions
diff --git a/include/utils/SkCanvasStateUtils.h b/include/utils/SkCanvasStateUtils.h deleted file mode 100644 index a558ba89b7..0000000000 --- a/include/utils/SkCanvasStateUtils.h +++ /dev/null @@ -1,76 +0,0 @@ -/* - * Copyright 2013 Google Inc. - * - * Use of this source code is governed by a BSD-style license that can be - * found in the LICENSE file. - */ - -#ifndef SkCanvasStateUtils_DEFINED -#define SkCanvasStateUtils_DEFINED - -#include "SkCanvas.h" - -struct SkCanvasState; - -/** - * A set of functions that are useful for copying an SkCanvas across a library - * boundary where the Skia libraries on either side of the boundary may not be - * version identical. The expected usage is outline below... - * - * Lib Boundary - * CaptureCanvasState(...) ||| - * SkCanvas --> SkCanvasState ||| - * ||| CreateFromCanvasState(...) - * ||| SkCanvasState --> SkCanvas` - * ||| Draw into SkCanvas` - * ||| Unref SkCanvas` - * ReleaseCanvasState(...) ||| - * - */ -namespace SkCanvasStateUtils { - /** - * Captures the current state of the canvas into an opaque ptr that is safe - * to pass between different instances of Skia (which may or may not be the - * same version). The function will return NULL in the event that one of the - * following conditions are true. - * 1) the canvas device type is not supported (currently only raster is supported) - * 2) the canvas clip type is not supported (currently only non-AA clips are supported) - * - * It is recommended that the original canvas also not be used until all - * canvases that have been created using its captured state have been dereferenced. - * - * Finally, it is important to note that any draw filters attached to the - * canvas are NOT currently captured. - * - * @param canvas The canvas you wish to capture the current state of. - * @return NULL or an opaque ptr that can be passed to CreateFromCanvasState - * to reconstruct the canvas. The caller is responsible for calling - * ReleaseCanvasState to free the memory associated with this state. - */ - SK_API SkCanvasState* CaptureCanvasState(SkCanvas* canvas); - - /** - * Create a new SkCanvas from the captured state of another SkCanvas. The - * function will return NULL in the event that one of the - * following conditions are true. - * 1) the captured state is in an unrecognized format - * 2) the captured canvas device type is not supported - * - * @param canvas The canvas you wish to capture the current state of. - * @return NULL or an SkCanvas* whose devices and matrix/clip state are - * identical to the captured canvas. The caller is responsible for - * calling unref on the SkCanvas. - */ - SK_API SkCanvas* CreateFromCanvasState(const SkCanvasState* state); - - /** - * Free the memory associated with the captured canvas state. The state - * should not be released until all SkCanvas objects created using that - * state have been dereferenced. - * - * @param state The captured state you wish to dispose of. - */ - SK_API void ReleaseCanvasState(SkCanvasState* state); -}; - -#endif |