ID2D1RenderTarget::SetDpi method (d2d1.h)

Sets the dots per inch (DPI) of the render target.

Syntax

void SetDpi(
  FLOAT dpiX,
  FLOAT dpiY
);

Parameters

dpiX

Type: FLOAT

A value greater than or equal to zero that specifies the horizontal DPI of the render target.

dpiY

Type: FLOAT

A value greater than or equal to zero that specifies the vertical DPI of the render target.

Return value

None

Remarks

This method specifies the mapping from pixel space to device-independent space for the render target. If both dpiX and dpiY are 0, the factory-read system DPI is chosen. If one parameter is zero and the other unspecified, the DPI is not changed.

For ID2D1HwndRenderTarget, the DPI defaults to the most recently factory-read system DPI. The default value for all other render targets is 96 DPI.

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1.h
Library D2d1.lib
DLL D2d1.dll

See also

ID2D1RenderTarget