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

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

此构造函数从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 可以使用 XMLoadByteN4 从规范化值加载 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扩展