XMBYTEN4 結構 (directxpackedvector.h)

3D 向量，用於將帶正負號的標準化值儲存為帶正負號的 8 位， (1 個字節) 整數。

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

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

 

語法

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

成員

x

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

y

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

z

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

w

範圍 [-127， 127] 中帶正負號的 8 位整數值，描述向量的 w 座標。

v

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

void XMBYTEN4 ()

的預設建構函式 XMBYTEN4

XMBYTEN4的預設建構函式

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

 

void XMBYTEN4 ( const XMBYTEN4 & unnamedParam1)

的建構函式 XMBYTEN4。

XMBYTEN4的建構函式。

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

XMBYTEN4 & operator= ( const XMBYTEN4 & unnamedParam1)

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

這個運算子會將向量元件數據從 XMBYTEN4 的一個實例指派給 目前的實例 XMBYTEN4。

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

void XMBYTEN4 ( XMBYTEN4 && unnamedParam1)

的建構函式 XMBYTEN4。

XMBYTEN4的建構函式。

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

XMBYTEN4 & operator=( XMBYTEN4 && unnamedParam1)

void XMBYTEN4 ( int8_t _x、int8_t _y、int8_t _z、int8_t _w) noexcept

從四int8_t個自變數初始化 的新實例XMBYTEN4。

這個建構函式會從四int8_t個自變數初始化 XMBYTEN4 的新實例。

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

 

void XMBYTEN4 ( uint32_t Packed) noexcept

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

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

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

 

void XMBYTEN4 ( const int8_t *pArray) noexcept

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

這個建構函式會從四個元素int8_t數位自變數初始化 XMBYTEN4 的新實例。

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

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

從四float個自變數初始化 的新實例XMBYTEN4。

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

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

 

void XMBYTEN4 ( const float *pArray) noexcept

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

這個建構函 式會從 四個元素 float 數位自變數初始化 XMBYTEN4 的新實例。

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

XMBYTEN4 & operator=( uint32_t Packed) noexcept

備註

使用浮點自變數的建 XMBYTEN4 構函式需要正規化輸入，其範圍必須是 [0.0.-1.0]。 在具現化期間，這些數據會乘以 127.0f，結果會四捨五入，然後指派給 的適當成員 XMBYTEN4。

XMBYTEN4 可用來從標準化值載入 XMVECTOR 的實例，方法是使用 XMLoadByteN4 來分割每個元件 127.0f、四捨五入結果，然後將元件指派給 XMVECTOR 實例。

XMVECTOR包含正規化值的實例可以使用 XMStoreByteN4 來儲存，XMBYTEN4將每個元件乘以 127.0f，將結果四捨五入，再將值指派給適當的XMBYTEN4成員。

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

平臺需求

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

規格需求

標頭	directxpackedvector.h

另請參閱

DirectXMath 連結庫結構

XMBYTEN4延伸模組