(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 & 運算子= ( 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 運算符 uint32_t () noexcept

傳回的 uint32_t 實例，包含封裝格式之 XMCOLOR 實例的元件。

注意 此運算子只能在 C++ 下使用。

 

XMCOLOR & 運算子= ( const uint32_t Color) noexcept

將封裝在 實例 uint32_t 中的向量元件數據指派給 目前的 實例 XMCOLOR。

這個運算子會將 封裝在 實例 uint32_t 中的向量元件數據指派給 目前的 XMCOLOR 實例。

注意 此運算子只能在 C++ 下使用。

 

備註

使用浮點自變數的建 XMCOLOR 構函式需要正規化的輸入，這些輸入會限制為 [0-1.0] 的範圍。 在具現化期間，指定色彩通道的浮點數據會乘以 255.0f，四捨五入，然後指派給 的適當成員 XMCOLOR。

XMCOLOR 可用來從標準化值載入 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 延伸模組