Struct palette::Rgb
[−]
[src]
pub struct Rgb<T: Float = f32> { pub red: T, pub green: T, pub blue: T, }
Linear RGB.
RGB is probably the most common color space, when it comes to computer graphics, and it's defined as an additive mixture of red, green and blue light, where gray scale colors are created when these three channels are equal in strength. This particular RGB type is based on the ITU-R BT.709 primaries, which makes it a linear version of sRGB.
Conversions and operations on this color space assumes that it's linear,
meaning that gamma correction is required when converting to and from a
displayable RGB, such as sRGB. See the pixel
module
for encoding types.
Fields
red: T
The amount of red light, where 0.0 is no red light and 1.0 is the highest displayable amount.
green: T
The amount of green light, where 0.0 is no green light and 1.0 is the highest displayable amount.
blue: T
The amount of blue light, where 0.0 is no blue light and 1.0 is the highest displayable amount.
Methods
impl<T: Float> Rgb<T>
[src]
fn new(red: T, green: T, blue: T) -> Rgb<T>
Linear RGB.
fn new_u8(red: u8, green: u8, blue: u8) -> Rgb<T>
Linear RGB from 8 bit values.
fn from_pixel<P: RgbPixel<T>>(pixel: &P) -> Rgb<T>
Linear RGB from a linear pixel value.
fn to_pixel<P: RgbPixel<T>>(&self) -> P
Convert to a linear RGB pixel. Rgb
is already assumed to be linear,
so the components will just be clamped to [0.0, 1.0] before conversion.
use palette::Rgb; let c = Rgb::new(0.5, 0.3, 0.1); assert_eq!((c.red, c.green, c.blue), c.to_pixel()); assert_eq!((0.5, 0.3, 0.1), c.to_pixel());
Trait Implementations
impl<T: PartialEq + Float> PartialEq for Rgb<T>
[src]
fn eq(&self, __arg_0: &Rgb<T>) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &Rgb<T>) -> bool
This method tests for !=
.
impl<T: Debug + Float> Debug for Rgb<T>
[src]
impl<T: Copy + Float> Copy for Rgb<T>
[src]
impl<T: Clone + Float> Clone for Rgb<T>
[src]
fn clone(&self) -> Rgb<T>
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more
impl<T: Float> FromColor<T> for Rgb<T>
[src]
fn from_xyz(xyz: Xyz<T>) -> Self
Convert from XYZ color space
fn from_rgb(rgb: Rgb<T>) -> Self
Convert from RGB color space
fn from_hsl(hsl: Hsl<T>) -> Self
Convert from HSL color space
fn from_hsv(hsv: Hsv<T>) -> Self
Convert from HSV color space
fn from_luma(luma: Luma<T>) -> Self
Convert from Luma
fn from_yxy(inp: Yxy<T>) -> Self
Convert from Yxy color space
fn from_lab(inp: Lab<T>) -> Self
Convert from L*a*b* color space
fn from_lch(inp: Lch<T>) -> Self
Convert from L*C*h° color space
fn from_hwb(inp: Hwb<T>) -> Self
Convert from HWB color space
impl<T: Float> Limited for Rgb<T>
[src]
fn is_valid(&self) -> bool
Check if the color's components are within the expected ranges.
fn clamp(&self) -> Rgb<T>
Return a new color where the components has been clamped to the nearest valid values. Read more
fn clamp_self(&mut self)
Clamp the color's components to the nearest valid values.
impl<T: Float> Mix for Rgb<T>
[src]
type Scalar = T
The type of the mixing factor.
fn mix(&self, other: &Rgb<T>, factor: T) -> Rgb<T>
Mix the color with an other color, by factor
. Read more
impl<T: Float> Shade for Rgb<T>
[src]
type Scalar = T
The type of the lighten/darken amount.
fn lighten(&self, amount: T) -> Rgb<T>
Lighten the color by amount
.
fn darken(&self, amount: Self::Scalar) -> Self
Darken the color by amount
.
impl<T: Float> GetHue for Rgb<T>
[src]
type Hue = RgbHue<T>
The kind of hue unit this color space uses. Read more
fn get_hue(&self) -> Option<RgbHue<T>>
Calculate a hue if possible. Read more
impl<T: Float> Blend for Rgb<T>
[src]
type Color = Rgb<T>
The core color type. Typically Self
for color types without alpha.
fn into_premultiplied(self) -> PreAlpha<Rgb<T>, T>
Convert the color to premultiplied alpha.
fn from_premultiplied(color: PreAlpha<Rgb<T>, T>) -> Self
Convert the color from premultiplied alpha.
fn blend<F>(self, destination: Self, blend_function: F) -> Self where F: BlendFunction<Self::Color>
Blend self, as the source color, with destination
, using blend_function
. Anything that implements BlendFunction
is acceptable, including functions and closures. Read more
fn over(self, other: Self) -> Self
Place self
over other
. This is the good old common alpha composition equation. Read more
fn inside(self, other: Self) -> Self
Results in the parts of self
that overlaps the visible parts of other
. Read more
fn outside(self, other: Self) -> Self
Results in the parts of self
that lies outside the visible parts of other
. Read more
fn atop(self, other: Self) -> Self
Place self
over only the visible parts of other
.
fn xor(self, other: Self) -> Self
Results in either self
or other
, where they do not overlap.
fn plus(self, other: Self) -> Self
Add self
and other
. This uses the alpha component to regulate the effect, so it's not just plain component wise addition. Read more
fn multiply(self, other: Self) -> Self
Multiply self
with other
. This uses the alpha component to regulate the effect, so it's not just plain component wise multiplication. Read more
fn screen(self, other: Self) -> Self
Make a color which is at least as light as self
or other
.
fn overlay(self, other: Self) -> Self
Multiply self
or other
if other is dark, or screen them if other
is light. This results in an S curve. Read more
fn darken(self, other: Self) -> Self
Return the darkest parts of self
and other
.
fn lighten(self, other: Self) -> Self
Return the lightest parts of self
and other
.
fn dodge(self, other: Self) -> Self
Lighten other
to reflect self
. Results in other
if self
is black. Read more
fn burn(self, other: Self) -> Self
Darken other
to reflect self
. Results in other
if self
is white. Read more
fn hard_light(self, other: Self) -> Self
Multiply self
or other
if other is dark, or screen them if self
is light. This is similar to overlay
, but depends on self
instead of other
. Read more
fn soft_light(self, other: Self) -> Self
Lighten other
if self
is light, or darken other
as if it's burned if self
is dark. The effect is increased if the components of self
is further from 0.5. Read more
fn difference(self, other: Self) -> Self
Return the absolute difference between self
and other
. It's basically abs(self - other)
, but regulated by the alpha component. Read more
fn exclusion(self, other: Self) -> Self
Similar to difference
, but appears to result in a lower contrast. other
is inverted if self
is white, and preserved if self
is black. Read more
impl<T: Float> ComponentWise for Rgb<T>
[src]
type Scalar = T
The scalar type for color components.
fn component_wise<F: FnMut(T, T) -> T>(&self, other: &Rgb<T>, f: F) -> Rgb<T>
Perform a binary operation on this and an other color.
fn component_wise_self<F: FnMut(T) -> T>(&self, f: F) -> Rgb<T>
Perform a unary operation on this color.
impl<T: Float> Default for Rgb<T>
[src]
impl<T: Float> Add<Rgb<T>> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the +
operator
fn add(self, other: Rgb<T>) -> Rgb<T>
The method for the +
operator
impl<T: Float> Add<T> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the +
operator
fn add(self, c: T) -> Rgb<T>
The method for the +
operator
impl<T: Float> Sub<Rgb<T>> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the -
operator
fn sub(self, other: Rgb<T>) -> Rgb<T>
The method for the -
operator
impl<T: Float> Sub<T> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the -
operator
fn sub(self, c: T) -> Rgb<T>
The method for the -
operator
impl<T: Float> Mul<Rgb<T>> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the *
operator
fn mul(self, other: Rgb<T>) -> Rgb<T>
The method for the *
operator
impl<T: Float> Mul<T> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the *
operator
fn mul(self, c: T) -> Rgb<T>
The method for the *
operator
impl<T: Float> Div<Rgb<T>> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the /
operator
fn div(self, other: Rgb<T>) -> Rgb<T>
The method for the /
operator
impl<T: Float> Div<T> for Rgb<T>
[src]
type Output = Rgb<T>
The resulting type after applying the /
operator
fn div(self, c: T) -> Rgb<T>
The method for the /
operator
impl<T: Float> From<Srgb<T>> for Rgb<T>
[src]
impl<T: Float> From<GammaRgb<T>> for Rgb<T>
[src]
impl<T: Float> IntoColor<T> for Rgb<T>
[src]
fn into_xyz(self) -> Xyz<T>
Convert into XYZ space
fn into_yxy(self) -> Yxy<T>
Convert into Yxy color space
fn into_lab(self) -> Lab<T>
Convert into L*a*b* color space
fn into_lch(self) -> Lch<T>
Convert into L*C*h° color space
fn into_rgb(self) -> Rgb<T>
Convert into RGB color space.
fn into_hsl(self) -> Hsl<T>
Convert into HSL color space
fn into_hsv(self) -> Hsv<T>
Convert into HSV color space
fn into_luma(self) -> Luma<T>
Convert into Luma
fn into_hwb(self) -> Hwb<T>
Convert into HWB color space
impl<T: Float> From<Alpha<Rgb<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Color<T>> for Rgb<T>
[src]
impl<T: Float> From<Xyz<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Xyz<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Yxy<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Yxy<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Lab<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Lab<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Lch<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Lch<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Hsl<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Hsl<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Hsv<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Hsv<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Hwb<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Hwb<T>, T>> for Rgb<T>
[src]
impl<T: Float> From<Luma<T>> for Rgb<T>
[src]
impl<T: Float> From<Alpha<Luma<T>, T>> for Rgb<T>
[src]
impl<T: Float + ApproxEq> ApproxEq for Rgb<T> where T::Epsilon: Copy + Float
[src]
type Epsilon = T::Epsilon
Used for specifying relative comparisons.
fn default_epsilon() -> Self::Epsilon
The default tolerance to use when testing values that are close together. Read more
fn default_max_relative() -> Self::Epsilon
The default relative tolerance for testing values that are far-apart. Read more
fn default_max_ulps() -> u32
The default ULPs to tolerate when testing values that are far-apart. Read more
fn relative_eq(&self, other: &Self, epsilon: Self::Epsilon, max_relative: Self::Epsilon) -> bool
A test for equality that uses a relative comparison if the values are far apart.
fn ulps_eq(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool
A test for equality that uses units in the last place (ULP) if the values are far apart.
fn relative_ne(&self, other: &Self, epsilon: Self::Epsilon, max_relative: Self::Epsilon) -> bool
The inverse of ApproxEq::relative_eq
.
fn ulps_ne(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool
The inverse of ApproxEq::ulps_eq
.