D3DXColorAdjustSaturation 함수

색의 채도값을 조정한다.

구문

D3DXCOLOR *D3DXColorAdjustSaturation(      

    D3DXCOLOR *pOut,
    D3DXCOLOR *pC,
    FLOAT s
);

파라미터

pOut
[in, out] 연산 결과인 D3DXCOLOR 구조체의 포인터.
pC
[in] 처리의 기본으로 되는 D3DXCOLOR 구조체의 포인터.
s
[in] 포화값. 이 파라미터는, 그레이 스케일에 변환된 색과 원의 색 pC 의 사이에 선형 보간 한다. s 의 값에 제한은 없다. s 가 0 의 경우, 돌려받는 색은 그레이 스케일 컬러이다. s 가 1 의 경우, 돌려받는 색은 원의 색이다.

반환값

이 함수는, 포화 조정 결과의 D3DXCOLOR 구조체의 포인터를 돌려준다.

주의

입력 알파 채널은, 수정되지 않고 출력 알파 채널에 복사 된다.
이 함수의 반환값은,pOut 파라미터의 반환값과 같다. 따라서, 이 함수를 다른 함수의 인수로서 사용할 수 있다.
다음에 나타내는 예의 같게, 이 함수는 미포화색과 있는 컬러의 사이에 D3DXCOLOR 구조체의 적 (red), 초록 (green), 파랑 (blue)의 색성분을 보간 한다.
    // Approximate values for each component's contribution to luminance.
    // Based upon the NTSC standard described in ITU-R Recommendation BT. 709.
    FLOAT grey = pC->r * 0.2125f + pC->g * 0.7154f + pC->b * 0.0721f;

    pOut->r = grey + s * (pC->r - grey);
s 가 0 보다 크게 1 보다 작은 경우, 채도는 작아진다. s 가 1 보다 큰 경우, 채도는 커진다.
그레이 스케일 컬러는 다음과 같이 해 계산된다.
r = g = b = 0.2125*r + 0.7154*g + 0.0721*b

함수의 정보

헤더 d3dx9math.h
임포트 라이브러리 d3dx9.lib
최저한의 operating system Windows 98

헤더	d3dx9math.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98

참조

D3DXColorAdjustContrast