Create a blank ASP.NET Core Web application.

Server side: Add references to the Vintasoft assemblies to your ASP.NET Core Web application.

Server side: Specify drawing engine, which should be used by VintaSoft Imaging .NET SDK for drawing of 2D graphics.

• Add reference to the Vintasoft.Imaging.Drawing.SkiaSharp.dll assembly.
  
• Add reference to the SkiaSharp nuget-package version 2.88.6.
• Open "Startup.cs" file, add code line "Vintasoft.Imaging.Drawing.SkiaSharp.SkiaSharpDrawingFactory.SetAsDefault();" at the beginning of ConfigureServices method - added code specifies that VintaSoft Imaging .NET SDK should use SkiaSharp library for drawing of 2D graphics.

• Add reference to the Vintasoft.Imaging.Gdi.dll assembly.
  
• Open "Startup.cs" file, add code line "Vintasoft.Imaging.Drawing.Gdi.GdiGraphicsFactory.SetAsDefault();" at the beginning of ConfigureServices method - added code specifies that VintaSoft Imaging .NET SDK should use System.Drawing library for drawing of 2D graphics.

Server side: Create web services, which allow to upload/download file, manage image collection, get information about images, get thumbnails, render image tiles, extract/search text and annotate document.

• Add the "Controllers" folder to the project.

• Create web service that allows to upload/download file

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftFileApiController" and press the "Add" button
    
  • Specify that MyVintasoftFileApiController class is derived from Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftFileApiController class
    
    Here are source codes of MyVintasoftFileApiController class:
    
    • C#

    using Microsoft.AspNetCore.Hosting;
    
    namespace WebApplication1.Controllers
    {
        public class MyVintasoftFileApiController : Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftFileApiController
        {
    
            public MyVintasoftFileApiController(IWebHostEnvironment hostingEnvironment)
                : base(hostingEnvironment)
            {
            }
    
        }
    }
    
    

• Create web service that allows to manage image collection

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftImageCollectionApiController" and press the "Add" button
    
  • Specify that MyVintasoftImageCollectionApiController class is derived from Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftImageCollectionApiController class
    
    Here are source codes of MyVintasoftImageCollectionApiController class:
    
    • C#

    using Microsoft.AspNetCore.Hosting;
    
    namespace WebApplication1.Controllers
    {
        public class MyVintasoftImageCollectionApiController : Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftImageCollectionApiController
        {
    
            public MyVintasoftImageCollectionApiController(IWebHostEnvironment hostingEnvironment)
                : base(hostingEnvironment)
            {
            }
    
        }
    }
    
    

• Create web service that allows to get information about images, get thumbnails, render image tiles, extract/search text

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftImageApiController" and press the "Add" button
    
  • Specify that MyVintasoftImageApiController class is derived from Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftImageApiController class
    
    Here are source codes of MyVintasoftImageApiController class:
    
    • C#

    using Microsoft.AspNetCore.Hosting;
    
    namespace WebApplication1.Controllers
    {
        public class MyVintasoftImageApiController : Vintasoft.Imaging.AspNetCore.ApiControllers.VintasoftImageApiController
        {
    
            public MyVintasoftImageApiController(IWebHostEnvironment hostingEnvironment)
                : base(hostingEnvironment)
            {
            }
    
        }
    }
    
    

• Create web service that allows to annotate images and documents

  • Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
    
  • Select "Empty API controller" template, set the controller name to the "MyVintasoftAnnotationCollectionApiController" and press the "Add" button
    
  • Specify that MyVintasoftAnnotationCollectionApiController class is derived from Vintasoft.Imaging.Annotation.AspNetCore.ApiControllers.VintasoftAnnotationCollectionApiController class
    
    Here are source codes of MyVintasoftAnnotationCollectionApiController class:
    
    • C#

    using Microsoft.AspNetCore.Hosting;
    
    namespace WebApplication1.Controllers
    {
        public class MyVintasoftAnnotationCollectionApiController :
            Vintasoft.Imaging.Annotation.AspNetCore.ApiControllers.VintasoftAnnotationCollectionApiController
        {
    
            public MyVintasoftAnnotationCollectionApiController(IWebHostEnvironment hostingEnvironment)
                : base(hostingEnvironment)
            {
            }
        }
    }
    
    

Server side: Add Newtonsoft JSON for deserialization of annotations.

• Add reference to the Microsoft.AspNetCore.Mvc.NewtonsoftJson nuget-package.

Server side: Create MVC controller for web view that will display document viewer.

• Press the right mouse button on the "Controllers" folder and select the "Add => Controller..." menu from context menu
  
• Select "MVC Controller - Empty" template, set the controller name to the "DefaultController" and press the "Add" button
  
• Open "Startup.cs" file, add controllers with views to the services of ASP.NET Core application:
  
  
  Add created MVC controller to the endpoints of ASP.NET Core application:
  
  
  Enable static file serving for the current request path of ASP.NET Core application:
  
  
  Here are C# source codes of Startup.cs file:
  
  • C#

  using Microsoft.AspNetCore.Builder;
  using Microsoft.AspNetCore.Hosting;
  using Microsoft.Extensions.Configuration;
  using Microsoft.Extensions.DependencyInjection;
  using Microsoft.Extensions.Hosting;
  
  namespace WebApplication1
  {
      public class Startup
      {
          public Startup(IConfiguration configuration)
          {
              Configuration = configuration;
          }
  
          public IConfiguration Configuration { get; }
  
          // This method gets called by the runtime. Use this method to add services to the container.
          public void ConfigureServices(IServiceCollection services)
          {
              // specify that VintaSoft Imaging .NET SDK should use SkiaSharp library for drawing of 2D graphics
              Vintasoft.Imaging.Drawing.SkiaSharp.SkiaSharpDrawingFactory.SetAsDefault();
  
              // add Newtonsoft JSON for deserialization of JSON annotations
              services.AddControllersWithViews().AddNewtonsoftJson();
  
              services.AddRazorPages();
          }
  
          // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
          public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
          {
              if (env.IsDevelopment())
              {
                  app.UseDeveloperExceptionPage();
              }
              else
              {
                  app.UseExceptionHandler("/Error");
                  // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
                  app.UseHsts();
              }
  
              app.UseHttpsRedirection();
              app.UseStaticFiles();
  
              app.UseRouting();
  
              app.UseAuthorization();
  
              app.UseEndpoints(endpoints =>
              {
                  endpoints.MapControllerRoute("default", "{controller=Default}/{action=Index}/{id?}");
              });
          }
      }
  }
  
  

Client side: Add JavaScript libraries to the project.

• Add the "wwwroot\js\" folder to ASP.NET Core application if folder does not exist.
  
  
• Copy Vintasoft.Shared.js, Vintasoft.Imaging.js, Vintasoft.Imaging.Annotation.js, Vintasoft.Imaging.DocumentViewer.js and Vintasoft.Imaging.DocumentViewer.css files from "<InstallPath>\VintaSoft Imaging .NET v12.5\Bin\JavaScript\" folder into "wwwroot\js\" folder.
• Specify, which "standard" dialogs (password dialog, print dialog, etc) should be used by web document viewer
  • If web document viewer should use ready-to-use "standard" Bootstrap dialogs:
    • Add Bootstrap and jQuery libraries to the project.
    • Copy Vintasoft.Imaging.Dialogs.Bootstrap.js and Vintasoft.Imaging.DocumentViewer.Dialogs.Bootstrap.js files from "<InstallPath>\VintaSoft Imaging .NET v12.5\Bin\JavaScript\" folder into "wwwroot\js\" folder.
  • If web document viewer should use ready-to-use "standard" jQuery UI dialogs:
    • Add jQuery and jQuery UI libraries to the project.
    • Copy Vintasoft.Imaging.Dialogs.jQueryUI.js and Vintasoft.Imaging.DocumentViewer.Dialogs.jQueryUI.js files from "<InstallPath>\VintaSoft Imaging .NET v12.5\Bin\JavaScript\" folder into "wwwroot\js\" folder.
  • If web document viewer should use custom "standard" dialogs,please read how to create custom "standard" dialogs here.

Client side: Add JavaScript code that allows to display document, search and extract text from document, annotate document.

• Create folder "wwwroot\UploadedImageFiles\SessionID" and copy test PDF document "<SdkInstallPath>\VintaSoft\Imaging .NET v12.5\Images\VintasoftImagingDemo.pdf" to the folder. This document will be displayed in document viewer.
  
  
• Open web view - file "Views\Default\Index.cshtml".
  
• Add references to used JavaScript libraries:
  • If Bootstrap dialogs are used, add references to the Bootstrap files and Vintasoft JavaScript files.
    Here is HTML code that adds references to the Bootstrap and Vintasoft JavaScript files:
    
    • HTML

    <link rel="stylesheet" type="text/css" href="~/js/jquery-ui-css/jquery-ui.min.css">
    <link rel="stylesheet" type="text/css" href="~/js/Vintasoft.Imaging.DocumentViewer.css">
    
    <script src="~/js/Vintasoft.Shared.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.Annotation.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.DocumentViewer.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.DocumentViewer.Dialogs.Bootstrap.js" type="text/javascript"></script>
    

    
    
  • If jQuery UI dialogs are used, add references to the jQuery files and Vintasoft JavaScript files.
    Here is HTML code that adds references to the jQuery and Vintasoft JavaScript files:
    
    • HTML

    <link rel="stylesheet" type="text/css" href="~/js/jquery-ui-css/jquery-ui.min.css">
    <link rel="stylesheet" type="text/css" href="~/js/Vintasoft.Imaging.DocumentViewer.css">
    
    <script src="~/js/jquery-3.3.1.min.js" type="text/javascript"></script>
    <script src="~/js/jquery-ui.min.js" type="text/javascript"></script>
    
    <script src="~/js/Vintasoft.Shared.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.Annotation.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.DocumentViewer.js" type="text/javascript"></script>
    <script src="~/js/Vintasoft.Imaging.DocumentViewer.Dialogs.jQueryUI.js" type="text/javascript"></script>
    

    
    
• Add HTML markup (a div-element that will display document viewer) to the web view:
  
  Here is HTML markup code:
  
  • HTML

  <h1 style="text-align: center">VintaSoft Document Viewer Demo (ASP.NET Core)</h1>
  
  <div id="documentViewerContainer" style="height:800px"></div>
  

• Add JavaScript code that initializes and creates document viewer:
  
  Here is JavaScript code that initializes and displays document viewer:
  
  • JavaScript

  <script type="text/javascript">
      // set the session identifier
      Vintasoft.Shared.WebImagingEnviromentJS.set_SessionId("SessionID");
  
      // specify web services, which should be used by Vintasoft Web Document Viewer
      Vintasoft.Shared.WebServiceJS.defaultFileService =
          new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftFileApi");
      Vintasoft.Shared.WebServiceJS.defaultImageCollectionService =
          new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftImageCollectionApi");
      Vintasoft.Shared.WebServiceJS.defaultImageService =
          new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftImageApi");
      Vintasoft.Shared.WebServiceJS.defaultAnnotationService =
          new Vintasoft.Shared.WebServiceControllerJS("vintasoft/api/MyVintasoftAnnotationCollectionApi");
  
      // create settings for document viewer with annotation support
      var docViewerSettings =
          new Vintasoft.Imaging.DocumentViewer.WebDocumentViewerSettingsJS("documentViewerContainer", { annotations: true });
  
      // get items of document viewer
      var items = docViewerSettings.get_Items();
  
      // get the main menu of document viewer
      var mainMenu = items.getItemByRegisteredId("mainMenu");
      // if main menu is found
      if (mainMenu != null) {
          // get items of main menu
          var mainMenuItems = mainMenu.get_Items();
  
          // add "Annotation" menu panel to the main menu
          mainMenuItems.addItem("annotationsMenuPanel");
      }
  
      // get side panel of document viewer
      var sidePanel = items.getItemByRegisteredId("sidePanel");
      // if side panel is found
      if (sidePanel != null) {
          // get items of side panel
          var sidePanelItems = sidePanel.get_PanelsCollection();
  
          // add "Annotations" panel to the side panel
          sidePanelItems.addItem("annotationsPanel");
  
          // add "Text selection" panel to the side panel
          sidePanelItems.addItem("textSelectionPanel");
  
          // add "Text searh" panel to the side panel
          sidePanelItems.addItem("textSearchPanel");
      }
  
      // create the document viewer
      var docViewer = new Vintasoft.Imaging.DocumentViewer.WebDocumentViewerJS(docViewerSettings);
  
      // create visual tool that allows to work with annotations, navigate document and select text
      var annotationNavigationTextSelectionTool =
          docViewer.getVisualToolById("AnnotationVisualTool,DocumentNavigationTool,TextSelectionTool");
      // specify visual tool as mandatory visual tool of document viewer
      docViewer.set_MandatoryVisualTool(annotationNavigationTextSelectionTool);
      // specify visual tool as current visual tool of document viewer
      docViewer.set_CurrentVisualTool(annotationNavigationTextSelectionTool);
  
      // get image viewer of document viewer
      var imageViewer = docViewer.get_ImageViewer();
      // open file from session folder and add images from file to the image viewer
      imageViewer.get_Images().openFile("VintasoftImagingDemo.pdf");
  </script>
  
  

Run the ASP.NET Core Web application and see the result.