Add SkSurface factory that takes an SkSurfaceCharacterization

TBR=bsalomon@google.com
Change-Id: Ie38123dc7c35005bfe8500bf4a16e0d16bbf36bd
Reviewed-on: https://skia-review.googlesource.com/117236
Reviewed-by: Robert Phillips <robertphillips@google.com>
Reviewed-by: Greg Daniel <egdaniel@google.com>
Commit-Queue: Robert Phillips <robertphillips@google.com>

1 files changed, 25 insertions, 0 deletions

diff --git a/docs/SkSurface_Reference.bmh b/docs/SkSurface_Reference.bmh
index a7053f69d3..e37ac57250 100644
--- a/docs/SkSurface_Reference.bmh
+++ b/docs/SkSurface_Reference.bmh
@@ -711,6 +711,31 @@ Surface bottom-left corner is pinned to the origin.
 
 # ------------------------------------------------------------------------------
 
+#Method static sk_sp<SkSurface> MakeRenderTarget(GrContext* context,
+                                             const SkSurfaceCharacterization& characterization,
+                                             SkBudgeted budgeted)
+
+Returns SkSurface on GPU indicated by context that is compatible with the provided
+characterization. budgeted selects whether allocation for pixels is tracked by context.
+
+        @param context           GPU context
+        @param characterization  description of the desired SkSurface
+        @param budgeted          one of: SkBudgeted::kNo, SkBudgeted::kYes
+        @return                  SkSurface if all parameters are valid; otherwise, nullptr
+
+#Param context  GPU_Context ##
+#Param characterization  description of the desired SkSurface ##
+#Param budgeted  one of: SkBudgeted::kNo, SkBudgeted::kYes
+##
+
+#Return Surface if all parameters are valid; otherwise, nullptr ##
+
+#SeeAlso MakeFromBackendRenderTarget MakeFromBackendTextureAsRenderTarget
+
+#Method ##
+
+# ------------------------------------------------------------------------------
+
 #Method static sk_sp<SkSurface> MakeNull(int width, int height)
 
 #In Constructor