Class SparklineBuilder
- Namespace
- SharpConsoleUI.Builders
- Assembly
- SharpConsoleUI.dll
Fluent builder for creating SparklineControl instances.
public class SparklineBuilder
- Inheritance
-
SparklineBuilder
- Inherited Members
Constructors
SparklineBuilder()
Initializes a new instance of the SparklineBuilder class.
public SparklineBuilder()
Methods
Build()
Builds the SparklineControl instance.
public SparklineControl Build()
Returns
Visible(bool)
Sets the visibility.
public SparklineBuilder Visible(bool visible)
Parameters
visiblebool
Returns
WithAlignment(HorizontalAlignment)
Sets the horizontal alignment.
public SparklineBuilder WithAlignment(HorizontalAlignment alignment)
Parameters
alignmentHorizontalAlignment
Returns
WithBackgroundColor(Color)
Sets the background color.
public SparklineBuilder WithBackgroundColor(Color color)
Parameters
colorColor
Returns
WithBarColor(Color)
Sets the bar color.
public SparklineBuilder WithBarColor(Color color)
Parameters
colorColor
Returns
WithBaseline(bool, char, Color?, TitlePosition)
Enables or disables the dotted baseline with optional customization.
public SparklineBuilder WithBaseline(bool show = true, char baselineChar = '┈', Color? color = null, TitlePosition position = TitlePosition.Bottom)
Parameters
showboolWhether to show the baseline.
baselineCharcharCharacter to use for the baseline (default: ┈).
colorColor?Color for the baseline (default: Grey50).
positionTitlePositionPosition of the baseline (Top or Bottom, default: Bottom).
Returns
WithBidirectionalData(IEnumerable<double>, IEnumerable<double>)
Sets both primary and secondary data at once (for bidirectional mode).
public SparklineBuilder WithBidirectionalData(IEnumerable<double> primaryData, IEnumerable<double> secondaryData)
Parameters
primaryDataIEnumerable<double>secondaryDataIEnumerable<double>
Returns
WithBorder(BorderStyle)
Sets the border style.
public SparklineBuilder WithBorder(BorderStyle style)
Parameters
styleBorderStyle
Returns
WithBorder(BorderStyle, Color)
Sets the border style and color.
public SparklineBuilder WithBorder(BorderStyle style, Color color)
Parameters
styleBorderStylecolorColor
Returns
WithBorderColor(Color)
Sets the border color.
public SparklineBuilder WithBorderColor(Color color)
Parameters
colorColor
Returns
WithData(IEnumerable<double>)
Sets the initial data points.
public SparklineBuilder WithData(IEnumerable<double> dataPoints)
Parameters
dataPointsIEnumerable<double>
Returns
WithGradient(ColorGradient)
Sets the color gradient for vertical color interpolation.
public SparklineBuilder WithGradient(ColorGradient gradient)
Parameters
gradientColorGradient
Returns
WithGradient(params Color[])
Sets the color gradient from an array of colors.
public SparklineBuilder WithGradient(params Color[] colors)
Parameters
colorsColor[]
Returns
WithGradient(string)
Sets the color gradient from a gradient specification string. Supports predefined gradients (cool, warm, spectrum, grayscale), arrow notation (blue→cyan→green), and :reverse suffix.
public SparklineBuilder WithGradient(string gradientSpec)
Parameters
gradientSpecstring
Returns
WithHeight(int)
Sets the graph height in lines.
public SparklineBuilder WithHeight(int height)
Parameters
heightint
Returns
WithInlineTitleBaseline(bool)
Sets whether to show the title inline with the baseline. Only applies when TitlePosition and BaselinePosition are the same (both Top or both Bottom). Format: "Title ┈┈┈┈┈┈┈┈┈" (title followed by baseline fill).
public SparklineBuilder WithInlineTitleBaseline(bool inline = true)
Parameters
inlinebool
Returns
WithMargin(Margin)
Sets the margin.
public SparklineBuilder WithMargin(Margin margin)
Parameters
marginMargin
Returns
WithMargin(int, int, int, int)
Sets the margin.
public SparklineBuilder WithMargin(int left, int top, int right, int bottom)
Parameters
Returns
WithMaxDataPoints(int)
Sets the maximum number of data points to keep.
public SparklineBuilder WithMaxDataPoints(int maxPoints)
Parameters
maxPointsint
Returns
WithMaxValue(double)
Sets the maximum value for the graph scale.
public SparklineBuilder WithMaxValue(double maxValue)
Parameters
maxValuedouble
Returns
WithMinValue(double)
Sets the minimum value for the graph scale.
public SparklineBuilder WithMinValue(double minValue)
Parameters
minValuedouble
Returns
WithMode(SparklineMode)
Sets the rendering mode (Block or Braille). Block uses 9-level block characters, Braille uses 5-level braille patterns.
public SparklineBuilder WithMode(SparklineMode mode)
Parameters
modeSparklineMode
Returns
WithName(string)
Sets the control name.
public SparklineBuilder WithName(string name)
Parameters
namestring
Returns
WithSecondaryBarColor(Color)
Sets the secondary bar color (for bidirectional mode).
public SparklineBuilder WithSecondaryBarColor(Color color)
Parameters
colorColor
Returns
WithSecondaryData(IEnumerable<double>)
Sets the secondary data points (for bidirectional mode).
public SparklineBuilder WithSecondaryData(IEnumerable<double> dataPoints)
Parameters
dataPointsIEnumerable<double>
Returns
WithSecondaryGradient(ColorGradient)
Sets the secondary color gradient for bidirectional mode.
public SparklineBuilder WithSecondaryGradient(ColorGradient gradient)
Parameters
gradientColorGradient
Returns
WithSecondaryGradient(params Color[])
Sets the secondary color gradient from an array of colors.
public SparklineBuilder WithSecondaryGradient(params Color[] colors)
Parameters
colorsColor[]
Returns
WithSecondaryGradient(string)
Sets the secondary color gradient from a gradient specification string. Supports predefined gradients (cool, warm, spectrum, grayscale), arrow notation (blue→cyan→green), and :reverse suffix.
public SparklineBuilder WithSecondaryGradient(string gradientSpec)
Parameters
gradientSpecstring
Returns
WithSecondaryMaxValue(double)
Sets the secondary max value (for bidirectional mode).
public SparklineBuilder WithSecondaryMaxValue(double maxValue)
Parameters
maxValuedouble
Returns
WithTitle(string)
Sets the title.
public SparklineBuilder WithTitle(string title)
Parameters
titlestring
Returns
WithTitle(string, Color)
Sets the title and color.
public SparklineBuilder WithTitle(string title, Color color)
Parameters
titlestringcolorColor
Returns
WithTitleColor(Color)
Sets the title color.
public SparklineBuilder WithTitleColor(Color color)
Parameters
colorColor
Returns
WithTitlePosition(TitlePosition)
Sets the title position (Top or Bottom).
public SparklineBuilder WithTitlePosition(TitlePosition position)
Parameters
positionTitlePosition
Returns
WithVerticalAlignment(VerticalAlignment)
Sets the vertical alignment.
public SparklineBuilder WithVerticalAlignment(VerticalAlignment alignment)
Parameters
alignmentVerticalAlignment
Returns
WithWidth(int)
Sets the width.
public SparklineBuilder WithWidth(int width)
Parameters
widthint