kmadej_fast_excel_fork 0.2.2

data/libxlsxwriter/include/xlsxwriter/chart.h

@@ -0,0 +1,3476 @@
+/*
+ * libxlsxwriter
+ *
+ * Copyright 2014-2017, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ *
+ * chart - A libxlsxwriter library for creating Excel XLSX chart files.
+ *
+ */
+
+/**
+ * @page chart_page The Chart object
+ *
+ * The Chart object represents an Excel chart. It provides functions for
+ * adding data series to the chart and for configuring the chart.
+ *
+ * See @ref chart.h for full details of the functionality.
+ *
+ * @file chart.h
+ *
+ * @brief Functions related to adding data to and configuring  a chart.
+ *
+ * The Chart object represents an Excel chart. It provides functions for
+ * adding data series to the chart and for configuring the chart.
+ *
+ * A Chart object isn't created directly. Instead a chart is created by
+ * calling the `workbook_add_chart()` function from a Workbook object. For
+ * example:
+ *
+ * @code
+ *
+ * #include "xlsxwriter.h"
+ *
+ * int main() {
+ *
+ *     lxw_workbook  *workbook  = new_workbook("chart.xlsx");
+ *     lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);
+ *
+ *     // User function to add data to worksheet, not shown here.
+ *     write_worksheet_data(worksheet);
+ *
+ *     // Create a chart object.
+ *     lxw_chart *chart = workbook_add_chart(workbook, LXW_CHART_COLUMN);
+ *
+ *     // In the simplest case we just add some value data series.
+ *     // The NULL categories will default to 1 to 5 like in Excel.
+ *     chart_add_series(chart, NULL, "=Sheet1!$A$1:$A$5");
+ *     chart_add_series(chart, NULL, "=Sheet1!$B$1:$B$5");
+ *     chart_add_series(chart, NULL, "=Sheet1!$C$1:$C$5");
+ *
+ *     // Insert the chart into the worksheet
+ *     worksheet_insert_chart(worksheet, CELL("B7"), chart);
+ *
+ *     return workbook_close(workbook);
+ * }
+ *
+ * @endcode
+ *
+ * The chart in the worksheet will look like this:
+ * @image html chart_simple.png
+ *
+ * The basic procedure for adding a chart to a worksheet is:
+ *
+ * 1. Create the chart with `workbook_add_chart()`.
+ * 2. Add one or more data series to the chart which refers to data in the
+ *    workbook using `chart_add_series()`.
+ * 3. Configure the chart with the other available functions shown below.
+ * 4. Insert the chart into a worksheet using `worksheet_insert_chart()`.
+ *
+ */
+
+#ifndef __LXW_CHART_H__
+#define __LXW_CHART_H__
+
+#include <stdint.h>
+#include <string.h>
+
+#include "common.h"
+#include "format.h"
+
+STAILQ_HEAD(lxw_chart_series_list, lxw_chart_series);
+STAILQ_HEAD(lxw_series_data_points, lxw_series_data_point);
+
+#define LXW_CHART_NUM_FORMAT_LEN 128
+#define LXW_CHART_DEFAULT_GAP 501
+
+/**
+ * @brief Available chart types.
+ */
+typedef enum lxw_chart_type {
+
+    /** None. */
+    LXW_CHART_NONE = 0,
+
+    /** Area chart. */
+    LXW_CHART_AREA,
+
+    /** Area chart - stacked. */
+    LXW_CHART_AREA_STACKED,
+
+    /** Area chart - percentage stacked. */
+    LXW_CHART_AREA_STACKED_PERCENT,
+
+    /** Bar chart. */
+    LXW_CHART_BAR,
+
+    /** Bar chart - stacked. */
+    LXW_CHART_BAR_STACKED,
+
+    /** Bar chart - percentage stacked. */
+    LXW_CHART_BAR_STACKED_PERCENT,
+
+    /** Column chart. */
+    LXW_CHART_COLUMN,
+
+    /** Column chart - stacked. */
+    LXW_CHART_COLUMN_STACKED,
+
+    /** Column chart - percentage stacked. */
+    LXW_CHART_COLUMN_STACKED_PERCENT,
+
+    /** Doughnut chart. */
+    LXW_CHART_DOUGHNUT,
+
+    /** Line chart. */
+    LXW_CHART_LINE,
+
+    /** Pie chart. */
+    LXW_CHART_PIE,
+
+    /** Scatter chart. */
+    LXW_CHART_SCATTER,
+
+    /** Scatter chart - straight. */
+    LXW_CHART_SCATTER_STRAIGHT,
+
+    /** Scatter chart - straight with markers. */
+    LXW_CHART_SCATTER_STRAIGHT_WITH_MARKERS,
+
+    /** Scatter chart - smooth. */
+    LXW_CHART_SCATTER_SMOOTH,
+
+    /** Scatter chart - smooth with markers. */
+    LXW_CHART_SCATTER_SMOOTH_WITH_MARKERS,
+
+    /** Radar chart. */
+    LXW_CHART_RADAR,
+
+    /** Radar chart - with markers. */
+    LXW_CHART_RADAR_WITH_MARKERS,
+
+    /** Radar chart - filled. */
+    LXW_CHART_RADAR_FILLED
+} lxw_chart_type;
+
+/**
+ * @brief Chart legend positions.
+ */
+typedef enum lxw_chart_legend_position {
+
+    /** No chart legend. */
+    LXW_CHART_LEGEND_NONE = 0,
+
+    /** Chart legend positioned at right side. */
+    LXW_CHART_LEGEND_RIGHT,
+
+    /** Chart legend positioned at left side. */
+    LXW_CHART_LEGEND_LEFT,
+
+    /** Chart legend positioned at top. */
+    LXW_CHART_LEGEND_TOP,
+
+    /** Chart legend positioned at bottom. */
+    LXW_CHART_LEGEND_BOTTOM,
+
+    /** Chart legend overlaid at right side. */
+    LXW_CHART_LEGEND_OVERLAY_RIGHT,
+
+    /** Chart legend overlaid at left side. */
+    LXW_CHART_LEGEND_OVERLAY_LEFT
+} lxw_chart_legend_position;
+
+/**
+ * @brief Chart line dash types.
+ *
+ * The dash types are shown in the order that they appear in the Excel dialog.
+ * See @ref chart_lines.
+ */
+typedef enum lxw_chart_line_dash_type {
+
+    /** Solid. */
+    LXW_CHART_LINE_DASH_SOLID = 0,
+
+    /** Round Dot. */
+    LXW_CHART_LINE_DASH_ROUND_DOT,
+
+    /** Square Dot. */
+    LXW_CHART_LINE_DASH_SQUARE_DOT,
+
+    /** Dash. */
+    LXW_CHART_LINE_DASH_DASH,
+
+    /** Dash Dot. */
+    LXW_CHART_LINE_DASH_DASH_DOT,
+
+    /** Long Dash. */
+    LXW_CHART_LINE_DASH_LONG_DASH,
+
+    /** Long Dash Dot. */
+    LXW_CHART_LINE_DASH_LONG_DASH_DOT,
+
+    /** Long Dash Dot Dot. */
+    LXW_CHART_LINE_DASH_LONG_DASH_DOT_DOT,
+
+    /* These aren't available in the dialog but are used by Excel. */
+    LXW_CHART_LINE_DASH_DOT,
+    LXW_CHART_LINE_DASH_SYSTEM_DASH_DOT,
+    LXW_CHART_LINE_DASH_SYSTEM_DASH_DOT_DOT
+} lxw_chart_line_dash_type;
+
+/**
+ * @brief Chart marker types.
+ */
+typedef enum lxw_chart_marker_type {
+
+    /** Automatic, series default, marker type. */
+    LXW_CHART_MARKER_AUTOMATIC,
+
+    /** No marker type. */
+    LXW_CHART_MARKER_NONE,
+
+    /** Square marker type. */
+    LXW_CHART_MARKER_SQUARE,
+
+    /** Diamond marker type. */
+    LXW_CHART_MARKER_DIAMOND,
+
+    /** Triangle marker type. */
+    LXW_CHART_MARKER_TRIANGLE,
+
+    /** X shape marker type. */
+    LXW_CHART_MARKER_X,
+
+    /** Star marker type. */
+    LXW_CHART_MARKER_STAR,
+
+    /** Short dash marker type. */
+    LXW_CHART_MARKER_SHORT_DASH,
+
+    /** Long dash marker type. */
+    LXW_CHART_MARKER_LONG_DASH,
+
+    /** Circle marker type. */
+    LXW_CHART_MARKER_CIRCLE,
+
+    /** Plus (+) marker type. */
+    LXW_CHART_MARKER_PLUS
+} lxw_chart_marker_type;
+
+/**
+ * @brief Chart pattern types.
+ */
+typedef enum lxw_chart_pattern_type {
+
+    /** None pattern. */
+    LXW_CHART_PATTERN_NONE,
+
+    /** 5 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_5,
+
+    /** 10 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_10,
+
+    /** 20 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_20,
+
+    /** 25 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_25,
+
+    /** 30 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_30,
+
+    /** 40 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_40,
+
+    /** 50 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_50,
+
+    /** 60 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_60,
+
+    /** 70 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_70,
+
+    /** 75 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_75,
+
+    /** 80 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_80,
+
+    /** 90 Percent pattern. */
+    LXW_CHART_PATTERN_PERCENT_90,
+
+    /** Light downward diagonal pattern. */
+    LXW_CHART_PATTERN_LIGHT_DOWNWARD_DIAGONAL,
+
+    /** Light upward diagonal pattern. */
+    LXW_CHART_PATTERN_LIGHT_UPWARD_DIAGONAL,
+
+    /** Dark downward diagonal pattern. */
+    LXW_CHART_PATTERN_DARK_DOWNWARD_DIAGONAL,
+
+    /** Dark upward diagonal pattern. */
+    LXW_CHART_PATTERN_DARK_UPWARD_DIAGONAL,
+
+    /** Wide downward diagonal pattern. */
+    LXW_CHART_PATTERN_WIDE_DOWNWARD_DIAGONAL,
+
+    /** Wide upward diagonal pattern. */
+    LXW_CHART_PATTERN_WIDE_UPWARD_DIAGONAL,
+
+    /** Light vertical pattern. */
+    LXW_CHART_PATTERN_LIGHT_VERTICAL,
+
+    /** Light horizontal pattern. */
+    LXW_CHART_PATTERN_LIGHT_HORIZONTAL,
+
+    /** Narrow vertical pattern. */
+    LXW_CHART_PATTERN_NARROW_VERTICAL,
+
+    /** Narrow horizontal pattern. */
+    LXW_CHART_PATTERN_NARROW_HORIZONTAL,
+
+    /** Dark vertical pattern. */
+    LXW_CHART_PATTERN_DARK_VERTICAL,
+
+    /** Dark horizontal pattern. */
+    LXW_CHART_PATTERN_DARK_HORIZONTAL,
+
+    /** Dashed downward diagonal pattern. */
+    LXW_CHART_PATTERN_DASHED_DOWNWARD_DIAGONAL,
+
+    /** Dashed upward diagonal pattern. */
+    LXW_CHART_PATTERN_DASHED_UPWARD_DIAGONAL,
+
+    /** Dashed horizontal pattern. */
+    LXW_CHART_PATTERN_DASHED_HORIZONTAL,
+
+    /** Dashed vertical pattern. */
+    LXW_CHART_PATTERN_DASHED_VERTICAL,
+
+    /** Small confetti pattern. */
+    LXW_CHART_PATTERN_SMALL_CONFETTI,
+
+    /** Large confetti pattern. */
+    LXW_CHART_PATTERN_LARGE_CONFETTI,
+
+    /** Zigzag pattern. */
+    LXW_CHART_PATTERN_ZIGZAG,
+
+    /** Wave pattern. */
+    LXW_CHART_PATTERN_WAVE,
+
+    /** Diagonal brick pattern. */
+    LXW_CHART_PATTERN_DIAGONAL_BRICK,
+
+    /** Horizontal brick pattern. */
+    LXW_CHART_PATTERN_HORIZONTAL_BRICK,
+
+    /** Weave pattern. */
+    LXW_CHART_PATTERN_WEAVE,
+
+    /** Plaid pattern. */
+    LXW_CHART_PATTERN_PLAID,
+
+    /** Divot pattern. */
+    LXW_CHART_PATTERN_DIVOT,
+
+    /** Dotted grid pattern. */
+    LXW_CHART_PATTERN_DOTTED_GRID,
+
+    /** Dotted diamond pattern. */
+    LXW_CHART_PATTERN_DOTTED_DIAMOND,
+
+    /** Shingle pattern. */
+    LXW_CHART_PATTERN_SHINGLE,
+
+    /** Trellis pattern. */
+    LXW_CHART_PATTERN_TRELLIS,
+
+    /** Sphere pattern. */
+    LXW_CHART_PATTERN_SPHERE,
+
+    /** Small grid pattern. */
+    LXW_CHART_PATTERN_SMALL_GRID,
+
+    /** Large grid pattern. */
+    LXW_CHART_PATTERN_LARGE_GRID,
+
+    /** Small check pattern. */
+    LXW_CHART_PATTERN_SMALL_CHECK,
+
+    /** Large check pattern. */
+    LXW_CHART_PATTERN_LARGE_CHECK,
+
+    /** Outlined diamond pattern. */
+    LXW_CHART_PATTERN_OUTLINED_DIAMOND,
+
+    /** Solid diamond pattern. */
+    LXW_CHART_PATTERN_SOLID_DIAMOND
+} lxw_chart_pattern_type;
+
+/**
+ * @brief Chart data label positions.
+ */
+typedef enum lxw_chart_label_position {
+    /** Series data label position: default position. */
+    LXW_CHART_LABEL_POSITION_DEFAULT,
+
+    /** Series data label position: center. */
+    LXW_CHART_LABEL_POSITION_CENTER,
+
+    /** Series data label position: right. */
+    LXW_CHART_LABEL_POSITION_RIGHT,
+
+    /** Series data label position: left. */
+    LXW_CHART_LABEL_POSITION_LEFT,
+
+    /** Series data label position: above. */
+    LXW_CHART_LABEL_POSITION_ABOVE,
+
+    /** Series data label position: below. */
+    LXW_CHART_LABEL_POSITION_BELOW,
+
+    /** Series data label position: inside base.  */
+    LXW_CHART_LABEL_POSITION_INSIDE_BASE,
+
+    /** Series data label position: inside end. */
+    LXW_CHART_LABEL_POSITION_INSIDE_END,
+
+    /** Series data label position: outside end. */
+    LXW_CHART_LABEL_POSITION_OUTSIDE_END,
+
+    /** Series data label position: best fit. */
+    LXW_CHART_LABEL_POSITION_BEST_FIT
+} lxw_chart_label_position;
+
+/**
+ * @brief Chart data label separator.
+ */
+typedef enum lxw_chart_label_separator {
+    /** Series data label separator: comma (the default). */
+    LXW_CHART_LABEL_SEPARATOR_COMMA,
+
+    /** Series data label separator: semicolon. */
+    LXW_CHART_LABEL_SEPARATOR_SEMICOLON,
+
+    /** Series data label separator: period. */
+    LXW_CHART_LABEL_SEPARATOR_PERIOD,
+
+    /** Series data label separator: newline. */
+    LXW_CHART_LABEL_SEPARATOR_NEWLINE,
+
+    /** Series data label separator: space. */
+    LXW_CHART_LABEL_SEPARATOR_SPACE
+} lxw_chart_label_separator;
+
+enum lxw_chart_subtype {
+
+    LXW_CHART_SUBTYPE_NONE = 0,
+    LXW_CHART_SUBTYPE_STACKED,
+    LXW_CHART_SUBTYPE_STACKED_PERCENT
+};
+
+enum lxw_chart_grouping {
+    LXW_GROUPING_CLUSTERED,
+    LXW_GROUPING_STANDARD,
+    LXW_GROUPING_PERCENTSTACKED,
+    LXW_GROUPING_STACKED
+};
+
+/**
+ * @brief Axis positions for category axes.
+ */
+typedef enum lxw_chart_axis_tick_position {
+
+    LXW_CHART_AXIS_POSITION_DEFAULT,
+
+    /** Position category axis on tick marks. */
+    LXW_CHART_AXIS_POSITION_ON_TICK,
+
+    /** Position category axis between tick marks. */
+    LXW_CHART_AXIS_POSITION_BETWEEN
+} lxw_chart_axis_tick_position;
+
+/**
+ * @brief Axis label positions.
+ */
+typedef enum lxw_chart_axis_label_position {
+
+    /** Position the axis labels next to the axis. The default. */
+    LXW_CHART_AXIS_LABEL_POSITION_NEXT_TO,
+
+    /** Position the axis labels at the top of the chart, for horizontal
+     * axes, or to the right for vertical axes.*/
+    LXW_CHART_AXIS_LABEL_POSITION_HIGH,
+
+    /** Position the axis labels at the bottom of the chart, for horizontal
+     * axes, or to the left for vertical axes.*/
+    LXW_CHART_AXIS_LABEL_POSITION_LOW,
+
+    /** Turn off the the axis labels. */
+    LXW_CHART_AXIS_LABEL_POSITION_NONE
+} lxw_chart_axis_label_position;
+
+/**
+ * @brief Display units for chart value axis.
+ */
+typedef enum lxw_chart_axis_display_unit {
+
+    /** Axis display units: None. The default. */
+    LXW_CHART_AXIS_UNITS_NONE,
+
+    /** Axis display units: Hundreds. */
+    LXW_CHART_AXIS_UNITS_HUNDREDS,
+
+    /** Axis display units: Thousands. */
+    LXW_CHART_AXIS_UNITS_THOUSANDS,
+
+    /** Axis display units: Ten thousands. */
+    LXW_CHART_AXIS_UNITS_TEN_THOUSANDS,
+
+    /** Axis display units: Hundred thousands. */
+    LXW_CHART_AXIS_UNITS_HUNDRED_THOUSANDS,
+
+    /** Axis display units: Millions. */
+    LXW_CHART_AXIS_UNITS_MILLIONS,
+
+    /** Axis display units: Ten millions. */
+    LXW_CHART_AXIS_UNITS_TEN_MILLIONS,
+
+    /** Axis display units: Hundred millions. */
+    LXW_CHART_AXIS_UNITS_HUNDRED_MILLIONS,
+
+    /** Axis display units: Billions. */
+    LXW_CHART_AXIS_UNITS_BILLIONS,
+
+    /** Axis display units: Trillions. */
+    LXW_CHART_AXIS_UNITS_TRILLIONS
+} lxw_chart_axis_display_unit;
+
+/**
+ * @brief Tick mark types for an axis.
+ */
+typedef enum lxw_chart_axis_tick_mark {
+
+    /** Default tick mark for the chart axis. Usually outside. */
+    LXW_CHART_AXIS_TICK_MARK_DEFAULT,
+
+    /** No tick mark for the axis. */
+    LXW_CHART_AXIS_TICK_MARK_NONE,
+
+    /** Tick mark inside the axis only. */
+    LXW_CHART_AXIS_TICK_MARK_INSIDE,
+
+    /** Tick mark outside the axis only. */
+    LXW_CHART_AXIS_TICK_MARK_OUTSIDE,
+
+    /** Tick mark inside and outside the axis. */
+    LXW_CHART_AXIS_TICK_MARK_CROSSING
+} lxw_chart_tick_mark;
+
+typedef struct lxw_series_range {
+    char *formula;
+    char *sheetname;
+    lxw_row_t first_row;
+    lxw_row_t last_row;
+    lxw_col_t first_col;
+    lxw_col_t last_col;
+    uint8_t ignore_cache;
+
+    uint8_t has_string_cache;
+    uint16_t num_data_points;
+    struct lxw_series_data_points *data_cache;
+
+} lxw_series_range;
+
+typedef struct lxw_series_data_point {
+    uint8_t is_string;
+    double number;
+    char *string;
+    uint8_t no_data;
+
+    STAILQ_ENTRY (lxw_series_data_point) list_pointers;
+
+} lxw_series_data_point;
+
+/**
+ * @brief Struct to represent a chart line.
+ *
+ * See @ref chart_lines.
+ */
+typedef struct lxw_chart_line {
+
+    /** The chart font color. See @ref working_with_colors. */
+    lxw_color_t color;
+
+    /** Turn off/hide line. Set to 0 or 1.*/
+    uint8_t none;
+
+    /** Width of the line in increments of 0.25. Default is 2.25. */
+    float width;
+
+    /** The line dash type. See #lxw_chart_line_dash_type. */
+    uint8_t dash_type;
+
+    /* Transparency for lines isn't generally useful. Undocumented for now. */
+    uint8_t transparency;
+
+    /* Members for internal use only. */
+    uint8_t has_color;
+
+} lxw_chart_line;
+
+/**
+ * @brief Struct to represent a chart fill.
+ *
+ * See @ref chart_fills.
+ */
+typedef struct lxw_chart_fill {
+
+    /** The chart font color. See @ref working_with_colors. */
+    lxw_color_t color;
+
+    /** Turn off/hide line. Set to 0 or 1.*/
+    uint8_t none;
+
+    /** Set the transparency of the fill. 0 - 100. Default 0. */
+    uint8_t transparency;
+
+    /* Members for internal use only. */
+    uint8_t has_color;
+
+} lxw_chart_fill;
+
+/**
+ * @brief Struct to represent a chart pattern.
+ *
+ * See @ref chart_patterns.
+ */
+typedef struct lxw_chart_pattern {
+
+    /** The pattern foreground color. See @ref working_with_colors. */
+    lxw_color_t fg_color;
+
+    /** The pattern background color. See @ref working_with_colors. */
+    lxw_color_t bg_color;
+
+    /** The pattern type. See #lxw_chart_pattern_type. */
+    uint8_t type;
+
+    /* Members for internal use only. */
+    uint8_t has_fg_color;
+    uint8_t has_bg_color;
+
+} lxw_chart_pattern;
+
+/**
+ * @brief Struct to represent a chart font.
+ *
+ * See @ref chart_fonts.
+ */
+typedef struct lxw_chart_font {
+
+    /** The chart font name, such as "Arial" or "Calibri". */
+    char *name;
+
+    /** The chart font size. The default is 11. */
+    uint16_t size;
+
+    /** The chart font bold property. Set to 0 or 1. */
+    uint8_t bold;
+
+    /** The chart font italic property. Set to 0 or 1. */
+    uint8_t italic;
+
+    /** The chart font underline property. Set to 0 or 1. */
+    uint8_t underline;
+
+    /** The chart font rotation property. Range: -90 to 90. */
+    int32_t rotation;
+
+    /** The chart font color. See @ref working_with_colors. */
+    lxw_color_t color;
+
+    /* Members for internal use only. */
+    uint8_t pitch_family;
+    uint8_t charset;
+    int8_t baseline;
+    uint8_t has_color;
+
+} lxw_chart_font;
+
+typedef struct lxw_chart_marker {
+
+    uint8_t type;
+    uint8_t size;
+    lxw_chart_line *line;
+    lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+
+} lxw_chart_marker;
+
+typedef struct lxw_chart_legend {
+
+    lxw_chart_font *font;
+    uint8_t position;
+
+} lxw_chart_legend;
+
+typedef struct lxw_chart_title {
+
+    char *name;
+    lxw_row_t row;
+    lxw_col_t col;
+    lxw_chart_font *font;
+    uint8_t off;
+    uint8_t is_horizontal;
+    uint8_t ignore_cache;
+
+    /* We use a range to hold the title formula properties even though it
+     * will only have 1 point in order to re-use similar functions.*/
+    lxw_series_range *range;
+
+    struct lxw_series_data_point data_point;
+
+} lxw_chart_title;
+
+/**
+ * @brief Struct to represent an Excel chart data point.
+ *
+ * The lxw_chart_point used to set the line, fill and pattern of one or more
+ * points in a chart data series. See @ref chart_points.
+ */
+typedef struct lxw_chart_point {
+
+    /** The line/border for the chart point. See @ref chart_lines. */
+    lxw_chart_line *line;
+
+    /** The fill for the chart point. See @ref chart_fills. */
+    lxw_chart_fill *fill;
+
+    /** The pattern for the chart point. See @ref chart_patterns.*/
+    lxw_chart_pattern *pattern;
+
+} lxw_chart_point;
+
+/**
+ * @brief Define how blank values are displayed in a chart.
+ */
+typedef enum lxw_chart_blank {
+
+    /** Show empty chart cells as gaps in the data. The default. */
+    LXW_CHART_BLANKS_AS_GAP,
+
+    /** Show empty chart cells as zeros. */
+    LXW_CHART_BLANKS_AS_ZERO,
+
+    /** Show empty chart cells as connected. Only for charts with lines. */
+    LXW_CHART_BLANKS_AS_CONNECTED
+} lxw_chart_blank;
+
+enum lxw_chart_position {
+    LXW_CHART_AXIS_RIGHT,
+    LXW_CHART_AXIS_LEFT,
+    LXW_CHART_AXIS_TOP,
+    LXW_CHART_AXIS_BOTTOM
+};
+
+/**
+ * @brief Type/amount of data series error bar.
+ */
+typedef enum lxw_chart_error_bar_type {
+    /** Error bar type: Standard error. */
+    LXW_CHART_ERROR_BAR_TYPE_STD_ERROR,
+
+    /** Error bar type: Fixed value. */
+    LXW_CHART_ERROR_BAR_TYPE_FIXED,
+
+    /** Error bar type: Percentage. */
+    LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE,
+
+    /** Error bar type: Standard deviation(s). */
+    LXW_CHART_ERROR_BAR_TYPE_STD_DEV
+} lxw_chart_error_bar_type;
+
+/**
+ * @brief Direction for a data series error bar.
+ */
+typedef enum lxw_chart_error_bar_direction {
+
+    /** Error bar extends in both directions. The default. */
+    LXW_CHART_ERROR_BAR_DIR_BOTH,
+
+    /** Error bar extends in positive direction. */
+    LXW_CHART_ERROR_BAR_DIR_PLUS,
+
+    /** Error bar extends in negative direction. */
+    LXW_CHART_ERROR_BAR_DIR_MINUS
+} lxw_chart_error_bar_direction;
+
+/**
+ * @brief End cap styles for a data series error bar.
+ */
+typedef enum lxw_chart_error_bar_cap {
+    /** Flat end cap. The default. */
+    LXW_CHART_ERROR_BAR_END_CAP,
+
+    /** No end cap. */
+    LXW_CHART_ERROR_BAR_NO_CAP
+} lxw_chart_error_bar_cap;
+
+typedef struct lxw_series_error_bars {
+    uint8_t type;
+    uint8_t direction;
+    uint8_t endcap;
+    uint8_t has_value;
+    uint8_t is_set;
+    uint8_t is_x;
+    uint8_t chart_group;
+    double value;
+    lxw_chart_line *line;
+
+} lxw_series_error_bars;
+
+/**
+ * @brief Series trendline/regression types.
+ */
+typedef enum lxw_chart_trendline_type {
+    /** Trendline type: Linear. */
+    LXW_CHART_TRENDLINE_TYPE_LINEAR,
+
+    /** Trendline type: Logarithm. */
+    LXW_CHART_TRENDLINE_TYPE_LOG,
+
+    /** Trendline type: Polynomial. */
+    LXW_CHART_TRENDLINE_TYPE_POLY,
+
+    /** Trendline type: Power. */
+    LXW_CHART_TRENDLINE_TYPE_POWER,
+
+    /** Trendline type: Exponential. */
+    LXW_CHART_TRENDLINE_TYPE_EXP,
+
+    /** Trendline type: Moving Average. */
+    LXW_CHART_TRENDLINE_TYPE_AVERAGE
+} lxw_chart_trendline_type;
+
+/**
+ * @brief Struct to represent an Excel chart data series.
+ *
+ * The lxw_chart_series is created using the chart_add_series function. It is
+ * used in functions that modify a chart series but the members of the struct
+ * aren't modified directly.
+ */
+typedef struct lxw_chart_series {
+
+    lxw_series_range *categories;
+    lxw_series_range *values;
+    lxw_chart_title title;
+    lxw_chart_line *line;
+    lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+    lxw_chart_marker *marker;
+    lxw_chart_point *points;
+    uint16_t point_count;
+
+    uint8_t smooth;
+    uint8_t invert_if_negative;
+
+    /* Data label parameters. */
+    uint8_t has_labels;
+    uint8_t show_labels_value;
+    uint8_t show_labels_category;
+    uint8_t show_labels_name;
+    uint8_t show_labels_leader;
+    uint8_t show_labels_legend;
+    uint8_t show_labels_percent;
+    uint8_t label_position;
+    uint8_t label_separator;
+    uint8_t default_label_position;
+    char *label_num_format;
+    lxw_chart_font *label_font;
+
+    lxw_series_error_bars *x_error_bars;
+    lxw_series_error_bars *y_error_bars;
+
+    uint8_t has_trendline;
+    uint8_t has_trendline_forecast;
+    uint8_t has_trendline_equation;
+    uint8_t has_trendline_r_squared;
+    uint8_t has_trendline_intercept;
+    uint8_t trendline_type;
+    uint8_t trendline_value;
+    double trendline_forward;
+    double trendline_backward;
+    uint8_t trendline_value_type;
+    char *trendline_name;
+    lxw_chart_line *trendline_line;
+    double trendline_intercept;
+
+    STAILQ_ENTRY (lxw_chart_series) list_pointers;
+
+} lxw_chart_series;
+
+/* Struct for major/minor axis gridlines. */
+typedef struct lxw_chart_gridline {
+
+    uint8_t visible;
+    lxw_chart_line *line;
+
+} lxw_chart_gridline;
+
+/**
+ * @brief Struct to represent an Excel chart axis.
+ *
+ * The lxw_chart_axis struct is used in functions that modify a chart axis
+ * but the members of the struct aren't modified directly.
+ */
+typedef struct lxw_chart_axis {
+
+    lxw_chart_title title;
+
+    char *num_format;
+    char *default_num_format;
+    uint8_t source_linked;
+
+    uint8_t major_tick_mark;
+    uint8_t minor_tick_mark;
+    uint8_t is_horizontal;
+
+    lxw_chart_gridline major_gridlines;
+    lxw_chart_gridline minor_gridlines;
+
+    lxw_chart_font *num_font;
+    lxw_chart_line *line;
+    lxw_chart_fill *fill;
+    lxw_chart_pattern *pattern;
+
+    uint8_t is_category;
+    uint8_t is_date;
+    uint8_t is_value;
+    uint8_t axis_position;
+    uint8_t position_axis;
+    uint8_t label_position;
+    uint8_t hidden;
+    uint8_t reverse;
+
+    uint8_t has_min;
+    double min;
+    uint8_t has_max;
+    double max;
+
+    uint8_t has_major_unit;
+    double major_unit;
+    uint8_t has_minor_unit;
+    double minor_unit;
+
+    uint16_t interval_unit;
+    uint16_t interval_tick;
+
+    uint16_t log_base;
+
+    uint8_t display_units;
+    uint8_t display_units_visible;
+
+    uint8_t has_crossing;
+    uint8_t crossing_max;
+    double crossing;
+
+} lxw_chart_axis;
+
+/**
+ * @brief Struct to represent an Excel chart.
+ *
+ * The members of the lxw_chart struct aren't modified directly. Instead
+ * the chart properties are set by calling the functions shown in chart.h.
+ */
+typedef struct lxw_chart {
+
+    FILE *file;
+
+    uint8_t type;
+    uint8_t subtype;
+    uint16_t series_index;
+
+    void (*write_chart_type) (struct lxw_chart *);
+    void (*write_plot_area) (struct lxw_chart *);
+
+    /**
+     * A pointer to the chart x_axis object which can be used in functions
+     * that configures the X axis.
+     */
+    lxw_chart_axis *x_axis;
+
+    /**
+     * A pointer to the chart y_axis object which can be used in functions
+     * that configures the Y axis.
+     */
+    lxw_chart_axis *y_axis;
+
+    lxw_chart_title title;
+
+    uint32_t id;
+    uint32_t axis_id_1;
+    uint32_t axis_id_2;
+    uint32_t axis_id_3;
+    uint32_t axis_id_4;
+
+    uint8_t in_use;
+    uint8_t chart_group;
+    uint8_t cat_has_num_fmt;
+
+    uint8_t has_horiz_cat_axis;
+    uint8_t has_horiz_val_axis;
+
+    uint8_t style_id;
+    uint16_t rotation;
+    uint16_t hole_size;
+
+    uint8_t no_title;
+    uint8_t has_overlap;
+    int8_t overlap_y1;
+    int8_t overlap_y2;
+    uint16_t gap_y1;
+    uint16_t gap_y2;
+
+    uint8_t grouping;
+    uint8_t default_cross_between;
+
+    lxw_chart_legend legend;
+    int16_t *delete_series;
+    uint16_t delete_series_count;
+    lxw_chart_marker *default_marker;
+
+    lxw_chart_line *chartarea_line;
+    lxw_chart_fill *chartarea_fill;
+    lxw_chart_pattern *chartarea_pattern;
+    lxw_chart_line *plotarea_line;
+    lxw_chart_fill *plotarea_fill;
+    lxw_chart_pattern *plotarea_pattern;
+
+    uint8_t has_drop_lines;
+    lxw_chart_line *drop_lines_line;
+
+    uint8_t has_high_low_lines;
+    lxw_chart_line *high_low_lines_line;
+
+    struct lxw_chart_series_list *series_list;
+
+    uint8_t has_table;
+    uint8_t has_table_vertical;
+    uint8_t has_table_horizontal;
+    uint8_t has_table_outline;
+    uint8_t has_table_legend_keys;
+    lxw_chart_font *table_font;
+
+    uint8_t show_blanks_as;
+    uint8_t show_hidden_data;
+
+    uint8_t has_up_down_bars;
+    lxw_chart_line *up_bar_line;
+    lxw_chart_line *down_bar_line;
+    lxw_chart_fill *up_bar_fill;
+    lxw_chart_fill *down_bar_fill;
+
+    uint8_t default_label_position;
+
+    STAILQ_ENTRY (lxw_chart) ordered_list_pointers;
+    STAILQ_ENTRY (lxw_chart) list_pointers;
+
+} lxw_chart;
+
+
+/* *INDENT-OFF* */
+#ifdef __cplusplus
+extern "C" {
+#endif
+/* *INDENT-ON* */
+
+lxw_chart *lxw_chart_new(uint8_t type);
+void lxw_chart_free(lxw_chart *chart);
+void lxw_chart_assemble_xml_file(lxw_chart *chart);
+
+/**
+ * @brief Add a data series to a chart.
+ *
+ * @param chart      Pointer to a lxw_chart instance to be configured.
+ * @param categories The range of categories in the data series.
+ * @param values     The range of values in the data series.
+ *
+ * @return A lxw_chart_series object pointer.
+ *
+ * In Excel a chart **series** is a collection of information that defines
+ * which data is plotted such as the categories and values. It is also used to
+ * define the formatting for the data.
+ *
+ * For an libxlsxwriter chart object the `%chart_add_series()` function is
+ * used to set the categories and values of the series:
+ *
+ * @code
+ *     chart_add_series(chart, "=Sheet1!$A$2:$A$7", "=Sheet1!$C$2:$C$7");
+ * @endcode
+ *
+ *
+ * The series parameters are:
+ *
+ * - `categories`: This sets the chart category labels. The category is more
+ *   or less the same as the X axis. In most Excel chart types the
+ *   `categories` property is optional and the chart will just assume a
+ *   sequential series from `1..n`:
+ *
+ * @code
+ *     // The NULL category will default to 1 to 5 like in Excel.
+ *     chart_add_series(chart, NULL, "Sheet1!$A$1:$A$5");
+ * @endcode
+ *
+ *  - `values`: This is the most important property of a series and is the
+ *    only mandatory option for every chart object. This parameter links the
+ *    chart with the worksheet data that it displays.
+ *
+ * The `categories` and `values` should be a string formula like
+ * `"=Sheet1!$A$2:$A$7"` in the same way it is represented in Excel. This is
+ * convenient when recreating a chart from an example in Excel but it is
+ * trickier to generate programmatically. For these cases you can set the
+ * `categories` and `values` to `NULL` and use the
+ * `chart_series_set_categories()` and `chart_series_set_values()` functions:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart, NULL, NULL);
+ *
+ *     // Configure the series using a syntax that is easier to define programmatically.
+ *     chart_series_set_categories(series, "Sheet1", 1, 0, 6, 0); // "=Sheet1!$A$2:$A$7"
+ *     chart_series_set_values(    series, "Sheet1", 1, 2, 6, 2); // "=Sheet1!$C$2:$C$7"
+ * @endcode
+ *
+ * As shown in the previous example the return value from
+ * `%chart_add_series()` is a lxw_chart_series pointer. This can be used in
+ * other functions that configure a series.
+ *
+ *
+ * More than one series can be added to a chart. The series numbering and
+ * order in the Excel chart will be the same as the order in which they are
+ * added in libxlsxwriter:
+ *
+ * @code
+ *    chart_add_series(chart, NULL, "Sheet1!$A$1:$A$5");
+ *    chart_add_series(chart, NULL, "Sheet1!$B$1:$B$5");
+ *    chart_add_series(chart, NULL, "Sheet1!$C$1:$C$5");
+ * @endcode
+ *
+ * It is also possible to specify non-contiguous ranges:
+ *
+ * @code
+ *    chart_add_series(
+ *        chart,
+ *        "=(Sheet1!$A$1:$A$9,Sheet1!$A$14:$A$25)",
+ *        "=(Sheet1!$B$1:$B$9,Sheet1!$B$14:$B$25)"
+ *    );
+ * @endcode
+ *
+ */
+lxw_chart_series *chart_add_series(lxw_chart *chart,
+                                   const char *categories,
+                                   const char *values);
+
+/**
+ * @brief Set a series "categories" range using row and column values.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param sheetname The name of the worksheet that contains the data range.
+ * @param first_row The first row of the range. (All zero indexed.)
+ * @param first_col The first column of the range.
+ * @param last_row  The last row of the range.
+ * @param last_col  The last col of the range.
+ *
+ * The `categories` and `values` of a chart data series are generally set
+ * using the `chart_add_series()` function and Excel range formulas like
+ * `"=Sheet1!$A$2:$A$7"`.
+ *
+ * The `%chart_series_set_categories()` function is an alternative method that
+ * is easier to generate programmatically. It requires that you set the
+ * `categories` and `values` parameters in `chart_add_series()`to `NULL` and
+ * then set them using row and column values in
+ * `chart_series_set_categories()` and `chart_series_set_values()`:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart, NULL, NULL);
+ *
+ *     // Configure the series ranges programmatically.
+ *     chart_series_set_categories(series, "Sheet1", 1, 0, 6, 0); // "=Sheet1!$A$2:$A$7"
+ *     chart_series_set_values(    series, "Sheet1", 1, 2, 6, 2); // "=Sheet1!$C$2:$C$7"
+ * @endcode
+ *
+ */
+void chart_series_set_categories(lxw_chart_series *series,
+                                 const char *sheetname, lxw_row_t first_row,
+                                 lxw_col_t first_col, lxw_row_t last_row,
+                                 lxw_col_t last_col);
+
+/**
+ * @brief Set a series "values" range using row and column values.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param sheetname The name of the worksheet that contains the data range.
+ * @param first_row The first row of the range. (All zero indexed.)
+ * @param first_col The first column of the range.
+ * @param last_row  The last row of the range.
+ * @param last_col  The last col of the range.
+ *
+ * The `categories` and `values` of a chart data series are generally set
+ * using the `chart_add_series()` function and Excel range formulas like
+ * `"=Sheet1!$A$2:$A$7"`.
+ *
+ * The `%chart_series_set_values()` function is an alternative method that is
+ * easier to generate programmatically. See the documentation for
+ * `chart_series_set_categories()` above.
+ */
+void chart_series_set_values(lxw_chart_series *series, const char *sheetname,
+                             lxw_row_t first_row, lxw_col_t first_col,
+                             lxw_row_t last_row, lxw_col_t last_col);
+
+/**
+ * @brief Set the name of a chart series range.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param name   The series name.
+ *
+ * The `%chart_series_set_name` function is used to set the name for a chart
+ * data series. The series name in Excel is displayed in the chart legend and
+ * in the formula bar. The name property is optional and if it isn't supplied
+ * it will default to `Series 1..n`.
+ *
+ * The function applies to a #lxw_chart_series object created using
+ * `chart_add_series()`:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart, NULL, "=Sheet1!$B$2:$B$7");
+ *
+ *     chart_series_set_name(series, "Quarterly budget data");
+ * @endcode
+ *
+ * The name parameter can also be a formula such as `=Sheet1!$A$1` to point to
+ * a cell in the workbook that contains the name:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart, NULL, "=Sheet1!$B$2:$B$7");
+ *
+ *     chart_series_set_name(series, "=Sheet1!$B1$1");
+ * @endcode
+ *
+ * See also the `chart_series_set_name_range()` function to see how to set the
+ * name formula programmatically.
+ */
+void chart_series_set_name(lxw_chart_series *series, const char *name);
+
+/**
+ * @brief Set a series name formula using row and column values.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param sheetname The name of the worksheet that contains the cell range.
+ * @param row       The zero indexed row number of the range.
+ * @param col       The zero indexed column number of the range.
+ *
+ * The `%chart_series_set_name_range()` function can be used to set a series
+ * name range and is an alternative to using `chart_series_set_name()` and a
+ * string formula:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart, NULL, "=Sheet1!$B$2:$B$7");
+ *
+ *     chart_series_set_name_range(series, "Sheet1", 0, 2); // "=Sheet1!$C$1"
+ * @endcode
+ */
+void chart_series_set_name_range(lxw_chart_series *series,
+                                 const char *sheetname, lxw_row_t row,
+                                 lxw_col_t col);
+/**
+ * @brief Set the line properties for a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param line   A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a chart series:
+ *
+ * @code
+ *     lxw_chart_line line = {.color = LXW_COLOR_RED};
+ *
+ *     chart_series_set_line(series1, &line);
+ *     chart_series_set_line(series2, &line);
+ *     chart_series_set_line(series3, &line);
+ * @endcode
+ *
+ * @image html chart_series_set_line.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_series_set_line(lxw_chart_series *series, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param fill   A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chart series:
+ *
+ * @code
+ *     lxw_chart_fill fill1 = {.color = LXW_COLOR_RED};
+ *     lxw_chart_fill fill2 = {.color = LXW_COLOR_YELLOW};
+ *     lxw_chart_fill fill3 = {.color = LXW_COLOR_GREEN};
+ *
+ *     chart_series_set_fill(series1, &fill1);
+ *     chart_series_set_fill(series2, &fill2);
+ *     chart_series_set_fill(series3, &fill3);
+ * @endcode
+ *
+ * @image html chart_series_set_fill.png
+ *
+ * For more information see @ref chart_fills.
+ */
+void chart_series_set_fill(lxw_chart_series *series, lxw_chart_fill *fill);
+
+/**
+ * @brief Invert the fill color for negative series values.
+ *
+ * @param series  A series object created via `chart_add_series()`.
+ *
+ * Invert the fill color for negative values. Usually only applicable to
+ * column and bar charts.
+ *
+ * @code
+ *     chart_series_set_invert_if_negative(series);
+ * @endcode
+ *
+ */
+void chart_series_set_invert_if_negative(lxw_chart_series *series);
+
+/**
+ * @brief Set the pattern properties for a chart series.
+ *
+ * @param series  A series object created via `chart_add_series()`.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart series:
+ *
+ * @code
+ *     lxw_chart_pattern pattern1 = {.type = LXW_CHART_PATTERN_SHINGLE,
+ *                                   .fg_color = 0x804000,
+ *                                   .bg_color = 0XC68C53};
+ *
+ *     lxw_chart_pattern pattern2 = {.type = LXW_CHART_PATTERN_HORIZONTAL_BRICK,
+ *                                   .fg_color = 0XB30000,
+ *                                   .bg_color = 0XFF6666};
+ *
+ *     chart_series_set_pattern(series1, &pattern1);
+ *     chart_series_set_pattern(series2, &pattern2);
+ *
+ * @endcode
+ *
+ * @image html chart_pattern.png
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_series_set_pattern(lxw_chart_series *series,
+                              lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the data marker type for a series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param type   The marker type, see #lxw_chart_marker_type.
+ *
+ * In Excel a chart marker is used to distinguish data points in a plotted
+ * series. In general only Line and Scatter and Radar chart types use
+ * markers. The libxlsxwriter chart types that can have markers are:
+ *
+ * - #LXW_CHART_LINE
+ * - #LXW_CHART_SCATTER
+ * - #LXW_CHART_SCATTER_STRAIGHT
+ * - #LXW_CHART_SCATTER_STRAIGHT_WITH_MARKERS
+ * - #LXW_CHART_SCATTER_SMOOTH
+ * - #LXW_CHART_SCATTER_SMOOTH_WITH_MARKERS
+ * - #LXW_CHART_RADAR
+ * - #LXW_CHART_RADAR_WITH_MARKERS
+ *
+ * The chart types with `MARKERS` in the name have markers with default colors
+ * and shapes turned on by default but it is possible using the various
+ * `chart_series_set_marker_xxx()` functions below to change these defaults. It
+ * is also possible to turn on an off markers.
+ *
+ * The `%chart_series_set_marker_type()` function is used to specify the
+ * type of the series marker:
+ *
+ * @code
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_DIAMOND);
+ * @endcode
+ *
+ * @image html chart_marker1.png
+ *
+ * The available marker types defined by #lxw_chart_marker_type are:
+ *
+ * - #LXW_CHART_MARKER_AUTOMATIC
+ * - #LXW_CHART_MARKER_NONE
+ * - #LXW_CHART_MARKER_SQUARE
+ * - #LXW_CHART_MARKER_DIAMOND
+ * - #LXW_CHART_MARKER_TRIANGLE
+ * - #LXW_CHART_MARKER_X
+ * - #LXW_CHART_MARKER_STAR
+ * - #LXW_CHART_MARKER_SHORT_DASH
+ * - #LXW_CHART_MARKER_LONG_DASH
+ * - #LXW_CHART_MARKER_CIRCLE
+ * - #LXW_CHART_MARKER_PLUS
+ *
+ * The `#LXW_CHART_MARKER_NONE` type can be used to turn off default markers:
+ *
+ * @code
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_NONE);
+ * @endcode
+ *
+ * @image html chart_series_set_marker_none.png
+ *
+ * The `#LXW_CHART_MARKER_AUTOMATIC` type is a special case which turns on a
+ * marker using the default marker style for the particular series. If
+ * automatic is on then other marker properties such as size, line or fill
+ * cannot be set.
+ */
+void chart_series_set_marker_type(lxw_chart_series *series, uint8_t type);
+
+/**
+ * @brief Set the size of a data marker for a series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param size   The size of the marker.
+ *
+ * The `%chart_series_set_marker_size()` function is used to specify the
+ * size of the series marker:
+ *
+ * @code
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_CIRCLE);
+ *     chart_series_set_marker_size(series, 10);
+ * @endcode
+ *
+ * @image html chart_series_set_marker_size.png
+ *
+ */
+void chart_series_set_marker_size(lxw_chart_series *series, uint8_t size);
+
+/**
+ * @brief Set the line properties for a chart series marker.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param line   A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a chart marker:
+ *
+ * @code
+ *     lxw_chart_line line = {.color = LXW_COLOR_BLACK};
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_series_set_marker_type(series, LXW_CHART_MARKER_SQUARE);
+ *     chart_series_set_marker_size(series, 8);
+ *
+ *     chart_series_set_marker_line(series, &line);
+ *     chart_series_set_marker_fill(series, &fill);
+ * @endcode
+ *
+ * @image html chart_marker2.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_series_set_marker_line(lxw_chart_series *series,
+                                  lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chart series marker.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param fill   A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chart marker:
+ *
+ * @code
+ *     chart_series_set_marker_fill(series, &fill);
+ * @endcode
+ *
+ * See the example and image above and also see @ref chart_fills.
+ */
+void chart_series_set_marker_fill(lxw_chart_series *series,
+                                  lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a chart series marker.
+ *
+ * @param series  A series object created via `chart_add_series()`.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart marker:
+ *
+ * @code
+ *     chart_series_set_marker_pattern(series, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_series_set_marker_pattern(lxw_chart_series *series,
+                                     lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the formatting for points in the series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param points An NULL terminated array of #lxw_chart_point pointers.
+ *
+ * @return A #lxw_error.
+ *
+ * In general formatting is applied to an entire series in a chart. However,
+ * it is occasionally required to format individual points in a series. In
+ * particular this is required for Pie/Doughnut charts where each segment is
+ * represented by a point.
+ *
+ * @dontinclude chart_pie_colors.c
+ * @skip Add the data series
+ * @until chart_series_set_points
+ *
+ * @image html chart_points1.png
+ *
+ * @note The array of #lxw_chart_point pointers should be NULL terminated
+ * as shown in the example.
+ *
+ * For more details see @ref chart_points
+ */
+lxw_error chart_series_set_points(lxw_chart_series *series,
+                                  lxw_chart_point *points[]);
+
+/**
+ * @brief Smooth a line or scatter chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param smooth Turn off/on the line smoothing. (0/1)
+ *
+ * The `chart_series_set_smooth()` function is used to set the smooth property
+ * of a line series. It is only applicable to the line and scatter chart
+ * types:
+ *
+ * @code
+ *     chart_series_set_smooth(series2, LXW_TRUE);
+ * @endcode
+ *
+ * @image html chart_smooth.png
+ *
+ *
+ */
+void chart_series_set_smooth(lxw_chart_series *series, uint8_t smooth);
+
+/**
+ * @brief Add data labels to a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels()` function is used to turn on data labels
+ * for a chart series. Data labels indicate the values of the plotted data
+ * points.
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ * @endcode
+ *
+ * @image html chart_labels1.png
+ *
+ * By default data labels are displayed in Excel with only the values shown:
+ *
+ * @image html chart_labels2.png
+ *
+ * However, it is possible to configure other display options, as shown
+ * in the functions below.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels(lxw_chart_series *series);
+
+/**
+ * @brief Set the display options for the labels of a data series.
+ *
+ * @param series        A series object created via `chart_add_series()`.
+ * @param show_name     Turn on/off the series name in the label caption.
+ * @param show_category Turn on/off the category name in the label caption.
+ * @param show_value    Turn on/off the value in the label caption.
+ *
+ * The `%chart_series_set_labels_options()` function is used to set the
+ * parameters that are displayed in the series data label:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ * @endcode
+ *
+ * @image html chart_labels3.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_options(lxw_chart_series *series,
+                                     uint8_t show_name, uint8_t show_category,
+                                     uint8_t show_value);
+
+/**
+ * @brief Set the separator for the data label captions.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param separator The separator for the data label options:
+ *                  #lxw_chart_label_separator.
+ *
+ * The `%chart_series_set_labels_separator()` function is used to change the
+ * separator between multiple data label items. The default options is a comma
+ * separator as shown in the previous example.
+ *
+ * The available options are:
+ *
+ * - #LXW_CHART_LABEL_SEPARATOR_SEMICOLON: semicolon separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_PERIOD: a period (dot) separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_NEWLINE: a newline separator.
+ * - #LXW_CHART_LABEL_SEPARATOR_SPACE: a space separator.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ *     chart_series_set_labels_separator(series, LXW_CHART_LABEL_SEPARATOR_NEWLINE);
+ * @endcode
+ *
+ * @image html chart_labels4.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_separator(lxw_chart_series *series,
+                                       uint8_t separator);
+
+/**
+ * @brief Set the data label position for a series.
+ *
+ * @param series   A series object created via `chart_add_series()`.
+ * @param position The data label position: #lxw_chart_label_position.
+ *
+ * The `%chart_series_set_labels_position()` function sets the position of
+ * the labels in the data series:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_position(series, LXW_CHART_LABEL_POSITION_ABOVE);
+ * @endcode
+ *
+ * @image html chart_labels5.png
+ *
+ * In Excel the allowable data label positions vary for different chart
+ * types. The allowable, and default, positions are:
+ *
+ * | Position                              | Line, Scatter | Bar, Column   | Pie, Doughnut | Area, Radar   |
+ * | :------------------------------------ | :------------ | :------------ | :------------ | :------------ |
+ * | #LXW_CHART_LABEL_POSITION_CENTER      | Yes           | Yes           | Yes           | Yes (default) |
+ * | #LXW_CHART_LABEL_POSITION_RIGHT       | Yes (default) |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_LEFT        | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_ABOVE       | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_BELOW       | Yes           |               |               |               |
+ * | #LXW_CHART_LABEL_POSITION_INSIDE_BASE |               | Yes           |               |               |
+ * | #LXW_CHART_LABEL_POSITION_INSIDE_END  |               | Yes           | Yes           |               |
+ * | #LXW_CHART_LABEL_POSITION_OUTSIDE_END |               | Yes (default) | Yes           |               |
+ * | #LXW_CHART_LABEL_POSITION_BEST_FIT    |               |               | Yes (default) |               |
+ *
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_position(lxw_chart_series *series,
+                                      uint8_t position);
+
+/**
+ * @brief Set leader lines for Pie and Doughnut charts.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_leader_line()` function  is used to turn on
+ * leader lines for the data label of a series. It is mainly used for pie
+ * or doughnut charts:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_leader_line(series);
+ * @endcode
+ *
+ * @note Even when leader lines are turned on they aren't automatically
+ *       visible in Excel or XlsxWriter. Due to an Excel limitation
+ *       (or design) leader lines only appear if the data label is moved
+ *       manually or if the data labels are very close and need to be
+ *       adjusted automatically.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_leader_line(lxw_chart_series *series);
+
+/**
+ * @brief Set the legend key for a data label in a chart series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_legend()` function is used to set the
+ * legend key for a data series:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_legend(series);
+ * @endcode
+ *
+ * @image html chart_labels6.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_legend(lxw_chart_series *series);
+
+/**
+ * @brief Set the percentage for a Pie/Doughnut data point.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_labels_percentage()` function is used to turn on
+ * the display of data labels as a percentage for a series. It is mainly
+ * used for pie charts:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_options(series, LXW_FALSE, LXW_FALSE, LXW_FALSE);
+ *     chart_series_set_labels_percentage(series);
+ * @endcode
+ *
+ * @image html chart_labels7.png
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_percentage(lxw_chart_series *series);
+
+/**
+ * @brief Set the number format for chart data labels in a series.
+ *
+ * @param series     A series object created via `chart_add_series()`.
+ * @param num_format The number format string.
+ *
+ * The `%chart_series_set_labels_num_format()` function is used to set the
+ * number format for data labels:
+ *
+ * @code
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_num_format(series, "$0.00");
+ * @endcode
+ *
+ * @image html chart_labels8.png
+ *
+ * The number format is similar to the Worksheet Cell Format num_format,
+ * see `format_set_num_format()`.
+ *
+ * For more information see @ref chart_labels.
+ */
+void chart_series_set_labels_num_format(lxw_chart_series *series,
+                                        char *num_format);
+
+/**
+ * @brief Set the font properties for chart data labels in a series
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param font   A pointer to a chart #lxw_chart_font font struct.
+ *
+ *
+ * The `%chart_series_set_labels_font()` function is used to set the font
+ * for data labels:
+ *
+ * @code
+ *     lxw_chart_font font = {.name = "Consolas", .color = LXW_COLOR_RED};
+ *
+ *     chart_series_set_labels(series);
+ *     chart_series_set_labels_font(series, &font);
+ * @endcode
+ *
+ * @image html chart_labels9.png
+ *
+ * For more information see @ref chart_fonts and @ref chart_labels.
+ *
+ */
+void chart_series_set_labels_font(lxw_chart_series *series,
+                                  lxw_chart_font *font);
+
+/**
+ * @brief Turn on a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param type   The type of trendline: #lxw_chart_trendline_type.
+ * @param value  The order/period value for polynomial and moving average
+ *               trendlines.
+ *
+ * A trendline can be added to a chart series to indicate trends in the data
+ * such as a moving average or a polynomial fit. The trendlines types are
+ * shown in the following Excel dialog:
+ *
+ * @image html chart_trendline0.png
+ *
+ * The `%chart_series_set_trendline()` function turns on these trendlines for
+ * a data series:
+ *
+ * @code
+ *     chart = workbook_add_chart(workbook, LXW_CHART_LINE);
+ *     series = chart_add_series(chart, NULL, "Sheet1!$A$1:$A$6");
+ *
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ * @endcode
+ *
+ * @image html chart_trendline2.png
+ *
+ * The `value` parameter corresponds to *order* for a polynomial trendline
+ * and *period* for a Moving Average trendline. It both cases it must be >= 2.
+ * The `value` parameter  is ignored for all other trendlines:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_AVERAGE, 2);
+ * @endcode
+ *
+ * @image html chart_trendline3.png
+ *
+ * The allowable values for the the trendline `type` are:
+ *
+ * - #LXW_CHART_TRENDLINE_TYPE_LINEAR: Linear trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_LOG: Logarithm trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_POLY: Polynomial trendline. The `value`
+ *   parameter corresponds to *order*.
+ * - #LXW_CHART_TRENDLINE_TYPE_POWER: Power trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_EXP: Exponential trendline.
+ * - #LXW_CHART_TRENDLINE_TYPE_AVERAGE: Moving Average trendline. The `value`
+ *   parameter corresponds to *period*.
+ *
+ * Other trendline options, such as those shown in the following Excel
+ * dialog, can be set using the functions below.
+ *
+ * @image html chart_trendline1.png
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline(lxw_chart_series *series, uint8_t type,
+                                uint8_t value);
+
+/**
+ * @brief Set the trendline forecast for a chart data series.
+ *
+ * @param series   A series object created via `chart_add_series()`.
+ * @param forward  The forward period.
+ * @param backward The backwards period.
+ *
+ * The `%chart_series_set_trendline_forecast()` function sets the forward
+ * and backward forecast periods for the trendline:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_forecast(series, 0.5, 0.5);
+ * @endcode
+ *
+ * @image html chart_trendline4.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_forecast(lxw_chart_series *series,
+                                         double forward, double backward);
+
+/**
+ * @brief Display the equation of a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_trendline_equation()` function displays the
+ * equation of the trendline on the chart:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_equation(series);
+ * @endcode
+ *
+ * @image html chart_trendline5.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_equation(lxw_chart_series *series);
+
+/**
+ * @brief Display the R squared value of a trendline for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ *
+ * The `%chart_series_set_trendline_r_squared()` function displays the
+ * R-squared value for the trendline on the chart:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_r_squared(series);
+ * @endcode
+ *
+ * @image html chart_trendline6.png
+ *
+ * @note This feature isn't available for Moving Average in Excel.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_r_squared(lxw_chart_series *series);
+
+/**
+ * @brief Set the trendline Y-axis intercept for a chart data series.
+ *
+ * @param series    A series object created via `chart_add_series()`.
+ * @param intercept Y-axis intercept value.
+ *
+ * The `%chart_series_set_trendline_intercept()` function sets the Y-axis
+ * intercept for the trendline:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_equation(series);
+ *     chart_series_set_trendline_intercept(series, 0.8);
+ * @endcode
+ *
+ * @image html chart_trendline7.png
+ *
+ * As can be seen from the equation on the chart the intercept point
+ * (when X=0) is the same as the value set in the equation.
+ *
+ * @note The intercept feature is only available in Excel for Exponential,
+ *       Linear and Polynomial trendline types.
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_intercept(lxw_chart_series *series,
+                                          double intercept);
+
+/**
+ * @brief Set the trendline name for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param name   The name of the trendline to display in the legend.
+ *
+ * The `%chart_series_set_trendline_name()` function sets the name of the
+ * trendline that is displayed in the chart legend. In the examples above
+ * the trendlines are displayed with default names like "Linear (Series 1)"
+ * and "2 per Mov. Avg. (Series 1)". If these names are too verbose or not
+ * descriptive enough you can set your own trendline name:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_name(series, "My trendline");
+ * @endcode
+ *
+ * @image html chart_trendline8.png
+ *
+ * It is often preferable to turn off the trendline caption in the legend.
+ * This is down in Excel by deleting the trendline name from the legend.
+ * In libxlsxwriter this is done using the `chart_legend_delete_series()`
+ * function to delete the zero based series numbers:
+ *
+ * @code
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *
+ *     // Delete the series name for the second series (=1 in zero base).
+ *     // The -1 value indicates the end of the array of values.
+ *     int16_t names[] = {1, -1};
+ *     chart_legend_delete_series(chart, names);
+ * @endcode
+ *
+ * @image html chart_trendline9.png
+ *
+ * For more information see @ref chart_trendlines.
+ */
+void chart_series_set_trendline_name(lxw_chart_series *series, char *name);
+
+/**
+ * @brief Set the trendline line properties for a chart data series.
+ *
+ * @param series A series object created via `chart_add_series()`.
+ * @param line   A #lxw_chart_line struct.
+ *
+ * The `%chart_series_set_trendline_line()` function is used to set the line
+ * properties of a trendline:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_LONG_DASH};
+ *
+ *     chart_series_set_trendline(series, LXW_CHART_TRENDLINE_TYPE_LINEAR, 0);
+ *     chart_series_set_trendline_line(series, &line);
+ * @endcode
+ *
+ * @image html chart_trendline10.png
+ *
+ * For more information see @ref chart_trendlines and @ref chart_lines.
+ */
+void chart_series_set_trendline_line(lxw_chart_series *series,
+                                     lxw_chart_line *line);
+
+/**
+ * Set the X or Y error bars for a chart series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param type       The type of error bar: #lxw_chart_error_bar_type.
+ * @param value      The error value.
+ *
+ * Error bars can be added to a chart series to indicate error bounds in the
+ * data. The error bars can be vertical `y_error_bars` (the most common type)
+ * or horizontal `x_error_bars` (for Bar and Scatter charts only).
+ *
+ * @image html chart_error_bars0.png
+ *
+ * The `%chart_series_set_error_bars()` function sets the error bar type
+ * and value associated with the type:
+ *
+ * @code
+ *     lxw_chart_series *series = chart_add_series(chart,
+ *                                                 "=Sheet1!$A$1:$A$5",
+ *                                                 "=Sheet1!$B$1:$B$5");
+ *
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ * @endcode
+ *
+ * @image html chart_error_bars1.png
+ *
+ * The error bar types that be used are:
+ *
+ * - #LXW_CHART_ERROR_BAR_TYPE_STD_ERROR: Standard error.
+ * - #LXW_CHART_ERROR_BAR_TYPE_FIXED: Fixed value.
+ * - #LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE: Percentage.
+ * - #LXW_CHART_ERROR_BAR_TYPE_STD_DEV: Standard deviation(s).
+ *
+ * @note Custom error bars are not currently supported.
+ *
+ * All error bar types, apart from Standard error, should have a valid
+ * value to set the error range:
+ *
+ * @code
+ *     chart_series_set_error_bars(series1->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_FIXED, 2);
+ *
+ *     chart_series_set_error_bars(series2->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_PERCENTAGE, 5);
+ *
+ *     chart_series_set_error_bars(series3->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_DEV, 1);
+ * @endcode
+ *
+ * For the Standard error type the value is ignored.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars(lxw_series_error_bars *error_bars,
+                                 uint8_t type, double value);
+
+/**
+ * @brief Set the direction (up, down or both) of the error bars for a chart
+ *        series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param direction  The bar direction: #lxw_chart_error_bar_direction .
+ *
+ * The `%chart_series_set_error_bars_direction()` function sets the
+ * direction of the error bars:
+ *
+ * @code
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_direction(series->y_error_bars,
+ *                                           LXW_CHART_ERROR_BAR_DIR_PLUS);
+ * @endcode
+ *
+ * @image html chart_error_bars2.png
+ *
+ * The valid directions are:
+ *
+ * - #LXW_CHART_ERROR_BAR_DIR_BOTH: Error bar extends in both directions.
+ *   The default.
+ * - #LXW_CHART_ERROR_BAR_DIR_PLUS: Error bar extends in positive direction.
+ * - #LXW_CHART_ERROR_BAR_DIR_MINUS: Error bar extends in negative direction.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_direction(lxw_series_error_bars *error_bars,
+                                           uint8_t direction);
+
+/**
+ * @brief Set the end cap type for the error bars of a chart series.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param endcap     The error bar end cap type: #lxw_chart_error_bar_cap .
+ *
+ * The `%chart_series_set_error_bars_endcap()` function sets the end cap
+ * type for the error bars:
+ *
+ * @code
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_endcap(series->y_error_bars,
+                                          LXW_CHART_ERROR_BAR_NO_CAP);
+ * @endcode
+ *
+ * @image html chart_error_bars3.png
+ *
+ * The valid values are:
+ *
+ * - #LXW_CHART_ERROR_BAR_END_CAP: Flat end cap. The default.
+ * - #LXW_CHART_ERROR_BAR_NO_CAP: No end cap.
+ *
+ * For more information see @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_endcap(lxw_series_error_bars *error_bars,
+                                        uint8_t endcap);
+
+/**
+ * @brief Set the line properties for a chart series error bars.
+ *
+ * @param error_bars A pointer to the series X or Y error bars.
+ * @param line       A #lxw_chart_line struct.
+ *
+ * The `%chart_series_set_error_bars_line()` function sets the line
+ * properties for the error bars:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_ROUND_DOT};
+ *
+ *     chart_series_set_error_bars(series->y_error_bars,
+ *                                 LXW_CHART_ERROR_BAR_TYPE_STD_ERROR, 0);
+ *
+ *     chart_series_set_error_bars_line(series->y_error_bars, &line);
+ * @endcode
+ *
+ * @image html chart_error_bars4.png
+ *
+ * For more information see @ref chart_lines and @ref chart_error_bars.
+ */
+void chart_series_set_error_bars_line(lxw_series_error_bars *error_bars,
+                                      lxw_chart_line *line);
+
+/**
+ * @brief Set the name caption of the an axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param name The name caption of the axis.
+ *
+ * The `%chart_axis_set_name()` function sets the name (also known as title or
+ * caption) for an axis. It can be used for the X or Y axes. The name is
+ * displayed below an X axis and to the side of a Y axis.
+ *
+ * @code
+ *     chart_axis_set_name(chart->x_axis, "Earnings per Quarter");
+ *     chart_axis_set_name(chart->y_axis, "US Dollars (Millions)");
+ * @endcode
+ *
+ * @image html chart_axis_set_name.png
+ *
+ * The name parameter can also be a formula such as `=Sheet1!$A$1` to point to
+ * a cell in the workbook that contains the name:
+ *
+ * @code
+ *     chart_axis_set_name(chart->x_axis, "=Sheet1!$B1$1");
+ * @endcode
+ *
+ * See also the `chart_axis_set_name_range()` function to see how to set the
+ * name formula programmatically.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name(lxw_chart_axis *axis, const char *name);
+
+/**
+ * @brief Set a chart axis name formula using row and column values.
+ *
+ * @param axis      A pointer to a chart #lxw_chart_axis object.
+ * @param sheetname The name of the worksheet that contains the cell range.
+ * @param row       The zero indexed row number of the range.
+ * @param col       The zero indexed column number of the range.
+ *
+ * The `%chart_axis_set_name_range()` function can be used to set an axis name
+ * range and is an alternative to using `chart_axis_set_name()` and a string
+ * formula:
+ *
+ * @code
+ *     chart_axis_set_name_range(chart->x_axis, "Sheet1", 1, 0);
+ *     chart_axis_set_name_range(chart->y_axis, "Sheet1", 2, 0);
+ * @endcode
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name_range(lxw_chart_axis *axis, const char *sheetname,
+                               lxw_row_t row, lxw_col_t col);
+
+/**
+ * @brief Set the font properties for a chart axis name.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param font A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_axis_set_name_font()` function is used to set the font of an
+ * axis name:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_axis_set_name(chart->x_axis, "Yearly data");
+ *     chart_axis_set_name_font(chart->x_axis, &font);
+ * @endcode
+ *
+ * @image html chart_axis_set_name_font.png
+ *
+ * For more information see @ref chart_fonts.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_name_font(lxw_chart_axis *axis, lxw_chart_font *font);
+
+/**
+ * @brief Set the font properties for the numbers of a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param font A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_axis_set_num_font()` function is used to set the font of the
+ * numbers on an axis:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_axis_set_num_font(chart->x_axis, &font1);
+ * @endcode
+ *
+ * @image html chart_axis_set_num_font.png
+ *
+ * For more information see @ref chart_fonts.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_num_font(lxw_chart_axis *axis, lxw_chart_font *font);
+
+/**
+ * @brief Set the number format for a chart axis.
+ *
+ * @param axis       A pointer to a chart #lxw_chart_axis object.
+ * @param num_format The number format string.
+ *
+ * The `%chart_axis_set_num_format()` function is used to set the format of
+ * the numbers on an axis:
+ *
+ * @code
+ *     chart_axis_set_num_format(chart->x_axis, "0.00%");
+ *     chart_axis_set_num_format(chart->y_axis, "$#,##0.00");
+ * @endcode
+ *
+ * The number format is similar to the Worksheet Cell Format num_format,
+ * see `format_set_num_format()`.
+ *
+ * @image html chart_axis_num_format.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_num_format(lxw_chart_axis *axis, char *num_format);
+
+/**
+ * @brief Set the line properties for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param line A #lxw_chart_line struct.
+ *
+ * Set the line properties of a chart axis:
+ *
+ * @code
+ *     // Hide the Y axis.
+ *     lxw_chart_line line = {.none = LXW_TRUE};
+ *
+ *     chart_axis_set_line(chart->y_axis, &line);
+ * @endcode
+ *
+ * @image html chart_axis_set_line.png
+ *
+ * For more information see @ref chart_lines.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_line(lxw_chart_axis *axis, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param fill A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chart axis:
+ *
+ * @code
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_YELLOW};
+ *
+ *     chart_axis_set_fill(chart->y_axis, &fill);
+ * @endcode
+ *
+ * @image html chart_axis_set_fill.png
+ *
+ * For more information see @ref chart_fills.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_fill(lxw_chart_axis *axis, lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a chart axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chart axis:
+ *
+ * @code
+ *     chart_axis_set_pattern(chart->y_axis, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_pattern(lxw_chart_axis *axis, lxw_chart_pattern *pattern);
+
+/**
+ * @brief Reverse the order of the axis categories or values.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ *
+ * Reverse the order of the axis categories or values:
+ *
+ * @code
+ *     chart_axis_set_reverse(chart->x_axis);
+ * @endcode
+ *
+ * @image html chart_reverse.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_reverse(lxw_chart_axis *axis);
+
+/**
+ * @brief Set the position that the axis will cross the opposite axis.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ * @param value The category or value that the axis crosses at.
+ *
+ * Set the position that the axis will cross the opposite axis:
+ *
+ * @code
+ *     chart_axis_set_crossing(chart->x_axis, 3);
+ *     chart_axis_set_crossing(chart->y_axis, 8);
+ * @endcode
+ *
+ * @image html chart_crossing1.png
+ *
+ * If crossing is omitted (the default) the crossing will be set automatically
+ * by Excel based on the chart data.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_crossing(lxw_chart_axis *axis, double value);
+
+/**
+ * @brief Set the opposite axis crossing position as the axis maximum.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ *
+ * Set the position that the opposite axis will cross as the axis maximum.
+ * The default axis crossing position is generally the axis minimum so this
+ * function can be used to reverse the location of the axes without reversing
+ * the number sequence:
+ *
+ * @code
+ *     chart_axis_set_crossing_max(chart->x_axis);
+ *     chart_axis_set_crossing_max(chart->y_axis);
+ * @endcode
+ *
+ * @image html chart_crossing2.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_crossing_max(lxw_chart_axis *axis);
+
+/**
+ * @brief Turn off/hide an axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ *
+ * Turn off, hide, a chart axis:
+ *
+ * @code
+ *     chart_axis_off(chart->x_axis);
+ * @endcode
+ *
+ * @image html chart_axis_off.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_off(lxw_chart_axis *axis);
+
+/**
+ * @brief Position a category axis on or between the axis tick marks.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param position A #lxw_chart_axis_tick_position value.
+ *
+ * Position a category axis horizontally on, or between, the axis tick marks.
+ *
+ * There are two allowable values:
+ *
+ * - #LXW_CHART_AXIS_POSITION_ON_TICK
+ * - #LXW_CHART_AXIS_POSITION_BETWEEN
+ *
+ * @code
+ *     chart_axis_set_position(chart->x_axis, LXW_CHART_AXIS_POSITION_BETWEEN);
+ * @endcode
+ *
+ * @image html chart_axis_set_position.png
+ *
+ * **Axis types**: This function is applicable to category axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_position(lxw_chart_axis *axis, uint8_t position);
+
+/**
+ * @brief Position the axis labels.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param position A #lxw_chart_axis_label_position value.
+ *
+ * Position the axis labels for the chart. The labels are the numbers, or
+ * strings or dates, on the axis that indicate the categories or values of
+ * the axis.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_axis_set_label_position(chart->x_axis, LXW_CHART_AXIS_LABEL_POSITION_HIGH);
+       chart_axis_set_label_position(chart->y_axis, LXW_CHART_AXIS_LABEL_POSITION_HIGH);
+ * @endcode
+ *
+ * @image html chart_label_position2.png
+ *
+ * The allowable values:
+ *
+ * - #LXW_CHART_AXIS_LABEL_POSITION_NEXT_TO - The default.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_HIGH - Also right for vertical axes.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_LOW - Also left for vertical axes.
+ * - #LXW_CHART_AXIS_LABEL_POSITION_NONE
+ *
+ * @image html chart_label_position1.png
+ *
+ * The #LXW_CHART_AXIS_LABEL_POSITION_NONE turns off the axis labels. This
+ * is slightly different from `chart_axis_off()` which also turns off the
+ * labels but also turns off tick marks.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_label_position(lxw_chart_axis *axis, uint8_t position);
+
+/**
+ * @brief Set the minimum value for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param min  Minimum value for chart axis. Value axes only.
+ *
+ * Set the minimum value for the axis range.
+ *
+ * @code
+ *     chart_axis_set_min(chart->y_axis, -4);
+ *     chart_axis_set_max(chart->y_axis, 21);
+ * @endcode
+ *
+ * @image html chart_max_min.png
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_min(lxw_chart_axis *axis, double min);
+
+/**
+ * @brief Set the maximum value for a chart axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param max  Maximum value for chart axis. Value axes only.
+ *
+ * Set the maximum value for the axis range.
+ *
+ * @code
+ *     chart_axis_set_min(chart->y_axis, -4);
+ *     chart_axis_set_max(chart->y_axis, 21);
+ * @endcode
+ *
+ * See the above image.
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_max(lxw_chart_axis *axis, double max);
+
+/**
+ * @brief Set the log base of the axis range.
+ *
+ * @param axis     A pointer to a chart #lxw_chart_axis object.
+ * @param log_base The log base for value axis. Value axes only.
+ *
+ * Set the log base for the axis:
+ *
+ * @code
+ *     chart_axis_set_log_base(chart->y_axis, 10);
+ * @endcode
+ *
+ * @image html chart_log_base.png
+ *
+ * The allowable range of values for the log base in Excel is between 2 and
+ * 1000.
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_log_base(lxw_chart_axis *axis, uint16_t log_base);
+
+/**
+ * @brief Set the major axis tick mark type.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param type The tick mark type, defined by #lxw_chart_tick_mark.
+ *
+ * Set the type of the major axis tick mark:
+ *
+ * @code
+ *     chart_axis_set_major_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_CROSSING);
+ *     chart_axis_set_minor_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ *
+ *     chart_axis_set_major_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_OUTSIDE);
+ *     chart_axis_set_minor_tick_mark(chart->y_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ *
+ *     // Hide the default gridlines so the tick marks are visible.
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_FALSE);
+ * @endcode
+ *
+ * @image html chart_tick_marks.png
+ *
+ * The tick mark types are:
+ *
+ * - #LXW_CHART_AXIS_TICK_MARK_NONE
+ * - #LXW_CHART_AXIS_TICK_MARK_INSIDE
+ * - #LXW_CHART_AXIS_TICK_MARK_OUTSIDE
+ * - #LXW_CHART_AXIS_TICK_MARK_CROSSING
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_major_tick_mark(lxw_chart_axis *axis, uint8_t type);
+
+/**
+ * @brief Set the minor axis tick mark type.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param type The tick mark type, defined by #lxw_chart_tick_mark.
+ *
+ * Set the type of the minor axis tick mark:
+ *
+ * @code
+ *     chart_axis_set_minor_tick_mark(chart->x_axis, LXW_CHART_AXIS_TICK_MARK_INSIDE);
+ * @endcode
+ *
+ * See the image and example above.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_minor_tick_mark(lxw_chart_axis *axis, uint8_t type);
+
+/**
+ * @brief Set the interval between category values.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The interval between the categories.
+ *
+ * Set the interval between the category values. The default interval is 1
+ * which gives the intervals shown in the charts above:
+ *
+ *     1, 2, 3, 4, 5, etc.
+ *
+ * Setting it to 2 gives:
+ *
+ *     1, 3, 5, 7, etc.
+ *
+ * For example:
+ *
+ * @code
+ *     chart_axis_set_interval_unit(chart->x_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_interval1.png
+ *
+ * **Axis types**: This function is applicable to category and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_interval_unit(lxw_chart_axis *axis, uint16_t unit);
+
+/**
+ * @brief Set the interval between category tick marks.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The interval between the category ticks.
+ *
+ * Set the interval between the category tick marks. The default interval is 1
+ * between each category but it can be set to other integer values:
+ *
+ * @code
+ *     chart_axis_set_interval_tick(chart->x_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_interval2.png
+ *
+ * **Axis types**: This function is applicable to category and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_interval_tick(lxw_chart_axis *axis, uint16_t unit);
+
+/**
+ * @brief Set the increment of the major units in the axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The increment of the major units.
+ *
+ * Set the increment of the major units in the axis range.
+ *
+ * @code
+ *     // Turn on the minor gridline (it is off by default).
+ *     chart_axis_minor_gridlines_set_visible(chart->y_axis, LXW_TRUE);
+ *
+ *     chart_axis_set_major_unit(chart->y_axis, 4);
+ *     chart_axis_set_minor_unit(chart->y_axis, 2);
+ * @endcode
+ *
+ * @image html chart_set_major_units.png
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_major_unit(lxw_chart_axis *axis, double unit);
+
+/**
+ * @brief Set the increment of the minor units in the axis.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param unit The increment of the minor units.
+ *
+ * Set the increment of the minor units in the axis range.
+ *
+ * @code
+ *     chart_axis_set_minor_unit(chart->y_axis, 2);
+ * @endcode
+ *
+ * See the image above
+ *
+ * **Axis types**: This function is applicable to value and date axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_minor_unit(lxw_chart_axis *axis, double unit);
+
+/**
+ * @brief Set the display units for a value axis.
+ *
+ * @param axis  A pointer to a chart #lxw_chart_axis object.
+ * @param units The display units: #lxw_chart_axis_display_unit.
+ *
+ * Set the display units for the axis. This can be useful if the axis numbers
+ * are very large but you don't want to represent them in scientific notation:
+ *
+ * @code
+ *     chart_axis_set_display_units(chart->x_axis, LXW_CHART_AXIS_UNITS_THOUSANDS);
+ *     chart_axis_set_display_units(chart->y_axis, LXW_CHART_AXIS_UNITS_MILLIONS);
+ * @endcode
+ *
+ * @image html chart_display_units.png
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_display_units(lxw_chart_axis *axis, uint8_t units);
+
+/**
+ * @brief Turn on/off the display units for a value axis.
+
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the display units. (0/1)
+ *
+ * Turn on or off the display units for the axis. This option is set on
+ * automatically by `chart_axis_set_display_units()`.
+ *
+ * @code
+ *     chart_axis_set_display_units_visible(chart->y_axis, LXW_TRUE);
+ * @endcode
+ *
+ * **Axis types**: This function is applicable to value axes only.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_set_display_units_visible(lxw_chart_axis *axis,
+                                          uint8_t visible);
+
+/**
+ * @brief Turn on/off the major gridlines for an axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the major gridline. (0/1)
+ *
+ * Turn on or off the major gridlines for an X or Y axis. In most Excel charts
+ * the Y axis major gridlines are on by default and the X axis major
+ * gridlines are off by default.
+ *
+ * Example:
+ *
+ * @code
+ *     // Reverse the normal visible/hidden gridlines for a column chart.
+ *     chart_axis_major_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_FALSE);
+ * @endcode
+ *
+ * @image html chart_gridline1.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_major_gridlines_set_visible(lxw_chart_axis *axis,
+                                            uint8_t visible);
+
+/**
+ * @brief Turn on/off the minor gridlines for an axis.
+ *
+ * @param axis    A pointer to a chart #lxw_chart_axis object.
+ * @param visible Turn off/on the minor gridline. (0/1)
+ *
+ * Turn on or off the minor gridlines for an X or Y axis. In most Excel charts
+ * the X and Y axis minor gridlines are off by default.
+ *
+ * Example, turn on all major and minor gridlines:
+ *
+ * @code
+ *     chart_axis_major_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_minor_gridlines_set_visible(chart->x_axis, LXW_TRUE);
+ *     chart_axis_major_gridlines_set_visible(chart->y_axis, LXW_TRUE);
+ *     chart_axis_minor_gridlines_set_visible(chart->y_axis, LXW_TRUE);
+ * @endcode
+ *
+ * @image html chart_gridline2.png
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_minor_gridlines_set_visible(lxw_chart_axis *axis,
+                                            uint8_t visible);
+
+/**
+ * @brief Set the line properties for the chart axis major gridlines.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param line A #lxw_chart_line struct.
+ *
+ * Format the line properties of the major gridlines of a chart:
+ *
+ * @code
+ *     lxw_chart_line line1 = {.color = LXW_COLOR_RED,
+ *                             .width = 0.5,
+ *                             .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
+ *
+ *     lxw_chart_line line2 = {.color = LXW_COLOR_YELLOW};
+ *
+ *     lxw_chart_line line3 = {.width = 1.25,
+ *                             .dash_type = LXW_CHART_LINE_DASH_DASH};
+ *
+ *     lxw_chart_line line4 = {.color =  0x00B050};
+ *
+ *     chart_axis_major_gridlines_set_line(chart->x_axis, &line1);
+ *     chart_axis_minor_gridlines_set_line(chart->x_axis, &line2);
+ *     chart_axis_major_gridlines_set_line(chart->y_axis, &line3);
+ *     chart_axis_minor_gridlines_set_line(chart->y_axis, &line4);
+ * @endcode
+ *
+ * @image html chart_gridline3.png
+ *
+ * For more information see @ref chart_lines.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_major_gridlines_set_line(lxw_chart_axis *axis,
+                                         lxw_chart_line *line);
+
+/**
+ * @brief Set the line properties for the chart axis minor gridlines.
+ *
+ * @param axis A pointer to a chart #lxw_chart_axis object.
+ * @param line A #lxw_chart_line struct.
+ *
+ * Format the line properties of the minor gridlines of a chart, see the
+ * example above.
+ *
+ * For more information see @ref chart_lines.
+ *
+ * **Axis types**: This function is applicable to to all axes types.
+ *                 See @ref ww_charts_axes.
+ */
+void chart_axis_minor_gridlines_set_line(lxw_chart_axis *axis,
+                                         lxw_chart_line *line);
+
+/**
+ * @brief Set the title of the chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param name  The chart title name.
+ *
+ * The `%chart_title_set_name()` function sets the name (title) for the
+ * chart. The name is displayed above the chart.
+ *
+ * @code
+ *     chart_title_set_name(chart, "Year End Results");
+ * @endcode
+ *
+ * @image html chart_title_set_name.png
+ *
+ * The name parameter can also be a formula such as `=Sheet1!$A$1` to point to
+ * a cell in the workbook that contains the name:
+ *
+ * @code
+ *     chart_title_set_name(chart, "=Sheet1!$B1$1");
+ * @endcode
+ *
+ * See also the `chart_title_set_name_range()` function to see how to set the
+ * name formula programmatically.
+ *
+ * The Excel default is to have no chart title.
+ */
+void chart_title_set_name(lxw_chart *chart, const char *name);
+
+/**
+ * @brief Set a chart title formula using row and column values.
+ *
+ * @param chart     Pointer to a lxw_chart instance to be configured.
+ * @param sheetname The name of the worksheet that contains the cell range.
+ * @param row       The zero indexed row number of the range.
+ * @param col       The zero indexed column number of the range.
+ *
+ * The `%chart_title_set_name_range()` function can be used to set a chart
+ * title range and is an alternative to using `chart_title_set_name()` and a
+ * string formula:
+ *
+ * @code
+ *     chart_title_set_name_range(chart, "Sheet1", 1, 0);
+ * @endcode
+ */
+void chart_title_set_name_range(lxw_chart *chart, const char *sheetname,
+                                lxw_row_t row, lxw_col_t col);
+
+/**
+ * @brief  Set the font properties for a chart title.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param font  A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_title_set_name_font()` function is used to set the font of a
+ * chart title:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_title_set_name(chart, "Year End Results");
+ *     chart_title_set_name_font(chart, &font);
+ * @endcode
+ *
+ * @image html chart_title_set_name_font.png
+ *
+ * For more information see @ref chart_fonts.
+ */
+void chart_title_set_name_font(lxw_chart *chart, lxw_chart_font *font);
+
+/**
+ * @brief Turn off an automatic chart title.
+ *
+ * @param chart  Pointer to a lxw_chart instance to be configured.
+ *
+ * In general in Excel a chart title isn't displayed unless the user
+ * explicitly adds one. However, Excel adds an automatic chart title to charts
+ * with a single series and a user defined series name. The
+ * `chart_title_off()` function allows you to turn off this automatic chart
+ * title:
+ *
+ * @code
+ *     chart_title_off(chart);
+ * @endcode
+ */
+void chart_title_off(lxw_chart *chart);
+
+/**
+ * @brief Set the position of the chart legend.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param position The #lxw_chart_legend_position value for the legend.
+ *
+ * The `%chart_legend_set_position()` function is used to set the chart
+ * legend to one of the #lxw_chart_legend_position values:
+ *
+ *     LXW_CHART_LEGEND_NONE
+ *     LXW_CHART_LEGEND_RIGHT
+ *     LXW_CHART_LEGEND_LEFT
+ *     LXW_CHART_LEGEND_TOP
+ *     LXW_CHART_LEGEND_BOTTOM
+ *     LXW_CHART_LEGEND_OVERLAY_RIGHT
+ *     LXW_CHART_LEGEND_OVERLAY_LEFT
+ *
+ * For example:
+ *
+ * @code
+ *     chart_legend_set_position(chart, LXW_CHART_LEGEND_BOTTOM);
+ * @endcode
+ *
+ * @image html chart_legend_bottom.png
+ *
+ * This function can also be used to turn off a chart legend:
+ *
+ * @code
+ *     chart_legend_set_position(chart, LXW_CHART_LEGEND_NONE);
+ * @endcode
+ *
+ * @image html chart_legend_none.png
+ *
+ */
+void chart_legend_set_position(lxw_chart *chart, uint8_t position);
+
+/**
+ * @brief Set the font properties for a chart legend.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param font  A pointer to a chart #lxw_chart_font font struct.
+ *
+ * The `%chart_legend_set_font()` function is used to set the font of a
+ * chart legend:
+ *
+ * @code
+ *     lxw_chart_font font = {.bold = LXW_TRUE, .color = LXW_COLOR_BLUE};
+ *
+ *     chart_legend_set_font(chart, &font);
+ * @endcode
+ *
+ * @image html chart_legend_set_font.png
+ *
+ * For more information see @ref chart_fonts.
+ */
+void chart_legend_set_font(lxw_chart *chart, lxw_chart_font *font);
+
+/**
+ * @brief Remove one or more series from the the legend.
+ *
+ * @param chart         Pointer to a lxw_chart instance to be configured.
+ * @param delete_series An array of zero-indexed values to delete from series.
+ *
+ * @return A #lxw_error.
+ *
+ * The `%chart_legend_delete_series()` function allows you to remove/hide one
+ * or more series in a chart legend (the series will still display on the chart).
+ *
+ * This function takes an array of one or more zero indexed series
+ * numbers. The array should be terminated with -1.
+ *
+ * For example to remove the first and third zero-indexed series from the
+ * legend of a chart with 3 series:
+ *
+ * @code
+ *     int16_t series[] = {0, 2, -1};
+ *
+ *     chart_legend_delete_series(chart, series);
+ * @endcode
+ *
+ * @image html chart_legend_delete.png
+ */
+lxw_error chart_legend_delete_series(lxw_chart *chart,
+                                     int16_t delete_series[]);
+
+/**
+ * @brief Set the line properties for a chartarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a chartarea. In Excel the chartarea
+ * is the background area behind the chart:
+ *
+ * @code
+ *     lxw_chart_line line = {.none  = LXW_TRUE};
+ *     lxw_chart_fill fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_chartarea_set_line(chart, &line);
+ *     chart_chartarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * @image html chart_chartarea.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_chartarea_set_line(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a chartarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param fill  A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a chartarea:
+ *
+ * @code
+ *     chart_chartarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * See the example and image above.
+ *
+ * For more information see @ref chart_fills.
+ */
+void chart_chartarea_set_fill(lxw_chart *chart, lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a chartarea.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a chartarea:
+ *
+ * @code
+ *     chart_chartarea_set_pattern(series1, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_chartarea_set_pattern(lxw_chart *chart,
+                                 lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the line properties for a plotarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * Set the line/border properties of a plotarea. In Excel the plotarea is
+ * the area between the axes on which the chart series are plotted:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .width     = 2,
+ *                            .dash_type = LXW_CHART_LINE_DASH_DASH};
+ *     lxw_chart_fill fill = {.color     = 0xFFFFC2};
+ *
+ *     chart_plotarea_set_line(chart, &line);
+ *     chart_plotarea_set_fill(chart, &fill);
+ *
+ * @endcode
+ *
+ * @image html chart_plotarea.png
+ *
+ * For more information see @ref chart_lines.
+ */
+void chart_plotarea_set_line(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the fill properties for a plotarea.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param fill  A #lxw_chart_fill struct.
+ *
+ * Set the fill properties of a plotarea:
+ *
+ * @code
+ *     chart_plotarea_set_fill(chart, &fill);
+ * @endcode
+ *
+ * See the example and image above.
+ *
+ * For more information see @ref chart_fills.
+ */
+void chart_plotarea_set_fill(lxw_chart *chart, lxw_chart_fill *fill);
+
+/**
+ * @brief Set the pattern properties for a plotarea.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param pattern A #lxw_chart_pattern struct.
+ *
+ * Set the pattern properties of a plotarea:
+ *
+ * @code
+ *     chart_plotarea_set_pattern(series1, &pattern);
+ * @endcode
+ *
+ * For more information see #lxw_chart_pattern_type and @ref chart_patterns.
+ */
+void chart_plotarea_set_pattern(lxw_chart *chart, lxw_chart_pattern *pattern);
+
+/**
+ * @brief Set the chart style type.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param style_id An index representing the chart style, 1 - 48.
+ *
+ * The `%chart_set_style()` function is used to set the style of the chart to
+ * one of the 48 built-in styles available on the "Design" tab in Excel 2007:
+ *
+ * @code
+ *     chart_set_style(chart, 37)
+ * @endcode
+ *
+ * @image html chart_style.png
+ *
+ * The style index number is counted from 1 on the top left in the Excel
+ * dialog. The default style is 2.
+ *
+ * **Note:**
+ *
+ * In Excel 2013 the Styles section of the "Design" tab in Excel shows what
+ * were referred to as "Layouts" in previous versions of Excel. These layouts
+ * are not defined in the file format. They are a collection of modifications
+ * to the base chart type. They can not be defined by the `chart_set_style()``
+ * function.
+ *
+ */
+void chart_set_style(lxw_chart *chart, uint8_t style_id);
+
+/**
+ * @brief Turn on a data table below the horizontal axis.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * The `%chart_set_table()` function adds a data table below the horizontal
+ * axis with the data used to plot the chart:
+ *
+ * @code
+ *     // Turn on the data table with default options.
+ *     chart_set_table(chart);
+ * @endcode
+ *
+ * @image html chart_data_table1.png
+ *
+ * The data table can only be shown with Bar, Column, Line and Area charts.
+ *
+ */
+void chart_set_table(lxw_chart *chart);
+
+/**
+ * @brief Turn on/off grid options for a chart data table.
+ *
+ * @param chart       Pointer to a lxw_chart instance to be configured.
+ * @param horizontal  Turn on/off the horizontal grid lines in the table.
+ * @param vertical    Turn on/off the vertical grid lines in the table.
+ * @param outline     Turn on/off the outline lines in the table.
+ * @param legend_keys Turn on/off the legend keys in the table.
+ *
+ * The `%chart_set_table_grid()` function turns on/off grid options for a
+ * chart data table. The data table grid options in Excel are shown in the
+ * dialog below:
+ *
+ * @image html chart_data_table3.png
+ *
+ * These options can be passed to the `%chart_set_table_grid()` function.
+ * The values for a default chart are:
+ *
+ * - `horizontal`: On.
+ * - `vertical`: On.
+ * - `outline`:  On.
+ * - `legend_keys`: Off.
+ *
+ * Example:
+ *
+ * @code
+ *     // Turn on the data table with default options.
+ *     chart_set_table(chart);
+ *
+ *     // Turn on all grid lines and the grid legend.
+ *     chart_set_table_grid(chart, LXW_TRUE, LXW_TRUE, LXW_TRUE, LXW_TRUE);
+ *
+ *     // Turn off the legend since it is show in the table.
+ *     chart_legend_set_position(chart, LXW_CHART_LEGEND_NONE);
+ *
+ * @endcode
+ *
+ * @image html chart_data_table2.png
+ *
+ * The data table can only be shown with Bar, Column, Line and Area charts.
+ *
+ */
+void chart_set_table_grid(lxw_chart *chart, uint8_t horizontal,
+                          uint8_t vertical, uint8_t outline,
+                          uint8_t legend_keys);
+
+void chart_set_table_font(lxw_chart *chart, lxw_chart_font *font);
+
+/**
+ * @brief Turn on up-down bars for the chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * The `%chart_set_up_down_bars()` function adds Up-Down bars to Line charts
+ * to indicate the difference between the first and last data series:
+ *
+ * @code
+ *     chart_set_up_down_bars(chart);
+ * @endcode
+ *
+ * @image html chart_data_tools4.png
+ *
+ * Up-Down bars are only available in Line charts. By default Up-Down bars are
+ * black and white like in the above example. To format the border or fill
+ * of the bars see the `chart_set_up_down_bars_format()` function below.
+ */
+void chart_set_up_down_bars(lxw_chart *chart);
+
+/**
+ * @brief Turn on up-down bars for the chart, with formatting.
+ *
+ * @param chart         Pointer to a lxw_chart instance to be configured.
+ * @param up_bar_line   A #lxw_chart_line struct for the up-bar border.
+ * @param up_bar_fill   A #lxw_chart_fill struct for the up-bar fill.
+ * @param down_bar_line A #lxw_chart_line struct for the down-bar border.
+ * @param down_bar_fill A #lxw_chart_fill struct for the down-bar fill.
+ *
+ * The `%chart_set_up_down_bars_format()` function adds Up-Down bars to Line
+ * charts to indicate the difference between the first and last data series.
+ * It also allows the up and down bars to be formatted:
+ *
+ * @code
+ *     lxw_chart_line line      = {.color = LXW_COLOR_BLACK};
+ *     lxw_chart_fill up_fill   = {.color = 0x00B050};
+ *     lxw_chart_fill down_fill = {.color = LXW_COLOR_RED};
+ *
+ *     chart_set_up_down_bars_format(chart, &line, &up_fill, &line, &down_fill);
+ * @endcode
+ *
+ * @image html chart_up_down_bars.png
+ *
+ * Up-Down bars are only available in Line charts.
+ * For more format information  see @ref chart_lines and @ref chart_fills.
+ */
+void chart_set_up_down_bars_format(lxw_chart *chart,
+                                   lxw_chart_line *up_bar_line,
+                                   lxw_chart_fill *up_bar_fill,
+                                   lxw_chart_line *down_bar_line,
+                                   lxw_chart_fill *down_bar_fill);
+
+/**
+ * @brief Turn on and format Drop Lines for a chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * The `%chart_set_drop_lines()` function adds Drop Lines to charts to
+ * show the Category value of points in the data:
+ *
+ * @code
+ *     chart_set_drop_lines(chart, NULL);
+ * @endcode
+ *
+ * @image html chart_data_tools6.png
+ *
+ * It is possible to format the Drop Line line properties if required:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
+ *
+ *     chart_set_drop_lines(chart, &line);
+ * @endcode
+ *
+ * Drop Lines are only available in Line and Area charts.
+ * For more format information see @ref chart_lines.
+ */
+void chart_set_drop_lines(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Turn on and format high-low Lines for a chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param line  A #lxw_chart_line struct.
+ *
+ * The `%chart_set_high_low_lines()` function adds High-Low Lines to charts
+ * to show the Category value of points in the data:
+ *
+ * @code
+ *     chart_set_high_low_lines(chart, NULL);
+ * @endcode
+ *
+ * @image html chart_data_tools5.png
+ *
+ * It is possible to format the High-Low Line line properties if required:
+ *
+ * @code
+ *     lxw_chart_line line = {.color     = LXW_COLOR_RED,
+ *                            .dash_type = LXW_CHART_LINE_DASH_SQUARE_DOT};
+ *
+ *     chart_set_high_low_lines(chart, &line);
+ * @endcode
+ *
+ * High-Low Lines are only available in Line charts.
+ * For more format information see @ref chart_lines.
+ */
+void chart_set_high_low_lines(lxw_chart *chart, lxw_chart_line *line);
+
+/**
+ * @brief Set the overlap between series in a Bar/Column chart.
+ *
+ * @param chart   Pointer to a lxw_chart instance to be configured.
+ * @param overlap The overlap between the series. -100 to 100.
+ *
+ * The `%chart_set_series_overlap()` function sets the overlap between series
+ * in Bar and Column charts.
+ *
+ * @code
+ *     chart_set_series_overlap(chart, -50);
+ * @endcode
+ *
+ * @image html chart_overlap.png
+ *
+ * The overlap value must be in the range `0 <= overlap <= 500`.
+ * The default value is 0.
+ *
+ * This option is only available for Bar/Column charts.
+ */
+void chart_set_series_overlap(lxw_chart *chart, int8_t overlap);
+
+/**
+ * @brief Set the gap between series in a Bar/Column chart.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param gap   The gap between the series.  0 to 500.
+ *
+ * The `%chart_set_series_gap()` function sets the gap between series in
+ * Bar and Column charts.
+ *
+ * @code
+ *     chart_set_series_gap(chart, 400);
+ * @endcode
+ *
+ * @image html chart_gap.png
+ *
+ * The gap value must be in the range `0 <= gap <= 500`. The default value
+ * is 150.
+ *
+ * This option is only available for Bar/Column charts.
+ */
+void chart_set_series_gap(lxw_chart *chart, uint16_t gap);
+
+/**
+ * @brief Set the option for displaying blank data in a chart.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param option The display option. A #lxw_chart_blank option.
+ *
+ * The `%chart_show_blanks_as()` function controls how blank data is displayed
+ * in a chart:
+ *
+ * @code
+ *     chart_show_blanks_as(chart, LXW_CHART_BLANKS_AS_CONNECTED);
+ * @endcode
+ *
+ * The `option` parameter can have one of the following values:
+ *
+ * - #LXW_CHART_BLANKS_AS_GAP: Show empty chart cells as gaps in the data.
+ *   This is the default option for Excel charts.
+ * - #LXW_CHART_BLANKS_AS_ZERO: Show empty chart cells as zeros.
+ * - #LXW_CHART_BLANKS_AS_CONNECTED: Show empty chart cells as connected.
+ *   Only for charts with lines.
+ */
+void chart_show_blanks_as(lxw_chart *chart, uint8_t option);
+
+/**
+ * @brief Display data on charts from hidden rows or columns.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ *
+ * Display data that is in hidden rows or columns on the chart:
+ *
+ * @code
+ *     chart_show_hidden_data(chart);
+ * @endcode
+ */
+void chart_show_hidden_data(lxw_chart *chart);
+
+/**
+ * @brief Set the Pie/Doughnut chart rotation.
+ *
+ * @param chart    Pointer to a lxw_chart instance to be configured.
+ * @param rotation The angle of rotation.
+ *
+ * The `chart_set_rotation()` function is used to set the rotation of the
+ * first segment of a Pie/Doughnut chart. This has the effect of rotating
+ * the entire chart:
+ *
+ * @code
+ *     chart_set_rotation(chart, 28);
+ * @endcode
+ *
+ * The angle of rotation must be in the range `0 <= rotation <= 360`.
+ *
+ * This option is only available for Pie/Doughnut charts.
+ *
+ */
+void chart_set_rotation(lxw_chart *chart, uint16_t rotation);
+
+/**
+ * @brief Set the Doughnut chart hole size.
+ *
+ * @param chart Pointer to a lxw_chart instance to be configured.
+ * @param size  The hole size as a percentage.
+ *
+ * The `chart_set_hole_size()` function is used to set the hole size of a
+ * Doughnut chart:
+ *
+ * @code
+ *     chart_set_hole_size(chart, 33);
+ * @endcode
+ *
+ * The hole size must be in the range `10 <= size <= 90`.
+ *
+ * This option is only available for Doughnut charts.
+ *
+ */
+void chart_set_hole_size(lxw_chart *chart, uint8_t size);
+
+lxw_error lxw_chart_add_data_cache(lxw_series_range *range, uint8_t *data,
+                                   uint16_t rows, uint8_t cols, uint8_t col);
+
+/* Declarations required for unit testing. */
+#ifdef TESTING
+
+STATIC void _chart_xml_declaration(lxw_chart *chart);
+STATIC void _chart_write_legend(lxw_chart *chart);
+
+#endif /* TESTING */
+
+/* *INDENT-OFF* */
+#ifdef __cplusplus
+}
+#endif
+/* *INDENT-ON* */
+
+#endif /* __LXW_CHART_H__ */