initial push (#3598)

* initial push

* initial push

* initial push

* initial push

Author: GrantMeStrength

hub/apps/develop/graphics.md

@@ -2,14 +2,18 @@
 title: Graphics
 description: This article provides an index of development features that are related to scenarios involving graphics in Windows apps.
 ms.topic: article
-ms.date: 05/11/2021
+ms.date: 05/25/2023
 keywords: 
 ---
 
 # Graphics
 
 This article provides an index of development features that are related to scenarios involving graphics in Windows apps.
 
+## Win2D
+
+[Win2D](/graphics/win2d.md) is an easy-to-use Windows Runtime API for immediate mode 2D graphics rendering with GPU acceleration.
+
 ## Windows App SDK features
 
 The [Windows App SDK](../windows-app-sdk/index.md) provides the following features related to graphics scenarios for Windows 10 and later OS releases.
@@ -18,6 +22,7 @@ The [Windows App SDK](../windows-app-sdk/index.md) provides the following featur
 |---------|-------------|
 | [Render text with DWriteCore](../windows-app-sdk/dwritecore.md) | Use the C++/COM APIs in the [DWriteCore headers](/windows/windows-app-sdk/api/win32/_dwritecore/) of the Windows App SDK to render text using a device-independent text layout system, high quality sub-pixel Microsoft ClearType text rendering, hardware-accelerated text, multi-format text, wide language support, and much more. |
 
+
 ## Windows OS features
 
 Windows 10 and later OS releases provide a wide variety of APIs related to graphics scenarios for apps. These features are available via a combination of WinRT and Win32 (C++ and COM) APIs provided by the [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk).

hub/apps/develop/win2d/hellowin2dworld.md

@@ -0,0 +1,58 @@
+---
+title: Hello Win2D World
+description: Display 'Hello world' using Win2D.
+ms.date: 05/25/2023
+ms.topic: article
+keywords: windows 10, windows 11, windows app sdk, winui, windows ui, graphics, games
+ms.localizationpriority: medium
+---
+
+# Hello Win2D World
+
+Launch Visual Studio, and create a new project.
+
+Add a CanvasControl to your XAML page to host the Win2D view.
+
+* Double-click on MainWindow.xaml in Solution Explorer to open the XAML editor
+* Add the **Microsoft.Graphics.Canvas.UI.Xaml** namespace next to the existing xmlns statements:
+
+```xmls
+xmlns:canvas="using:Microsoft.Graphics.Canvas.UI.Xaml"
+```
+
+Next, add a CanvasControl inside the existing Grid control:
+
+```xmls
+<Grid>
+    <canvas:CanvasControl Draw="CanvasControl_Draw" ClearColor="CornflowerBlue"/>
+</Grid>
+```
+
+Now add some Win2D drawing code. Edit **MainWindow.xaml.cs**, and add:
+
+
+```cs
+using Microsoft.UI;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.Graphics.Canvas.UI.Xaml;
+
+public sealed partial class MainWindow : Window
+{
+    public MainWindow()
+    {
+        this.InitializeComponent();
+    }
+
+    void CanvasControl_Draw(CanvasControl sender, CanvasDrawEventArgs args)
+    {
+        args.DrawingSession.DrawEllipse(155, 115, 80, 30, Colors.Black, 3);
+        args.DrawingSession.DrawText("Hello, Win2D world!", 100, 100, Colors.Yellow);
+    }
+}
+```
+
+Press **F5** to launch and run the project.
+
+## See Also
+
+* Win2D [Quick start](https://microsoft.github.io/Win2D/WinUI3/html/QuickStart.htm)

hub/apps/develop/win2d/index.md

@@ -0,0 +1,45 @@
+---
+title: Win2D
+description: Win2D is an easy-to-use Windows Runtime API for immediate mode 2D graphics rendering with GPU acceleration.
+ms.date: 05/25/2023
+ms.topic: article
+keywords: windows 10, windows 11, windows app sdk, winui, windows ui, graphics, games
+ms.localizationpriority: medium
+---
+
+# Win2D
+
+> [!NOTE]
+> Win2D on WinUI 3 is a work in progress. Some features are not supported, and some of the documentation still points to older WinUI2 concepts and classes. For information on using Win2D with UWP apps, see the [Win2D UWP Documentation](https://microsoft.github.io/Win2D/WinUI2/html/Introduction.htm) on GitHub.
+
+Win2D is an easy-to-use Windows Runtime API for immediate mode 2D graphics rendering with GPU acceleration. It is available to C#, C++ and VB developers writing apps for WinUI3. It utilizes the power of Direct2D, and integrates seamlessly with XAML.
+
+It's ideal for creating simple games, displays such as charts, and other simple 2D graphics.
+
+## Get Started
+
+Win2D is available as a NuGet package, or as source code [on GitHub](https://github.com/microsoft/Win2D).
+
+### Install Win2D
+
+Add the Win2D NuGet package to your WinUI 3 app:
+
+* From within Visual Studio, go to **Tools**, **NuGet Package Manager**, **Manage NuGet Packages for Solution..**
+* Type **Win2D** into the **Search Online** box, and hit **Enter**.
+* Select the **Microsoft.Graphics.Win2D** package and click **Install**, then **OK**.
+* Accept the license agreement.
+* Click **Close**.
+
+Next, visit [Hello Win2D World](hellowin2dworld.md) or the [Quick start](https://microsoft.github.io/Win2D/WinUI3/html/QuickStart.htm) to learn about creating a simple app.
+
+## Reference
+
+The [Win2D APIs](https://microsoft.github.io/Win2D/WinUI3/html/APIReference.htm).
+
+## Articles
+
+A list of useful [Win2D topics](https://microsoft.github.io/Win2D/WinUI3/html/Articles.htm).
+
+## See Also
+
+Win2D [on GitHub](https://github.com/microsoft/Win2D)

hub/apps/toc.yml

@@ -356,6 +356,13 @@ items:
             href: windows-app-sdk/composition.md
           - name: Render text with DWriteCore
             href: windows-app-sdk/dwritecore.md
+          - name: Win2D
+            items:
+              - name: "Overview of Win2D"
+                href: develop/win2d/index.md
+              - name: "Hello Win2D World"
+                href: develop/win2d/hellowin2dworld.md
+
       - name: Data and files
         items:
           - name: App resources