IDWriteFontFace3::GetRecommendedRenderingMode 메서드(dwrite_3.h)

글꼴, 크기, 월드 변환 및 측정 모드에 따라 사용할 권장 텍스트 렌더링 및 그리드 맞춤 모드를 결정합니다.

구문

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

매개 변수

[in] fontEmSize

형식: FLOAT

DIP의 논리적 글꼴 크기입니다.

[in] dpiX

형식: FLOAT

가로 방향의 논리 인치당 픽셀 수입니다.

[in] dpiY

형식: FLOAT

세로 방향의 논리적 인치당 픽셀 수입니다.

[in, optional] transform

형식: const DWRITE_MATRIX*

월드 변환을 설명하는 DWRITE_MATRIX 구조체입니다.

[in] isSideways

형식: BOOL

글꼴이 옆면인지 여부를 지정합니다. 글 꼴이 옆으로 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

[in] outlineThreshold

형식: DWRITE_OUTLINE_THRESHOLD

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

[in] measuringMode

형식: DWRITE_MEASURING_MODE

텍스트 레이아웃 중에 측정하는 데 사용되는 메서드를 지정하는 DWRITE_MEASURING_MODE 형식의 값입니다. 적절한 문자 모양 간격의 경우 이 메서드는 지정된 측정 모드와 호환되는 렌더링 모드를 반환합니다.

[in, optional] renderingParams

형식: IDWriteRenderingParams*

렌더링 매개 변수 개체에 대한 IDWriteRenderingParams 인터페이스에 대한 포인터입니다. 이 매개 변수는 렌더링 매개 변수 개체가 렌더링 모드를 재정의하는 경우에 필요합니다.

[out] renderingMode

형식: DWRITE_RENDERING_MODE1*

권장 렌더링 모드에 대한 DWRITE_RENDERING_MODE1 형식의 값을 수신하는 변수에 대한 포인터입니다.

[out] gridFitMode

형식: DWRITE_GRID_FIT_MODE*

권장 그리드 맞춤 모드에 대한 DWRITE_GRID_FIT_MODE 형식 값을 수신하는 변수에 대한 포인터입니다.

반환 값

형식: HRESULT

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

요구 사항

지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwrite_3.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteFontFace3