microsoft / windows-appsample-photo-lab Goto Github PK

View Code? Open in Web Editor NEW

121.0 25.0 164.0 8.38 MB

A photo viewing and editing sample for the Universal Windows Platform (UWP).

License: MIT License

C# 100.00%

windows-appsample-photo-lab's Introduction

page_type

languages

products

statusNotificationTargets

sample

csharp

windows

windows-uwp

[email protected]

PhotoLab sample

A mini-app for viewing and editing image files, demonstrating XAML layout, data binding, and UI customization features for Universal Windows Platform (UWP) apps.

Note - This sample is targeted and tested for Windows 10, version 2004 (10.0; Build 19041), and Visual Studio 2019. If you prefer, you can use project properties to retarget the project(s) to Windows 10, version 1903 (10.0; Build 18362).

This repo includes the complete sample pictured above, plus separate versions that serve as starting points for a series of XAML basics tutorials. Each of these starting points is a simplified version of the complete sample, making the code easier to browse around in as you go through each tutorial.

Note: The tutorials do not proceed sequentially to build up to the complete sample, so be sure to start each tutorial by opening the correct starting point project. Also, be sure to check out the complete sample to see additional features such as custom animations.

Features

PhotoLab demonstrates:

XAML layout ranging from basics to adaptive and tailored layouts.
XAML data binding including the {x:Bind} markup extension.
XAML styling and UI customization.
Image effects from Windows.UI.Composition.
Use of the Windows UI Library (WinUI) and the Windows Community Toolkit (for ReorderGridAnimation).
Loading images from the Pictures library using data virtualization to increase performance when there are numerous files.

Code at a glance

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 for examples of some highlighted features:

Layout: see MainPage.xaml and DetailPage.xaml.
Data binding with x:Bind: see ImageGridView_DefaultItemTemplate in MainPage.xaml
Styling and customization: see FancySliderControlTemplate in DetailPage.xaml.
Image effects: see code starting with InitializeEffects in DetailPage.xaml.cs.

External libraries used in this sample

Universal Windows Platform development

Prerequisites

Windows 10. Minimum: Windows 10, version 1809 (10.0; Build 17763), also known as the Windows 10 October 2018 Update.
Windows 10 SDK. Minimum: Windows SDK version 10.0.17763.0 (Windows 10, version 1809).
Visual Studio 2019 (or Visual Studio 2017). You can use the free Visual Studio Community Edition to build and run Windows Universal Platform (UWP) apps.

To get the latest updates to Windows and the development tools, and to help shape their development, join the Windows Insider Program.

Running the sample

The default project is PhotoLab and you can Start Debugging (F5) or Start Without Debugging (Ctrl+F5) to try it out. The app will run in the emulator or on physical devices.

Note: The platform target currently defaults to ARM, so be sure to change that to x64 or x86 if you want to test on a non-ARM device.

windows-appsample-photo-lab's People

Contributors

Stargazers

Watchers

Forkers

decenova arrebagrove alant2 notframe larsdahlberg wilsunchong carlozlopes uri92 0lbertrand jod8bd haze101 empister mockermockery frehop b93rn vanessa0215 seesharpies jasshao blackbaret mrhodel direkshan-digital lcp3npedusg janlenoch jeetuwatson jopier ksnnacar ioproject2 tosminen graverpl lelek132 yiomo buhijs adejo88 kingkrayz tcorbet kengarmany symonknine rigo4rigo cheapw mikeapi mollyawatson marifox charygao spookykitties dadukebke m-khosravi roncrosson tyjortiz luco2018 vincelm creativewebmatrixsolutions sn0wf0x333 chucoyos s-shubham nelsongori kc345ws thinkgandhi andreyfom5555 johnzyg jinuos joshuaduncan306 yuva2achieve dualbios ax1951 przwar c-firstsecond-sharp liangjianyi lava84flow rurrui adrianzijp majav5 im9t cat23 hugotitus silversr clouddevelopmentstudios domigijzen ikyeazige kaisersoser cdl0266 sasedlock kmboese kechunlinbot mahendranj nonzulu we452366 kevinmiles corn100 pupil96 jatinderkumarchaurasia elesh17 jimmidier timshererwithaquent jonmyrseth asherlatham bottlis cwierzbicki tusharrex rauthan009 m497

windows-appsample-photo-lab's Issues

This repo is missing important files

There are important files that Microsoft projects should all have that are not present in this repository. A pull request has been opened to add the missing file(s). When the pr is merged this issue will be closed automatically.

Microsoft teams can learn more about this effort and share feedback within the open source guidance available internally.

Merge this pull request

60 errors when opening the application

Check the image below for info:

https://i.imgur.com/QDsc4DN.png

Use the latest version of Microsoft.Toolkit.Uwp.UI.Animations

It is this issue

Pls. release to the store

I'm a dev but I don't want to run visual studio just to try out the sample.

Update the version of the UWP MetaPackage

The photolab app references Microsoft.NETCore.UniversalWindowsPlatform 5.3.3, it should use one of the latest versions in th 6.x range.

App crashes when loading a massive of photos

Hi, Is there a way to load massive photos. Currently the app crashes when loading a folder which contains many pictures.

I add fileStream.Dispose();, but it seems useless.

public async static Task<ImageFileInfo> LoadImageInfo(StorageFile file)
        {
            // Open a stream for the selected file.
            // The 'using' block ensures the stream is disposed
            // after the image is loaded.
            using (IRandomAccessStream fileStream = await file.OpenReadAsync())
            {
                // Create a bitmap to be the image source.
                BitmapImage bitmapImage = new BitmapImage();
                bitmapImage.SetSource(fileStream);

                var properties = await file.Properties.GetImagePropertiesAsync();
                ImageFileInfo info = new ImageFileInfo(
                    properties, file, bitmapImage,
                    file.DisplayName, file.DisplayType);
                fileStream.Dispose();
                return info; 
            }
        }

Photolab requires the latest version of Windows

If the application can run in previous versions of the SDK the TargetPlatformMinVersion should be set to the lower version to increase reach.

Additionally it will avoid problems for users who are not getting the Windows Update and report issues like this