4d5f43ec1c
Previously the projection project was converted over to not use AnyCPU anymore. This was because there's a bug where the WindowsAppSdk bootstrap dll tries to deploy an AnyCPU version (which doesn't exist) and fails. Not using AnyCPU causes issues down the line with adding more tests, so this change restores back to using AnyCPU. But it also addresses the bootstrap dll bug more directly, and works around it to deploy x86. |
||
---|---|---|
build | ||
tools | ||
winrt | ||
.gitattributes | ||
.gitignore | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
LICENSE.txt | ||
Microsoft.Graphics.Win2D.sln | ||
README.md | ||
Win2D.proj | ||
build.cmd | ||
global.json | ||
nuget.config | ||
runbuild.ps1 | ||
smoke.cmd |
README.md
Transitioning Win2D to Reunion is In-Progress
Moving Win2D over to WindowsAppSdk and WinUI3 is a work in progress, and some features such as CanvasAnimatedControl have partial or no support.
Win2D
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.
Where to get it
How to use it
- Documentation
- Sample code - also available in the Store (not updated for Reunion)
More info
Code Example
To give you a flavor of what the code looks like, here is a snippet of XAML:
xmlns:canvas="using:Microsoft.Graphics.Canvas.UI.Xaml"
<Grid>
<canvas:CanvasControl Draw="canvasControl_Draw" ClearColor="CornflowerBlue" />
</Grid>
and C#:
void canvasControl_Draw(CanvasControl sender, CanvasDrawEventArgs args)
{
args.DrawingSession.DrawEllipse(155, 115, 80, 30, Colors.Black, 3);
args.DrawingSession.DrawText("Hello, world!", 100, 100, Colors.Yellow);
}
or C++/CX:
void MainPage::CanvasControl_Draw(CanvasControl^ sender, CanvasDrawEventArgs^ args)
{
args->DrawingSession->DrawEllipse(155, 115, 80, 30, Colors::Black, 3);
args->DrawingSession->DrawText("Hello, world!", 100, 100, Colors::Yellow);
}
or C++/WinRT:
void MainPage::CanvasControl_Draw(CanvasControl const& sender, CanvasDrawEventArgs const& args)
{
args.DrawingSession().DrawEllipse(155, 115, 80, 30, Colors::Black(), 3);
args.DrawingSession().DrawText(L"Hello, world!", 100, 100, Colors::Yellow());
}
or VB:
Sub canvasControl_Draw(sender As CanvasControl, args As CanvasDrawEventArgs)
args.DrawingSession.DrawEllipse(155, 115, 80, 30, Colors.Black, 3)
args.DrawingSession.DrawText("Hello, world!", 100, 100, Colors.Yellow)
End Sub
Using Win2D
The documentation explains how to install Visual Studio, add the Win2D NuGet package to your project, and get started using the API.
Building Win2D from source
Requirements
- Visual Studio 2019 16.9 with Tools for Universal Windows Apps 15.0.27428.01 and Windows SDK 18362
Clone Repository
- Go to 'View' -> 'Team Explorer' -> 'Local Git Repositories' -> 'Clone'
- Add the Win2D repository URL (https://github.com/Microsoft/Win2D.git) and hit 'Clone'
Build NuGet Packages
- Launch 'Developer Command Prompt for VS2019'
- Change directory to your cloned Win2D repository and run 'build'
Point Visual Studio at the resulting 'bin' directory
- In Visual Studio, go to 'Tools' -> 'NuGet Package Manager' -> 'Package Manager Settings'
- Choose 'Package Sources'
- Click the '+' button to add a new source
- Set 'Name' to 'Win2D' (or a name of your choosing)
- Set 'Source' to the full path to the 'bin' directory (inside your cloned Win2D repository)
- Click the 'Update' button
- Click 'OK'
Locally built versions of Win2D are marked as prerelease, so you must change the 'Stable Only' setting to 'Include Prerelease' when adding them to your project.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.