IDWriteFontFace1::GetRecommendedRenderingMode 메서드(dwrite_1.h)

지정된 크기 및 렌더링 매개 변수를 사용하여 글꼴에 권장되는 렌더링 모드를 결정합니다.

구문

HRESULT GetRecommendedRenderingMode(
                 FLOAT                    fontEmSize,
                 FLOAT                    dpiX,
                 FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
                 BOOL                     isSideways,
                 DWRITE_OUTLINE_THRESHOLD outlineThreshold,
                 DWRITE_MEASURING_MODE    measuringMode,
  [out]          DWRITE_RENDERING_MODE    *renderingMode
);

매개 변수

fontEmSize

형식: FLOAT

DIP 단위로 된 글꼴의 논리적 크기입니다. DIP("디바이스 독립적 픽셀")는 1/96인치와 같습니다.

dpiX

형식: FLOAT

수평 위치의 DIP당 실제 픽셀 수입니다. 예를 들어 렌더링 화면의 DPI가 96이면 이 값은 1.0f입니다. DPI가 120이면 이 값은 120.0f/96입니다.

dpiY

형식: FLOAT

세로 위치의 DIP당 실제 픽셀 수입니다. 예를 들어 렌더링 화면의 DPI가 96이면 이 값은 1.0f입니다. DPI가 120이면 이 값은 120.0f/96입니다.

[in, optional] transform

형식: const DWRITE_MATRIX*

월드 변환을 지정합니다.

isSideways

형식: BOOL

실행의 문자 모양이 옆으로 표시되는지 여부입니다.

outlineThreshold

형식: DWRITE_OUTLINE_THRESHOLD

그래픽 시스템의 개요 렌더링 품질을 지정하는 DWRITE_OUTLINE_THRESHOLD 형식의 값은 개요 렌더링이 사용되는 위의 크기 임계값에 영향을 줍니다.

measuringMode

형식: DWRITE_MEASURING_MODE

글꼴의 문자 모양에 사용할 측정 메서드입니다. 렌더러 구현은 다음과 같은 다양한 측정 방법에 대해 다른 렌더링 모드를 선택할 수 있습니다.

• DWRITE_MEASURING_MODE_NATURAL 대한 DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL
• DWRITE_MEASURING_MODE_GDI_CLASSIC 대한 DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC
• DWRITE_MEASURING_MODE_GDI_NATURAL 대한 DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL

[out] renderingMode

형식: DWRITE_RENDERING_MODE*

이 메서드가 반환되면 사용할 권장 렌더링 모드를 나타내는 값이 포함됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 렌더링 매개 변수 개체의 렌더링 모드가 DWRITE_RENDERING_MODE_DEFAULT 경우 실제 렌더링 모드를 확인하는 데 사용해야 합니다.

요구 사항

추가 정보

IDWriteFontFace1