XMXDECN4 結構 (directxpackedvector.h)

4D 向量，用於將帶正負號、正規化值儲存為10位帶正負號 x-、y-和 z- 元件，並將未帶正負號的標準化值儲存為2位不帶正負號的 w-component。

如需在 C++ 中程式設計時可用的 XMXDECN4 建構函式和運算子等其他功能清單，請參閱 XMXDECN4 Extensions。

注意如需對等D3DDECLTYPE、D3DFORMAT和DXGI_FORMAT對象的相關信息，請參閱 DirectXMath 連結庫類型等價。

 

語法

struct XMXDECN4 {
  union {
    struct {
      int32_t  x : 10;
      int32_t  y : 10;
      int32_t  z : 10;
      uint32_t w : 2;
    };
             uint32_t v;
  };
  void       XMXDECN4();
  void       XMXDECN4(
    const XMXDECN4 & unnamedParam1
  );
  XMXDECN4 & operator=(
    const XMXDECN4 & unnamedParam1
  );
  void       XMXDECN4(
    XMXDECN4 && unnamedParam1
  );
  XMXDECN4 & operator=(
    XMXDECN4 && unnamedParam1
  );
  void       XMXDECN4(
    uint32_t Packed
  );
  void       XMXDECN4(
    float _x,
    float _y,
    float _z,
    float _w
  ) noexcept;
  void       XMXDECN4(
    const float *pArray
  ) noexcept;
  void       operator uint32_t() noexcept;
  XMXDECN4 & operator=(
    uint32_t Packed
  ) noexcept;
};

成員

x

描述向量 X 座標的範圍 [-511， 511] 中的帶正負號整數值。

y

範圍 [-511， 511] 中的帶正負號整數值，描述向量的 Y 座標。

z

描述向量 Z 座標的範圍 [-511， 511] 中的帶正負號整數值。

w

描述向量 w 座標的範圍 [0， 3] 中的無符號整數值。

v

表示 4D 向量的無符號 32 位整數。

void XMXDECN4 ()

的預設建構函式 XMXDECN4。

XMXDECN4的預設建構函式。

注意 此建構函式只能在 C++ 下使用。

 

void XMXDECN4 ( const XMXDECN4 & unnamedParam1)

XMXDECN4 的建構函式。

XMXDECN4的建構函式。

注意 此建構函式只能在 C++ 下使用。

XMXDECN4 & operator=( const XMXDECN4 & unnamedParam1)

void XMXDECN4 ( XMXDECN4 && unnamedParam1)

XMXDECN4 的建構函式。

XMXDECN4的建構函式。

注意 此建構函式只能在 C++ 下使用。

XMXDECN4 & operator= ( XMXDECN4 && unnamedParam1)

將 向量元件數據從 一個 實例 XMXDECN4 指派給 目前的 實例 XMXDECN4。

注意 此運算子僅適用於 C++。

void XMXDECN4 ( uint32_t Packed)

從變數初始化 的新實例 XMXDECN4 ， uint32_t 其中包含封裝格式的元件數據。

這個建構函式會從uint32_t包含封裝格式之元件數據的變數，初始化 XMXDECN4 的新實例。

注意 此建構函式只能在 C++ 下使用。

 

void XMXDECN4 ( float _x、float _y、float _z、float _w) noexcept

從四個標準化float自變數初始化 的新實例XMXDECN4。

這個建構函式會從四個標準化float自變數初始化 XMXDECN4 的新實例。

注意 此建構函式只能在 C++ 下使用。

 

void XMXDECN4 ( const float *pArray) noexcept

從四float個項目數位自變數初始化 XMXDECN4 的新實例。

這個建構函式會從四float個項目數位化自變數初始化 XMXDECN4的新實例。

注意 此建構函式只能在 C++ 下使用。

void 運算符 uint32_t () noexcept

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

傳回的實例 uint32_t ，其中包含已封裝格式之 XMXDECN4 實例的元件。

注意 此運算子僅適用於 C++。

 

XMXDECN4 &运算符= ( uint32_t Packed) noexcept

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

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

注意 此運算子僅適用於 C++。

 

備註

使用浮點自變數的建 XMXDECN4 構函式需要正規化輸入，其必須位於 w-component 的 [-1.0.-1.0] 範圍內。 在具現化期間，指定 x、y 和 z 元件的輸入會乘以 511.0f，而 w 元件乘以 3.0f，這些結果會四捨五入，然後指派給 的適當成員 XMXDECN4。

XMXDECN4 可用來從標準化值載入 XMVECTOR 的實例，方法是使用 XMLoadXDecN4，將 x-、y-和 z-components 除以 511.0f、w 元件為 3.0f、四捨五入結果，然後將元件指派給 XMVECTOR 實例。

XMVECTOR包含正規化值的實例可以使用 XMStoreXDecN4 來儲存XMXDECN4，其會將 x-、y-和 z-components 乘以 511.0f，w 元件乘以 3.0f，將結果四捨五入，再將值指派給適當的XMXDECN4成員。

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

平臺需求

Microsoft Visual Studio 2010 或 Microsoft Visual Studio 2012 搭配 Windows SDK for Windows 8。 支援 Win32 傳統型應用程式、Windows 市集應用程式和 Windows Phone 8 個應用程式。

規格需求

標頭	directxpackedvector.h

另請參閱

DirectXMath 連結庫結構

XMXDECN4延伸模組