Overview

neoChart renders antialiased line, bar, area, pie, and donut charts in VisualNEO Win. It supports simple single-series data, named multi-series comparisons, preset or custom color palettes, responsive legends, negative values, adaptive axes, and BMP or real PNG export.

The layout adapts to small controls. Y-axis space is calculated from the formatted tick labels, value labels are confined to the plot, colliding point labels are moved or omitted, and X-axis labels are thinned when the available width is insufficient.

Properties

Property	Type	Default	Purpose
`chartType`	string	`"line"`	`line`, `bar`, `area`, `pie`, or `donut`.
`labels`	string	`"Jan,Feb,Mar,Apr,May,Jun"`	Comma-separated category labels.
`data`	string	`"12,19,3,5,2,30"`	Values for a simple single-series chart.
`series`	string	empty	Optional multi-series JSON. When present, it replaces `data`.
`palette`	string	`"modern"`	Preset: `modern`, `neon`, `pastel`, `ocean`, or `sunset`.
`customPalette`	string	empty	Comma-separated `#HEX` colors. A non-empty list overrides `palette`.
`title`	string	`"Sales Overview"`	Chart title.
`bgColor`	string	`"auto"`	Background `#HEX`, or `auto` for the VisualNEO fill color.
`showGrid`	boolean	`true`	Shows Cartesian grid lines. Axis values remain visible when disabled.
`showValues`	boolean	`true`	Shows values near points, bars, or pie legend entries.
`showLegend`	boolean	`true`	Shows the series legend when multiple series are present.

VisualNEO fill, line, line width, and text colors are honored. Property values and action changes repaint the chart immediately.

Multi-Series JSON

series is a JSON array. Every item accepts name, data, and an optional color. If color is omitted, the next custom or preset palette color is used.

VisualNEO opens series and the Series JSON parameter of neoChartSetSeries in its structured JSON editor, where the document can be formatted and validated before it is applied.

JSON

[
  {"name":"North","data":[18,24,27,31,35,42]},
  {"name":"South","data":[15,22,20,29,33,37],"color":"#E83E8C"},
  {"name":"Online","data":[8,14,19,25,34,46]}
]

Line and area charts draw one path per series. Bar charts draw grouped bars. Pie and donut charts use the first series and color its categories with the active palette.

Actions

`neoChartSetData`

Sets a simple chart and clears multi-series data.

TEXT

neoChartSetData "Chart1" "Q1,Q2,Q3,Q4" "1450,2100,1890,3200"

`neoChartSetSeries`

Sets category labels and multiple named series.

TEXT

neoChartSetSeries "Chart1" "Jan,Feb,Mar,Apr" "[{\"name\":\"Actual\",\"data\":[12,18,21,26]},{\"name\":\"Target\",\"data\":[14,17,23,28]}]"

`neoChartAddPoint`

Appends one category and value to a simple chart.

TEXT

neoChartAddPoint "Chart1" "Q5" "3500"

`neoChartSetType`

TEXT

neoChartSetType "Chart1" "bar"

`neoChartSetColors`

Selects a preset and clears the custom palette.

TEXT

neoChartSetColors "Chart1" "ocean"

`neoChartSetCustomPalette`

TEXT

neoChartSetCustomPalette "Chart1" "#0057B8,#E83E8C,#16A05D,#F59E0B"

`neoChartClear`

TEXT

neoChartClear "Chart1"

`neoChartExport`

Exports the current control. .png creates PNG data and .bmp creates BMP data.

TEXT

neoChartExport "Chart1" "[PubDir]reports/comparison.png" "1200" "700"

`neoChartGenerate`

Generates a simple chart without placing a control on the page.

TEXT

neoChartGenerate "Q1,Q2,Q3,Q4" "1450,2100,1890,3200" "bar" "modern" "Quarterly Sales" "[PubDir]sales.png" "900" "520"

Recommendations

Use at least 280 x 190 for a titled chart with values.
Disable showValues when comparing many dense series; the legend and axes remain available.
Prefer 3 to 6 high-contrast custom colors for comparison charts.
Use bar for direct category comparison and line for trends.
Export at a larger size than the on-page control for reports.

Notes

Missing series values are rendered as zero.
Positive-only and negative-only data include a zero baseline.
Invalid numeric values are treated as zero.
Custom palette colors accept #RRGGBB values separated by commas, semicolons, or |.