using System.Text;
using System;
using System.Collections.Generic;
using System.Linq;
namespace Terminal.Gui {
///
/// Control for rendering graphs (bar, scatter etc)
///
public class GraphView : View {
///
/// Horizontal axis
///
///
public HorizontalAxis AxisX { get; set; }
///
/// Vertical axis
///
///
public VerticalAxis AxisY { get; set; }
///
/// Collection of data series that are rendered in the graph
///
public List Series { get; } = new List ();
///
/// Elements drawn into graph after series have been drawn e.g. Legends etc
///
public List Annotations { get; } = new List ();
///
/// Amount of space to leave on left of control. Graph content ()
/// will not be rendered in margins but axis labels may be
///
public uint MarginLeft { get; set; }
///
/// Amount of space to leave on bottom of control. Graph content ()
/// will not be rendered in margins but axis labels may be
///
public uint MarginBottom { get; set; }
///
/// The graph space position of the bottom left of the control.
/// Changing this scrolls the viewport around in the graph
///
///
public PointF ScrollOffset { get; set; } = new PointF (0, 0);
///
/// Translates console width/height into graph space. Defaults
/// to 1 row/col of console space being 1 unit of graph space.
///
///
public PointF CellSize { get; set; } = new PointF (1, 1);
///
/// The color of the background of the graph and axis/labels
///
public Attribute? GraphColor { get; set; }
///
/// Creates a new graph with a 1 to 1 graph space with absolute layout
///
public GraphView ()
{
CanFocus = true;
AxisX = new HorizontalAxis ();
AxisY = new VerticalAxis ();
// Things this view knows how to do
AddCommand (Command.ScrollUp, () => { Scroll (0, CellSize.Y); return true; });
AddCommand (Command.ScrollDown, () => { Scroll (0, -CellSize.Y); return true; });
AddCommand (Command.ScrollRight, () => { Scroll (CellSize.X, 0); return true; });
AddCommand (Command.ScrollLeft, () => { Scroll (-CellSize.X, 0); return true; });
AddCommand (Command.PageUp, () => { PageUp (); return true; });
AddCommand (Command.PageDown, () => { PageDown (); return true; });
AddKeyBinding (Key.CursorRight, Command.ScrollRight);
AddKeyBinding (Key.CursorLeft, Command.ScrollLeft);
AddKeyBinding (Key.CursorUp, Command.ScrollUp);
AddKeyBinding (Key.CursorDown, Command.ScrollDown);
// Not bound by default (preserves backwards compatibility)
//AddKeyBinding (Key.PageUp, Command.PageUp);
//AddKeyBinding (Key.PageDown, Command.PageDown);
}
///
/// Clears all settings configured on the graph and resets all properties
/// to default values (, etc)
///
public void Reset ()
{
ScrollOffset = new PointF (0, 0);
CellSize = new PointF (1, 1);
AxisX.Reset ();
AxisY.Reset ();
Series.Clear ();
Annotations.Clear ();
GraphColor = null;
SetNeedsDisplay ();
}
///
public override void OnDrawContent (Rect contentArea)
{
if (CellSize.X == 0 || CellSize.Y == 0) {
throw new Exception ($"{nameof (CellSize)} cannot be 0");
}
SetDriverColorToGraphColor ();
Move (0, 0);
// clear all old content
for (int i = 0; i < Bounds.Height; i++) {
Move (0, i);
Driver.AddStr (new string (' ', Bounds.Width));
}
// If there is no data do not display a graph
if (!Series.Any () && !Annotations.Any ()) {
return;
}
// The drawable area of the graph (anything that isn't in the margins)
var graphScreenWidth = Bounds.Width - ((int)MarginLeft);
var graphScreenHeight = Bounds.Height - (int)MarginBottom;
// if the margins take up the full draw bounds don't render
if (graphScreenWidth < 0 || graphScreenHeight < 0) {
return;
}
// Draw 'before' annotations
foreach (var a in Annotations.ToArray ().Where (a => a.BeforeSeries)) {
a.Render (this);
}
SetDriverColorToGraphColor ();
AxisY.DrawAxisLine (this);
AxisX.DrawAxisLine (this);
AxisY.DrawAxisLabels (this);
AxisX.DrawAxisLabels (this);
// Draw a cross where the two axis cross
var axisIntersection = new Point (AxisY.GetAxisXPosition (this), AxisX.GetAxisYPosition (this));
if (AxisX.Visible && AxisY.Visible) {
Move (axisIntersection.X, axisIntersection.Y);
AddRune (axisIntersection.X, axisIntersection.Y, (Rune)'\u253C');
}
SetDriverColorToGraphColor ();
Rect drawBounds = new Rect ((int)MarginLeft, 0, graphScreenWidth, graphScreenHeight);
RectangleF graphSpace = ScreenToGraphSpace (drawBounds);
foreach (var s in Series.ToArray ()) {
s.DrawSeries (this, drawBounds, graphSpace);
// If a series changes the graph color reset it
SetDriverColorToGraphColor ();
}
SetDriverColorToGraphColor ();
// Draw 'after' annotations
foreach (var a in Annotations.ToArray ().Where (a => !a.BeforeSeries)) {
a.Render (this);
}
}
///
/// Sets the color attribute of to the
/// (if defined) or otherwise.
///
public void SetDriverColorToGraphColor ()
{
Driver.SetAttribute (GraphColor ?? (GetNormalColor ()));
}
///
/// Returns the section of the graph that is represented by the given
/// screen position
///
///
///
///
public RectangleF ScreenToGraphSpace (int col, int row)
{
return new RectangleF (
ScrollOffset.X + ((col - MarginLeft) * CellSize.X),
ScrollOffset.Y + ((Bounds.Height - (row + MarginBottom + 1)) * CellSize.Y),
CellSize.X, CellSize.Y);
}
///
/// Returns the section of the graph that is represented by the screen area
///
///
///
public RectangleF ScreenToGraphSpace (Rect screenArea)
{
// get position of the bottom left
var pos = ScreenToGraphSpace (screenArea.Left, screenArea.Bottom - 1);
return new RectangleF (pos.X, pos.Y, screenArea.Width * CellSize.X, screenArea.Height * CellSize.Y);
}
///
/// Calculates the screen location for a given point in graph space.
/// Bear in mind these be off screen
///
/// Point in graph space that may or may not be represented in the
/// visible area of graph currently presented. E.g. 0,0 for origin
/// Screen position (Column/Row) which would be used to render the graph .
/// Note that this can be outside the current client area of the control
public Point GraphSpaceToScreen (PointF location)
{
return new Point (
(int)((location.X - ScrollOffset.X) / CellSize.X) + (int)MarginLeft,
// screen coordinates are top down while graph coordinates are bottom up
(Bounds.Height - 1) - (int)MarginBottom - (int)((location.Y - ScrollOffset.Y) / CellSize.Y)
);
}
///
/// Also ensures that cursor is invisible after entering the .
public override bool OnEnter (View view)
{
Driver.SetCursorVisibility (CursorVisibility.Invisible);
return base.OnEnter (view);
}
///
public override bool ProcessKey (KeyEvent keyEvent)
{
if (HasFocus && CanFocus) {
var result = InvokeKeybindings (keyEvent);
if (result != null)
return (bool)result;
}
return base.ProcessKey (keyEvent);
}
///
/// Scrolls the graph up 1 page
///
public void PageUp ()
{
Scroll (0, CellSize.Y * Bounds.Height);
}
///
/// Scrolls the graph down 1 page
///
public void PageDown ()
{
Scroll (0, -1 * CellSize.Y * Bounds.Height);
}
///
/// Scrolls the view by a given number of units in graph space.
/// See to translate this into rows/cols
///
///
///
public void Scroll (float offsetX, float offsetY)
{
ScrollOffset = new PointF (
ScrollOffset.X + offsetX,
ScrollOffset.Y + offsetY);
SetNeedsDisplay ();
}
#region Bresenham's line algorithm
// https://rosettacode.org/wiki/Bitmap/Bresenham%27s_line_algorithm#C.23
int ipart (decimal x) { return (int)x; }
decimal fpart (decimal x)
{
if (x < 0) return (1 - (x - Math.Floor (x)));
return (x - Math.Floor (x));
}
///
/// Draws a line between two points in screen space. Can be diagonals.
///
///
///
/// The symbol to use for the line
public void DrawLine (Point start, Point end, Rune symbol)
{
if (Equals (start, end)) {
return;
}
int x0 = start.X;
int y0 = start.Y;
int x1 = end.X;
int y1 = end.Y;
int dx = Math.Abs (x1 - x0), sx = x0 < x1 ? 1 : -1;
int dy = Math.Abs (y1 - y0), sy = y0 < y1 ? 1 : -1;
int err = (dx > dy ? dx : -dy) / 2, e2;
while (true) {
AddRune (x0, y0, symbol);
if (x0 == x1 && y0 == y1) break;
e2 = err;
if (e2 > -dx) { err -= dy; x0 += sx; }
if (e2 < dy) { err += dx; y0 += sy; }
}
}
#endregion
}
}