Microsoft MVP성태의 닷넷 이야기
.NET Framework: 724. WPF + Direct2D 출력 C# 예제 [링크 복사], [링크+제목 복사],
조회: 27630
글쓴 사람
정성태 (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)
13843정성태12/13/20244391오류 유형: 938. Docker container 내에서 빌드 시 error MSB3021: Unable to copy file "..." to "...". Access to the path '...' is denied.
13842정성태12/12/20244534디버깅 기술: 205. Windbg - KPCR, KPRCB
13841정성태12/11/20244866오류 유형: 937. error MSB4044: The "ValidateValidArchitecture" task was not given a value for the required parameter "RemoteTarget"
13840정성태12/11/20244439오류 유형: 936. msbuild - Your project file doesn't list 'win' as a "RuntimeIdentifier"
13839정성태12/11/20244877오류 유형: 936. msbuild - error CS1617: Invalid option '12.0' for /langversion. Use '/langversion:?' to list supported values.
13838정성태12/4/20244604오류 유형: 935. Windbg - Breakpoint 0's offset expression evaluation failed.
13837정성태12/3/20245073디버깅 기술: 204. Windbg - 윈도우 핸들 테이블 (3) - Windows 10 이상인 경우
13836정성태12/3/20244625디버깅 기술: 203. Windbg - x64 가상 주소를 물리 주소로 변환 (페이지 크기가 2MB인 경우)
13835정성태12/2/20245071오류 유형: 934. Azure - rm: cannot remove '...': Directory not empty
13834정성태11/29/20245301Windows: 275. C# - CUI 애플리케이션과 Console 윈도우 (Windows 10 미만의 Classic Console 모드인 경우) [1]파일 다운로드1
13833정성태11/29/20244979개발 환경 구성: 737. Azure Web App에서 Scale-out으로 늘어난 리눅스 인스턴스에 SSH 접속하는 방법
13832정성태11/27/20244913Windows: 274. Windows 7부터 도입한 conhost.exe
13831정성태11/27/20244382Linux: 111. eBPF - BPF_MAP_TYPE_PERF_EVENT_ARRAY, BPF_MAP_TYPE_RINGBUF에 대한 다양한 용어들
13830정성태11/25/20245198개발 환경 구성: 736. 파이썬 웹 앱을 Azure App Service에 배포하기
13829정성태11/25/20245169스크립트: 67. 파이썬 - Windows 버전에서 함께 설치되는 py.exe
13828정성태11/25/20244450개발 환경 구성: 735. Azure - 압축 파일을 이용한 web app 배포 시 디렉터리 구분이 안 되는 문제파일 다운로드1
13827정성태11/25/20245105Windows: 273. Windows 환경의 파일 압축 방법 (tar, Compress-Archive)
13826정성태11/21/20245337닷넷: 2313. C# - (비밀번호 등의) Console로부터 입력받을 때 문자열 출력 숨기기(echo 끄기)파일 다운로드1
13825정성태11/21/20245672Linux: 110. eBPF / bpf2go - BPF_RINGBUF_OUTPUT / BPF_MAP_TYPE_RINGBUF 사용법
13824정성태11/20/20244751Linux: 109. eBPF / bpf2go - BPF_PERF_OUTPUT / BPF_MAP_TYPE_PERF_EVENT_ARRAY 사용법
13823정성태11/20/20245304개발 환경 구성: 734. Ubuntu에 docker, kubernetes (k3s) 설치
13822정성태11/20/20245169개발 환경 구성: 733. Windbg - VirtualBox VM의 커널 디버거 연결 시 COM 포트가 없는 경우
13821정성태11/18/20245094Linux: 108. Linux와 Windows의 프로세스/스레드 ID 관리 방식
13820정성태11/18/20245250VS.NET IDE: 195. Visual C++ - C# 프로젝트처럼 CopyToOutputDirectory 항목을 추가하는 방법
13819정성태11/15/20244490Linux: 107. eBPF - libbpf CO-RE의 CONFIG_DEBUG_INFO_BTF 빌드 여부에 대한 의존성
13818정성태11/15/20245297Windows: 272. Windows 11 24H2 - sudo 추가
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...