XMCOLOR-Struktur (directxpackedvector.h)

Ein 32-Bit Alpha Red Green Blue (ARGB)-Farbvektor, bei dem jeder Farbkanal als unsignierte 8-Bit-Ganzzahl angegeben wird.

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

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

 

Syntax

struct XMCOLOR {
  union {
    struct {
      uint8_t b;
      uint8_t g;
      uint8_t r;
      uint8_t a;
    };
             uint32_t c;
  };
  void      XMCOLOR();
  void      XMCOLOR(
    const XMCOLOR & unnamedParam1
  );
  XMCOLOR & operator=(
    const XMCOLOR & unnamedParam1
  );
  void      XMCOLOR(
    XMCOLOR && unnamedParam1
  );
  XMCOLOR & operator=(
    XMCOLOR && unnamedParam1
  );
  void      XMCOLOR(
    uint32_t Color
  ) noexcept;
  void      XMCOLOR(
    float _r,
    float _g,
    float _b,
    float _a
  ) noexcept;
  void      XMCOLOR(
    const float *pArray
  ) noexcept;
  void      operator uint32_t() noexcept;
  XMCOLOR & operator=(
    const uint32_t Color
  ) noexcept;
};

Member

b

Ganzzahl ohne Vorzeichen zwischen 0 und 255, die die blaue Komponente darstellt.

g

Ganze Zahl ohne Vorzeichen zwischen 0 und 255, die die grüne Komponente darstellt.

r

Ganze Zahl ohne Vorzeichen zwischen 0 und 255, die die rote Komponente darstellt.

a

Ganze Zahl ohne Vorzeichen zwischen 0 und 255, die die Alphakomponente darstellt.

c

32-Bit-Ganzzahl ohne Vorzeichen, die die Farbe darstellt. Die Farben werden in A8R8G8B8 Format gespeichert.

Die Alphakomponente die wichtigsten Bits, und die blaue Komponente wird in den am wenigsten signifikanten Bits gespeichert.

void XMCOLOR()

Standardkonstruktor für XMCOLOR

Standardkonstruktor für XMCOLOR

Hinweis Dies ist nur für C++-basierte Entwicklung verfügbar.

 

void XMCOLOR( const XMCOLOR & ohne NamenParam1)

Ein Konstruktor für XMCOLOR

Ein Konstruktor für XMCOLOR

Hinweis Dies ist nur für C++-basierte Entwicklung verfügbar.

XMCOLOR & operator=( const XMCOLOR & unnamedParam1)

void XMCOLOR( XMCOLOR && ohne NamenParam1)

Ein Konstruktor für XMCOLOR

Ein Konstruktor für XMCOLOR

Hinweis Dies ist nur für C++-basierte Entwicklung verfügbar.

XMCOLOR & operator=( XMCOLOR && unnamedParam1)

Dieser Operator weist die Daten der Vektorkomponente aus einer instance von XMCOLOR dem aktuellen instance von XMCOLOR zu.

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

void XMCOLOR( uint32_t Color) noexcept

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

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

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

 

void XMCOLOR( float _r, float _g, float _b, float _a) noexcept

Initialisiert eine neue instance von XMCOLOR vier float Argumenten.

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

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

 

void XMCOLOR( const float *pArray) noexcept

Initialisiert eine neue instance von XMCOLOR aus einem Argument mit vier Elementarraysfloat.

Dieser Konstruktor initialisiert eine neue instance von XMCOLOR aus einem aus einem Argument mit vier Elementarraysfloat.

Hinweis Dies ist nur für C++-basierte Entwicklung verfügbar.

void-Operator uint32_t() noexcept

Gibt eine instance zurückuint32_t, die die Komponenten des XMCOLOR instance in einem gepackten Format enthält.

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

 

XMCOLOR & operator=( const uint32_t Color) noexcept

Weist die Daten der Vektorkomponente, die in einem instance von uint32_t gepackt sind, dem aktuellen instance von zuXMCOLOR.

Dieser Operator weist die Vektorkomponentendaten, die in einer instance von uint32_t gepackt sind, dem aktuellen instance von XMCOLOR zu.

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

 

Hinweise

Diese XMCOLOR Konstruktoren, die Gleitkommaargumente verwenden, erfordern normalisierte Eingaben, die an den Bereich von [0-1,0] geklemmt werden. Während der Instanziierung werden die Gleitkommadaten, die die Farbkanäle angeben, mit 255.0f multipliziert, gerundet und dann den entsprechenden Membern von XMCOLORzugewiesen.

XMCOLORkann verwendet werden, um Instanzen von XMVECTOR aus normalisierten Werten zu laden, indem XMLoadColor verwendet wird, das Farbkanaldaten durch 255.0f dividiert, das Ergebnis rundet und dann die Komponenten einem XMVECTOR instance zuweist.

XMVECTORInstanzen, die normalisierte Werte enthalten, können mithilfe von XMStoreColor gespeichert XMCOLOR werden, wodurch Farbkanaldaten mit 255.0f multipliziert werden, wodurch das Ergebnis abgerundet wird, bevor die Werte den entsprechenden XMCOLOR 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

XMCOLOR-Erweiterungen