Ellipse annotation allows to add an ellipse or circle to the chart, as any other annotation it can be drawn by user or added to the chart via XML or JSON settings. In this article you can learn how to add an ellipse via XML or JSON settings and what visual settings can be done.
To learn about basic settings, that can be done with an annotation please refer to: Drawing Tools and Annotations: General Settings.
To add an Ellipse annotation to a chart you need to, as with any other annotation, add an annotation node, assign the id, set "Ellipse" type and specify the chart id using chart attribute.
In ellipse_annotation node you need anchors, which define two points on which ellipse is based.
All this you can see in the basic XML/JSON snippet below:
01 |
<?xml version="1.0" encoding="UTF-8"?> |
02 |
<stock xmlns="http://anychart.com/products/stock/schemas/1.9.0/schema.xsd"> |
03 |
<annotations> |
04 |
<annotation_list> |
05 |
<annotation id="Ellipse_0856719161" type="Ellipse" chart="idMainChart"> |
06 |
<ellipse_annotation first_time_anchor="2009-02-15" first_value_anchor="24.82" second_time_anchor="2009-05-28" second_value_anchor="16.68" /> |
07 |
</annotation> |
08 |
</annotation_list> |
09 |
</annotations> |
10 |
</stock> |
01 | { |
02 | annotations: { |
03 | annotationList: [ |
04 | { |
05 | id: "Ellipse_0856719161", |
06 | type: "Ellipse", |
07 | chart: "idMainChart", |
08 | ellipseAnnotation: { |
09 | firstTimeAnchor: "2009-02-15", |
10 | firstValueAnchor: 24.82, |
11 | secondTimeAnchor: "2009-05-28", |
12 | secondValueAnchor: 16.68 |
13 | } |
14 | } |
15 | ] |
16 | } |
17 | } |
Live sample below shows a chart with this sample basic Ellipse annotation:
You have a total control over the look of the ellipse, to define visual settings you need to add settings node and then use border and fill nodes to set how it should look like. Sample XML/JSON snippet below shows this.
If you click on nodes in the snippet, XML or JSON reference will be opened and you will be able to browse all possible settings, including the look of the ellipse in different states.
Note: ellipse border can not be dashed.
01 |
<?xml version="1.0" encoding="UTF-8"?> |
02 |
<stock xmlns="http://anychart.com/products/stock/schemas/1.9.0/schema.xsd"> |
03 |
<annotations> |
04 |
<annotation_list> |
05 |
<annotation id="Ellipse_0856719161" type="Ellipse" chart="idMainChart"> |
06 |
<ellipse_annotation color="#DB2A0E" first_time_anchor="2009-03-04" first_value_anchor="28.79" second_time_anchor="2009-06-06" second_value_anchor="20.19"> |
07 |
<settings> |
10 |
</settings> |
11 |
</ellipse_annotation> |
12 |
</annotation> |
13 |
</annotation_list> |
14 |
</annotations> |
15 |
</stock> |
01 | { |
02 | annotations: { |
03 | annotationList: [ |
04 | { |
05 | id: "Ellipse_0856719161", |
06 | type: "Ellipse", |
07 | chart: "idMainChart", |
08 | ellipseAnnotation: { |
09 | color: "#DB2A0E", |
10 | firstTimeAnchor: "2009-03-04", |
11 | firstValueAnchor: 28.79, |
12 | secondTimeAnchor: "2009-06-06", |
13 | secondValueAnchor: 20.19, |
14 | settings: { |
15 | border: { |
16 | thickness: 1 |
17 | }, |
18 | fill: { |
19 | color: "%Color", |
20 | opacity: 0.1 |
21 | } |
22 | } |
23 | } |
24 | } |
25 | ] |
26 | } |
27 | } |
Live sample below contains several Ellipse annotations colored and configured in a different way:
