skia2/docs/SkColor4f_Reference.bmh
Cary Clark b94f6da248 fix define comments
add generated comment for includes

R=caryclark@google.com

Docs-Preview: https://skia.org/?cl=132924
Bug: skia:6898
Change-Id: I42034e2753ed079dd0d0e3ae99f976d32ffaf77a
Reviewed-on: https://skia-review.googlesource.com/132924
Reviewed-by: Cary Clark <caryclark@skia.org>
Auto-Submit: Cary Clark <caryclark@skia.org>
Commit-Queue: Cary Clark <caryclark@skia.org>
2018-06-08 16:31:02 +00:00

305 lines
8.0 KiB
Plaintext

#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.0578054 green=0.246201 blue=0.603827 alpha=0.533333
[0]=0.0578054 [1]=0.246201 [2]=0.603827 [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.0578054 green=0.246201 blue=0.603827 alpha=0.533333
[0]=0.0578054 [1]=0.246201 [2]=0.603827 [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.0742136 green=0.130136 blue=0.318547 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=75 green=101 blue=153 alpha=43
red=0.0703601 green=0.130136 blue=0.318547 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 SkPM4f premul() const
#In Utility
#Line # returns Premultiplied color; internal use only ##
#Private
Internal use only.
##
#Return Premultiplied color ##
#Method ##
#Struct SkColor4f ##
#Struct SkPM4f
#Private
Internal use only.
##
##
#Topic Color4f ##