Bagikan melalui

Gambaran umum DWriteCore

DWriteCore adalah implementasi Windows App SDKDirectWrite (DirectWrite adalah API DirectX untuk penyajian teks berkualitas tinggi, font outline yang independen dari resolusi, serta dukungan untuk teks dan tata letak Unicode sepenuhnya). DWriteCore adalah bentuk DirectWrite yang dapat berjalan pada versi Windows hingga Windows 10, versi 1809 (10.0; Build 17763). DWriteCore mengimplementasikan API yang sama dengan DirectWrite, dengan beberapa penambahan seperti yang dijelaskan dalam topik ini.

Topik pengantar ini menjelaskan apa itu DWriteCore, dan menunjukkan cara menginstalnya ke lingkungan pengembangan dan program Anda dengannya.

Untuk aplikasi yang sudah menggunakan DirectWrite, beralih ke DWriteCore memerlukan perubahan minimal:

Sebagai imbalannya, aplikasi mendapatkan keuntungan dari Windows App SDK—yaitu, akses ke API dan fungsionalitas terbaru terlepas dari versi Windows apa yang dijalankan pelanggan Anda.

Petunjuk

Untuk deskripsi dan tautan ke komponen DirectX dalam pengembangan aktif, lihat posting blog Halaman Utama DirectX.

Proposisi nilai DWriteCore

DirectWrite sendiri mendukung berbagai fitur yang menjadikannya alat penyajian font pilihan di Windows untuk sebagian besar aplikasi—baik itu melalui panggilan langsung, atau melalui Direct2D. DirectWrite mencakup sistem tata letak teks independen perangkat, sub-piksel berkualitas tinggi penyajian teks Microsoft ClearType, teks yang dipercepat perangkat keras, teks multiformat, fitur tipografi OpenType® tingkat lanjut, dukungan bahasa luas, dan GDItata letak dan penyajian yang kompatibel. DirectWrite telah tersedia sejak Windows Vista SP2, dan telah berkembang selama bertahun-tahun untuk menyertakan fitur yang lebih canggih seperti font variabel, yang memungkinkan Anda menerapkan gaya, bobot, dan atribut lainnya ke font hanya dengan satu sumber daya font.

Namun, karena umur panjang DirectWrite, kemajuan dalam pengembangan cenderung meninggalkan versi Windows yang lebih lama. Selain itu, status DirectWrite sebagai teknologi penyajian teks utama hanya terbatas pada Windows, meninggalkan aplikasi lintas platform untuk menulis tumpukan penyajian teks mereka sendiri, atau untuk mengandalkan solusi pihak ke-3.

DWriteCore memecahkan masalah mendasar terkait kekosongan fitur versi dan kompatibilitas antar-platform dengan menghapus pustaka dari sistem serta menargetkan semua titik akhir yang mungkin didukung. Untuk itu, kami telah mengintegrasikan DWriteCore ke dalam Windows App SDK.

Nilai utama yang diberikan DWriteCore, sebagai pengembang, di Windows App SDK adalah menyediakan akses ke banyak (dan akhirnya semua) fitur DirectWrite. Semua fitur DWriteCore akan berfungsi sama pada semua versi tingkat bawah tanpa perbedaan apa pun mengenai fitur mana yang mungkin berfungsi pada versi mana.

Aplikasi demo DWriteCore—DWriteCoreGallery

DWriteCore ditunjukkan dengan cara aplikasi sampel DWriteCoreGallery, yang tersedia untuk Anda unduh dan pelajari.

Mulai menggunakan DWriteCore

DWriteCore adalah bagian dari Windows App SDK. Bagian ini menjelaskan cara menyiapkan lingkungan pengembangan Anda untuk pemrograman dengan DWriteCore.

Menginstal alat untuk Windows App SDK

Lihat alat Penginstalan untukWindows App SDK .

Membuat proyek baru

Di Visual Studio, buat proyek baru dari templat proyek Blank App, Packaged (WinUI 3 in Desktop). Anda dapat menemukan templat proyek tersebut dengan memilih bahasa: C++; platform: Windows App SDK ; jenis proyek: Desktop.

Untuk informasi selengkapnya, lihat templat Proyek untuk WinUI 3.

Menginstal paket NuGet Microsoft.ProjectReunion.DWrite

Di Visual Studio, klik Project>Kelola Paket NuGet...>Telusuri, ketik atau tempel Microsoft.ProjectReunion.DWrite di kotak pencarian, pilih item di hasil pencarian, lalu klik Instal untuk menginstal paket untuk proyek tersebut.

Atau, mulailah dengan aplikasi sampel DWriteCoreGallery

Atau, Anda dapat memprogram dengan DWriteCore dengan memulai proyek aplikasi sampel DWriteCoreGallery, dan mendasarkan pengembangan Anda pada proyek tersebut. Anda kemudian dapat merasa bebas untuk menghapus kode sumber (atau file) yang ada dari proyek sampel tersebut, dan untuk menambahkan kode sumber baru (atau file) ke proyek.

Menggunakan DWriteCore dalam proyek Anda

Untuk informasi selengkapnya tentang pemrograman dengan DWriteCore, lihat bagian Pemrograman dengan DWriteCore nanti dalam topik ini.

Fase rilis DWriteCore

Porting DirectWrite ke DWriteCore adalah proyek yang cukup besar untuk mencakup beberapa siklus rilis Windows. Proyek tersebut dibagi menjadi beberapa fase, yang masing-masing sesuai dengan potongan fungsionalitas yang dikirimkan dalam rilis.

Fitur dalam rilis DWriteCore saat ini

DWriteCore adalah bagian dari Windows App SDK. Ini berisi alat dasar yang Anda, sebagai pengembang, perlu menggunakan DWriteCore, termasuk fitur-fitur berikut.

Fitur banner adalah font warna. Font warna memungkinkan Anda merender font Anda dengan fungsionalitas warna yang lebih canggih di luar warna tunggal sederhana. Misalnya, font warna adalah yang mendukung kemampuan untuk merender font ikon emoji dan toolbar (yang terakhir digunakan oleh Office, misalnya). Font warna pertama kali diperkenalkan di Windows 8.1, tetapi fitur ini sangat diperluas pada Windows 10, versi 1607 (Pembaruan Hari Jadi).

Pekerjaan pembersihan cache font, dan pemuat font dalam memori, memungkinkan pemuatan font yang lebih cepat, dan peningkatan memori.

Dengan fitur-fitur ini, Anda dapat segera mulai memanfaatkan beberapa fungsionalitas inti modern DirectWrite—seperti font variabel. Font variabel adalah salah satu fitur terpenting untuk pelanggan DirectWrite.

Undangan kami kepada Anda sebagai pengembang DirectWrite

DWriteCore, bersama dengan komponen Windows App SDK lainnya, akan dikembangkan dengan kebukaan terhadap umpan balik pengembang. Kami mengundang Anda untuk mulai menjelajahi DWriteCore, dan untuk memberikan wawasan atau permintaan ke dalam pengembangan fitur pada repositori GitHub Windows App SDK kami.

Pemrograman dengan DWriteCore

Sama seperti DirectWrite, Anda memprogram dengan DWriteCore melalui API COM-light-nya, melalui antarmukaIDWriteFactory.

Untuk menggunakan DWriteCore, perlu menyertakan file header dwrite_core.h.

// pch.h
...
// DWriteCore header file.
#include <dwrite_core.h>

File header dwrite_core.h pertama-tama menentukan token DWRITE_CORE, lalu menyertakan file header dwrite_3.h. Token DWRITE_CORE penting, karena mengarahkan header yang kemudian disertakan untuk membuat semua API DirectWrite tersedia untuk Anda. Setelah proyek Anda menyertakan dwrite_core.h, Anda kemudian dapat melanjutkan dan menulis kode, membangun, dan menjalankan.

API yang baru, atau berbeda, untuk DWriteCore

Permukaan API DWriteCore sebagian besar sama dengan untuk DirectWrite. Tetapi ada sejumlah kecil API baru yang hanya ada di DWriteCore saat ini.

Membuat objek pabrik

Fungsi DWriteCoreCreateFactory gratis membuat objek pabrik yang digunakan untuk pembuatan objek DWriteCore individual berikutnya.

DWriteCoreCreateFactory secara fungsional sama dengan fungsi DWriteCreateFactory yang diekspor oleh versi sistem DirectWrite. Fungsi DWriteCore memiliki nama yang berbeda untuk menghindari ambiguitas.

Membuat objek pabrik yang terbatasi

Enumerasi DWRITE_FACTORY_TYPE memiliki konstanta baru—DWRITE_FACTORY_TYPE_ISOLATED2, yang menunjukkan pabrik yang dibatasi. Pabrik terbatas lebih terkunci daripada pabrik yang terisolasi. Ini tidak berinteraksi dengan lintas proses maupun cache font persisten dengan cara apa pun. Selain itu, koleksi font sistem yang dikembalikan dari pabrik ini hanya mencakup font terkenal. Berikut cara menggunakan DWRITE_FACTORY_TYPE_ISOLATED2 untuk membuat objek pabrik terbatas saat Anda memanggil fungsi DWriteCoreCreateFactory gratis.

// Create a factory that doesn't interact with any cross-process nor
// persistent cache state.
winrt::com_ptr<::IDWriteFactory7> spFactory;
winrt::check_hresult(
  ::DWriteCoreCreateFactory(
    DWRITE_FACTORY_TYPE_ISOLATED2,
    __uuidof(spFactory),
    reinterpret_cast<IUnknown**>(spFactory.put())
  )
);

Jika Anda meneruskan DWRITE_FACTORY_TYPE_ISOLATED2 ke versi DirectWrite yang lebih lama yang tidak mendukungnya, maka DWriteCreateFactory mengembalikan E_INVALIDARG.

Menggambar glif ke dalam bitmap memori sistem

DirectWrite memiliki antarmuka target render bitmap yang mendukung rendering glyph ke bitmap dalam memori sistem. Namun, saat ini satu-satunya cara untuk mendapatkan akses ke data piksel yang mendasar adalah dengan melalui GDI, sehingga API tidak dapat digunakan lintas platform. Ini mudah diperbaiki dengan menambahkan metode untuk mengambil data piksel.

Sehingga DWriteCore memperkenalkan antarmukaIDWriteBitmapRenderTarget2, dan metodenya IDWriteBitmapRenderTarget2::GetBitmapData. Metode itu mengambil parameter jenis (pointer ke) DWRITE_BITMAP_DATA_BGRA32, yang merupakan struct baru.

Aplikasi Anda membuat target render bitmap dengan memanggil IDWriteGdiInterop::CreateBitmapRenderTarget. Di Windows, target render bitmap merangkum DC memori GDI dengan bitmap independen perangkat GDI (DIB) yang dipilih ke dalamnya. IDWriteBitmapRenderTarget::DrawGlyphRun menggambar glyph ke DIB. DirectWrite menghasilkan aksara itu sendiri tanpa melalui GDI. Aplikasi Anda kemudian bisa mendapatkan HDC dari target render bitmap, dan menggunakan BitBlt untuk menyalin piksel ke jendela HDC.

Pada platform non-Windows, aplikasi Anda masih dapat membuat target render bitmap, tetapi hanya merangkum array memori sistem tanpa HDC dan tanpa DIB. Tanpa HDC, harus ada cara lain bagi aplikasi Anda untuk mendapatkan piksel bitmap sehingga dapat menyalinnya, atau menggunakannya. Bahkan di Windows, terkadang berguna untuk mendapatkan data piksel aktual, dan kami menunjukkan cara saat ini untuk melakukannya dalam contoh kode di bawah ini.

// pch.h
#pragma once

#include <windows.h>
#include <Unknwn.h>
#include <winrt/Windows.Foundation.h>

// WinMain.cpp
#include "pch.h"
#include <dwrite_core.h>
#pragma comment(lib, "Gdi32")

class TextRenderer
{
    DWRITE_BITMAP_DATA_BGRA32 m_targetBitmapData;

public:
    void InitializeBitmapData(winrt::com_ptr<IDWriteBitmapRenderTarget> const& renderTarget)
    {
        // Query the bitmap render target for the new interface. 
        winrt::com_ptr<IDWriteBitmapRenderTarget2> renderTarget2;
        renderTarget2 = renderTarget.try_as<IDWriteBitmapRenderTarget2>();

        if (renderTarget2)
        {
            // IDWriteBitmapRenderTarget2 exists, so we can get the bitmap the easy way. 
            winrt::check_hresult(renderTarget2->GetBitmapData(OUT & m_targetBitmapData));
        }
        else
        {
            // We're using an older version that doesn't implement IDWriteBitmapRenderTarget2, 
            // so we have to get the bitmap by going through GDI. First get the bitmap handle. 
            HDC hdc = renderTarget->GetMemoryDC();
            winrt::handle dibHandle{ GetCurrentObject(hdc, OBJ_BITMAP) };
            winrt::check_bool(bool{ dibHandle });

            // Call a GDI function to fill in the DIBSECTION structure for the bitmap. 
            DIBSECTION dib;
            winrt::check_bool(GetObject(dibHandle.get(), sizeof(dib), &dib));

            m_targetBitmapData.width = dib.dsBm.bmWidth;
            m_targetBitmapData.height = dib.dsBm.bmHeight;
            m_targetBitmapData.pixels = static_cast<uint32_t*>(dib.dsBm.bmBits);
        }
    }
};

int __stdcall wWinMain(HINSTANCE, HINSTANCE, LPWSTR, int)
{
    TextRenderer textRenderer;
    winrt::com_ptr<IDWriteBitmapRenderTarget> renderTarget{ /* ... */ };
    textRenderer.InitializeBitmapData(renderTarget);
}

Perbedaan API lainnya antara DWriteCore dan DirectWrite

Ada beberapa API yang hanya merupakan rangkap, atau bersifat agak berbeda pada platform non-Windows. Misalnya, IDWriteGdiInterop::CreateFontFaceFromHdc mengembalikan E_NOTIMPL pada platform non-Windows, karena tidak ada hal seperti HDC tanpa GDI.

Dan, akhirnya, ada BEBERAPA API Windows lain yang biasanya digunakan bersama dengan DirectWrite (Direct2D menjadi contoh penting). Namun, saat ini, Direct2D dan DWriteCore tidak beroperasi. Misalnya, jika Anda membuat IDWriteTextLayout menggunakan DWriteCore, dan meneruskannya ke D2D1RenderTarget::DrawTextLayout, maka panggilan tersebut akan gagal.

  • Last updated on