Vvidget Server ► Dictionary ► Bar Chart
This section explains how to form an input string for a bar chart such as these:
| Format | |
| 1; fill_color=AAAA00 | 1; With Labels, no fill color |
| 2, no fill color | 3 |
The input string has this form:
chart_type=3&chart_subtype=0&chart_format_type=1&data_values=v1 v2 ... vN&fill_color=RRGGBBAA&label_1=string&label_2=string&templates=string
The following table defines the input string key and value pairs:
| Chart Specific Entries | |
| Key | Value Description |
| chart_type¹ | The chart type is always 3 (aliased to bar), indicating a bar chart. |
| chart_subtype¹ | The chart subtype is always 0. (aliased to default) |
| chart_format_type¹ | The chart format type is an index from 1 to 3 (aliased to {default , alternate, extruded}) which produces the varied results of the figures above. |
| title | The main title of the graph. If this key is not present then the template's title is used. |
| x_title | The x title of the graph. If this key is not present then the template's x-title is used. |
| y_title | The y title of the graph. If this key is not present then the template's y-title is used. |
| data_values | A white space delimited list of values representing the length of the bar. See Data Oriented keys for additional information and keys. |
| label_I | A string for the I-th label value. I starts at 1. |
| fill_color | A hex encoded representation of a RGBA color value. This only is in effect for format type 1. If this key is not present then the color table template is used. |
| fill_color_I | A hex encoded representation of a RGBA color value for the I-th bar. I starts at 1 (example: fill_color_2=FF0000 assigns the 2nd bar to a red fill color). This entry overrides the fill_color and the table color specifications. |
| templates | A custom Templates directory. |
If you incorporate this functionality into your web site please consult Web URL.
You can also modify the following Templates:
| Template Document Names | |
| Template | Description |
| PVST_Bar_Chart | Forms the static attributes for this chart type when there are no label keys. |
| PVST_Custom_Label_Bar_Chart | Forms the static attributes for this chart type when there is at least one label key. The left margin is greater to accommodate longer labels. |
| PVST_bar_color_table | Forms the bar color attributes for odd format type indices. |
| PVST_bar_color_table_1 | Forms the bar color attributes for even format type indices. |
The following Server Side Attributes define additional non-graphic attributes. A file with this name in the templates directory will alter the parameters that appear in the attribute file.
| Server Side Attributes Names | |
| Name | Description |
| PVST_Bar_Chart_attributes | Main server side attributes. |
Other examples
Group bars can be formed by using the data_I keys instead of the data_values key. Here is an example: