Microsoft MVP성태의 닷넷 이야기
.NET Framework: 724. WPF + Direct2D 출력 C# 예제 [링크 복사], [링크+제목 복사],
조회: 31471
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 2개 있습니다.)

WPF + Direct2D 출력 C# 예제

WPF에서 Direct2D를 쓰기 위한 방법을 알아봤습니다. 검색해 보면 많은 글들이 나오는데 제 경우에는 아래의 설명이 좋았습니다.

Using Direct2D with WPF
; https://www.codeproject.com/Articles/113991/Using-Direct-D-with-WPF

WPF는 .NET 3.5 SP1부터 D3DImage 타입을 Direct3D 통합을 위해 제공한다고 합니다. 그리고 이 방법은 다음의 글에서 잘 설명하고 있습니다.

Introduction to D3DImage
; https://www.codeproject.com/Articles/28526/Introduction-to-D-DImage

위의 글에 대해서는 저도 예전에 빌드한 적이 있었습니다. ^^

DirectX 9 예제 프로젝트 빌드하는 방법
; https://www.sysnet.pe.kr/2/0/1723

하지만, D3DImage가 Direct3D 9 버전의 컨테이너여서 Direct2D가 기반으로 하는 Direct3D 10.1 이상의 버전과 달라 문제가 되는데, 이에 대한 해결책으로,

Direct3D 10/11 & Direct2D in WPF
; http://jmorrill.hjtcentral.com/Home/tabid/428/EntryId/437/Direct3D-10-11-Direct2D-in-WPF.aspx

Direct3D 10/11에서 생성한 공유 Render Target을 IDirect3DDevice9Ex에 전달하면 된다고 합니다. Direct3D를 잘 모르니 ^^ 정확한 동작 방식은 모르겠으나, 어쨌든 복잡한 부분은 "Using Direct2D with WPF" 글에서 공개한 Direct2D C# 프로젝트에서 잘 래핑하고 있습니다.




그럼, 공개된 C# 프로젝트를 이용해 간단한 실습을 해볼까요? ^^ 이를 위해 WPF 프로젝트를 만들고, Direct2D C# 라이브러리 프로젝트를 빌드한 DLL(Direct2D.dll)을 참조합니다. (또는 프로젝트를 복사해 참조하거나.)

그다음 NuGet을 통해 "WindowsAPICodePack.DirectX"를 참조 추가합니다. (Direct2D C# 라이브러리도 동일한 NuGet 패키지로 바꿔줍니다.) 이제 MainWindow.xaml을 열어 다음과 같이 IDirect3DDevice9Ex와 연결된 D3DImage를 소유한 컨트롤(Direct2DControl)을 만듭니다.

<Window x:Class="WpfApp1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp1"
        mc:Ignorable="d"
        xmlns:d2d="clr-namespace:Direct2D;assembly=Direct2D"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <d2d:Direct2DControl x:Name="d2DControl" Margin="5" />
    </Grid>
</Window>

이어서 해당 컨트롤에 그림 그리기 작업을 수행할 타입을 하나 만듭니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using D2D = Microsoft.WindowsAPICodePack.DirectX.Direct2D1;
using DWrite = Microsoft.WindowsAPICodePack.DirectX.DirectWrite;

namespace WpfApp1
{
    class BasicScene : Direct2D.AnimatedScene
    {
        public BasicScene() : base(100)
        {
        }

        protected override void Dispose(bool disposing)
        {
            base.Dispose(disposing);
        }

        protected override void OnCreateResources()
        {
            base.OnCreateResources(); // Call this last to start the animation
        }

        protected override void OnFreeResources()
        {
            base.OnFreeResources(); // Call this first to stop the animation
        }

        protected override void OnRender()
        {
            var size = this.RenderTarget.Size;

            this.RenderTarget.BeginDraw();
            this.RenderTarget.Clear(new D2D.ColorF(0, 0, 1, 1f));


            this.RenderTarget.EndDraw();
        }
    }
}

직관적으로, 그리기 작업을 OnRender의 BeginDraw/EndDraw 사이에 넣으면 된다는 것을 알 수 있습니다. (위의 코드는 Clear 메서드로 인해 컨트롤 영역을 파란색으로 채우기만 합니다.)

마지막으로, 위의 BasicScene 인스턴스를 xaml에서 생성한 Direct2DControl과 연결해줍니다.

public partial class MainWindow : Window
{
    BasicScene scene;

    public MainWindow()
    {
        InitializeComponent();

        scene = new BasicScene();
        this.d2DControl.Scene = scene;
        scene.IsAnimating = true;
    }
}

끝입니다. 이렇게 만들고 실행하면 다음과 같이 파란색으로 칠해진 화면을 볼 수 있습니다. (물론 원한다면 얼마든지 OnRender 메서드에 Direct2D API를 호출해 작업을 추가할 수 있습니다.)

wpf_direct2d_1.png

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




그 외에, 검색해 보면 HwndHost를 이용한 방법도 있습니다. 그것의 단점이라면 HWND 윈도우 핸들을 기반으로 하기 때문에 다른 WPF 요소들 간의 조화가 깨지게 됩니다.

또는, SharpDX를 기반으로 한 버전도 있습니다.

SharpDX.WPF
; https://sharpdxwpf.codeplex.com/

아쉽게도 상당히 지난 버전으로 최신 SharpDX를 적용하려면 위의 코드에서 약간의 마이그레이션 작업이 필요합니다.

만약 WPF가 아닌 UWP 앱이라면 SwapChainPanel이 있어 좀 더 매끄럽게 통합이 됩니다. 이에 대해서는 다음의 글들을 참고하세요.

Your first DirectX 11 Metro application using SharpDX
; https://english.r2d2rigo.es/2012/05/28/your-first-directx-11-metro-application-using-sharpdx/

Basic Direct2D drawing with SharpDX
; https://english.r2d2rigo.es/2012/07/04/basic-direct2d-drawing-with-sharpdx/




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 3/10/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2018-01-11 02시37분
WPF + Direct2D + SharpDX 출력 C# 예제
; http://www.sysnet.pe.kr/2/0/11432
정성태
2021-03-26 04시32분
jingwood/d2dlib - A .NET library for hardware-accelerated, high performance, immediate mode rendering via Direct2D.
; https://github.com/jingwood/d2dlib

[.Net] 이미지 뷰어는 ImageGlass로 쉽게 개발하기
; https://luckygg.tistory.com/373
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
14013정성태9/14/2025387닷넷: 2363. C# - Whisper.NET Library를 이용해 음성을 텍스트로 변환 및 번역하는 예제파일 다운로드1
14012정성태9/9/2025800닷넷: 2362. C# - Windows.Media.Ocr: 윈도우 운영체제에 포함된 OCR(Optical Character Recognition)파일 다운로드1
14011정성태9/7/20251360닷넷: 2361. C# - Linux 환경의 readlink 호출
14010정성태9/1/20251490오류 유형: 983. apt update 시 "The repository 'http://deb.debian.org/debian buster Release' does not have a Release file." 오류
14009정성태8/28/20251912닷넷: 2360. C# 14 - (11) Expression Tree에 선택적 인수와 명명된 인수 허용파일 다운로드1
14008정성태8/26/20252238닷넷: 2359. C# 14 - (10) 복합 대입 연산자의 오버로드 지원파일 다운로드1
14007정성태8/25/20252614닷넷: 2358. C# - 현재 빌드에 적용 중인 컴파일러 버전 확인 방법 (#error version)
14006정성태8/23/20252813Linux: 121. Linux - snap 패키지 관리자로 설치한 소프트웨어의 디렉터리 접근 제한
14005정성태8/21/20252281오류 유형: 982. sudo: unable to load /usr/libexec/sudo/sudoers.so: libssl.so.3: cannot open shared object file: No such file or directory
14004정성태8/21/20252562오류 유형: 981. dotnet 실행 시 No usable version of the libssl was found
14003정성태8/21/20252842닷넷: 2357. C# 14 - (9) 새로운 지시자 추가 (Ignored directives)
14002정성태8/20/20252826오류 유형: 980. C# - appsettings.json 파일의 설정값이 적용 안 된다면?
14001정성태8/19/20255982닷넷: 2356. .NET SDK 10 - 단일 소스 코드 파일을 빌드/실행하는 기능을 "dotnet" 명령어에 추가 [1]
14000정성태8/18/20252925오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/20252886닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/20252830닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/20252942Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/20252415오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/20252590개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/20252316오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/20253118오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20253081닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20252824오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/20252335Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20253325닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...