#Topic Image_Info #Alias Image_Info_Reference ## #Code #Populate ## Image_Info specifies the dimensions and encoding of the pixels in a Bitmap. The dimensions are integral width and height. The encoding is how pixel bits describe Color_Alpha, transparency; Color components red, blue, and green; and Color_Space, the range and linearity of colors. Image_Info describes an uncompressed raster pixels. In contrast, Image additionally describes compressed pixels like PNG, and Surface describes destinations on the GPU. Image and Surface may be specified by Image_Info, but Image and Surface may not contain Image_Info. # ------------------------------------------------------------------------------ #Subtopic Alpha_Type #Line # encoding for pixel transparency ## #Alias Alpha_Type ## #Alias Alpha_Types ## #PhraseDef list_of_alpha_types kUnknown_SkAlphaType, kOpaque_SkAlphaType, kPremul_SkAlphaType, kUnpremul_SkAlphaType ## #Enum SkAlphaType #Line # encoding for pixel transparency ## #Code #Populate ## Describes how to interpret the alpha component of a pixel. A pixel may be opaque, or Color_Alpha, describing multiple levels of transparency. In simple blending, Color_Alpha weights the draw color and the destination color to create a new color. If alpha describes a weight from zero to one, new color is set to: #Formula # draw color * alpha + destination color * (1 - alpha) ##. In practice alpha is encoded in two or more bits, where 1.0 equals all bits set. RGB may have Color_Alpha included in each component value; the stored value is the original RGB multiplied by Color_Alpha. Premultiplied color components improve performance. #Const kUnknown_SkAlphaType 0 #Line # uninitialized ## Alpha_Type is uninitialized. ## #Const kOpaque_SkAlphaType 1 #Line # pixel is opaque ## #Details Opaque Pixels are opaque. The Color_Type must have no explicit alpha component, or all alpha components must be set to their maximum value. ## #Const kPremul_SkAlphaType 2 #Line # pixel components are Premultiplied by Alpha ## #Details Premul Pixels have Alpha Premultiplied into color components. Surface pixels must be Premultiplied. ## #Const kUnpremul_SkAlphaType 3 #Line # pixel components are independent of Alpha ## #Details Unpremul Pixel color component values are independent of alpha value. Images generated from encoded data like PNG do not Premultiply pixel color components. kUnpremul_SkAlphaType is supported for Image pixels, but not for Surface pixels. ## #Const kLastEnum_SkAlphaType 3 #Line # last valid value ## Used by tests to iterate through all valid values. ## #NoExample ## #SeeAlso SkColorType SkColorSpace #Enum SkAlphaType ## #Subtopic Opaque #Line # hints all pixels are opaque ## Use kOpaque_SkAlphaType as a hint to optimize drawing when Alpha component of all pixel is set to its maximum value of 1.0; all alpha component bits are set. If Image_Info is set to kOpaque_SkAlphaType but all alpha values are not 1.0, results are undefined. #Example #Height 64 #Description SkPreMultiplyARGB parameter a is set to 255, its maximum value, and is interpreted as Color_Alpha of 1.0. kOpaque_SkAlphaType may be set to improve performance. If SkPreMultiplyARGB parameter a is set to a value smaller than 255, kPremul_SkAlphaType must be used instead to avoid undefined results. The four displayed values are the original component values, though not necessarily in the same order. ## SkPMColor color = SkPreMultiplyARGB(255, 50, 100, 150); SkString s; s.printf("%u %u %u %u", SkColorGetA(color), SkColorGetR(color), SkColorGetG(color), SkColorGetB(color)); SkPaint paint; paint.setAntiAlias(true); canvas->drawString(s, 10, 62, paint); canvas->scale(50, 50); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(1, 1, kN32_SkColorType, kOpaque_SkAlphaType); if (bitmap.installPixels(imageInfo, (void*) &color, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 0, 0); } ## #Subtopic Opaque ## #Subtopic Premul #Line # stores components scaled by Alpha ## Use kPremul_SkAlphaType when stored color components are the original color multiplied by the alpha component. The alpha component range of 0.0 to 1.0 is achieved by dividing the integer bit value by the maximum bit value. #Code stored color = original color * alpha / max alpha ## The color component must be equal to or smaller than the alpha component, or the results are undefined. #Example #Description SkPreMultiplyARGB parameter a is set to 150, less than its maximum value, and is interpreted as Color_Alpha of about 0.6. kPremul_SkAlphaType must be set, since SkPreMultiplyARGB parameter a is set to a value smaller than 255, to avoid undefined results. The four displayed values reflect that the alpha component has been multiplied by the original color. ## #Height 64 SkPMColor color = SkPreMultiplyARGB(150, 50, 100, 150); SkString s; s.printf("%u %u %u %u", SkColorGetA(color), SkColorGetR(color), SkColorGetG(color), SkColorGetB(color)); SkPaint paint; paint.setAntiAlias(true); canvas->drawString(s, 10, 62, paint); canvas->scale(50, 50); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(1, 1, kN32_SkColorType, kPremul_SkAlphaType); if (bitmap.installPixels(imageInfo, (void*) &color, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 0, 0); } ## #Subtopic Premul ## #Subtopic Unpremul #Line # stores components without Alpha scaling ## Use kUnpremul_SkAlphaType if stored color components are not divided by the alpha component. Some drawing destinations may not support kUnpremul_SkAlphaType. #Bug 7079 #Example #Height 64 #Description SkColorSetARGB parameter a is set to 150, less than its maximum value, and is interpreted as Color_Alpha of about 0.6. color is not Premultiplied; color components may have values greater than color alpha. The four displayed values are the original component values, though not necessarily in the same order. ## SkColor color = SkColorSetARGB(150, 50, 100, 255); SkString s; s.printf("%u %u %u %u", SkColorGetA(color), SkColorGetR(color), SkColorGetG(color), SkColorGetB(color)); SkPaint paint; paint.setAntiAlias(true); canvas->drawString(s, 10, 62, paint); canvas->scale(50, 50); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(1, 1, kN32_SkColorType, kUnpremul_SkAlphaType); if (bitmap.installPixels(imageInfo, (void*) &color, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 0, 0); } ## #Subtopic Unpremul ## #Method static bool SkAlphaTypeIsOpaque(SkAlphaType at) #In Property #Line # returns if Alpha_Type equals kOpaque_SkAlphaType ## #Populate #NoExample ## ## #Subtopic Alpha_Type ## # ------------------------------------------------------------------------------ #Subtopic Color_Type #Line # encoding for pixel color ## #Alias Color_Type ## #Alias Color_Types ## #PhraseDef list_of_color_types kUnknown_SkColorType, kAlpha_8_SkColorType, kRGB_565_SkColorType, kARGB_4444_SkColorType, kRGBA_8888_SkColorType, kRGB_888x_SkColorType, kBGRA_8888_SkColorType, kRGBA_1010102_SkColorType, kRGB_101010x_SkColorType, kGray_8_SkColorType, kRGBA_F16_SkColorType ## #Enum SkColorType #Line # encoding for pixel color ## #Code #Populate ## Describes how pixel bits encode color. A pixel may be an alpha mask, a grayscale, RGB, or ARGB. kN32_SkColorType selects the native 32-bit ARGB format. On Little_Endian processors, pixels containing 8-bit ARGB components pack into 32-bit kBGRA_8888_SkColorType. On Big_Endian processors, pixels pack into 32-bit kRGBA_8888_SkColorType. #Const kUnknown_SkColorType 0 #Line # uninitialized ## Color_Type is set to kUnknown_SkColorType by default. If set, encoding format and size is unknown. ## #Const kAlpha_8_SkColorType 1 #Line # pixel with Alpha in 8-bit byte ## #Details Alpha_8 Stores 8-bit byte pixel encoding that represents transparency. Value of zero is completely transparent; a value of 255 is completely opaque. ## #Const kRGB_565_SkColorType 2 #Line # pixel with 5 bits red, 6 bits green, 5 bits blue, in 16-bit word ## #Details RGB_565 Stores 16-bit word pixel encoding that contains five bits of blue, six bits of green, and five bits of red. ## #Const kARGB_4444_SkColorType 3 #Line # pixel with 4 bits for alpha, red, green, blue; in 16-bit word ## #Details ARGB_4444 Stores 16-bit word pixel encoding that contains four bits of alpha, four bits of blue, four bits of green, and four bits of red. ## #Const kRGBA_8888_SkColorType 4 #Line # pixel with 8 bits for red, green, blue, alpha; in 32-bit word ## #Details RGBA_8888 Stores 32-bit word pixel encoding that contains eight bits of red, eight bits of green, eight bits of blue, and eight bits of alpha. ## #Const kRGB_888x_SkColorType 5 #Line # pixel with 8 bits each for red, green, blue; in 32-bit word ## #Details RGB_888 Stores 32-bit word pixel encoding that contains eight bits of red, eight bits of green, eight bits of blue, and eight unused bits. ## #Const kBGRA_8888_SkColorType 6 #Line # pixel with 8 bits for blue, green, red, alpha; in 32-bit word ## #Details BGRA_8888 Stores 32-bit word pixel encoding that contains eight bits of blue, eight bits of green, eight bits of red, and eight bits of alpha. ## #Const kRGBA_1010102_SkColorType 7 #Line # 10 bits for red, green, blue; 2 bits for alpha; in 32-bit word ## #Details RGBA_1010102 Stores 32-bit word pixel encoding that contains ten bits of red, ten bits of green, ten bits of blue, and two bits of alpha. ## #Const kRGB_101010x_SkColorType 8 #Line # pixel with 10 bits each for red, green, blue; in 32-bit word ## #Details RGB_101010 Stores 32-bit word pixel encoding that contains ten bits of red, ten bits of green, ten bits of blue, and two unused bits. ## #Const kGray_8_SkColorType 9 #Line # pixel with grayscale level in 8-bit byte ## #Details Gray_8 Stores 8-bit byte pixel encoding that equivalent to equal values for red, blue, and green, representing colors from black to white. ## #Const kRGBA_F16_SkColorType 10 #Line # pixel with half floats for red, green, blue, alpha; in 64-bit word ## #Details RGBA_F16 Stores 64-bit word pixel encoding that contains 16 bits of blue, 16 bits of green, 16 bits of red, and 16 bits of alpha. Each component is encoded as a half float. ## #Const kRGBA_F32_SkColorType 11 #Line # pixel using C float for red, green, blue, alpha; in 128-bit word ## #Details RGBA_F32 Stores 128-bit word pixel encoding that contains 32 bits of blue, 32 bits of green, 32 bits of red, and 32 bits of alpha. Each component is encoded as a single precision float. ## #Const kLastEnum_SkColorType 11 #NoJustify #Line # last valid value ## Used by tests to iterate through all valid values. ## #Const kN32_SkColorType 4 or 6 #Alias Native_Color_Type ## #NoJustify #Line # native ARGB 32-bit encoding ## Encodes ARGB as either kRGBA_8888_SkColorType or kBGRA_8888_SkColorType, whichever is native to the platform. ## #NoExample ## #SeeAlso SkAlphaType SkColorSpace #Enum SkColorType ## #Subtopic Alpha_8 #Line # encodes transparency only ## Alpha pixels encode transparency without color information. Value of zero is completely transparent; a value of 255 is completely opaque. Bitmap pixels do not visibly draw, because its pixels have no color information. When SkColorType is set to kAlpha_8_SkColorType, the paired SkAlphaType is ignored. #Example #Description Alpha pixels can modify another draw. orangePaint fills the bounds of bitmap, with its transparency set to alpha8 pixel value. ## #Height 64 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kAlpha_8_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); SkPaint orangePaint; orangePaint.setARGB(0xFF, 0xFF, 0xA5, 0x00); canvas->drawBitmap(bitmap, 0, 0, &orangePaint); uint8_t alpha8[] = { 0xFF, 0xBB, 0x77, 0x33 }; SkPixmap alphaPixmap(imageInfo, &alpha8, imageInfo.minRowBytes()); if (bitmap.writePixels(alphaPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2, &orangePaint); } ## #SeeAlso Alpha Gray_8 ## #Subtopic RGB_565 #Line # encodes RGB in 16 bits ## kRGB_565_SkColorType encodes RGB to fit in a 16-bit word. Red and blue components use five bits describing 32 levels. Green components, more sensitive to the eye, use six bits describing 64 levels. kRGB_565_SkColorType has no bits for Alpha. Pixels are fully opaque as if its Color_Alpha was set to one, and should always be paired with kOpaque_SkAlphaType. #Illustration #Example #Height 96 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGB_565_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack565 = [](unsigned r, unsigned g, unsigned b) -> uint16_t { return (b << 0) | (g << 5) | (r << 11); }; uint16_t red565[] = { pack565(0x1F, 0x00, 0x00), pack565(0x17, 0x00, 0x00), pack565(0x0F, 0x00, 0x00), pack565(0x07, 0x00, 0x00) }; uint16_t blue565[] = { pack565(0x00, 0x00, 0x1F), pack565(0x00, 0x00, 0x17), pack565(0x00, 0x00, 0x0F), pack565(0x00, 0x00, 0x07) }; SkPixmap redPixmap(imageInfo, &red565, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blue565, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso ARGB_4444 RGBA_8888 ## #Subtopic ARGB_4444 #Line # encodes ARGB in 16 bits ## kARGB_4444_SkColorType encodes ARGB to fit in 16-bit word. Each component: alpha, blue, green, and red; use four bits, describing 16 levels. Note that kARGB_4444_SkColorType is misnamed; the acronym does not describe the actual component order. #Illustration If paired with kPremul_SkAlphaType: blue, green, and red components are Premultiplied by the alpha value. If blue, green, or red is greater than alpha, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: alpha, blue, green, and red components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; blue, green, and red components are fully opaque. If any alpha component is less than 15, the drawn result is undefined. #Bug 7648 #Example #Height 96 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kARGB_4444_SkColorType, kPremul_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack4444 = [](unsigned a, unsigned r, unsigned g, unsigned b) -> uint16_t { return (a << 0) | (b << 4) | (g << 8) | (r << 12); }; uint16_t red4444[] = { pack4444(0xF, 0xF, 0x0, 0x0), pack4444(0xF, 0xb, 0x0, 0x0), pack4444(0xF, 0x7, 0x0, 0x0), pack4444(0xF, 0x3, 0x0, 0x0) }; uint16_t blue4444[] = { pack4444(0xF, 0x0, 0x0, 0xF), pack4444(0xF, 0x0, 0x0, 0xb), pack4444(0xF, 0x0, 0x0, 0x7), pack4444(0xF, 0x0, 0x0, 0x3) }; SkPixmap redPixmap(imageInfo, &red4444, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blue4444, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGBA_8888 ## #Subtopic RGBA_8888 #Line # encodes ARGB Big_Endian in 32 bits ## kRGBA_8888_SkColorType encodes ARGB into a 32-bit word. Each component: red, green, blue, alpha; use eight bits, describing 256 levels. #Illustration If paired with kPremul_SkAlphaType: red, green, and blue components are Premultiplied by the alpha value. If red, green, or blue is greater than alpha, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: alpha, red, green, and blue components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; red, green, and blue components are fully opaque. If any alpha component is less than 255, the drawn result is undefined. On Big_Endian platforms, kRGBA_8888_SkColorType is the native Color_Type, and will have the best performance. Use kN32_SkColorType to choose the best Color_Type for the platform at compile time. #Example #Height 96 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGBA_8888_SkColorType, kPremul_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack8888 = [](unsigned a, unsigned r, unsigned g, unsigned b) -> uint32_t { return (r << 0) | (g << 8) | (b << 16) | (a << 24); }; uint32_t red8888[] = { pack8888(0xFF, 0xFF, 0x0, 0x0), pack8888(0xFF, 0xbb, 0x0, 0x0), pack8888(0xFF, 0x77, 0x0, 0x0), pack8888(0xFF, 0x33, 0x0, 0x0) }; uint32_t blue8888[] = { pack8888(0xFF, 0x0, 0x0, 0x0FF), pack8888(0xFF, 0x0, 0x0, 0x0bb), pack8888(0xFF, 0x0, 0x0, 0x077), pack8888(0xFF, 0x0, 0x0, 0x033) }; SkPixmap redPixmap(imageInfo, &red8888, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blue8888, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGB_888 BGRA_8888 ## #Subtopic RGB_888 #Line # encodes RGB in 32 bits ## kRGB_888x_SkColorType encodes RGB into a 32-bit word. Each component: red, green, blue; use eight bits, describing 256 levels. Eight bits are unused. Pixels described by kRGB_888x_SkColorType are fully opaque as if their Color_Alpha was set to one, and should always be paired with kOpaque_SkAlphaType. #Illustration #Example #Bug 7645 #Height 96 #Platform cpu canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGB_888x_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack888 = [](unsigned r, unsigned g, unsigned b) -> uint32_t { return (r << 0) | (g << 8) | (b << 16); }; uint32_t red888[] = { pack888(0xFF, 0x00, 0x00), pack888(0xbb, 0x00, 0x00), pack888(0x77, 0x00, 0x00), pack888(0x33, 0x00, 0x00) }; uint32_t blue888[] = { pack888(0x00, 0x00, 0xFF), pack888(0x00, 0x00, 0xbb), pack888(0x00, 0x00, 0x77), pack888(0x00, 0x00, 0x33) }; if (bitmap.installPixels(imageInfo, (void*) red888, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 2, 2); } if (bitmap.installPixels(imageInfo, (void*) blue888, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGBA_8888 BGRA_8888 ## #Subtopic BGRA_8888 #Line # encodes ARGB Little_Endian in 32 bits ## kBGRA_8888_SkColorType encodes ARGB into a 32-bit word. Each component: blue, green, red, and alpha; use eight bits, describing 256 levels. #Illustration If paired with kPremul_SkAlphaType: blue, green, and red components are Premultiplied by the alpha value. If blue, green, or red is greater than alpha, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: blue, green, red, and alpha components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; blue, green, and red components are fully opaque. If any alpha component is less than 255, the drawn result is undefined. On Little_Endian platforms, kBGRA_8888_SkColorType is the native Color_Type, and will have the best performance. Use kN32_SkColorType to choose the best Color_Type for the platform at compile time. #Example #Height 96 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kBGRA_8888_SkColorType, kPremul_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack8888 = [](unsigned a, unsigned r, unsigned g, unsigned b) -> uint32_t { return (b << 0) | (g << 8) | (r << 16) | (a << 24); }; uint32_t red8888[] = { pack8888(0xFF, 0xFF, 0x0, 0x0), pack8888(0xFF, 0xbb, 0x0, 0x0), pack8888(0xFF, 0x99, 0x0, 0x0), pack8888(0xFF, 0x55, 0x0, 0x0) }; uint32_t blue8888[] = { pack8888(0xFF, 0x0, 0x0, 0x0FF), pack8888(0xFF, 0x0, 0x0, 0x0bb), pack8888(0xFF, 0x0, 0x0, 0x099), pack8888(0xFF, 0x0, 0x0, 0x055) }; SkPixmap redPixmap(imageInfo, &red8888, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blue8888, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGBA_8888 ## #Subtopic RGBA_1010102 #Line # encodes ARGB ten bits per color component ## kRGBA_1010102_SkColorType encodes ARGB into a 32-bit word. Each Color component: red, green, and blue; use ten bits, describing 1024 levels. Two bits contain alpha, describing four levels. Possible alpha values are zero: fully transparent; one: 33% opaque; two: 67% opaque; three: fully opaque. At present, Color in Paint does not provide enough precision to draw all colors possible to a kRGBA_1010102_SkColorType Surface. #Illustration If paired with kPremul_SkAlphaType: red, green, and blue components are Premultiplied by the alpha value. If red, green, or blue is greater than the alpha replicated to ten bits, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: alpha, red, green, and blue components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; red, green, and blue components are fully opaque. If any alpha component is less than three, the drawn result is undefined. #Example #Bug 7645 #Height 96 #Platform cpu canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGBA_1010102_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack1010102 = [](unsigned r, unsigned g, unsigned b, unsigned a) -> uint32_t { return (r << 0) | (g << 10) | (b << 20) | (a << 30); }; uint32_t redBits[] = { pack1010102(0x3FF, 0x000, 0x000, 0x3), pack1010102(0x2ff, 0x000, 0x000, 0x3), pack1010102(0x1ff, 0x000, 0x000, 0x3), pack1010102(0x0ff, 0x000, 0x000, 0x3) }; uint32_t blueBits[] = { pack1010102(0x000, 0x000, 0x3FF, 0x3), pack1010102(0x000, 0x000, 0x2ff, 0x3), pack1010102(0x000, 0x000, 0x1ff, 0x3), pack1010102(0x000, 0x000, 0x0ff, 0x3) }; if (bitmap.installPixels(imageInfo, (void*) redBits, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blueBits, imageInfo.minRowBytes()); if (bitmap.installPixels(imageInfo, (void*) blueBits, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGB_101010 RGBA_8888 ## #Subtopic RGB_101010 #Line # encodes RGB ten bits per color component ## kRGB_101010x_SkColorType encodes RGB into a 32-bit word. Each Color component: red, green, and blue; use ten bits, describing 1024 levels. Two bits are unused. Pixels described by kRGB_101010x_SkColorType are fully opaque as if its Color_Alpha was set to one, and should always be paired with kOpaque_SkAlphaType. At present, Color in Paint does not provide enough precision to draw all colors possible to a kRGB_101010x_SkColorType Surface. #Illustration #Example #Bug 7645 #Height 96 #Platform cpu canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGB_101010x_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto pack101010x = [](unsigned r, unsigned g, unsigned b) -> uint32_t { return (r << 0) | (g << 10) | (b << 20); }; uint32_t redBits[] = { pack101010x(0x3FF, 0x000, 0x000), pack101010x(0x2ff, 0x000, 0x000), pack101010x(0x1ff, 0x000, 0x000), pack101010x(0x0ff, 0x000, 0x000) }; uint32_t blueBits[] = { pack101010x(0x000, 0x000, 0x3FF), pack101010x(0x000, 0x000, 0x2ff), pack101010x(0x000, 0x000, 0x1ff), pack101010x(0x000, 0x000, 0x0ff) }; if (bitmap.installPixels(imageInfo, (void*) redBits, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, &blueBits, imageInfo.minRowBytes()); if (bitmap.installPixels(imageInfo, (void*) blueBits, imageInfo.minRowBytes())) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso RGBA_1010102 ## #Subtopic Gray_8 #Line # encodes level of grayscale in 8 bits ## kGray_8_SkColorType encodes grayscale level in eight bits that is equivalent to equal values for red, blue, and green, representing colors from black to white. Pixels described by kGray_8_SkColorType are fully opaque as if its Color_Alpha was set to one, and should always be paired with kOpaque_SkAlphaType. #Example #Height 64 canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kGray_8_SkColorType, kOpaque_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); uint8_t gray8[] = { 0xFF, 0xBB, 0x77, 0x33 }; SkPixmap grayPixmap(imageInfo, &gray8, imageInfo.minRowBytes()); if (bitmap.writePixels(grayPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } ## #SeeAlso Alpha_8 ## #Subtopic RGBA_F16 #Line # encodes ARGB as half floats ## kRGBA_F16_SkColorType encodes ARGB into a 64-bit word. Each component: blue, green, red, and alpha; use 16 bits, describing a floating point value, from -65500 to 65000 with 3.31 decimal digits of precision. At present, Color in Paint does not provide enough precision or range to draw all colors possible to a kRGBA_F16_SkColorType Surface. Each component encodes a floating point value using #A Half floats # https://www.khronos.org/opengl/wiki/Small_Float_Formats ## . Meaningful colors are represented by the range 0.0 to 1.0, although smaller and larger values may be useful when used in combination with Transfer_Mode. #Illustration If paired with kPremul_SkAlphaType: blue, green, and red components are Premultiplied by the alpha value. If blue, green, or red is greater than alpha, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: blue, green, red, and alpha components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; blue, green, and red components are fully opaque. If any alpha component is less than one, the drawn result is undefined. #ToDo FloatToHalf should be replaced with SkFloatToHalf if/when that's made public ## #Example #Height 96 #Function union FloatUIntUnion { uint32_t fUInt; float fFloat; }; uint16_t FloatToHalf(float f) { static const FloatUIntUnion magic = { 15 << 23 }; static const uint32_t round_mask = ~0xfffu; FloatUIntUnion floatUnion; floatUnion.fFloat = f; uint32_t sign = floatUnion.fUInt & 0x80000000u; floatUnion.fUInt ^= sign; floatUnion.fUInt &= round_mask; floatUnion.fFloat *= magic.fFloat; floatUnion.fUInt -= round_mask; return (floatUnion.fUInt >> 13) | (sign >> 16); } ## void draw(SkCanvas* canvas) { canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGBA_F16_SkColorType, kPremul_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); auto H = [](float c) -> uint16_t { return FloatToHalf(c); }; // R G B A uint16_t red_f16[][4] = { { H(1.0), H(0.0), H(0.0), H(1.0) }, { H(.75), H(0.0), H(0.0), H(1.0) }, { H(.50), H(0.0), H(0.0), H(1.0) }, { H(.25), H(0.0), H(0.0), H(1.0) } }; uint16_t blue_f16[][4] = { { H(0.0), H(0.0), H(1.0), H(1.0) }, { H(0.0), H(0.0), H(.75), H(1.0) }, { H(0.0), H(0.0), H(.50), H(1.0) }, { H(0.0), H(0.0), H(.25), H(1.0) } }; SkPixmap redPixmap(imageInfo, red_f16, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, blue_f16, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } } ## #SeeAlso SkColor4f ## #Subtopic RGBA_F32 #Line # encodes ARGB as single precision floats ## kRGBA_F32_SkColorType encodes ARGB into a 128-bit word. Each component: blue, green, red, and alpha; use 32 bits, describing a floating point value, from -3.402823e+38 to 3.402823e+38 with 7.225 decimal digits of precision. At present, Color in Paint does not provide enough precision or range to draw all colors possible to a kRGBA_F32_SkColorType Surface. Each component encodes a floating point value using #A single-precision floats # https://en.wikipedia.org/wiki/Single-precision_floating-point_format ## . Meaningful colors are represented by the range 0.0 to 1.0, although smaller and larger values may be useful when used in combination with Transfer_Mode. #Illustration If paired with kPremul_SkAlphaType: blue, green, and red components are Premultiplied by the alpha value. If blue, green, or red is greater than alpha, the drawn result is undefined. If paired with kUnpremul_SkAlphaType: blue, green, red, and alpha components may have any value. There may be a performance penalty with Unpremultiplied pixels. If paired with kOpaque_SkAlphaType: all alpha component values are at the maximum; blue, green, and red components are fully opaque. If any alpha component is less than one, the drawn result is undefined. #NoExample canvas->scale(16, 16); SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(2, 2, kRGBA_F32_SkColorType, kPremul_SkAlphaType); bitmap.allocPixels(imageInfo); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorGREEN); canvas->drawBitmap(bitmap, 0, 0); // R G B A float red_f32[][4] = { { 1.0, 0.0, 0.0, 1.0 }, { .75, 0.0, 0.0, 1.0 }, { .50, 0.0, 0.0, 1.0 }, { .25, 0.0, 0.0, 1.0 } }; float blue_f32[][4] = { { 0.0, 0.0, 1.0, 1.0 }, { 0.0, 0.0, .75, 1.0 }, { 0.0, 0.0, .50, 1.0 }, { 0.0, 0.0, .25, 1.0 } }; SkPixmap redPixmap(imageInfo, red_f32, imageInfo.minRowBytes()); if (bitmap.writePixels(redPixmap, 0, 0)) { canvas->drawBitmap(bitmap, 2, 2); } SkPixmap bluePixmap(imageInfo, blue_f32, imageInfo.minRowBytes()); if (bitmap.writePixels(bluePixmap, 0, 0)) { canvas->drawBitmap(bitmap, 4, 4); } ## #SeeAlso SkColor4f ## #Subtopic Color_Type ## # ------------------------------------------------------------------------------ #Method int SkColorTypeBytesPerPixel(SkColorType ct) #In Property #Line # returns Color_Type byte size ## #Populate #Example #Height 192 const char* colors[] = { "Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16" }; SkPaint paint; SkFont font(SkTypeface::MakeFromName("monospace", SkFontStyle()), 10); int y = 15; canvas->drawString(" colorType bytes", 10, y, paint); for (SkColorType colorType : { #list_of_color_types# } ) { int result = SkColorTypeBytesPerPixel(colorType); SkString string; string.printf("%13s %4d", colors[(int) colorType], result); canvas->drawString(string, 10, y += 14, font, paint); } ## #SeeAlso SkImageInfo::bytesPerPixel ## # ------------------------------------------------------------------------------ #Method bool SkColorTypeIsAlwaysOpaque(SkColorType ct) #In Property #Line # returns if Color_Type includes Color_Alpha ## #Populate #Example #Height 192 const char* colors[] = { "Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16" }; SkPaint paint; SkFont font(SkTypeface::MakeFromName("monospace", SkFontStyle()), 10); int y = 15; canvas->drawString(" colorType bytes", 10, y, paint); for (SkColorType colorType : { #list_of_color_types# } ) { bool result = SkColorTypeIsAlwaysOpaque(colorType); SkString string; string.printf("%13s %6s", colors[(int) colorType], result ? "true" : "false"); canvas->drawString(string, 10, y += 14, font, paint); } ## #SeeAlso SkColorTypeValidateAlphaType ## # ------------------------------------------------------------------------------ #Method bool SkColorTypeValidateAlphaType(SkColorType colorType, SkAlphaType alphaType, SkAlphaType* canonical = nullptr) #In Property #Line # returns if Alpha_Type is valid ## #Populate #Example #Height 640 const char* colors[] = { "Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16" }; const char* alphas[] = {"Unknown ", "Opaque ", "Premul ", "Unpremul"}; SkAlphaType alphaTypes[] = { #list_of_alpha_types# }; SkPaint paint; SkFont font(SkTypeface::MakeFromName("monospace", SkFontStyle()), 10); int y = 15; canvas->drawString(" colorType alphaType canonical", 10, y, paint); for (SkColorType colorType : { #list_of_color_types# } ) { for (SkAlphaType alphaType : alphaTypes) { SkAlphaType canonicalAlphaType = kUnknown_SkAlphaType; bool result = SkColorTypeValidateAlphaType(colorType, alphaType, &canonicalAlphaType); SkString string; string.printf("%13s %10s %10s", colors[(int) colorType], alphas[(int) alphaType], result ? alphas[(int) canonicalAlphaType] : "------ "); canvas->drawString(string, 10, y += 14, paint); } } ## #SeeAlso SkColorTypeIsAlwaysOpaque ## # ------------------------------------------------------------------------------ #Subtopic YUV_ColorSpace #Line # color range of YUV pixels ## #Alias YUV_ColorSpace ## #Enum SkYUVColorSpace #Line # color range of YUV pixels ## #Code #Populate ## Describes color range of YUV pixels. The color mapping from YUV to RGB varies depending on the source. YUV pixels may be generated by JPEG images, standard video streams, or high definition video streams. Each has its own mapping from YUV and RGB. JPEG YUV values encode the full range of 0 to 255 for all three components. Video YUV values range from 16 to 235 for all three components. Details of encoding and conversion to RGB are described in #A YCbCr color space # https://en.wikipedia.org/wiki/YCbCr ## . #Const kJPEG_SkYUVColorSpace 0 #Line # describes full range ## Describes standard JPEG color space; #A CCIR 601 # https://en.wikipedia.org/wiki/Rec._601 ## with full range of 0 to 255 for components. ## #Const kRec601_SkYUVColorSpace 1 #Line # describes SDTV range ## Describes standard used by standard definition television; #A CCIR 601 # https://en.wikipedia.org/wiki/Rec._601 ## with studio range of 16 to 235 range for components. ## #Const kRec709_SkYUVColorSpace 2 #Line # describes HDTV range ## Describes standard used by high definition television; #A Rec. 709 # https://en.wikipedia.org/wiki/Rec._709 ## with studio range of 16 to 235 range for components. ## #Const kLastEnum_SkYUVColorSpace 2 #Line # last valid value ## Used by tests to iterate through all valid values. ## #NoExample ## #SeeAlso SkImage::MakeFromYUVTexturesCopy SkImage::MakeFromNV12TexturesCopy #Enum SkYUVColorSpace ## #Subtopic YUV_ColorSpace ## # ------------------------------------------------------------------------------ #Struct SkImageInfo #Code #Populate ## Describes pixel dimensions and encoding. Bitmap, Image, Pixmap, and Surface can be created from Image_Info. Image_Info can be retrieved from Bitmap and Pixmap, but not from Image and Surface. For example, Image and Surface implementations may defer pixel depth, so may not completely specify Image_Info. Image_Info contains dimensions, the pixel integral width and height. It encodes how pixel bits describe Color_Alpha, transparency; Color components red, blue, and green; and Color_Space, the range and linearity of colors. # ------------------------------------------------------------------------------ #Method SkImageInfo() #In Constructors #Line # creates with zeroed dimensions, kUnknown_SkColorType, kUnknown_SkAlphaType ## #Populate #Example #Height 32 #Description An empty Image_Info may be passed to SkCanvas::accessTopLayerPixels as storage for the Canvas actual Image_Info. ## SkImageInfo imageInfo; size_t rowBytes; SkIPoint origin; (void) canvas->accessTopLayerPixels(&imageInfo, &rowBytes, &origin); const char* alphaType[] = { "Unknown", "Opaque", "Premul", "Unpremul" }; SkString string; string.printf("k%s_SkAlphaType", alphaType[(int) imageInfo.alphaType()]); SkPaint paint; canvas->drawString(string, 20, 20, paint); ## #SeeAlso Make MakeN32 MakeS32 MakeA8 #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo Make(int width, int height, SkColorType ct, SkAlphaType at, sk_sp cs = nullptr) #In Constructors #Line # creates Image_Info from dimensions, Color_Type, Alpha_Type, Color_Space ## #Populate #Example #Height 48 uint8_t storage[][5] = {{ 0xCA, 0xDA, 0xCA, 0xC9, 0xA3 }, { 0xAC, 0xA8, 0x89, 0xA7, 0x87 }, { 0x9B, 0xB5, 0xE5, 0x95, 0x46 }, { 0x90, 0x81, 0xC5, 0x71, 0x33 }, { 0x75, 0x55, 0x44, 0x40, 0x30 }}; SkImageInfo imageInfo = SkImageInfo::Make(5, 5, kGray_8_SkColorType, kOpaque_SkAlphaType); SkPixmap pixmap(imageInfo, storage[0], sizeof(storage) / 5); SkBitmap bitmap; bitmap.installPixels(pixmap); canvas->scale(8, 8); canvas->drawBitmap(bitmap, 0, 0); ## #SeeAlso MakeN32 MakeN32Premul MakeS32 MakeA8 #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeN32(int width, int height, SkAlphaType at, sk_sp cs = nullptr) #In Constructors #Line # creates Image_Info with Native_Color_Type ## #Populate #Example #Height 128 SkBitmap bitmap; bitmap.allocPixels(SkImageInfo::MakeN32(16, 16, kPremul_SkAlphaType)); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorWHITE); SkPaint paint; offscreen.drawString("g", 0, 10, paint); canvas->scale(8, 8); canvas->drawBitmap(bitmap, 0, 0); ## #SeeAlso Make MakeN32Premul MakeS32 MakeA8 #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeS32(int width, int height, SkAlphaType at) #In Constructors #Line # creates Image_Info with Native_Color_Type, sRGB Color_Space ## #Populate #Example #Set sRGB #Height 128 #Description Top gradient is drawn to offScreen without Color_Space. It is darker than middle gradient, drawn to offScreen with sRGB Color_Space. Bottom gradient shares bits with middle, but does not specify the Color_Space in noColorSpaceBitmap. A source without Color_Space is treated as sRGB; the bottom gradient is identical to the middle gradient. ## const int width = 256; const int height = 32; SkImageInfo info = SkImageInfo::MakeN32Premul(width, height); SkColor gradColors[] = { 0xFFAA0055, 0xFF11CC88 }; SkPoint gradPoints[] = { { 0, 0 }, { width, 0 } }; SkPaint gradPaint; gradPaint.setShader(SkGradientShader::MakeLinear(gradPoints, gradColors, nullptr, SK_ARRAY_COUNT(gradColors), SkShader::kClamp_TileMode)); SkBitmap bitmap; bitmap.allocPixels(SkImageInfo::MakeN32(width, height, kPremul_SkAlphaType)); SkCanvas offScreen(bitmap); offScreen.drawRect(SkRect::MakeWH(width, height), gradPaint); canvas->drawBitmap(bitmap, 0, 0); bitmap.allocPixels(SkImageInfo::MakeS32(width, height, kPremul_SkAlphaType)); SkCanvas sRGBOffscreen(bitmap); sRGBOffscreen.drawRect(SkRect::MakeWH(width, height), gradPaint); canvas->drawBitmap(bitmap, 0, 48); SkBitmap noColorSpaceBitmap; noColorSpaceBitmap.setInfo(SkImageInfo::MakeN32(width, height, kPremul_SkAlphaType)); noColorSpaceBitmap.setPixels(bitmap.getAddr(0, 0)); canvas->drawBitmap(noColorSpaceBitmap, 0, 96); ## #SeeAlso Make MakeN32 MakeN32Premul MakeA8 #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeN32Premul(int width, int height, sk_sp cs = nullptr) #In Constructors #Line # creates Image_Info with Native_Color_Type, kPremul_SkAlphaType ## #Populate #Example #Height 128 SkBitmap bitmap; bitmap.allocPixels(SkImageInfo::MakeN32Premul(18, 18)); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorWHITE); SkPaint paint; SkFont font(nullptr, 15); offscreen.drawString("\xF0\x9F\x98\xB8", 1, 15, font, paint); canvas->scale(6, 6); canvas->drawBitmap(bitmap, 0, 0); ## #SeeAlso MakeN32 MakeS32 MakeA8 Make #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeN32Premul(const SkISize& size) #In Constructors #Populate #Example #Height 128 SkBitmap bitmap; bitmap.allocPixels(SkImageInfo::MakeN32Premul({18, 18})); SkCanvas offscreen(bitmap); offscreen.clear(SK_ColorWHITE); SkPaint paint; SkFont font(nullptr, 15); offscreen.drawString("\xF0\x9F\x98\xB9", 1, 15, font, paint); canvas->scale(6, 6); canvas->drawBitmap(bitmap, 0, 0); ## #SeeAlso MakeN32 MakeS32 MakeA8 Make #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeA8(int width, int height) #In Constructors #Line # creates Image_Info with kAlpha_8_SkColorType, kPremul_SkAlphaType ## #Populate #Example #Height 64 uint8_t pixels[][8] = { { 0x00, 0x00, 0x3f, 0x00, 0x00, 0x00, 0x00, 0x00}, { 0x00, 0x7f, 0xff, 0x3f, 0x3f, 0x7f, 0x3f, 0x00}, { 0x3f, 0xff, 0x7f, 0x00, 0x7f, 0xff, 0x7f, 0x00}, { 0x00, 0x3f, 0x00, 0x00, 0x3f, 0x7f, 0x3f, 0x00}, { 0x3f, 0x7f, 0x7f, 0x3f, 0x00, 0x00, 0x00, 0x00}, { 0x7f, 0xff, 0xff, 0x7f, 0x00, 0x3f, 0x7f, 0x3f}, { 0x7f, 0xff, 0xff, 0x7f, 0x00, 0x7f, 0xff, 0x7f}, { 0x3f, 0x7f, 0x7f, 0x3f, 0x00, 0x3f, 0x7f, 0x3f} }; SkBitmap bitmap; bitmap.installPixels(SkImageInfo::MakeA8(8, 8), (void*) pixels, sizeof(pixels[0])); SkPaint paint; canvas->scale(4, 4); for (auto color : { SK_ColorRED, SK_ColorBLUE, 0xFF007F00} ) { paint.setColor(color); canvas->drawBitmap(bitmap, 0, 0, &paint); canvas->translate(12, 0); } ## #SeeAlso MakeN32 MakeS32 Make #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeUnknown(int width, int height) #In Constructors #Line # creates Image_Info with kUnknown_SkColorType, kUnknown_SkAlphaType ## #Populate #Example #Height 32 #Width 384 SkImageInfo info; // default constructor SkString string; string.printf("SkImageInfo() %c= SkImageInfo::MakeUnknown(0, 0)", info == SkImageInfo::MakeUnknown(0, 0) ? '=' : '!'); SkPaint paint; canvas->drawString(string, 0, 12, paint); ## #SeeAlso SkImageInfo() MakeN32 MakeS32 Make #Method ## # ------------------------------------------------------------------------------ #Method static SkImageInfo MakeUnknown() #In Constructors #Populate #Example #Height 32 #Width 384 SkImageInfo info; // default constructor SkString string; string.printf("SkImageInfo() %c= SkImageInfo::MakeUnknown()", info == SkImageInfo::MakeUnknown() ? '=' : '!'); SkPaint paint; canvas->drawString(string, 0, 12, paint); ## #SeeAlso SkImageInfo() MakeN32 MakeS32 Make #Method ## # ------------------------------------------------------------------------------ #Subtopic Property #Line # metrics and attributes ## ## #Method int width() const #In Property #Line # returns pixel column count ## #Populate #Example #Image 4 #Height 96 canvas->translate(10, 10); canvas->drawBitmap(source, 0, 0); SkImageInfo imageInfo = source.info(); canvas->translate(0, imageInfo.height()); SkPaint paint; canvas->drawLine(0, 10, imageInfo.width(), 10, paint); canvas->drawString("width", imageInfo.width() / 2 - 15, 25, paint); ## #SeeAlso height SkBitmap::width SkPixelRef::width SkImage::width SkSurface::width #Method ## # ------------------------------------------------------------------------------ #Method int height() const #In Property #Line # returns pixel row count ## #Populate #Example #Image 4 #Height 96 canvas->translate(10, 20); canvas->drawBitmap(source, 0, 0); SkImageInfo imageInfo = source.info(); SkPaint paint; canvas->drawLine(imageInfo.width() + 10, 0, imageInfo.width() + 10, imageInfo.height(), paint); canvas->drawString("height", imageInfo.width() + 15, imageInfo.height() / 2, paint); ## #SeeAlso width SkBitmap::height SkPixelRef::height SkImage::height SkSurface::height #Method ## # ------------------------------------------------------------------------------ #Method SkColorType colorType() const #In Property #Line # returns Color_Type ## Returns Color_Type, one of: #list_of_color_types#. #Return Color_Type ## #Example const char* colors[] = {"Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16"}; SkImageInfo info = SkImageInfo::MakeA8(16, 32); SkDebugf("color type: k" "%s" "_SkColorType\n", colors[info.colorType()]); #StdOut color type: kAlpha_8_SkColorType ## ## #SeeAlso alphaType SkPixmap::colorType SkBitmap::colorType #Method ## # ------------------------------------------------------------------------------ #Method SkAlphaType alphaType() const #In Property #Line # returns Alpha_Type ## Returns Alpha_Type, one of: #list_of_alpha_types#. #Return Alpha_Type ## #Example const char* alphas[] = {"Unknown", "Opaque", "Premul", "Unpremul"}; SkImageInfo info = SkImageInfo::MakeA8(16, 32); SkDebugf("alpha type: k" "%s" "_SkAlphaType\n", alphas[info.alphaType()]); #StdOut alpha type: kPremul_SkAlphaType ## ## #SeeAlso colorType SkPixmap::alphaType SkBitmap::alphaType #Method ## # ------------------------------------------------------------------------------ #Method SkColorSpace* colorSpace() const #In Property #Line # returns Color_Space ## #Populate #Example #Description SkColorSpace::MakeSRGBLinear creates Color_Space with linear gamma and an sRGB gamut. This Color_Space gamma is not close to sRGB gamma. ## SkImageInfo info = SkImageInfo::MakeN32(16, 32, kPremul_SkAlphaType, SkColorSpace::MakeSRGBLinear()); SkColorSpace* colorSpace = info.colorSpace(); SkDebugf("gammaCloseToSRGB: %s gammaIsLinear: %s isSRGB: %s\n", colorSpace->gammaCloseToSRGB() ? "true" : "false", colorSpace->gammaIsLinear() ? "true" : "false", colorSpace->isSRGB() ? "true" : "false"); #StdOut gammaCloseToSRGB: false gammaIsLinear: true isSRGB: false ## ## #SeeAlso Color_Space SkPixmap::colorSpace SkBitmap::colorSpace #Method ## # ------------------------------------------------------------------------------ #Method sk_sp refColorSpace() const #In Property #Line # returns Color_Space ## #Populate #Example SkImageInfo info1 = SkImageInfo::MakeN32(16, 32, kPremul_SkAlphaType, SkColorSpace::MakeSRGBLinear()); SkImageInfo info2 = SkImageInfo::MakeN32(16, 32, kPremul_SkAlphaType, info1.refColorSpace()); SkColorSpace* colorSpace = info2.colorSpace(); SkDebugf("gammaCloseToSRGB: %s gammaIsLinear: %s isSRGB: %s\n", colorSpace->gammaCloseToSRGB() ? "true" : "false", colorSpace->gammaIsLinear() ? "true" : "false", colorSpace->isSRGB() ? "true" : "false"); ## #SeeAlso Color_Space SkBitmap::refColorSpace #Method ## # ------------------------------------------------------------------------------ #Method bool isEmpty() const #In Property #Line # returns if dimensions contain pixels ## #Populate #Example for (int width : { 0, 2 } ) { for (int height : { 0, 2 } ) { SkImageInfo imageInfo= SkImageInfo::MakeA8(width, height); SkDebugf("width: %d height: %d empty: %s\n", width, height, imageInfo.isEmpty() ? "true" : "false"); } } #StdOut width: 0 height: 0 empty: true width: 0 height: 2 empty: true width: 2 height: 0 empty: true width: 2 height: 2 empty: false ## ## #SeeAlso dimensions bounds SkBitmap::empty SkPixmap::bounds #Method ## # ------------------------------------------------------------------------------ #Method bool isOpaque() const #In Property #Line # returns if Alpha_Type is kOpaque_SkAlphaType ## #Populate #Example const int height = 2; const int width = 2; SkBitmap bitmap; SkImageInfo imageInfo = SkImageInfo::Make(width, height, kN32_SkColorType, kPremul_SkAlphaType); bitmap.setInfo(imageInfo); for (int index = 0; index < 2; ++index) { bitmap.allocPixels(); bitmap.eraseColor(0x00000000); SkDebugf("isOpaque: %s\n", imageInfo.isOpaque() ? "true" : "false"); bitmap.eraseColor(0xFFFFFFFF); SkDebugf("isOpaque: %s\n", imageInfo.isOpaque() ? "true" : "false"); imageInfo = imageInfo.makeAlphaType(kOpaque_SkAlphaType); bitmap.setInfo(imageInfo); } #StdOut isOpaque: false isOpaque: false isOpaque: true isOpaque: true ## ## #SeeAlso Color_Alpha SkColorTypeValidateAlphaType SkBitmap::isOpaque SkImage::isOpaque SkPixmap::isOpaque #Method ## # ------------------------------------------------------------------------------ #Method SkISize dimensions() const #In Property #Line # returns width() and height() ## #Populate #Example const int height = 2; const int width = 2; SkImageInfo imageInfo = SkImageInfo::Make(width, height, kN32_SkColorType, kPremul_SkAlphaType); SkISize dimensions = imageInfo.dimensions(); SkIRect bounds = imageInfo.bounds(); SkIRect dimensionsAsBounds = SkIRect::MakeSize(dimensions); SkDebugf("dimensionsAsBounds %c= bounds\n", dimensionsAsBounds == bounds ? '=' : '!'); #StdOut dimensionsAsBounds == bounds ## ## #SeeAlso width height bounds SkBitmap::dimensions #Method ## # ------------------------------------------------------------------------------ #Method SkIRect bounds() const #In Property #Line # returns width() and height() as Rectangle ## #Populate #Example #Height 64 #Image 4 canvas->scale(.5f, .5f); SkImageInfo imageInfo = source.info(); SkIRect bounds = imageInfo.bounds(); for (int x : { 0, bounds.width() } ) { for (int y : { 0, bounds.height() } ) { canvas->drawBitmap(source, x, y); } } ## #SeeAlso width height dimensions #Method ## # ------------------------------------------------------------------------------ #Method bool gammaCloseToSRGB() const #In Property #Line # returns if Color_Space gamma is approximately the same as sRGB ## Returns true if associated Color_Space is not nullptr, and Color_Space gamma is approximately the same as sRGB. This includes the ###$ $A sRGB transfer function $ https://en.wikipedia.org/wiki/SRGB#The_sRGB_transfer_function_(%22gamma%22) $$ $$$# as well as a gamma curve described by a 2.2 exponent. #Return true if Color_Space gamma is approximately the same as sRGB ## #Example #Height 144 const int width = 256; const int height = 64; auto drawLabel = [=](const char* what, bool closeToSRGB) -> void { SkString string; string.printf("%s gamma is %s" "close to sRGB", what, closeToSRGB ? "" : "not "); SkPaint paint; paint.setAntiAlias(true); canvas->drawString(string, 20, 56, paint); }; SkColor gradColors[] = { 0xFFFF7F00, 0xFF00FF7F, 0xFF0000FF, 0xFF7F7FFF }; SkPoint gradPoints[] = { { 0, 0 }, { width, 0 }, { width * 2, 0 }, { width * 3, 0 } }; SkPaint gradPaint; gradPaint.setShader(SkGradientShader::MakeLinear(gradPoints, gradColors, nullptr, SK_ARRAY_COUNT(gradColors), SkShader::kClamp_TileMode)); canvas->drawRect(SkRect::MakeWH(width, height), gradPaint); drawLabel("canvas", canvas->imageInfo().gammaCloseToSRGB()); SkBitmap bitmap; SkImageInfo offscreenInfo = SkImageInfo::MakeS32(width, height, kPremul_SkAlphaType); bitmap.allocPixels(offscreenInfo); SkCanvas sRGBOffscreen(bitmap); sRGBOffscreen.drawRect(SkRect::MakeWH(width, height), gradPaint); canvas->translate(0, 80); canvas->drawBitmap(bitmap, 0, 0); drawLabel("offscreen", offscreenInfo.gammaCloseToSRGB()); ## #SeeAlso SkColorSpace::gammaCloseToSRGB #Method ## # ------------------------------------------------------------------------------ #Method SkImageInfo makeWH(int newWidth, int newHeight) const #In Constructors #Line # creates Image_Info with changed dimensions ## #Populate #Example #Height 144 #Image 3 SkImageInfo canvasImageInfo = canvas->imageInfo(); SkRect canvasBounds = SkRect::Make(canvasImageInfo.bounds()); canvas->drawBitmapRect(source, source.bounds(), canvasBounds, nullptr); SkImageInfo insetImageInfo = canvasImageInfo.makeWH(canvasBounds.width() / 2, canvasBounds.height() / 2); SkBitmap inset; inset.allocPixels(insetImageInfo); SkCanvas offscreen(inset); offscreen.drawBitmapRect(source, source.bounds(), SkRect::Make(inset.bounds()), nullptr); canvas->drawBitmap(inset, canvasBounds.width() / 4, canvasBounds.height() / 4); ## #SeeAlso Make makeAlphaType makeColorSpace makeColorType #Method ## # ------------------------------------------------------------------------------ #Method SkImageInfo makeAlphaType(SkAlphaType newAlphaType) const #In Constructors #Line # creates Image_Info with changed Alpha_Type ## #Populate #Example #Image 3 const int width = 256; const int height = 128; SkColor pixels[height][width]; for (int y = 0; y < height; ++y) { for (int x = 0; x < width; ++x) { int red = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarSin((x * 4 + y) * 0.03f))); int blue = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarCos((x * 3 + y) * 0.04f))); int green = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarSin((x * 2 + y) * 0.05f))); int alpha = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarCos((x * 1 + y) * 0.006f))); pixels[y][x] = SkColorSetARGB(alpha, red * alpha / 255, green * alpha / 255, blue * alpha / 255); } } SkBitmap bitmap; SkImageInfo info = SkImageInfo::Make(width, height, kBGRA_8888_SkColorType, kPremul_SkAlphaType); bitmap.installPixels(info, (void*) pixels, sizeof(SkColor) * width); canvas->drawBitmap(source, 0, 0); canvas->drawBitmap(bitmap, 0, 0); SkImageInfo unpremulInfo = info.makeAlphaType(kUnpremul_SkAlphaType); bitmap.installPixels(unpremulInfo, (void*) pixels, sizeof(SkColor) * width); canvas->drawBitmap(bitmap, 0, 128); ## #SeeAlso Make MakeA8 makeColorType makeColorSpace #Method ## # ------------------------------------------------------------------------------ #Method SkImageInfo makeColorType(SkColorType newColorType) const #In Constructors #Line # creates Image_Info with changed Color_Type ## #Populate #Example const int width = 256; const int height = 128; SkColor pixels[height][width]; for (int y = 0; y < height; ++y) { for (int x = 0; x < width; ++x) { int red = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarSin((x * 4 + y) * 0.03f))); int blue = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarCos((x * 3 + y) * 0.04f))); int green = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarSin((x * 2 + y) * 0.05f))); int alpha = SkScalarRoundToInt(255 * SkScalarAbs(SkScalarCos((x * 1 + y) * 0.006f))); pixels[y][x] = SkColorSetARGB(alpha, red * alpha / 255, green * alpha / 255, blue * alpha / 255); } } SkBitmap bitmap; SkImageInfo info = SkImageInfo::Make(width, height, kBGRA_8888_SkColorType, kPremul_SkAlphaType); bitmap.installPixels(info, (void*) pixels, sizeof(SkColor) * width); canvas->drawBitmap(source, 0, 0); canvas->drawBitmap(bitmap, 0, 0); SkImageInfo rgbaInfo = info.makeColorType(kRGBA_8888_SkColorType); bitmap.installPixels(rgbaInfo, (void*) pixels, sizeof(SkColor) * width); canvas->drawBitmap(bitmap, 0, 128); ## #SeeAlso Make makeAlphaType makeColorSpace #Method ## # ------------------------------------------------------------------------------ #Method SkImageInfo makeColorSpace(sk_sp cs) const #In Constructors #Line # creates Image_Info with changed Color_Space ## #Populate #Example #Height 224 const int width = 256; const int height = 64; auto drawLabel = [=](const char* what, bool closeToSRGB) -> void { SkString string; string.printf("%s gamma is %s" "close to sRGB", what, closeToSRGB ? "" : "not "); SkPaint paint; paint.setAntiAlias(true); canvas->drawString(string, 20, 56, paint); }; SkColor gradColors[] = { 0xFFFF7F00, 0xFF00FF7F, 0xFF0000FF, 0xFF7F7FFF }; SkPoint gradPoints[] = { { 0, 0 }, { width, 0 }, { width * 2, 0 }, { width * 3, 0 } }; SkPaint gradPaint; gradPaint.setShader(SkGradientShader::MakeLinear(gradPoints, gradColors, nullptr, SK_ARRAY_COUNT(gradColors), SkShader::kClamp_TileMode)); canvas->drawRect(SkRect::MakeWH(width, height), gradPaint); drawLabel("canvas", canvas->imageInfo().gammaCloseToSRGB()); SkBitmap bitmap; SkImageInfo offscreenInfo = SkImageInfo::MakeS32(width, height, kPremul_SkAlphaType); bitmap.allocPixels(offscreenInfo); SkCanvas sRGBOffscreen(bitmap); sRGBOffscreen.drawRect(SkRect::MakeWH(width, height), gradPaint); canvas->translate(0, 80); canvas->drawBitmap(bitmap, 0, 0); drawLabel("offscreen", offscreenInfo.gammaCloseToSRGB()); SkImageInfo linearGamma = offscreenInfo.makeColorSpace(offscreenInfo.colorSpace()->makeLinearGamma()); bitmap.allocPixels(linearGamma); SkCanvas lgOffscreen(bitmap); lgOffscreen.drawRect(SkRect::MakeWH(width, height), gradPaint); canvas->translate(0, 80); canvas->drawBitmap(bitmap, 0, 0); drawLabel("linear", linearGamma.gammaCloseToSRGB()); ## #SeeAlso Make MakeS32 makeAlphaType makeColorType #Method ## # ------------------------------------------------------------------------------ #Method int bytesPerPixel() const #In Property #Line # returns number of bytes in pixel based on Color_Type ## #Populate #Example const char* colors[] = {"Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16"}; for (SkColorType colorType : { #list_of_color_types# } ) { SkImageInfo info = SkImageInfo::Make(1, 1, colorType, kOpaque_SkAlphaType); SkDebugf("color: k" "%s" "_SkColorType" "%*s" "bytesPerPixel: %d\n", colors[colorType], 13 - strlen(colors[colorType]), " ", info.bytesPerPixel()); } #StdOut color: kUnknown_SkColorType bytesPerPixel: 0 color: kAlpha_8_SkColorType bytesPerPixel: 1 color: kRGB_565_SkColorType bytesPerPixel: 2 color: kARGB_4444_SkColorType bytesPerPixel: 2 color: kRGBA_8888_SkColorType bytesPerPixel: 4 color: kRGB_888x_SkColorType bytesPerPixel: 4 color: kBGRA_8888_SkColorType bytesPerPixel: 4 color: kRGBA_1010102_SkColorType bytesPerPixel: 4 color: kRGB_101010x_SkColorType bytesPerPixel: 4 color: kGray_8_SkColorType bytesPerPixel: 1 color: kRGBA_F16_SkColorType bytesPerPixel: 8 ## ## #SeeAlso width shiftPerPixel SkBitmap::bytesPerPixel #Method ## # ------------------------------------------------------------------------------ #Method int shiftPerPixel() const #In Property #Line # returns bit shift from pixels to bytes ## #Populate #Example const char* colors[] = {"Unknown", "Alpha_8", "RGB_565", "ARGB_4444", "RGBA_8888", "RGB_888x", "BGRA_8888", "RGBA_1010102", "RGB_101010x", "Gray_8", "RGBA_F16"}; for (SkColorType colorType : { #list_of_color_types# } ) { SkImageInfo info = SkImageInfo::Make(1, 1, colorType, kOpaque_SkAlphaType); SkDebugf("color: k" "%s" "_SkColorType" "%*s" "shiftPerPixel: %d\n", colors[colorType], 14 - strlen(colors[colorType]), " ", info.shiftPerPixel()); } #StdOut color: kUnknown_SkColorType shiftPerPixel: 0 color: kAlpha_8_SkColorType shiftPerPixel: 0 color: kRGB_565_SkColorType shiftPerPixel: 1 color: kARGB_4444_SkColorType shiftPerPixel: 1 color: kRGBA_8888_SkColorType shiftPerPixel: 2 color: kRGB_888x_SkColorType shiftPerPixel: 2 color: kBGRA_8888_SkColorType shiftPerPixel: 2 color: kRGBA_1010102_SkColorType shiftPerPixel: 2 color: kRGB_101010x_SkColorType shiftPerPixel: 2 color: kGray_8_SkColorType shiftPerPixel: 0 color: kRGBA_F16_SkColorType shiftPerPixel: 3 ## ## #SeeAlso bytesPerPixel minRowBytes SkBitmap::shiftPerPixel SkPixmap::shiftPerPixel #Method ## # ------------------------------------------------------------------------------ #Method uint64_t minRowBytes64() const #In Property #Line # returns width() times bytesPerPixel in 64 bits ## #Populate #Example for (int shift = 24; shift < 32; ++shift) { int width = 1 << shift; SkImageInfo imageInfo = SkImageInfo::Make(width, 1, kRGBA_F16_SkColorType, kPremul_SkAlphaType); uint64_t minRowBytes = imageInfo.minRowBytes64(); bool widthTooLarge = (uint64_t) (int32_t) minRowBytes != minRowBytes; SkDebugf("RGBA_F16 width %d (0x%08x) %s\n", width, width, widthTooLarge ? "too large" : "OK"); } #StdOut RGBA_F16 width 16777216 (0x01000000) OK RGBA_F16 width 33554432 (0x02000000) OK RGBA_F16 width 67108864 (0x04000000) OK RGBA_F16 width 134217728 (0x08000000) OK RGBA_F16 width 268435456 (0x10000000) too large RGBA_F16 width 536870912 (0x20000000) too large RGBA_F16 width 1073741824 (0x40000000) too large RGBA_F16 width -2147483648 (0x80000000) too large ## ## #SeeAlso minRowBytes computeByteSize computeMinByteSize validRowBytes #Method ## # ------------------------------------------------------------------------------ #Method size_t minRowBytes() const #In Property #Line # returns width() times bytesPerPixel in 32 bits ## #Populate #Example for (int shift = 24; shift < 32; ++shift) { int width = 1 << shift; SkImageInfo imageInfo = SkImageInfo::Make(width, 1, kRGBA_F16_SkColorType, kPremul_SkAlphaType); size_t minRowBytes = imageInfo.minRowBytes(); bool widthTooLarge = !minRowBytes; SkDebugf("RGBA_F16 width %d (0x%08x) %s\n", width, width, widthTooLarge ? "too large" : "OK"); } #StdOut RGBA_F16 width 16777216 (0x01000000) OK RGBA_F16 width 33554432 (0x02000000) OK RGBA_F16 width 67108864 (0x04000000) OK RGBA_F16 width 134217728 (0x08000000) OK RGBA_F16 width 268435456 (0x10000000) too large RGBA_F16 width 536870912 (0x20000000) too large RGBA_F16 width 1073741824 (0x40000000) too large RGBA_F16 width -2147483648 (0x80000000) too large ## ## #SeeAlso minRowBytes64 computeByteSize computeMinByteSize validRowBytes #Method ## # ------------------------------------------------------------------------------ #Method size_t computeOffset(int x, int y, size_t rowBytes) const #In Utility #Line # returns byte offset within pixel array ## #Populate #Example #Height 128 uint8_t pixels[][12] = { { 0x00, 0x00, 0x00, 0xFF, 0xFF, 0x00, 0x00, 0x00}, { 0x00, 0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00}, { 0x00, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00}, { 0xFF, 0xFF, 0x00, 0xFF, 0xFF, 0x00, 0xFF, 0xFF}, { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}, { 0x00, 0x00, 0xFF, 0x00, 0x00, 0xFF, 0x00, 0x00}, { 0x00, 0xFF, 0x00, 0x00, 0x00, 0x00, 0xFF, 0x00}, { 0x00, 0x00, 0xFF, 0x00, 0x00, 0xFF, 0x00, 0x00} }; SkImageInfo imageInfo = SkImageInfo::MakeA8(8, 8); SkBitmap bitmap; bitmap.installPixels(imageInfo, (void*) pixels, sizeof(pixels[0])); SkPaint paint; paint.setColor(SK_ColorRED); canvas->drawBitmapRect(bitmap, SkRect::MakeWH(8, 8), SkRect::MakeWH(32, 32), &paint); size_t offset = imageInfo.computeOffset(2, 3, sizeof(pixels[0])); pixels[0][offset] = 0x7F; offset = imageInfo.computeOffset(5, 3, sizeof(pixels[0])); pixels[0][offset] = 0x7F; bitmap.installPixels(imageInfo, (void*) pixels, sizeof(pixels[0])); canvas->drawBitmapRect(bitmap, SkRect::MakeWH(8, 8), SkRect::MakeWH(128, 128), &paint); ## #SeeAlso height width minRowBytes computeByteSize #Method ## # ------------------------------------------------------------------------------ #Method bool operator==(const SkImageInfo& other) const #Line # compares Image_Info for equality ## #Populate #Example SkImageInfo info1 = SkImageInfo::Make(10, 20, kGray_8_SkColorType, kPremul_SkAlphaType); SkImageInfo info2 = SkImageInfo::Make(20, 10, kAlpha_8_SkColorType, kUnpremul_SkAlphaType); SkDebugf("info1 %c= info2\n", info1 == info2 ? '=' : '!'); info2 = info2.makeWH(10, 20); SkDebugf("info1 %c= info2\n", info1 == info2 ? '=' : '!'); info2 = info2.makeColorType(kGray_8_SkColorType); SkDebugf("info1 %c= info2\n", info1 == info2 ? '=' : '!'); info2 = info2.makeAlphaType(kPremul_SkAlphaType); SkDebugf("info1 %c= info2\n", info1 == info2 ? '=' : '!'); #StdOut info1 != info2 info1 != info2 info1 != info2 info1 == info2 ## ## #SeeAlso operator!=(const SkImageInfo& other) const SkColorSpace::Equals #Method ## # ------------------------------------------------------------------------------ #Method bool operator!=(const SkImageInfo& other) const #Line # compares Image_Info for inequality ## #Populate #Example SkImageInfo info1 = SkImageInfo::Make(10, 20, kGray_8_SkColorType, kPremul_SkAlphaType); SkImageInfo info2 = SkImageInfo::Make(20, 10, kAlpha_8_SkColorType, kUnpremul_SkAlphaType); SkDebugf("info1 %c= info2\n", info1 != info2 ? '!' : '='); info2 = info2.makeWH(10, 20); SkDebugf("info1 %c= info2\n", info1 != info2 ? '!' : '='); info2 = info2.makeColorType(kGray_8_SkColorType); SkDebugf("info1 %c= info2\n", info1 != info2 ? '!' : '='); info2 = info2.makeAlphaType(kPremul_SkAlphaType); SkDebugf("info1 %c= info2\n", info1 != info2 ? '!' : '='); #StdOut info1 != info2 info1 != info2 info1 != info2 info1 == info2 ## ## #SeeAlso operator==(const SkImageInfo& other) const SkColorSpace::Equals #Method ## # ------------------------------------------------------------------------------ #Method size_t computeByteSize(size_t rowBytes) const #In Utility #Line # returns memory required by pixel buffer with given row bytes ## #Populate #Example #Height 130 SkImageInfo info = SkImageInfo::MakeN32Premul(2, 2); const size_t size = info.computeByteSize(100000); SkAutoTMalloc storage(size); SkPMColor* pixels = storage.get(); SkBitmap bitmap; bitmap.setInfo(info); bitmap.setPixels(pixels); bitmap.eraseColor(SK_ColorRED); canvas->scale(50, 50); canvas->rotate(8); canvas->drawBitmap(bitmap, 2, 0); ## #SeeAlso computeMinByteSize validRowBytes #Method ## # ------------------------------------------------------------------------------ #Method size_t computeMinByteSize() const #In Utility #Line # returns least memory required by pixel buffer ## #Populate #Example #Height 130 SkImageInfo info = SkImageInfo::MakeN32Premul(2, 2); const size_t size = info.computeMinByteSize(); SkAutoTMalloc storage(size); SkPMColor* pixels = storage.get(); SkBitmap bitmap; bitmap.setInfo(info); bitmap.setPixels(pixels); bitmap.eraseColor(SK_ColorRED); canvas->scale(50, 50); canvas->rotate(8); canvas->drawBitmap(bitmap, 2, 0); ## #SeeAlso computeByteSize validRowBytes #Method ## # ------------------------------------------------------------------------------ #Method static bool ByteSizeOverflowed(size_t byteSize) #In Utility #Line # checks result of computeByteSize and computeMinByteSize ## #Populate #Example SkImageInfo info = SkImageInfo::MakeN32Premul(2, 1000000000); for (size_t rowBytes = 100000000; rowBytes < 10000000000000LL; rowBytes *= 10) { const size_t size = info.computeByteSize(rowBytes); SkDebugf("rowBytes:%llu size:%llu overflowed:%s\n", rowBytes, size, SkImageInfo::ByteSizeOverflowed(size) ? "true" : "false"); } #StdOut rowBytes:100000000 size:99999999900000008 overflowed:false rowBytes:1000000000 size:999999999000000008 overflowed:false rowBytes:10000000000 size:9999999990000000008 overflowed:false rowBytes:100000000000 size:18446744073709551615 overflowed:true rowBytes:1000000000000 size:18446744073709551615 overflowed:true ## ## #SeeAlso computeByteSize computeMinByteSize validRowBytes #Method ## # ------------------------------------------------------------------------------ #Method bool validRowBytes(size_t rowBytes) const #In Utility #Line # checks if row bytes is large enough to contain pixel row ## #Populate #Example SkImageInfo info = SkImageInfo::MakeN32Premul(16, 8); for (size_t rowBytes = 60; rowBytes < 72; rowBytes += sizeof(SkPMColor)) { SkDebugf("validRowBytes(%llu): %s\n", rowBytes, info.validRowBytes(rowBytes) ? "true" : "false"); } #StdOut validRowBytes(60): false validRowBytes(64): true validRowBytes(68): true ## ## #SeeAlso ByteSizeOverflowed computeByteSize computeMinByteSize #Method ## # ------------------------------------------------------------------------------ #Method void reset() #In Constructors #Line # sets zero dimensions, kUnknown_SkColorType, kUnknown_SkAlphaType ## #Populate #Example SkImageInfo info = SkImageInfo::MakeN32Premul(16, 8); SkImageInfo copy = info; SkDebugf("info %c= copy\n", info == copy ? '=' : '!'); copy.reset(); SkDebugf("info %c= reset copy\n", info == copy ? '=' : '!'); SkDebugf("SkImageInfo() %c= reset copy\n", SkImageInfo() == copy ? '=' : '!'); #StdOut info == copy info != reset copy SkImageInfo() == reset copy ## ## #SeeAlso SkImageInfo() #Method ## # ------------------------------------------------------------------------------ #Subtopic Utility #Line # rarely called management functions ## ## #Method void validate() const #In Utility #Line # asserts if Image_Info is invalid (debug only) ## #Populate #NoExample ## #SeeAlso validRowBytes SkBitmap::validate #Method ## #Struct SkImageInfo ## #Topic Image_Info ##