Win10/UWP开发-Ink墨迹书写

在UWP开发中，微软提供了一个新型的InkCanvas控件用来让用户能书写墨迹，在新版的Edga浏览器中微软自己也用到了该控件使用户很方便的可以在web上做笔记。

InkCanvas控件使用很简单，从工具箱里拖出一个InkCanvas控件即可，InkCanvas有个属性叫InkPresenter，通过它我们可以多样化的设置我们的画笔属性，InkPresenter里面有几个重要的属性：

 // 获取或设置输入数据用于从中提取 InkStroke 的输入设备类型。

 public CoreInputDeviceTypes InputDeviceTypes { get; set; }

 // 获取 InkCanvas 控件上的 InkStroke 的行为。例如，墨迹、清除或选择。

 public InkInputProcessingConfiguration InputProcessingConfiguration { get; }

 // 获取或设置是否已启用输入以进行墨迹书写。

 public System.Boolean IsInputEnabled { get; set; }

 // 获取或设置 InkStrokeContainer 对象以管理 InkCanvas 控件上的一个或多个 InkStroke 对象的输入、处理和操作。

 public InkStrokeContainer StrokeContainer { get; set; }

 // 从关联的 InkCanvas 控件获取笔划墨迹输入。

 public InkStrokeInput StrokeInput { get; }

 // 设置 InkCanvas 控件上一个或多个接触点的墨迹书写行为。

 public void SetPredefinedConfiguration(InkPresenterPredefinedConfiguration value);

 // 指定渲染新的 InkStroke 时 InkCanvas 控件所使用的 InkDrawingAttributes。

 public void UpdateDefaultDrawingAttributes(InkDrawingAttributes value);

接下来我们做一个画图板，功能要实现墨迹书写，墨迹擦除，墨迹保存，墨迹加载，手写识别。

墨迹书写

前台声明一个InkCanvas控件：

<InkCanvas x:Name="InkCanvas" />

后台设置下Ink的墨笔属性：

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
     //设置输入类型为触控输入和鼠标输入
     InkCanvas.InkPresenter.InputDeviceTypes = CoreInputDeviceTypes.Mouse | CoreInputDeviceTypes.Touch;
     //创建一个新的画笔属性（此步可省略，省略后采用默认画笔）
     var attr = new InkDrawingAttributes
     {
         Color = Colors.Red, //颜色
         IgnorePressure = true,  //是否忽略数字化器表面上的接触压力
         PenTip = PenTipShape.Rectangle, //笔尖类型设置
         Size = new Size(, ), //画笔粗细
         PenTipTransform = Matrix3x2.CreateRotation((float)( * Math.PI / )) //笔尖形状矩阵
     };
     //更新画笔
     InkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(attr);
 }

墨迹擦除

墨迹擦除只需要设置画笔行为为橡皮擦即可

    InkCanvas.InkPresenter.InputProcessingConfiguration.Mode = InkInputProcessingMode.Erasing;

墨迹保存

 private async void Btn_Save_OnClick(object sender, RoutedEventArgs e)
 {
     //声明一个流来存储墨迹信息
     IRandomAccessStream stream = new InMemoryRandomAccessStream();
     //保存墨迹信息到流
     //拿到流了就可以随意处置墨迹了，可以保持到App内部 也可以保存为文件，我们直接保存为文件
     await InkCanvas.InkPresenter.StrokeContainer.SaveAsync(stream);
     //创建一个文件保存对话框
     var picker = new Windows.Storage.Pickers.FileSavePicker
     {
         SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary
     };
     //文件类型
     picker.FileTypeChoices.Add("INK files", new List<string>() { ".ink" });
     //弹出保存对话框
     var file = await picker.PickSaveFileAsync();
     if (file == null) return;

     CachedFileManager.DeferUpdates(file);
     //将流转为byte
     var bt = await ConvertImagetoByte(stream);
     //写入文件
     await Windows.Storage.FileIO.WriteBytesAsync(file, bt);
     //保存
     await CachedFileManager.CompleteUpdatesAsync(file);
 }
 private async Task<byte[]> ConvertImagetoByte(IRandomAccessStream fileStream)
 {
     //IRandomAccessStream fileStream = await image.OpenAsync(FileAccessMode.Read);
     var reader = new Windows.Storage.Streams.DataReader(fileStream.GetInputStreamAt());
     await reader.LoadAsync((uint)fileStream.Size);

     byte[] pixels = new byte[fileStream.Size];

     reader.ReadBytes(pixels);

     return pixels;
 }

墨迹加载

 private async void Btn_load_OnClick(object sender, RoutedEventArgs e)
        {
            //创建一个文件选择器
            var picker = new Windows.Storage.Pickers.FileOpenPicker
            {
                SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary
            };
            //规定文件类型
            picker.FileTypeFilter.Add(".ink");
            //显示选择器
            var pickedFile = await picker.PickSingleFileAsync();
            if (pickedFile != null)
            {
                var file = await pickedFile.OpenReadAsync();
                //加载墨迹
                await InkCanvas.InkPresenter.StrokeContainer.LoadAsync(file);
            }
        }

手写识别

手写识别是指通过用户使用画笔写出的墨迹，我们可以识别出是什么内容，主要是通过InkRecognizerContainer类来完成的。

InkRecognizerContainer类有几个主要方法：

// 获取 InkRecognizer 对象的集合。
public IReadOnlyList<InkRecognizer> GetRecognizers();

// 对一个或多 InkStroke 对象执行手写识别。
public IAsyncOperation<IReadOnlyList<InkRecognitionResult>> RecognizeAsync(InkStrokeContainer strokeCollection, InkRecognitionTarget recognitionTarget);

// 设置用于手写标识的默认 InkRecognizer。
public void SetDefaultRecognizer(InkRecognizer recognizer);

具体使用方法：

 private async void btnOcr_OnClick(object sender, RoutedEventArgs e)
 {
     //手写识别
     var container = new InkRecognizerContainer();
     //使用墨迹识别
     var result = await container.RecognizeAsync(InkCanvas.InkPresenter.StrokeContainer, InkRecognitionTarget.All);
     //获取识别结果  InkRecognitionResult 对象中还能获取候选字
     var txt = result[].GetTextCandidates()[];

     var dia = new ContentDialog()
     {
         Content = new TextBlock() { Text = txt },
         PrimaryButtonText = "ok",
         IsPrimaryButtonEnabled = true

     };
     dia.PrimaryButtonClick += (s, a) =>
     {
         dia.Hide();
     };
     await dia.ShowAsync();
 }

Ink Toolbar control

上面介绍了Ink控件的基本使用方法，其中最主要的就是画笔属性的设置，为了方便大家的开发，微软还提供了一个辅助Control叫做Ink Toolbar，通过它，我们可以很方便的集成一个画笔设置工具栏。

首先安装该工具扩展，然后引用InkToolbar Control.dll，接着在View中声明控件:

xmlns:ink="using:Microsoft.Labs.InkToolbarControl"

<ink:InkToolbar x:Name="bar_InkTool"

TargetInkCanvas="{x:Bind InkCanvas}"

VerticalAlignment="Top" HorizontalAlignment="Right" />

TargetInkCanvas属性bind到要设置的InkCanvas上即可。

效果图：

推荐一个UWP开发群：53078485 大家可以进来一起学习