XMUBYTEN4結構 (directxpackedvector.h)

3D 向量，用來將不帶正負號的標準化值儲存為帶正負號的8位 (1位元組) 整數。

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

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

 

語法

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

成員

x

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

y

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

z

描述向量 z 座標的範圍 [0， 255] 中的不帶正負號 8 位整數值。

w

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

v

不帶正負號的 32 位整數，表示 4D 向量。

void XMUBYTEN4 ()

的預設建構函式 XMUBYTEN4

XMUBYTEN4的預設建構函式

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

 

void XMUBYTEN4 ( const XMUBYTEN4 & unnamedParam1)

的建構函式 XMUBYTEN4

XMUBYTEN4的建構函式

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

XMUBYTEN4 & operator=( const XMUBYTEN4 & unnamedParam1)

void XMUBYTEN4 ( XMUBYTEN4 && unnamedParam1)

的建構函式 XMUBYTEN4

XMUBYTEN4的建構函式

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

XMUBYTEN4 &运算符= ( XMUBYTEN4 && unnamedParam1)

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

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

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

void XMUBYTEN4 ( uint8_t _x、uint8_t _y、uint8_t _z、uint8_t _w) noexcept

從四uint8_t個自變數初始化 的新實例XMUBYTEN4。

此建構函式會從四uint8_t個自變數初始化 XMUBYTEN4的新實例。

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

 

void XMUBYTEN4 ( uint32_t packed) noexcept

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

此建構函式會從uint32_t包含封裝格式元件數據的變數初始化 XMUBYTEN4 的新實例。

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

 

void XMUBYTEN4 ( const uint8_t *pArray) noexcept

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

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

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

void XMUBYTEN4 ( float _x， float _y， float _z， float _w) noexcept

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

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

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

 

void XMUBYTEN4 ( const float *pArray) noexcept

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

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

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

XMUBYTEN4 & operator=( uint32_t Packed) noexcept

備註

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

XMUBYTEN4 可用來從正規化值載入 XMVECTOR 的實例，方法是使用 XMLoadUByteN4 來分割每個元件 255.0f、四捨五入結果，然後將元件指派給 XMVECTOR 實例。

XMVECTOR包含正規化值的實例可以使用 XMStoreUByteN4 儲存到 XMUBYTEN4 中，這會將每個元件乘以 255.0f，將結果四捨五入，再將值指派給適當的XMUBYTEN4成員。

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

平臺需求

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

規格需求

標頭	directxpackedvector.h

另請參閱

DirectXMath 連結庫結構

XMUBYTEN4擴充功能