IMixerPinConfig::SetColorKey 메서드(mpconfig.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 SetColorKey 비디오 스트림에서 사용되는 색 키를 설정합니다.

구문

HRESULT SetColorKey(
  [in] COLORKEY *pColorKey
);

매개 변수

[in] pColorKey

COLORKEY 구조체에 대한 포인터입니다.

반환 값

HRESULT 값을 반환합니다.

설명

색 키라는 용어는 참조하는 스트림에 따라 다른 의미를 줍니다. 기본 스트림의 색 키는 오버레이 표면에서 사용되는 대상 색 키를 나타냅니다. 보조 스트림의 색 키는 오프스크린 표면에서 기본 화면으로 블리팅할 때 사용되는 원본 색 키를 나타냅니다.

애플리케이션은 기본 핀의 색 키를 모호한 색(모든 확률로 바탕 화면에 존재하지 않는 일부 색)으로 설정해야 합니다. 오버레이 믹서 필터는 모호한 색을 선택하려고 시도하지만 애플리케이션에서 지정된 색이 다른 콘텐츠의 일부임을 알고 있는 경우 애플리케이션에서 이를 변경해야 합니다.

보조 스트림에서 색 키를 설정하여 스트림을 투명하게 만들고 비각형 이미지를 사용하도록 설정할 수 있습니다. 예를 들어 보조 스트림이 선택 자막 텍스트인 경우 선택 자막 텍스트 디코더는 배경에 단색을 그은 다음 해당 핀의 색 키를 해당 색으로 설정해야 합니다. 이렇게 하면 색 키로 지정된 픽셀을 제외한 모든 픽셀이 전송됩니다. 가능하면 애플리케이션은 보조 스트림의 색 키를 기본 스트림의 색 키와 동일하게 설정하여 약간의 성능 이점을 제공해야 합니다.

기본 스트림에서 이 값을 설정하면 오버레이 표면에서 사용되는 대상 색 키가 설정됩니다. 기본적으로 대상 색 키는 모든 투명(보조) 스트림의 색 키로 사용됩니다.

pColorKey 매개 변수의 유효한 인수에는 비디오 표시 모드가 256색으로 설정된 경우의 CK_INDEX, 비디오 표시 모드가 하이 컬러, 24비트 또는 32비트와 같은 더 높은 색 깊이로 설정된 경우 CK_RGB 포함됩니다. CK_RGB 플래그는 CK_INDEX 함께 지정해야 합니다. CK_INDEX 플래그가 설정된 경우 인덱스는 256 색 모드에서 색상표 인덱스로 사용됩니다. 그러나 표시 모드가 즉시 변경될 경우 DirectShow가 지정된 진 색을 사용하여 로 전환할 수 있도록 유효한 진색을 가진 COLORREF 를 제공해야 합니다. 이는 많은 참 색을 단일 색상표 인덱스로 매핑할 수 있지만 색상표 인덱스에서 실제 색으로 다른 방향으로 가는 것은 일대일이 아니기 때문입니다.

요구 사항

추가 정보

오류 및 성공 코드

IMixerPinConfig 인터페이스

IMixerPinConfig::GetColorKey