diff options
author | Brian Salomon <bsalomon@google.com> | 2018-03-15 12:16:02 -0400 |
---|---|---|
committer | Skia Commit-Bot <skia-commit-bot@chromium.org> | 2018-03-15 19:41:26 +0000 |
commit | 6a426c1d72aba0e37794fb8043cb71645eed4110 (patch) | |
tree | 73ba6627156ddb9e12f482597d08df20beade200 /docs | |
parent | 1a114377898ae10c943695594223e447bee5aeb0 (diff) |
Cleanup SkImage YUV texture factories.
Remove unused GrBackendObject variants.
Add versions without redundant size param.
Make this work with GrBackendTextures that weren't created with a GrPixelConfig.
Change-Id: Ic1bbf5f2817cebab938b4f31000126a6ab5c44d5
Reviewed-on: https://skia-review.googlesource.com/114460
Reviewed-by: Greg Daniel <egdaniel@google.com>
Commit-Queue: Brian Salomon <bsalomon@google.com>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/SkImage_Reference.bmh | 54 |
1 files changed, 18 insertions, 36 deletions
diff --git a/docs/SkImage_Reference.bmh b/docs/SkImage_Reference.bmh index f45862af5f..b94e4331b3 100644 --- a/docs/SkImage_Reference.bmh +++ b/docs/SkImage_Reference.bmh @@ -649,25 +649,21 @@ Recognized formats vary by GPU back-end. # ------------------------------------------------------------------------------ #Method static sk_sp<SkImage> MakeFromYUVTexturesCopy(GrContext* context, SkYUVColorSpace yuvColorSpace, - const GrBackendObject yuvTextureHandles[3], - const SkISize yuvSizes[3], + const GrBackendTexture yuvTextures[3], GrSurfaceOrigin surfaceOrigin, sk_sp<SkColorSpace> colorSpace = nullptr) #In Constructor #Line # creates Image from YUV_ColorSpace data in three planes ## -Creates Image from copy of yuvTextureHandles, an array of textures on GPU. -yuvTextureHandles contain pixels for YUV planes of Image. -yuvSizes contain dimensions for each pixel plane. Dimensions must be greater than -zero but may differ from plane to plane. Returned Image has the dimensions -yuvSizes[0]. yuvColorSpace describes how YUV colors convert to RGB colors. +Creates Image from copy of yuvTextures, an array of textures on GPU. +yuvTextures contain pixels for YUV planes of Image. Returned Image has the dimensions +yuvTextures[0]. yuvColorSpace describes how YUV colors convert to RGB colors. #Param context GPU_Context ## #Param yuvColorSpace one of: kJPEG_SkYUVColorSpace, kRec601_SkYUVColorSpace, kRec709_SkYUVColorSpace ## -#Param yuvTextureHandles array of YUV textures on GPU ## -#Param yuvSizes dimensions of YUV textures ## +#Param yuvTextures array of YUV textures on GPU ## #Param surfaceOrigin one of: kBottomLeft_GrSurfaceOrigin, kTopLeft_GrSurfaceOrigin ## #Param colorSpace range of colors; may be nullptr ## @@ -688,22 +684,17 @@ should this be moved to chrome only? # ------------------------------------------------------------------------------ #Method static sk_sp<SkImage> MakeFromYUVTexturesCopy(GrContext* context, SkYUVColorSpace yuvColorSpace, - const GrBackendTexture yuvTextureHandles[3], + const GrBackendTexture yuvTextures[3], const SkISize yuvSizes[3], GrSurfaceOrigin surfaceOrigin, sk_sp<SkColorSpace> colorSpace = nullptr) - -Creates Image from copy of yuvTextureHandles, an array of textures on GPU. -yuvTextureHandles contain pixels for YUV planes of Image. -yuvSizes contain dimensions for each pixel plane. Dimensions must be greater than -zero but may differ from plane to plane. Returned Image has the dimensions -yuvSizes[0]. yuvColorSpace describes how YUV colors convert to RGB colors. +This version of MakeFromYUVTexturesCopy is over specified and should not be used. #Param context GPU_Context ## #Param yuvColorSpace one of: kJPEG_SkYUVColorSpace, kRec601_SkYUVColorSpace, kRec709_SkYUVColorSpace ## -#Param yuvTextureHandles array of YUV textures on GPU ## +#Param yuvTextures array of YUV textures on GPU ## #Param yuvSizes dimensions of YUV textures ## #Param surfaceOrigin one of: kBottomLeft_GrSurfaceOrigin, kTopLeft_GrSurfaceOrigin ## #Param colorSpace range of colors; may be nullptr ## @@ -726,27 +717,24 @@ should this be moved to chrome only? #Method static sk_sp<SkImage> MakeFromNV12TexturesCopy(GrContext* context, SkYUVColorSpace yuvColorSpace, - const GrBackendObject nv12TextureHandles[2], - const SkISize nv12Sizes[2], + const GrBackendTexture nv12Textures[2], GrSurfaceOrigin surfaceOrigin, sk_sp<SkColorSpace> colorSpace = nullptr) #In Constructor -#Line # creates Image from YUV_ColorSpace data in two planes ## +#Line # creates Image from YUV_ColorSpace data in three planes ## Creates Image from copy of nv12TextureHandles, an array of textures on GPU. -nv12TextureHandles[0] contains pixels for YUV_Component_Y plane. -nv12TextureHandles[1] contains pixels for YUV_Component_U plane, +nv12Textures[0] contains pixels for YUV_Component_Y plane. +nv12Textures[1] contains pixels for YUV_Component_U plane, followed by pixels for YUV_Component_V plane. -nv12Sizes contain dimensions for each pixel plane. Dimensions must be greater than -zero but may differ from plane to plane. Returned Image has the dimensions -nv12Sizes[0]. yuvColorSpace describes how YUV colors convert to RGB colors. +Returned Image has the dimensions +nv12Textures[2]. yuvColorSpace describes how YUV colors convert to RGB colors. #Param context GPU_Context ## #Param yuvColorSpace one of: kJPEG_SkYUVColorSpace, kRec601_SkYUVColorSpace, kRec709_SkYUVColorSpace ## -#Param nv12TextureHandles array of YUV textures on GPU ## -#Param nv12Sizes dimensions of YUV textures ## +#Param nv12Textures array of YUV textures on GPU ## #Param surfaceOrigin one of: kBottomLeft_GrSurfaceOrigin, kTopLeft_GrSurfaceOrigin ## #Param colorSpace range of colors; may be nullptr ## @@ -768,24 +756,18 @@ should this be moved to chrome only? #Method static sk_sp<SkImage> MakeFromNV12TexturesCopy(GrContext* context, SkYUVColorSpace yuvColorSpace, - const GrBackendTexture nv12TextureHandles[2], + const GrBackendTexture nv12Textures[2], const SkISize nv12Sizes[2], GrSurfaceOrigin surfaceOrigin, sk_sp<SkColorSpace> colorSpace = nullptr) -Creates Image from copy of nv12TextureHandles, an array of textures on GPU. -nv12TextureHandles[0] contains pixels for YUV_Component_Y plane. -nv12TextureHandles[1] contains pixels for YUV_Component_U plane, -followed by pixels for YUV_Component_V plane. -nv12Sizes contain dimensions for each pixel plane. Dimensions must be greater than -zero but may differ from plane to plane. Returned Image has the dimensions -nv12Sizes[0]. yuvColorSpace describes how YUV colors convert to RGB colors. +This version of MakeFromYUVTexturesCopy is over specified and should not be used. #Param context GPU_Context ## #Param yuvColorSpace one of: kJPEG_SkYUVColorSpace, kRec601_SkYUVColorSpace, kRec709_SkYUVColorSpace ## -#Param nv12TextureHandles array of YUV textures on GPU ## +#Param nv12Textures array of YUV textures on GPU ## #Param nv12Sizes dimensions of YUV textures ## #Param surfaceOrigin one of: kBottomLeft_GrSurfaceOrigin, kTopLeft_GrSurfaceOrigin ## #Param colorSpace range of colors; may be nullptr ## |