Skip to main content

Overview

The standard series samples demonstrate the most commonly used chart types in TeeChart VCL. These foundational series types support extensive customization including gradients, transparency, 3D effects, and interactive features.

Bar Series

Bar charts are ideal for comparing values across categories.

Bar with Gradient

Demonstrates applying gradient fills to bar series for enhanced visual appeal. Location: TeeNew/Bar_Gradient.pas
unit Bar_Gradient;

type
  TBarGradient = class(TBaseForm)
    Series1: TBarSeries;
    Button1: TButton;
    procedure FormCreate(Sender: TObject);
    procedure Button1Click(Sender: TObject);
  end;

procedure TBarGradient.FormCreate(Sender: TObject);
begin
  inherited;
  Series1.FillSampleValues(6);
end;

procedure TBarGradient.Button1Click(Sender: TObject);
begin
  // Open gradient editor dialog
  TTeeGradientEditor.Edit(Self, Series1.Gradient, True, True);
end;
Key Features:
  • Gradient fill customization
  • Interactive gradient editor
  • Visual gradient effects

Bar 3D Depth

Shows how to control 3D depth for bar series. Location: TeeNew/Bar_3DDepth.pas Features:
  • Adjustable 3D depth
  • Perspective rendering
  • Side-by-side bar comparison

Other Bar Samples

Bar_Cylinder

Cylindrical bar rendering

Bar_Image

Image fills for bars

Bar_MarksOnBar

Value labels positioned on bars

Bar_Rounded

Rounded corner bars

Bar_SelfStack

Self-stacking bar series

Bar_StackGroup

Grouped and stacked bars

Bar_TickLines

Tick marks on bars

Bar_SideAll

Side-by-side bar arrangement

Line Series

Line charts excel at showing trends and changes over time.

Fast Line with Real-time Data

Optimized line series for high-performance real-time data display. Location: TeeNew/FastLine_Realtime.pas
procedure TFastLineRealtime.Timer1Timer(Sender: TObject);
begin
  // Add new point and remove old point for scrolling effect
  Series1.AddXY(Series1.XValues.Last + 1, Random(100));
  
  if Series1.Count > MaxPoints then
    Series1.Delete(0);
end;
Key Features:
  • Real-time data streaming
  • Scrolling chart effect
  • Optimized performance
  • Configurable data point limits

Line Series Samples

Draw all points vs. sampling for performance
Different drawing styles for fast lines
Handling null values in line series
Various null value treatment options
Horizontal line series

Area Series

Area charts fill the region between the line and the axis.

Area with Transparency

Location: TeeNew/Area_Transparency.pas
procedure TAreaTransparency.FormCreate(Sender: TObject);
begin
  inherited;
  Series1.FillSampleValues(10);
  Series2.FillSampleValues(10);
  
  // Set transparency for overlapping areas
  Series1.Transparency := 70;
  Series2.Transparency := 70;
end;
Features:
  • Adjustable transparency levels
  • Overlapping area visualization
  • Gradient fills

Area Series Samples

Area_Gradient

Gradient-filled areas

Area_Origin

Custom origin point for area fill

Area_Stairs

Step-style area charts

Area_TreatNulls

Null value handling in areas

Pie Series

Pie charts display proportional data as slices of a circle.

Pie with Explosions

Location: TeeNew/Pie_Exploded.pas Features:
  • Slice explosion effects
  • Custom slice colors
  • Percentage labels
  • 3D pie rendering

Donut Series

Location: TeeNew/Donut_Series.pas
procedure TDonutForm.FormCreate(Sender: TObject);
begin
  inherited;
  Series1.FillSampleValues(5);
  
  // Configure donut appearance
  Series1.DonutPercent := 50;  // Inner radius percentage
end;

Pie Series Samples

Automatic mark positioning to avoid overlaps
Highlight selected slice on click
Combine small slices into “Other” category
Pattern fills for slices

Point Series

Point series display individual data points with customizable markers.

Point with Custom Pointers

Location: TeeNew/Point_Pointers.pas Features:
  • Custom pointer shapes (circle, rectangle, triangle, star, etc.)
  • Pointer size and color customization
  • Image-based pointers

Bubble Series

Bubble charts show three dimensions of data: X, Y, and radius. Location: TeeNew/Bubble_Gradient.pas
procedure TBubbleGradient.FormCreate(Sender: TObject);
begin
  inherited;
  Series1.AddBubble(10, 20, 30, 'Point 1', clRed);
  Series1.AddBubble(20, 35, 25, 'Point 2', clBlue);
  Series1.AddBubble(30, 15, 40, 'Point 3', clGreen);
  
  // Enable gradient for bubbles
  Series1.Gradient.Visible := True;
end;

Point Series Samples

Bubble_Transparency

Transparent bubbles for overlap visibility

Point_ColorEach

Individual point colors

Point_InflateMargins

Automatic margin adjustment for point visibility

Point_Pointers3D

3D pointer rendering

Common Features

All standard series support:
  • Custom mark text
  • Mark positioning
  • Mark styles (value, percent, label, etc.)
  • HTML formatted marks
  • Individual point colors
  • Gradient fills
  • Transparency
  • Color palettes
  • Click events
  • Mouse hover tooltips
  • Point selection
  • Drag and drop
  • 3D rendering
  • Rotation and elevation
  • Depth control
  • Orthogonal vs perspective

Performance Optimization

For large datasets, use these techniques:
// Disable auto-repaint during data loading
Chart1.AutoRepaint := False;
try
  for i := 0 to 10000 do
    Series1.AddXY(i, RandomValue);
finally
  Chart1.AutoRepaint := True;
end;

// Use FastLine for best performance
Series1.DrawStyle := dsAll;  // or dsSegments
Series1.LinePen.Width := 1;  // Thin pens are faster

Statistical Charts

Box plots, histograms, error bars

Financial Charts

Candle, OHLC, volume series

3D Charts

Surface, contour, 3D points

Gauges

Circular and linear gauges

Build docs developers (and LLMs) love