Bagikan melalui


Fungsi XMColorAdjustSaturation (directxmath.h)

Menyesuaikan nilai saturasi warna.

Sintaks

XMVECTOR XM_CALLCONV XMColorAdjustSaturation(
  [in] FXMVECTOR C,
  [in] float     Saturation
) noexcept;

Parameter

[in] C

XMVECTOR yang menjelaskan warnanya. Masing-masing komponen C harus dalam rentang 0,0f hingga 1,0f.

[in] Saturation

Nilai saturasi. Parameter ini secara linier menginterpolasi antara warna yang dikonversi ke skala abu-abu dan warna asli, C. Jika Saturasi adalah 0,0f, fungsi mengembalikan warna skala abu-abu. Jika Saturasi adalah 1,0f, fungsi mengembalikan warna asli.

Nilai kembali

Mengembalikan XMVECTOR yang menjelaskan warna yang dihasilkan dari penyesuaian saturasi.

Keterangan

Pseudocode berikut menunjukkan pengoperasian fungsi.

XMVector colorOut;

// Approximate values for each component's contribution to luminance.
// Based upon the NTSC standard described in ITU-R Recommendation BT.709.
float Luminance = 0.2125f * C.x + 0.7154f * C.y + 0.0721f * C.z;

colorOut.x = (C.x - Luminance) * Saturation + Luminance;
colorOut.y = (C.y - Luminance) * Saturation + Luminance;
colorOut.z = (C.z - Luminance) * Saturation + Luminance;
colorOut.w = C.w;

return colorOut;

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

Persyaratan Nilai
Target Platform Windows
Header directxmath.h

Lihat juga

Fungsi Warna Pustaka DirectXMath