Color Documentation
- treat Color, ARGB, etc as things not requiring definitions
- fix links to Anti-alias, RGB-565
- finish everything marked incomplete, color and elsewhere
- add #Code blocks for #Typedef
R=caryclark@google.com
Docs-Preview: https://skia.org/?cl=128547
Bug: skia:6898
Change-Id: Icf12fe70bc2bf1a8b1a5b31380b2454610949f23
Reviewed-on: https://skia-review.googlesource.com/128547
Reviewed-by: Cary Clark <caryclark@skia.org>
Commit-Queue: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
diff --git a/docs/SkImage_Reference.bmh b/docs/SkImage_Reference.bmh
index 571dc49..4f2549b 100644
--- a/docs/SkImage_Reference.bmh
+++ b/docs/SkImage_Reference.bmh
@@ -144,6 +144,11 @@
#Typedef void* ReleaseContext
#Line # parameter type for MakeFromRaster ##
+
+#Code
+typedef void* ReleaseContext;
+##
+
Caller data passed to RasterReleaseProc; may be nullptr.
#SeeAlso MakeFromRaster RasterReleaseProc
@@ -152,6 +157,11 @@
#Typedef void (*RasterReleaseProc)(const void* pixels, ReleaseContext)
#Line # parameter type for MakeFromRaster ##
+
+#Code
+typedef void (*RasterReleaseProc)(const void* pixels, ReleaseContext);
+##
+
Function called when Image no longer shares pixels. ReleaseContext is
provided by caller when Image is created, and may be nullptr.
@@ -340,6 +350,11 @@
#Typedef void (*TextureReleaseProc)(ReleaseContext releaseContext)
#Line # parameter type for MakeFromTexture ##
+
+#Code
+typedef void (*TextureReleaseProc)(ReleaseContext releaseContext);
+##
+
User function called when supplied texture may be deleted.
#SeeAlso MakeFromTexture
##
@@ -696,11 +711,11 @@
#Const kU8 0
#Line # uses 8-bit unsigned int per Color component ##
-Use 8 bits per Color_ARGB component using unsigned integer format.
+Use 8 bits per ARGB component using unsigned integer format.
##
#Const kF16 1
#Line # uses 16-bit float per Color component ##
-Use 16 bits per Color_ARGB component using half-precision floating point format.
+Use 16 bits per ARGB component using half-precision floating point format.
##
#NoExample
@@ -940,8 +955,7 @@
const char* alphaTypeStr[] = { "Unknown", "Opaque", "Premul", "Unpremul" };
SkAlphaType alphaType = image->alphaType();
canvas->drawImage(image, 16, 0);
- SkPaint paint;
- canvas->drawString(alphaTypeStr[(int) alphaType], 20, image->height() + 20, paint);
+ canvas->drawString(alphaTypeStr[(int) alphaType], 20, image->height() + 20, SkPaint());
##
#SeeAlso SkImageInfo::alphaType
@@ -959,7 +973,13 @@
#Return Color_Type of Image ##
#Example
-// incomplete
+#Image 4
+#Height 96
+ const char* colors[] = { "Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x",
+ "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16" };
+ SkColorType colorType = image->colorType();
+ canvas->drawImage(image, 16, 0);
+ canvas->drawString(colors[(int) colorType], 20, image->height() + 20, SkPaint());
##
#SeeAlso SkImageInfo::colorType
@@ -1994,6 +2014,11 @@
#Typedef std::function<void(GrBackendTexture)> BackendTextureReleaseProc
#Line # parameter type for MakeBackendTextureFromSkImage ##
+
+#Code
+typedef std::function<void(GrBackendTexture)> BackendTextureReleaseProc;
+##
+
Defines a function take one parameter of type
GrBackendTexture with no return value.
##