XMUBYTEN4-Struktur (directxpackedvector.h)

Ein 3D-Vektor zum Speichern von nicht signierten, normalisierten Werten als 8-Bit-Ganzzahlen (1 Byte) mit Vorzeichen.

Eine Liste mit zusätzlichen Funktionen wie Konstruktoren und Operatoren, die bei XMUBYTEN4 der Programmierung in C++ verfügbar sind, finden Sie unter XMUBYTEN4 Extensions.

Hinweis Informationen zu gleichwertigen D3DDECLTYPE, D3DFORMAT und DXGI_FORMAT-Objekten finden Sie unter DirectXMath Library Type Equivalences( DirectXMath Library Type Equivalences).

 

Syntax

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

Member

x

Ganzzahlwert ohne Vorzeichen im Bereich [0, 255], der die x-Koordinate des Vektors beschreibt.

y

8-Bit-Ganzzahlwert ohne Vorzeichen im Bereich [0, 255], der die y-Koordinate des Vektors beschreibt.

z

Ganzzahlwert ohne Vorzeichen im Bereich [0, 255], der die Z-Koordinate des Vektors beschreibt.

w

Ganzzahlwert ohne Vorzeichen im Bereich [0, 255], der die w-Koordinate des Vektors beschreibt.

v

32-Bit-Ganzzahl ohne Vorzeichen, die den 4D-Vektor darstellt.

void XMUBYTEN4()

Standardkonstruktor für XMUBYTEN4

Standardkonstruktor für XMUBYTEN4

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

 

void XMUBYTEN4( const XMUBYTEN4 & unnamedParam1)

Ein Konstruktor für XMUBYTEN4

Ein Konstruktor für XMUBYTEN4

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

XMUBYTEN4 & operator=( const XMUBYTEN4 & unnamedParam1)

void XMUBYTEN4( XMUBYTEN4 && unnamedParam1)

Ein Konstruktor für XMUBYTEN4

Ein Konstruktor für XMUBYTEN4

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

XMUBYTEN4 & operator=( XMUBYTEN4 && unnamedParam1)

Weist die Daten der Vektorkomponente aus einem instance XMUBYTEN4 der aktuellen instance von XMUBYTEN4 zu.

Dieser Operator weist die Daten der Vektorkomponente aus einem instance XMUBYTEN4 der aktuellen instance von XMUBYTEN4 zu.

Hinweis Dieser Operator ist nur unter C++ verfügbar.

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

Initialisiert eine neue instance aus XMUBYTEN4 vier uint8_t Argumenten.

Dieser Konstruktor initialisiert eine neue instance von XMUBYTEN4 aus vier uint8_t Argumenten.

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

 

void XMUBYTEN4( uint32_t Packed) noexcept

Initialisiert eine neue instance von XMUBYTEN4 aus einer uint32_t Variablen, die Komponentendaten in einem gepackten Format enthält.

Dieser Konstruktor initialisiert eine neue instance von XMUBYTEN4 aus einer uint32_t Variablen, die Komponentendaten in einem gepackten Format enthält.

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

 

void XMUBYTEN4( const uint8_t *pArray) noexcept

Initialisiert eine neue instance von XMUBYTEN4 aus einem Arrayargument mit vier Elementenuint8_t.

Dieser Konstruktor initialisiert eine neue instance von XMUBYTEN4 aus einem Arrayargument mit vier Elementenuint8_t.

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

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

Initialisiert eine neue instance aus XMUBYTEN4 vier float Argumenten.

Dieser Konstruktor initialisiert eine neue instance von XMUBYTEN4 aus vier float Argumenten.

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

 

void XMUBYTEN4( const float *pArray) noexcept

Initialisiert eine neue instance von XMUBYTEN4 aus einem Arrayargument mit vier Elementenfloat.

Dieser Konstruktor initialisiert eine neue instance von XMUBYTEN4 aus einem aus einem Arrayargument mit vier Elementenfloat.

Hinweis Dieser Konstruktor ist nur unter C++ verfügbar.

XMUBYTEN4 & operator=( uint32_t Packed) noexcept

Hinweise

Diese XMUBYTEN4 Konstruktoren, die Gleitkommaargumente verwenden, erfordern normalisierte Eingaben, die im Bereich von [0.0.-1.0] liegen müssen. Während der Instanziierung werden diese Daten mit 255.0f multipliziert, die Ergebnisse gerundet und dann den entsprechenden Membern von XMUBYTEN4zugewiesen.

XMUBYTEN4kann verwendet werden, um Instanzen von XMVECTOR aus normalisierten Werten zu laden, indem XMLoadUByteN4 verwendet wird, das jede Komponente 255.0f dividiert, das Ergebnis rundet und dann die Komponenten einem XMVECTOR instance zuweist.

XMVECTORInstanzen, die normalisierte Werte enthalten, können mithilfe von XMStoreUByteN4 gespeichert XMUBYTEN4 werden, wodurch jede Komponente mit 255,0f multipliziert wird und das Ergebnis abgerundet wird, bevor die Werte den entsprechenden XMUBYTEN4 Membern zugewiesen werden.

Namespace: Verwenden von DirectX::P ackedVector

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.

Anforderungen

Kopfzeile	directxpackedvector.h

Weitere Informationen

DirectXMath-Bibliotheksstrukturen

XMUBYTEN4-Erweiterungen