Bagikan melalui

API dan pengaturan registri terkait DPI

Jika Anda perlu melakukan penyesuaian penyebaran, bagian berikut menjelaskan kunci registri dan parameter sistem yang mungkin perlu diakses oleh skrip pasca-penginstalan Anda.

Dalam artikel ini:

Resolusi asli tampilan utama

Tabel 1 Windows 8.1 Tingkat Penskalaan, sementara tanpa berarti lengkap, memberikan informasi tentang tingkat penskalaan Windows 8.1 untuk sejumlah tampilan umum. Panel DPI menunjukkan kepadatan piksel fisik panel, dan tingkat Penskalaan menunjukkan faktor skala yang akan digunakan untuk tampilan ini.

Tabel 1 Windows 8.1 Tingkat Penskalan

Ukuran tampilan Resolusi tampilan Horizontal (piksel) Vertikal (piksel) Panel DPI Tingkat penskalakan
10.6" FHD 1920 1080 208 150%
10.6" HD 1366 768 148 100%
11.6" WUXGA 1920 1200 195 150%
11.6" HD 1366 768 135 100%
13.3" WUXGA 1920 1200 170 150%
13.3" QHD 2560 1440 221 200%
13.3" HD 1366 768 118 100%
15.4" FHD 1920 1080 143 125%
15.6" QHD+ 3200 1800 235 200%
17" FHD 1920 1080 130 125%
23" QFHD (4K) 3840 2160 192 200%
24" QHD 2560 1440 122 125%

Untuk menemukan informasi ini secara terprogram untuk perangkat apa pun, Anda dapat menulis program utilitas yang melaporkan kembali data. Resolusi utama asli diambil dengan memanggil fungsi API GetDeviceCaps(), menggunakan hdc untuk desktop dan indeks HORZRES dan VERTRES:

// Get desktop dc
desktopDc = GetDC(NULL);
// Get native resolution
horizontalResolution = GetDeviceCaps(desktopDc,HORZRES);
verticalResolution = GetDeviceCaps(desktopDc,VERTRES);

Untuk informasi selengkapnya tentang GetDC, lihat Fungsi GetDC().

Faktor skala DPI tampilan utama

Demikian pula, Anda bisa mendapatkan kepadatan piksel dengan menggunakan indeks LOGPIXELSX dan LOGPIXELSY:

// Get desktop dc
desktopDc = GetDC(NULL);
// Get native resolution
horizontalDPI = GetDeviceCaps(desktopDc,LOGPIXELSX);
verticalDPI = GetDeviceCaps(desktopDc,LOGPIXELSY);

Hasil ini dikembalikan dalam sistem koordinat di mana 96 sesuai dengan 100%, seperti yang ditunjukkan dalam Faktor Skala DPI Tabel 2.

Faktor Skala DPI Tabel 2

DPI Faktor skala
96 100
120 125
144 150
192 200

Catatan

API ini akan mengembalikan hasil yang berbeda tergantung pada mode kesadaran DPI aplikasi Anda. Mengonfigurasi mode kesadaran memerlukan penambahan XML ke manifes aplikasi, seperti yang dijelaskan di bawah ini:

Mode Kesadaran DPI Pengaturan Manifes Nilai yang Dikembalikan
Tidak ada Tidak ada  96 untuk semua tampilan, terlepas dari faktor skala
Sistem DPI Sadar <dpiAware>True</dpiAware> DPI tampilan utama pada saat sesi Windows dimulai (ketika pengguna pertama kali masuk ke Windows)
Per-Monitor Sadar DPI <dpiAware>True/PM</dpiAware> DPI tampilan utama pada saat sesi Windows dimulai (ketika pengguna pertama kali masuk ke Windows). Untuk mendapatkan DPI tampilan tempat aplikasi berada, gunakan GetWindowDpi() atau GetDpiForMonitor()

Untuk informasi selengkapnya tentang pengaturan manifes ini, lihat Fungsi SetProcessDPIAware.

Mode penskalakan

Antarmuka pengguna Panel Kontrol\ Appearance and Personalization\Display (UI) menyertakan kotak centang: Biarkan saya memilih satu tingkat penskalaan untuk semua tampilan saya, yang mengontrol apakah sistem menerapkan faktor skala tunggal ke semua tampilan (seperti dalam Windows 8 dan versi Windows yang lebih lama), atau faktor skala berbeda yang memperhitungkan kepadatan piksel setiap tampilan ( Windows 8.1 default). Kotak centang ini mengonfigurasi kunci registri HKCU\Panel Kontrol\Desktop\Win8DpiScaling di Windows 8.1.

Tabel 3 HKCU\Panel Kontrol\Desktop\Win8DpiScaling Values

Nilai kunci Makna
0 Faktor skala yang berbeda untuk setiap tampilan: default Windows 8.1. Konten yang dipindahkan dari satu tampilan ke tampilan lain akan menjadi ukuran yang tepat, tetapi dapat diskalakan bitmap.
1 Faktor skala yang sama diterapkan ke semua tampilan: Windows 8 dan perilaku versi Windows yang lebih lama. Isi yang dipindahkan dari satu tampilan ke tampilan lainnya mungkin ukurannya salah.

Pengabaian penskalaian dalam mode penskalakan Windows 8.1

Ketika kotak centang Izinkan saya memilih satu tingkat penskalaan untuk semua tampilan saya dibersihkan dan sistem berjalan dalam mode penskalaan Windows 8.1, pengguna disediakan dengan penggoser yang memungkinkan mereka mengambil alih faktor skala saat ini, dari Lebih Kecil, ke Sedang, ke Lebih Besar. Pengaturan ini dikonfigurasi dalam kunci registri HKCU\Panel Kontrol\Desktop\DesktopDPIOverride.

Tabel 4 HKCU\Panel Kontrol\Desktop\DesktopDPIOverride Nilai

Nilai kunci Makna
<0 Kurangi setiap faktor skala tampilan dari default dengan nilai ini (misalnya, jika defaultnya adalah penskalaan 150%, -1 sesuai dengan 125%, -2 hingga 100%).
0 Gunakan nilai default untuk setiap tampilan.
0 > Tingkatkan setiap faktor tampilan dengan nilai ini (menggunakan contoh sebelumnya, +1 sesuai dengan penskalakan 200%).

Semua faktor skala tampilan dalam mode ini dibatasi menjadi salah satu dari empat nilai ini: 100%, 125%, 150%, 200%. Selain itu, setelah penskalaan diterapkan, aplikasi mengharapkan untuk memiliki setidaknya 720 baris resolusi yang efektif (yaitu, resolusi vertikal fisik tampilan dibagi dengan faktor skala); ini selanjutnya dapat membatasi rentang faktor skala tampilan yang diizinkan. Nilai Tampilan Tabel 5 memperlihatkan nilai mana yang diizinkan untuk tampilan berukuran berbeda:

Tabel 5 Menampilkan Nilai

Garis vertikal Faktor skala yang didukung
<900 100%
>= 900 dan <1080 100%, 125%
>=1080 dan <1440 100%, 125%, 150%
>=1440 100%, 125%, 150%, 200%

Faktor skala seluruh sistem dalam mode penskalakan Windows 8

Saat kotak centang Biarkan saya memilih satu tingkat penskalaan untuk semua tampilan saya dicentang, pengguna dapat menentukan faktor skala yang berlaku untuk semua tampilan, terlepas dari kepadatan piksel setiap tampilan. Dengan menggunakan pengaturan kustom, pengguna dapat memilih nilai selain 100%, 125%, 150%, 200%, meskipun terbatas pada rentang (100%-500%). Pengaturan ini dikonfigurasi dalam kunci registri HKCU\Panel Kontrol\Desktop\LogPixels.

Tabel 6 HKCU\Panel Kontrol\Desktop\LogPixels Values

Nilai kunci Makna
96 Penskalakan 100% pada setiap tampilan
120 Penskalakan 125% pada setiap tampilan
144 Penskalakan 150% pada setiap tampilan
192 Penskalan 200% pada setiap tampilan
<Lain> <penskalakan 96/100 lainnya> di setiap tampilan

Dokumentasi untuk mengembangkan aplikasi DPI Tinggi

Dukungan DPI Tinggi untuk Profesional TI