| #Topic Color4f |
| #Alias Color4f_Reference ## |
| |
| #Struct SkColor4f |
| |
| Each component is stored as a 32-bit single precision floating point float value. |
| All values are allowed, but only the range from zero to one is meaningful. |
| |
| Each component is independent of the others; fA Alpha is not Premultiplied |
| with fG green, fB blue, or fR red. |
| |
| Values smaller than zero or larger than one are allowed. Values out of range |
| may be used with Blend_Mode so that the final component is in range. |
| |
| #Subtopic Overview |
| #Populate |
| ## |
| |
| #Subtopic Operator |
| #Populate |
| ## |
| |
| #Subtopic Member_Function |
| #Populate |
| ## |
| |
| #Member float fR |
| #Line # red component ## |
| Single precision float for red ranges from no red (0.0) to full red (1.0). |
| ## |
| |
| #Member float fG |
| #Line # green component ## |
| Single precision float for green ranges from no green (0.0) to full green (1.0). |
| ## |
| |
| #Member float fB |
| #Line # blue component ## |
| Single precision float for blue ranges from no blue (0.0) to full blue (1.0). |
| ## |
| |
| #Member float fA |
| #Line # alpha component ## |
| Single precision float for Alpha ranges from no Alpha (0.0) to full Alpha (1.0). |
| ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method bool operator==(const SkColor4f& other)_const |
| #In Operator |
| #Line # compares Color4f for equality ## |
| |
| Compares Color4f with other, and returns true if all components are equivalent. |
| |
| #Param other Color4f to compare ## |
| |
| #Return true if Color4f equals other ## |
| |
| #Example |
| SkColor4f colorRed = { 1, 0, 0, 1 };
|
| SkColor4f colorNamedRed = SkColor4f::FromColor(SK_ColorRED);
|
| SkDebugf("colorRed %c= colorNamedRed", colorRed == colorNamedRed ? '=' : '!');
|
| #StdOut |
| colorRed == colorNamedRed |
| ## |
| ## |
| |
| #SeeAlso operator!=(const SkColor4f& other)_const |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method bool operator!=(const SkColor4f& other)_const |
| #In Operator |
| #Line # compares colors for inequality ## |
| |
| Compares Color4f with other, and returns true if all components are not |
| equivalent. |
| |
| #Param other Color4f to compare ## |
| |
| #Return true if Color4f is not equal to other ## |
| |
| #Example |
| SkColor4f colorGray = { .5, .5, .5, 1 };
|
| SkColor4f colorNamedGray = SkColor4f::FromColor(SK_ColorGRAY);
|
| SkDebugf("colorGray %c= colorNamedGray ", colorGray != colorNamedGray ? '!' : '=');
|
| #StdOut |
| colorGray != colorNamedGray |
| ## |
| ## |
| |
| #SeeAlso operator==(const SkColor4f& other)_const |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method const float* vec() const |
| #In Property |
| #Line # returns array of components ## |
| |
| Returns Color4f components as a read-only array. |
| |
| #Return components as read-only array ## |
| |
| #Example |
| SkColor4f color = SkColor4f::FromColor(0x884488CC);
|
| SkDebugf("red=%g green=%g blue=%g alpha=%g\n", color.fR, color.fG, color.fB, color.fA);
|
| const float* array = color.vec();
|
| SkDebugf("[0]=%g [1]=%g [2]=%g [3]=%g\n", array[0], array[1], array[2], array[3]);
|
| #StdOut |
| red=0.266667 green=0.533333 blue=0.8 alpha=0.533333
|
| [0]=0.266667 [1]=0.533333 [2]=0.8 [3]=0.533333 |
| ## |
| ## |
| |
| #SeeAlso SkColor4f |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method float* vec() |
| #In Property |
| #Line # returns array of components ## |
| |
| Returns Color4f components as a writable array. |
| |
| #Return components as writable array ## |
| |
| #Example |
| SkColor4f color = SkColor4f::FromColor(0x884488CC);
|
| SkDebugf("red=%g green=%g blue=%g alpha=%g\n", color.fR, color.fG, color.fB, color.fA);
|
| float* array = color.vec();
|
| array[3] = 1;
|
| SkDebugf("[0]=%g [1]=%g [2]=%g [3]=%g\n", array[0], array[1], array[2], array[3]); |
| #StdOut |
| red=0.266667 green=0.533333 blue=0.8 alpha=0.533333
|
| [0]=0.266667 [1]=0.533333 [2]=0.8 [3]=1 |
| ## |
| ## |
| |
| #SeeAlso SkColor4f |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method static SkColor4f Pin(float r, float g, float b, float a) |
| #In Utility |
| #Line # sets components to valid range ## |
| |
| Constructs and returns Color4f with each component pinned from zero to one. |
| |
| #Param r red component ## |
| #Param g green component ## |
| #Param b blue component ## |
| #Param a Alpha component ## |
| |
| #Return Color4f with valid components ## |
| |
| #Example |
| #Height 40 |
| uint32_t storage[8]; |
| SkImageInfo info = SkImageInfo::MakeN32Premul(8, 1); |
| SkPixmap pixmap(info, storage, info.minRowBytes()); |
| pixmap.erase(SK_ColorWHITE); |
| SkIRect bounds = {0, 0, 1, 1}; |
| SkColor4f colors[] = { SkColor4f::Pin(1.5, 0.45f, 0.0, 1), |
| SkColor4f::Pin(1, 0.45f, -0.25, 1), |
| {1.5, 0.45f, 0.0, 1}, |
| {1, 0.45f, -0.25, 1}, |
| }; |
| for (auto color4f : colors) { |
| pixmap.erase(color4f, &bounds); |
| bounds.offset(2, 0); |
| } |
| SkBitmap bitmap; |
| canvas->scale(20, 20); |
| bitmap.installPixels(pixmap); |
| canvas->drawBitmap(bitmap, 0, 0); |
| ## |
| |
| #SeeAlso pin() FromColor |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method static SkColor4f FromColor(SkColor) |
| #In Utility |
| #Line # sets components from Color ## |
| |
| Converts to closest Color4f. |
| |
| #Param SkColor Color with Alpha, red, blue, and green components ## |
| |
| #Return Color4f equivalent ## |
| |
| #Example |
| uint8_t red = 77, green = 101, blue = 153, alpha = 43;
|
| SkColor argb = SkColorSetARGB(alpha, red, green, blue);
|
| SkColor4f color4f = SkColor4f::FromColor(argb);
|
| SkDebugf("red=%g green=%g blue=%g alpha=%g\n", color4f.fR, color4f.fG, color4f.fB, color4f.fA);
|
| SkColor fromColor4f = color4f.toSkColor();
|
| SkDebugf("red=%d green=%d blue=%d alpha=%d\n", SkColorGetR(fromColor4f),
|
| SkColorGetG(fromColor4f), SkColorGetB(fromColor4f), SkColorGetA(fromColor4f)); |
| #StdOut |
| red=0.301961 green=0.396078 blue=0.6 alpha=0.168627
|
| red=77 green=101 blue=153 alpha=43 |
| ## |
| ## |
| |
| #SeeAlso toSkColor |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method SkColor toSkColor() const |
| #In Utility |
| #Line # returns closest Color ## |
| |
| Converts to closest SkColor. |
| |
| #Return closest Color ## |
| |
| #Example |
| float red = 0.07, green = 0.13, blue = 0.32, alpha = 0.17;
|
| SkColor4f color4f = { red, green, blue, alpha };
|
| SkColor argb = color4f.toSkColor();
|
| SkDebugf("red=%d green=%d blue=%d alpha=%d\n", SkColorGetR(argb),
|
| SkColorGetG(argb), SkColorGetB(argb), SkColorGetA(argb)); |
| SkColor4f fromSkColor = SkColor4f::FromColor(argb);
|
| SkDebugf("red=%g green=%g blue=%g alpha=%g\n", fromSkColor.fR, fromSkColor.fG,
|
| fromSkColor.fB, fromSkColor.fA);
|
| #StdOut
|
| red=18 green=33 blue=82 alpha=43
|
| red=0.0705882 green=0.129412 blue=0.321569 alpha=0.168627
|
| ##
|
| ## |
| |
| #SeeAlso FromColor |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method SkColor4f pin() const |
| #In Utility |
| #Line # sets components to valid range ## |
| |
| Returns Color4f with all components in the range from zero to one. |
| |
| #Return Color4f with valid components ## |
| |
| #Example |
| #Height 40 |
| uint32_t storage[8]; |
| SkImageInfo info = SkImageInfo::MakeN32Premul(8, 1); |
| SkPixmap pixmap(info, storage, info.minRowBytes()); |
| pixmap.erase(SK_ColorWHITE); |
| SkIRect bounds = {0, 0, 1, 1}; |
| SkColor4f colors[] = { {1.5, 0.45f, 0.0, 1}, |
| {1, 0.45f, -0.25, 1}, |
| }; |
| for (auto color4f : colors) { |
| pixmap.erase(color4f, &bounds); |
| bounds.offset(2, 0); |
| pixmap.erase(color4f.pin(), &bounds); |
| bounds.offset(2, 0); |
| } |
| SkBitmap bitmap; |
| canvas->scale(20, 20); |
| bitmap.installPixels(pixmap); |
| canvas->drawBitmap(bitmap, 0, 0); |
| ## |
| |
| #SeeAlso Pin |
| |
| #Method ## |
| |
| # ------------------------------------------------------------------------------ |
| |
| #Method SkColor4f premul() const |
| #In Utility |
| #Line # returns Premultiplied color ## |
| |
| Returns SkColor4f with all components premultiplied by Alpha. |
| |
| #Return Premultiplied color ## |
| |
| #NoExample |
| ## |
| |
| #SeeAlso unpremul |
| |
| #Method ## |
| |
| #Method SkColor4f unpremul() const |
| #In Utility |
| #Line # returns Unpremultiplied color ## |
| |
| Returns SkColor4f with all components independent of Alpha. |
| |
| #Return Unpremultiplied color ## |
| |
| #NoExample |
| ## |
| |
| #SeeAlso premul |
| |
| #Method ## |
| |
| #Method SkPM4f toPM4f() const |
| #Line # is for internal use only ## |
| |
| #Private |
| Internal use only. |
| ## |
| #Return premultiplied color ## |
| #Method ## |
| |
| #Struct SkColor4f ## |
| |
| #Struct SkPM4f |
| #Private |
| Internal use only. |
| ## |
| ## |
| |
| #Topic Color4f ## |
