aboutsummaryrefslogtreecommitdiffhomepage
path: root/include/utils/SkCanvasStateUtils.h
diff options
context:
space:
mode:
authorGravatar djsollen@google.com <djsollen@google.com@2bbb7eff-a529-9590-31e7-b0007b416f81>2013-08-29 19:41:56 +0000
committerGravatar djsollen@google.com <djsollen@google.com@2bbb7eff-a529-9590-31e7-b0007b416f81>2013-08-29 19:41:56 +0000
commit16b86ced1f43d61e7216b878c87e5e86947404bb (patch)
treeccf2e9cc01937ab79e10499c11829a096e97dcfd /include/utils/SkCanvasStateUtils.h
parent2ce9fce145c0b6cc80a02bf534fdea2798936265 (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.h76
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