(directxpackedvector.h) 的 XMCOLOR 结构

32 位 Alpha 红绿蓝 (ARGB) 颜色向量，其中每个颜色通道指定为无符号 8 位整数。

有关使用 C++ 编程时可用的 XMCOLOR 其他功能（例如构造函数和运算符）的列表，请参阅 XMCOLOR 扩展。

注意有关等效D3DDECLTYPE、D3DFORMAT和DXGI_FORMAT对象的信息，请参阅 DirectXMath 库类型等效性。

 

语法

struct XMCOLOR {
  union {
    struct {
      uint8_t b;
      uint8_t g;
      uint8_t r;
      uint8_t a;
    };
             uint32_t c;
  };
  void      XMCOLOR();
  void      XMCOLOR(
    const XMCOLOR & unnamedParam1
  );
  XMCOLOR & operator=(
    const XMCOLOR & unnamedParam1
  );
  void      XMCOLOR(
    XMCOLOR && unnamedParam1
  );
  XMCOLOR & operator=(
    XMCOLOR && unnamedParam1
  );
  void      XMCOLOR(
    uint32_t Color
  ) noexcept;
  void      XMCOLOR(
    float _r,
    float _g,
    float _b,
    float _a
  ) noexcept;
  void      XMCOLOR(
    const float *pArray
  ) noexcept;
  void      operator uint32_t() noexcept;
  XMCOLOR & operator=(
    const uint32_t Color
  ) noexcept;
};

成员

b

0 到 255 之间的无符号整数，表示蓝色分量。

g

0 和 255 之间的无符号整数，表示绿色分量。

r

0 和 255 之间的无符号整数，表示红色分量。

a

0 和 255 之间的无符号整数，表示 alpha 分量。

c

表示颜色的无符号 32 位整数。 颜色以A8R8G8B8格式存储。

alpha 分量是最高有效位，蓝色分量存储在最低有效位中。

void XMCOLOR ()

的默认构造函数 XMCOLOR

XMCOLOR 的默认构造函数

注意 这仅适用于基于 C++ 的开发。

 

void XMCOLOR ( const XMCOLOR & unnamedParam1)

的构造函数 XMCOLOR

XMCOLOR 的构造函数

注意 这仅适用于基于 C++ 的开发。

XMCOLOR & operator=( const XMCOLOR & unnamedParam1)

void XMCOLOR ( XMCOLOR && unnamedParam1)

的构造函数 XMCOLOR

XMCOLOR 的构造函数

注意 这仅适用于基于 C++ 的开发。

XMCOLOR & operator= ( XMCOLOR && unnamedParam1)

此运算符将一个 XMCOLOR 实例中的矢量分量数据分配给 XMCOLOR 的当前实例。

注意 此运算符仅在 C++ 下可用。

void XMCOLOR ( uint32_t Color) noexcept

从uint32_t包含采用打包格式的XMCOLOR组件数据的变量初始化 的新实例。

此构造函数从uint32_t包含采用打包格式的组件数据的变量初始化 XMCOLOR 的新实例。

注意 此构造函数仅在 C++ 下可用。

 

void XMCOLOR ( float _r、float _g、float _b、float _a) noexcept

从四float个参数初始化 的新XMCOLOR实例。

此构造函数从四float个参数初始化 XMCOLOR 的新实例。

注意 此构造函数仅在 C++ 下可用。

 

void XMCOLOR ( const float *pArray) noexcept

从四元素float数组参数初始化 XMCOLOR 的新实例。

此构造函数从四元素float数组参数中初始化 XMCOLOR 的新实例。

注意 这仅适用于基于 C++ 的开发。

void operator uint32_t () noexcept

返回 的实例，该实例 uint32_t 包含打包格式的 XMCOLOR 实例的组件。

注意 此运算符仅在 C++ 下可用。

 

XMCOLOR & operator= ( const uint32_t Color) noexcept

将 打包在 实例 uint32_t 中的矢量组件数据分配给 的 XMCOLOR当前实例。

此运算符将 打包在 实例 uint32_t 中的矢量分量数据分配给 XMCOLOR 的当前实例。

注意 此运算符仅在 C++ 下可用。

 

注解

那些 XMCOLOR 使用浮点参数的构造函数需要规范化的输入，这些输入被固定到 [0-1.0] 范围内。 在实例化期间，指定颜色通道的浮点数据将乘以 255.0f，舍入，然后分配给 的 XMCOLOR相应成员。

XMCOLOR 可用于通过 XMLoadColor 从规范化值加载 XMVECTOR 的实例， XMLoadColor 将颜色通道数据除以 255.0f，对结果进行舍入，然后将组件分配给实例 XMVECTOR 。

XMVECTOR包含规范化值的实例可以使用 XMStoreColor 存储到 中XMCOLOR，该函数将颜色通道数据乘以 255.0f，在将值分配给相应XMCOLOR成员之前将结果舍入。

命名 空间： 使用 DirectX：:P ackedVector

平台要求

Microsoft Visual Studio 2010 或 Microsoft Visual Studio 2012 以及 Windows SDK for Windows 8。 支持 Win32 桌面应用、Windows 应用商店应用和 Windows Phone 8 应用。

要求

标头	directxpackedvector.h

另请参阅

DirectXMath 库结构

XMCOLOR 扩展