具有独立颜色和 alpha 分量类型的像素称为异构像素（HetPixel），而具有单一颜色和 alpha 分量类型像素称为同构像素（Pixel）。

像素特性

所有像素类型的函数都通过特性实现。这意味着像素类型，如 Rgb<u8>，没有任何固有方法。这使得您可以轻松选择在任何给定时间希望存在的作用域内的方法，而固有方法总是存在于作用域内。

此软件包提供了以下特性

HetPixel

每个像素类型实现的最基础像素特性。

use rgb::{Rgba, HetPixel};

let mut rgba: Rgba<u8> = Rgba::try_from_colors_alpha([0, 0, 0], 0).unwrap();

*rgba.color_array_mut()[2] = u8::MAX;
assert_eq!(rgba.color_array(), [0, 0, 255]);

*rgba.alpha_opt_mut().unwrap() = 50;
assert_eq!(rgba.alpha_opt(), Some(50));

let rgba = rgba.map_colors(u16::from);
let rgba = rgba.map_colors_same(|c| c * 2);
let rgba = rgba.map_alpha(f32::from);
let rgba = rgba.map_alpha_same(|a| a * 2.0);

assert_eq!(rgba, Rgba::<u16, f32> {r: 0, g: 0, b: 510, a: 100.0});

Pixel

比 HetPixel 更严格的特性，其中两个分量类型，颜色和 alpha，是相同的。

use rgb::{Rgba, Pixel};

let mut rgba: Rgba<u8> = Rgba::try_from_components([0, 0, 0, 0]).unwrap();

*rgba.each_mut()[2] = u8::MAX;
assert_eq!(rgba.to_array(), [0, 0, 255, 0]);

let rgba = rgba.map(u16::from);
let rgba = rgba.map_same(|c| c * 2);

assert_eq!(rgba, Rgba::<u16> {r: 0, g: 0, b: 510, a: 0});

GainAlpha

以各种方式向像素类型添加 alpha 的方法。

use rgb::{Rgb, Rgba, GainAlpha};

let expected: Rgba<u8> = Rgba {r: 0, g: 0, b: 0, a: 255};

assert_eq!(Rgb {r: 0, g: 0, b: 0}.with_default_alpha(255), expected);
assert_eq!(Rgb {r: 0, g: 0, b: 0}.with_alpha(255), expected);
assert_eq!(Rgba {r: 0, g: 0, b: 0, a: 0}.with_alpha(255), expected);

HasAlpha

仅在具有 alpha 分量的像素上实现的一个特性。

由于与几个已弃用的同名固有函数（如 Rgb::alpha()）存在命名冲突，因此 HasAlpha::alpha() 方法需要完全限定语法以消除歧义。这些弃用函数将在未来的版本中删除，这将解决此问题。

use rgb::{Rgba, HasAlpha};

let mut rgba: Rgba<u8> = Rgba {r: 0, g: 0, b: 0, a: 255};

*rgba.alpha_mut() -= 50;

assert_eq!(HasAlpha::alpha(&rgba), 205);

Bytemuck

如果您有一个 &[u8] 或 Vec<u8> 类型，并且您想转换为一个 &[Rgb<u8>] 或 Vec<Rgb<u8>> 类型，则可以通过 bytemuck 软件包（请参阅 cast_slice() 和 cast_vec()）安全地进行这些类型转换。

要使用此软件包中的像素类型上的 bytemuck 库函数，您需要启用 bytemuck 软件包功能。

软件包功能

• default：默认功能，不做任何事情。
• num-traits：启用对像素类型（如CheckedAdd）的多种num_traits特征实现。
• defmt-03 = 启用像素类型对defmt v0.3的Format特征实现
• serde = 为像素类型启用serde的Serializable和Deserializable特征实现
• bytemuck = 为像素类型启用bytemuck的Pod和Zeroable特征实现

遗留功能

以下crate功能仅用于与v0.8版本兼容，以保持非破坏性，但一旦迁移到v0.9，您就不再应该使用这些功能。它们将在下一个主版本（在v0.9之后）中删除。

argb = []
grb = []
checked_fns = []
as-bytes = ["bytemuck"]

颜色空间无关

这个crate故意对像素类型的颜色空间保持无关，例如，Gray<u8>可以是线性亮度或伽玛校正的亮度等。

# use rgb::Rgb;
struct LinearLight(u16);
type LinearRGB = Rgb<LinearLight>;