Struktur XMCOLOR (directxpackedvector.h)

Vektor warna Alpha Red Green Blue (ARGB) 32-bit, di mana setiap saluran warna ditentukan sebagai bilangan bulat 8 bit yang tidak ditandatangani.

Untuk daftar fungsionalitas tambahan seperti konstruktor dan operator yang tersedia menggunakan XMCOLOR saat Anda memprogram di C++, lihat Ekstensi XMCOLOR.

Catatan Lihat Kesetaraan Jenis Pustaka DirectXMath untuk informasi tentang objek D3DDECLTYPE, D3DFORMAT, dan DXGI_FORMAT yang setara.

 

Sintaks

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

Anggota

b

Bilangan bulat yang tidak ditandatangani antara 0 dan 255 mewakili komponen biru.

g

Bilangan bulat yang tidak ditandatangani antara 0 dan 255 mewakili komponen hijau.

r

Bilangan bulat yang tidak ditandatangani antara 0 dan 255 mewakili komponen merah.

a

Bilangan bulat yang tidak ditandatangani antara 0 dan 255 mewakili komponen alfa.

c

Bilangan bulat 32-bit yang tidak ditandatangani mewakili warna. Warna disimpan dalam format A8R8G8B8.

Komponen alfa bit yang paling signifikan, dan komponen biru disimpan dalam bit yang paling tidak signifikan.

void XMCOLOR()

Konstruktor default untuk XMCOLOR

Konstruktor default untuk XMCOLOR

Catatan Ini hanya tersedia untuk pengembangan berbasis C++.

 

void XMCOLOR( const XMCOLOR & unnamedParam1)

Konstruktor untuk XMCOLOR

Konstruktor untuk XMCOLOR

Catatan Ini hanya tersedia untuk pengembangan berbasis C++.

XMCOLOR & operator=( const XMCOLOR & unnamedParam1)

void XMCOLOR( XMCOLOR && unnamedParam1)

Konstruktor untuk XMCOLOR

Konstruktor untuk XMCOLOR

Catatan Ini hanya tersedia untuk pengembangan berbasis C++.

XMCOLOR & operator=( XMCOLOR && unnamedParam1)

Operator ini menetapkan data komponen vektor dari satu instans XMCOLOR ke instans XMCOLOR saat ini.

Catatan Operator ini hanya tersedia di bawah C++.

noexcept XMCOLOR( uint32_t Color) void

Menginisialisasi instans baru dari XMCOLOR variabel yang uint32_t berisi data komponen dalam format yang dikemas.

Konstruktor ini menginisialisasi instans baru XMCOLOR dari variabel yang uint32_t berisi data komponen dalam format yang dikemas.

Catatan Konstruktor ini hanya tersedia di bawah C++.

 

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

Menginisialisasi instans baru dari XMCOLOR empat float argumen.

Konstruktor ini menginisialisasi instans baru XMCOLOR dari empat float argumen.

Catatan Konstruktor ini hanya tersedia di bawah C++.

 

void XMCOLOR( const float *pArray) noexcept

Menginisialisasi instans baru XMCOLOR dari argumen array empat elemen float .

Konstruktor ini menginisialisasi instans baru XMCOLOR dari argumen array empat elemen float .

Catatan Ini hanya tersedia untuk pengembangan berbasis C++.

noexcept operator void uint32_t()

Mengembalikan instans uint32_t yang berisi komponen instans XMCOLOR dalam format yang dikemas.

Catatan Operator ini hanya tersedia di bawah C++.

 

Noexcept XMCOLOR & operator=( const uint32_t Color)

Menetapkan data komponen vektor yang dikemas dalam instans uint32_t ke instans saat ini dari XMCOLOR.

Operator ini menetapkan data komponen vektor yang dikemas dalam instans uint32_t ke instans XMCOLOR saat ini.

Catatan Operator ini hanya tersedia di bawah C++.

 

Keterangan

Konstruktor yang XMCOLOR menggunakan argumen floating point memerlukan input yang dinormalisasi, yang dijepit ke kisaran [0-1.0]. Selama instansiasi, data floating point yang menentukan saluran warna dikalikan dengan 255,0f, dibulatkan dan kemudian ditetapkan ke anggota yang sesuai dari XMCOLOR.

XMCOLOR dapat digunakan untuk memuat instans XMVECTOR dari nilai yang dinormalisasi, dengan menggunakan XMLoadColor, yang membagi data saluran warna sebesar 255,0f, membulatkan hasilnya, lalu menetapkan komponen ke XMVECTOR instans.

XMVECTOR instans yang berisi nilai yang dinormalisasi dapat disimpan ke dalam XMCOLOR menggunakan XMStoreColor, yang mengalikan data saluran warna sebesar 255,0f, membulatkan hasil sebelum menetapkan nilai ke anggota yang sesuai XMCOLOR .

Namespace: Gunakan DirectX::P ackedVector

Persyaratan Platform

Microsoft Visual Studio 2010 atau Microsoft Visual Studio 2012 dengan Windows SDK untuk Windows 8. Didukung untuk aplikasi desktop Win32, aplikasi Windows Store, dan aplikasi Windows Phone 8.

Persyaratan

Header	directxpackedvector.h

Lihat juga

Struktur Pustaka DirectXMath

Ekstensi XMCOLOR