How to Ensure That Your Application Displays Properly on High-DPI Displays
Although Direct2D addresses many high-DPI issues for you, there are two steps you should take to ensure that your application works properly on high-DPI displays:
- Step 1: Use the System DPI When Creating Windows
- Step 2: Declare That the Application is DPI-Aware
- Related topics
The ID2D1Factory interface provides the GetDesktopDpi method for retrieving the system DPI. It provides the horizontal and vertical dimensions of the display in dots per inch (DPI). To use these values to set the width of a window, use the following formula:
<horizontal DPI> * <width, in pixels> / <default horizontal DPI>
...where horizontal DPI is the value retrived by GetDesktopDpi and default horizontal DPI is 96. The formula is similar for the vertical size:
<vertical DPI> * <height, in pixels> / <default vertical DPI>
...where vertical DPI is the value retrieved by the GetDesktopDpi method and default vertical DPI is 96.
The following code uses the GetDesktopDpi method to retrieve the system DPI and then creates a 640 × 480 window, scaled to the system DPI.
// Because the CreateWindow function takes its size in pixels, // obtain the system DPI and use it to scale the window size. FLOAT dpiX, dpiY; // The factory returns the current system DPI. This is also the value it will use // to create its own windows. m_pDirect2dFactory->GetDesktopDpi(&dpiX, &dpiY); // Create the window. m_hwnd = CreateWindow( L"D2DDemoApp", L"Direct2D Demo App", WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, static_cast<UINT>(ceil(640.f * dpiX / 96.f)), static_cast<UINT>(ceil(480.f * dpiY / 96.f)), NULL, NULL, HINST_THISCOMPONENT, this );
Starting with Windows 8, you can use the Windows::Graphics::Display::DisplayProperties class to get the system DPI.
When an application declares itself to be DPI-aware, it is a statement specifying that the application behaves well at DPI settings up to 200 DPI. In Windows Vista and Windows 7, when DPI virtualization is enabled, applications that are not DPI-aware are scaled, and applications receive virtualized data from the system APIs, such as the GetSystemMetric function. To declare that your application is DPI-aware, complete the following steps.
- Create a file called DeclareDPIAware.manifest.
- Copy the following xml into the file and save it:
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3" > <asmv3:application> <asmv3:windowsSettings xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings"> <dpiAware>true</dpiAware> </asmv3:windowsSettings> </asmv3:application> </assembly>
- In the project's .vcproj file, add the following entry inside each Configuration element under VisualStudioProject/Configurations:
For the complete code, see the Draw Rectangle Example.
Build date: 11/29/2012