The Photo Editor application is a Universal Windows Platform (UWP) sample that showcases development with the C++/WinRT language projection. The sample application allows you to retrieve photos from the Pictures library, and then edit the selected image with assorted photo effects. In the sample's source code, you'll see a number of common practices—such as data binding, and asynchronous actions and operations—performed using the C++/WinRT projection.
Photo Editor primarily demonstrates:
- Use of Standard C++17 syntax and libraries with Windows Runtime (WinRT) APIs.
- Use of coroutines, including the use of co_await, co_return, IAsyncAction, and IAsyncOperation<TResult>.
- Creation and use of custom Windows Runtime class (runtime class) projected types and implementation types. For more info about these terms, see Consume APIs with C++/WinRT and Author APIs with C++/WinRT.
- Event handling, including the use of auto-revoking event tokens.
- Use of the external Win2D NuGet package, and Windows::UI::Composition, for image effects.
- XAML data binding, including the {x:Bind} markup extension.
- XAML styling and UI customization, including connected animations.
This sample requires:
- Visual Studio 2017 and the latest version of the Windows 10 SDK (10.0.17134.0). You can use the free Visual Studio Community Edition to build and run Windows Universal Platform (UWP) apps.
- Download and install the C++/WinRT Visual Studio Extension.
To get the latest updates to Windows and the development tools, and to help shape their development, join the Windows Insider Program.
The default project is PhotoEditor and you can Start Debugging (F5) or Start Without Debugging (Ctrl+F5) to try it out, just make sure to set the platform target appropriately. The app will run in the emulator or on physical devices.
If you're just interested in code snippets for certain areas, and don't want to browse or run the full sample, check out the following files.
A custom runtime class that represents a photo.
The first page that loads the photos from the Pictures Library and displays a tiled thumbnail view.
Tapping a photo from the MainPage thumbnail view will take you to the photo editor page, where Win2D effects are toggled, set, and chained together.