structure XMBYTEN4 (directxpackedvector.h)

Article
08/23/2023

Vecteur 3D pour stocker des valeurs signées et normalisées sous forme d’entiers signés de 8 bits (1 octet).

Pour obtenir la liste des fonctionnalités supplémentaires telles que les constructeurs et les opérateurs disponibles XMBYTEN4 lorsque vous programmez en C++, consultez extensions XMBYTEN4.

Note Pour plus d’informations sur les objets D3DDECLTYPE, D3DFORMAT et DXGI_FORMAT équivalents, consultez Équivalences de type de bibliothèque DirectXMath.

Syntaxe

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;
};

Membres

x

Valeur entière 8 bits signée dans la plage [-127, 127] décrivant la coordonnée x du vecteur.

y

Valeur entière 8 bits signée dans la plage [-127, 127] décrivant la coordonnée y du vecteur.

z

Valeur entière 8 bits signée dans la plage [-127, 127] décrivant la coordonnée z du vecteur.

w

Valeur entière 8 bits signée dans la plage [-127, 127] décrivant la coordonnée w du vecteur.

v

Entier 32 bits non signé représentant le vecteur 4D.

void XMBYTEN4()

Constructeur par défaut pour XMBYTEN4

Constructeur par défaut pour XMBYTEN4

Note Ce constructeur est disponible uniquement sous C++.

void XMBYTEN4( const XMBYTEN4 & unnamedParam1)

Constructeur pour XMBYTEN4.

Constructeur pour XMBYTEN4.

Note Ce constructeur est disponible uniquement sous C++.

XMBYTEN4 & operator=( const XMBYTEN4 & unnamedParam1)

Affecte les données de composant vectoriel d’un instance de XMBYTEN4 à la instance actuelle de XMBYTEN4.

Cet opérateur affecte les données de composant vectoriel d’un instance de XMBYTEN4 à la instance actuelle de XMBYTEN4.

Note Ce constructeur est disponible uniquement sous C++.

void XMBYTEN4( XMBYTEN4 && unnamedParam1)

Constructeur pour XMBYTEN4.

Constructeur pour XMBYTEN4.

Note Ce constructeur est disponible uniquement sous C++.

XMBYTEN4 & operator=( XMBYTEN4 && unnamedParam1)

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

Initialise une nouvelle instance de à partir de XMBYTEN4 quatre int8_t arguments.

Ce constructeur initialise une nouvelle instance de XMBYTEN4 à partir de quatre int8_t arguments.

Note Ce constructeur est disponible uniquement sous C++.

void XMBYTEN4( uint32_t Packed) noexcept

Initialise une nouvelle instance de à partir d’une XMBYTEN4uint32_t variable contenant des données de composant dans un format packed.

Ce constructeur initialise une nouvelle instance de XMBYTEN4 à partir d’une uint32_t variable contenant des données de composant dans un format packed.

Note Ce constructeur est disponible uniquement sous C++.

void XMBYTEN4( const int8_t *pArray) noexcept

Initialise une nouvelle instance de XMBYTEN4 à partir d’un argument de tableau à quatre élémentsint8_t.

Ce constructeur initialise une nouvelle instance de XMBYTEN4 à partir d’un argument de tableau à quatre élémentsint8_t.

Note Ce constructeur est disponible uniquement sous C++.

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

Initialise une nouvelle instance de à partir de XMBYTEN4 quatre float arguments.

Ce constructeur initialise une nouvelle instance de XMBYTEN4 à partir de quatre float arguments.

Note Ce constructeur est disponible uniquement sous C++.

void XMBYTEN4( const float *pArray) noexcept

Initialise une nouvelle instance de XMBYTEN4 à partir d’un argument de tableau à quatre élémentsfloat.

Ce constructeur initialise une nouvelle instance de XMBYTEN4 à partir d’un argument de tableau à quatre élémentsfloat.

Note Ce constructeur est disponible uniquement sous C++.

XMBYTEN4 & operator=( uint32_t Packed) noexcept

Remarques

Les XMBYTEN4 constructeurs qui utilisent des arguments à virgule flottante nécessitent une entrée normalisée, qui doit se trouver dans la plage de [0.0.-1.0]. Pendant l’instanciation, ces données sont multipliées par 127.0f, les résultats sont arrondis, puis attribués aux membres appropriés de XMBYTEN4.

XMBYTEN4peut être utilisé pour charger des instances de XMVECTOR à partir de valeurs normalisées, à l’aide de XMLoadByteN4, qui divise chaque composant 127.0f, arrondit le résultat, puis affecte les composants à un XMVECTOR instance.

XMVECTOR les instances contenant des valeurs normalisées peuvent être stockées dans XMBYTEN4 à l’aide de XMStoreByteN4, qui multiplie chaque composant par 127,0f, arrondissant le résultat, avant d’affecter les valeurs aux membres appropriés XMBYTEN4 .

Noms: Utiliser DirectX ::P ackedVector

Configuration requise pour la plateforme

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le Kit de développement logiciel (SDK) Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et Windows Phone 8 applications.

Configuration requise


En-tête	directxpackedvector.h

Voir aussi

Structures de bibliothèque DirectXMath

XMBYTEN4 Extensions