Canvas.Source 1.0.9-prerelease

This is a prerelease version of Canvas.Source.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Canvas.Source --version 1.0.9-prerelease                
NuGet\Install-Package Canvas.Source -Version 1.0.9-prerelease                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Canvas.Source" Version="1.0.9-prerelease" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Canvas.Source --version 1.0.9-prerelease                
#r "nuget: Canvas.Source, 1.0.9-prerelease"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Canvas.Source as a Cake Addin
#addin nuget:?package=Canvas.Source&version=1.0.9-prerelease&prerelease

// Install Canvas.Source as a Cake Tool
#tool nuget:?package=Canvas.Source&version=1.0.9-prerelease&prerelease                

Update

The most active development continues in the cross-platform web version

https://github.com/Indemos/Canvas

Canvas and Open GL Stock and Financial Charts

Generic cross-platform real-time charts for Desktop apps.

The main purpose of this app is to be used as a charting tool for real-time financial applications, e.g. backtesters for trading strategies. Here is the most comprehensive guide dedicated to charting in .NET that I have seen so far. Nevertheless, trying various options from that guide I wasn't able to find anything flexible enough for my needs, so created my own. Usage samples can be found here or as more complete example in a separate repository.

Nuget

Install-Package Canvas.Views.WPF -Version 1.0.9-prerelease
Install-Package Canvas.Views.Avalonia -Version 1.0.9-prerelease

Drawing Methods

Currently available controls.

  • CanvasControl - base Canvas control exposing DrawingContext used with Shapes and Geometries
  • CanvasPanelControl - a wrapper around SkiaSharp and Open GL

In order to add a different type of panel, e.g. GDI+ or Direct 2D, you need to implement ICanvasControl interface.

Chart Types

At the moment, there are four built-in chart types.

  • Line - line
  • Bar - polygon
  • Area - polygon
  • Candle - OHLC box, a mix of a line and a rectangle polygon

If there is a need to create a new chart type, then you need to implement IShape interface.

Pan and Zoom

The chart is completely data-centric, thus in order to scale the chart you need to change the data source. By default, the chart displays last 100 data points, as defined in IndexCount property.

MinIndex = Items.Count - IndexCount
MaxIndex = Items.Count

To pan the chart to the left, subtract arbitrary value from both MinIndex and MaxIndex.

MinIndex -= 1
MaxIndex -= 1

To pan the chart to the right, do the opposite.

MinIndex += 1
MaxIndex += 1

To zoom in, increase MinIndex and decrease MaxIndex to decrease number of visible points.

MinIndex += 1
MaxIndex -= 1

To zoom out, do the opposite.

MinIndex -= 1
MaxIndex += 1

Data source structure

To simplify sycnhronization of multiple charts, data source has format of a list where each entry point has a time stamp and a set of Areas and Series that will be rendered in the relevant viewport.

[
  DateTime
  {
    Area A
    {
      Line Series => double,
      Candle Series => OHLC
    },
    Area B 
    {
      Line Series => double,
      Line Series => double
    },
    Area C 
    {
      Bar Series => double
    }
  }, 
  DateTime { ... },
  DateTime { ... },
  DateTime { ... }
]

  • Area is a viewport, an actual chart, each viewport can show several types of series, e.g. a mix of candles and lines.
  • Series is a single chart type to be displayed in the viewport, e.g. lines.
  • Model is a data point of dynamic type, can accept different type of inputs, e.g. double or OHLC box.

At this moment, Painter supports only horizontal orientation, so the axis X is used as an index scale that picks data points from the source list and axis Y is a value scale that represents the actual value of each data point.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Canvas.Source:

Package Downloads
Canvas.Views.Avalonia

Generic real-time charts for Desktop apps with built-in pan and zoom support. Financial and stock-trading charts.

Canvas.Views.WPF

Generic real-time charts for Desktop apps with built-in pan and zoom support.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.1-prerelease 165 4/14/2022
1.1.0-prerelease 139 4/9/2022
1.0.9-prerelease 138 4/5/2022