SkImageInfo.h File Reference

#include "include/core/SkAlphaType.h"
#include "include/core/SkColorType.h"
#include "include/core/SkRect.h"
#include "include/core/SkRefCnt.h"
#include "include/core/SkSize.h"
#include "include/private/base/SkAPI.h"
#include "include/private/base/SkDebug.h"
#include "include/private/base/SkMath.h"
#include "include/private/base/SkTFitsIn.h"
#include <cstddef>
#include <cstdint>
#include <utility>

Go to the source code of this file.

Classes
struct	SkColorInfo
struct	SkImageInfo

Enumerations
enum	SkYUVColorSpace : int {   kJPEG_Full_SkYUVColorSpace , kRec601_Limited_SkYUVColorSpace , kRec709_Full_SkYUVColorSpace , kRec709_Limited_SkYUVColorSpace ,   kBT2020_8bit_Full_SkYUVColorSpace , kBT2020_8bit_Limited_SkYUVColorSpace , kBT2020_10bit_Full_SkYUVColorSpace , kBT2020_10bit_Limited_SkYUVColorSpace ,   kBT2020_12bit_Full_SkYUVColorSpace , kBT2020_12bit_Limited_SkYUVColorSpace , kFCC_Full_SkYUVColorSpace , kFCC_Limited_SkYUVColorSpace ,   kSMPTE240_Full_SkYUVColorSpace , kSMPTE240_Limited_SkYUVColorSpace , kYDZDX_Full_SkYUVColorSpace , kYDZDX_Limited_SkYUVColorSpace ,   kGBR_Full_SkYUVColorSpace , kGBR_Limited_SkYUVColorSpace , kYCgCo_8bit_Full_SkYUVColorSpace , kYCgCo_8bit_Limited_SkYUVColorSpace ,   kYCgCo_10bit_Full_SkYUVColorSpace , kYCgCo_10bit_Limited_SkYUVColorSpace , kYCgCo_12bit_Full_SkYUVColorSpace , kYCgCo_12bit_Limited_SkYUVColorSpace ,   kIdentity_SkYUVColorSpace , kLastEnum_SkYUVColorSpace = kIdentity_SkYUVColorSpace , kJPEG_SkYUVColorSpace = kJPEG_Full_SkYUVColorSpace , kRec601_SkYUVColorSpace = kRec601_Limited_SkYUVColorSpace ,   kRec709_SkYUVColorSpace = kRec709_Limited_SkYUVColorSpace , kBT2020_SkYUVColorSpace = kBT2020_8bit_Limited_SkYUVColorSpace }

Functions
SK_API int	SkColorTypeBytesPerPixel (SkColorType ct)
SK_API bool	SkColorTypeIsAlwaysOpaque (SkColorType ct)
SK_API bool	SkColorTypeValidateAlphaType (SkColorType colorType, SkAlphaType alphaType, SkAlphaType *canonical=nullptr)

Enumeration Type Documentation

SkYUVColorSpace

enum SkYUVColorSpace : int

Enumerator
kJPEG_Full_SkYUVColorSpace	describes full range
kRec601_Limited_SkYUVColorSpace	describes SDTV range
kRec709_Full_SkYUVColorSpace	describes HDTV range
kRec709_Limited_SkYUVColorSpace
kBT2020_8bit_Full_SkYUVColorSpace	describes UHDTV range, non-constant-luminance
kBT2020_8bit_Limited_SkYUVColorSpace
kBT2020_10bit_Full_SkYUVColorSpace
kBT2020_10bit_Limited_SkYUVColorSpace
kBT2020_12bit_Full_SkYUVColorSpace
kBT2020_12bit_Limited_SkYUVColorSpace
kFCC_Full_SkYUVColorSpace	describes FCC range
kFCC_Limited_SkYUVColorSpace
kSMPTE240_Full_SkYUVColorSpace	describes SMPTE240M range
kSMPTE240_Limited_SkYUVColorSpace
kYDZDX_Full_SkYUVColorSpace	describes YDZDX range
kYDZDX_Limited_SkYUVColorSpace
kGBR_Full_SkYUVColorSpace	describes GBR range
kGBR_Limited_SkYUVColorSpace
kYCgCo_8bit_Full_SkYUVColorSpace	describes YCgCo matrix
kYCgCo_8bit_Limited_SkYUVColorSpace
kYCgCo_10bit_Full_SkYUVColorSpace
kYCgCo_10bit_Limited_SkYUVColorSpace
kYCgCo_12bit_Full_SkYUVColorSpace
kYCgCo_12bit_Limited_SkYUVColorSpace
kIdentity_SkYUVColorSpace	maps Y->R, U->G, V->B
kLastEnum_SkYUVColorSpace	last valid value
kJPEG_SkYUVColorSpace
kRec601_SkYUVColorSpace
kRec709_SkYUVColorSpace
kBT2020_SkYUVColorSpace

Definition at line 68 of file SkImageInfo.h.

                     : int {
    kJPEG_Full_SkYUVColorSpace,                 //!< describes full range
    kRec601_Limited_SkYUVColorSpace,            //!< describes SDTV range
    kRec709_Full_SkYUVColorSpace,               //!< describes HDTV range
    kRec709_Limited_SkYUVColorSpace,
    kBT2020_8bit_Full_SkYUVColorSpace,          //!< describes UHDTV range, non-constant-luminance
    kBT2020_8bit_Limited_SkYUVColorSpace,
    kBT2020_10bit_Full_SkYUVColorSpace,
    kBT2020_10bit_Limited_SkYUVColorSpace,
    kBT2020_12bit_Full_SkYUVColorSpace,
    kBT2020_12bit_Limited_SkYUVColorSpace,
    kFCC_Full_SkYUVColorSpace,                  //!< describes FCC range
    kFCC_Limited_SkYUVColorSpace,
    kSMPTE240_Full_SkYUVColorSpace,             //!< describes SMPTE240M range
    kSMPTE240_Limited_SkYUVColorSpace,
    kYDZDX_Full_SkYUVColorSpace,                //!< describes YDZDX range
    kYDZDX_Limited_SkYUVColorSpace,
    kGBR_Full_SkYUVColorSpace,                  //!< describes GBR range
    kGBR_Limited_SkYUVColorSpace,
    kYCgCo_8bit_Full_SkYUVColorSpace,           //!< describes YCgCo matrix
    kYCgCo_8bit_Limited_SkYUVColorSpace,
    kYCgCo_10bit_Full_SkYUVColorSpace,
    kYCgCo_10bit_Limited_SkYUVColorSpace,
    kYCgCo_12bit_Full_SkYUVColorSpace,
    kYCgCo_12bit_Limited_SkYUVColorSpace,
    kIdentity_SkYUVColorSpace,                  //!< maps Y->R, U->G, V->B
 
    kLastEnum_SkYUVColorSpace = kIdentity_SkYUVColorSpace, //!< last valid value
 
    // Legacy (deprecated) names:
    kJPEG_SkYUVColorSpace = kJPEG_Full_SkYUVColorSpace,
    kRec601_SkYUVColorSpace = kRec601_Limited_SkYUVColorSpace,
    kRec709_SkYUVColorSpace = kRec709_Limited_SkYUVColorSpace,
    kBT2020_SkYUVColorSpace = kBT2020_8bit_Limited_SkYUVColorSpace,
};

Function Documentation

SkColorTypeBytesPerPixel()

SK_API int SkColorTypeBytesPerPixel

(

SkColorType

ct

)

Returns the number of bytes required to store a pixel, including unused padding. Returns zero if ct is kUnknown_SkColorType or invalid.

Returns

bytes per pixel

Definition at line 16 of file SkImageInfo.cpp.

                                             {
    switch (ct) {
        case kUnknown_SkColorType:            return 0;
        case kAlpha_8_SkColorType:            return 1;
        case kRGB_565_SkColorType:            return 2;
        case kARGB_4444_SkColorType:          return 2;
        case kRGBA_8888_SkColorType:          return 4;
        case kBGRA_8888_SkColorType:          return 4;
        case kRGB_888x_SkColorType:           return 4;
        case kRGBA_1010102_SkColorType:       return 4;
        case kRGB_101010x_SkColorType:        return 4;
        case kBGRA_1010102_SkColorType:       return 4;
        case kBGR_101010x_SkColorType:        return 4;
        case kBGR_101010x_XR_SkColorType:     return 4;
        case kBGRA_10101010_XR_SkColorType:   return 8;
        case kRGBA_10x6_SkColorType:          return 8;
        case kGray_8_SkColorType:             return 1;
        case kRGBA_F16Norm_SkColorType:       return 8;
        case kRGBA_F16_SkColorType:           return 8;
        case kRGBA_F32_SkColorType:           return 16;
        case kR8G8_unorm_SkColorType:         return 2;
        case kA16_unorm_SkColorType:          return 2;
        case kR16G16_unorm_SkColorType:       return 4;
        case kA16_float_SkColorType:          return 2;
        case kR16G16_float_SkColorType:       return 4;
        case kR16G16B16A16_unorm_SkColorType: return 8;
        case kSRGBA_8888_SkColorType:         return 4;
        case kR8_unorm_SkColorType:           return 1;
    }
    SkUNREACHABLE;
}

SkColorTypeIsAlwaysOpaque()

SK_API bool SkColorTypeIsAlwaysOpaque

(

SkColorType

ct

)

Returns true if SkColorType always decodes alpha to 1.0, making the pixel fully opaque. If true, SkColorType does not reserve bits to encode alpha.

Returns

true if alpha is always set to 1.0

Definition at line 48 of file SkImageInfo.cpp.

                                               {
    return !(SkColorTypeChannelFlags(ct) & kAlpha_SkColorChannelFlag);
}

SkColorTypeValidateAlphaType()

SK_API bool SkColorTypeValidateAlphaType	(	SkColorType	colorType,
		SkAlphaType	alphaType,
		SkAlphaType *	canonical = nullptr
	)

Returns true if canonical can be set to a valid SkAlphaType for colorType. If there is more than one valid canonical SkAlphaType, set to alphaType, if valid. If true is returned and canonical is not nullptr, store valid SkAlphaType.

Returns false only if alphaType is kUnknown_SkAlphaType, color type is not kUnknown_SkColorType, and SkColorType is not always opaque. If false is returned, canonical is ignored.

Parameters

canonical

storage for SkAlphaType

Returns

true if valid SkAlphaType can be associated with colorType

Definition at line 194 of file SkImageInfo.cpp.

                                                          {
    switch (colorType) {
        case kUnknown_SkColorType:
            alphaType = kUnknown_SkAlphaType;
            break;
        case kAlpha_8_SkColorType:         // fall-through
        case kA16_unorm_SkColorType:       // fall-through
        case kA16_float_SkColorType:
            if (kUnpremul_SkAlphaType == alphaType) {
                alphaType = kPremul_SkAlphaType;
            }
            [[fallthrough]];
        case kARGB_4444_SkColorType:
        case kRGBA_8888_SkColorType:
        case kSRGBA_8888_SkColorType:
        case kBGRA_8888_SkColorType:
        case kRGBA_1010102_SkColorType:
        case kBGRA_1010102_SkColorType:
        case kRGBA_10x6_SkColorType:
        case kRGBA_F16Norm_SkColorType:
        case kRGBA_F16_SkColorType:
        case kRGBA_F32_SkColorType:
        case kBGRA_10101010_XR_SkColorType:
        case kR16G16B16A16_unorm_SkColorType:
            if (kUnknown_SkAlphaType == alphaType) {
                return false;
            }
            break;
        case kGray_8_SkColorType:
        case kR8G8_unorm_SkColorType:
        case kR16G16_unorm_SkColorType:
        case kR16G16_float_SkColorType:
        case kRGB_565_SkColorType:
        case kRGB_888x_SkColorType:
        case kRGB_101010x_SkColorType:
        case kBGR_101010x_SkColorType:
        case kBGR_101010x_XR_SkColorType:
        case kR8_unorm_SkColorType:
            alphaType = kOpaque_SkAlphaType;
            break;
    }
    if (canonical) {
        *canonical = alphaType;
    }
    return true;
}