Merge branch 'master' of git://github.com/danvk/dygraphs into highlight3
authorKlaus Weidner <klausw@google.com>
Sun, 26 Feb 2012 00:04:41 +0000 (16:04 -0800)
committerKlaus Weidner <klausw@google.com>
Sun, 26 Feb 2012 00:04:41 +0000 (16:04 -0800)
1  2 
dygraph-options-reference.js

@@@ -41,19 -41,36 +41,36 @@@ Dygraph.OPTIONS_REFERENCE =  // <JSON
      "default": "false",
      "labels": ["Data Line display"],
      "type": "boolean",
-     "description": "Draw a small dot at each point, in addition to a line going through the point. This makes the individual data points easier to see, but can increase visual clutter in the chart. The small dot can be replaced with a custom rendering by supplying a drawPointCallback."
+     "description": "Draw a small dot at each point, in addition to a line going through \
+         the point. This makes the individual data points easier to see, but  \
+         can increase visual clutter in the chart. The small dot can be \
+         replaced with a custom rendering by supplying a \
+         <a href='#drawPointCallback'>drawPointCallback</a>."
    },
    "drawPointCallback": {
      "default": "null",
      "labels": ["Data Line display"],
      "type": "function(g, seriesName, canvasContext, cx, cy, color, pointSize)",
-     "description": "Draw a custom item when drawPoints is enabled. Default is a small dot matching the series color."
+     "parameters": [
+       [ "g" , "the reference graph" ],
+       [ "seriesName" , "the name of the series" ],
+       [ "canvasContext" , "the canvas to draw on" ],
+       [ "cx" , "center x coordinate" ],
+       [ "cy" , "center y coordinate" ],
+       [ "color" , "series color" ],
+       [ "pointSize" , "the radius of the image." ]
+     ],
+     "description": "Draw a custom item when drawPoints is enabled. \
+         Default is a small dot matching the series color. This method \
+         should constrain drawing to within pointSize pixels from (cx, cy). \
+         Also see <a href='#drawHighlightPointCallback'>drawHighlightPointCallback</a>"
    },
    "height": {
      "default": "320",
      "labels": ["Overall display"],
      "type": "integer",
-     "description": "Height, in pixels, of the chart. If the container div has been explicitly sized, this will be ignored."
+     "description": "Height, in pixels, of the chart. If the container div has \
+       been explicitly sized, this will be ignored."
    },
    "zoomCallback": {
      "default": "null",
@@@ -64,7 -81,8 +81,8 @@@
        [ "maxDate" , "milliseconds since epoch." ],
        [ "yRanges" , "is an array of [bottom, top] pairs, one for each y-axis." ]
      ],
-     "description": "A function to call when the zoom window is changed (either by zooming in or out)."
+     "description": "A function to call when the zoom window is changed (either \
+       by zooming in or out)."
    },
    "pointClickCallback": {
      "snippet": "function(e, point){<br>&nbsp;&nbsp;alert(point);<br>}",
    "highlightCallback": {
      "default": "null",
      "labels": ["Callbacks"],
 -    "type": "function(event, x, points, row)",
 +    "type": "function(event, x, points, row, seriesName)",
      "description": "When set, this callback gets called every time a new point is highlighted.",
      "parameters": [
        ["event", "the JavaScript mousemove event"],
        ["x", "the x-coordinate of the highlighted points"],
        ["points", "an array of highlighted points: <code>[ {name: 'series', yval: y-value}, &hellip; ]</code>"],
 -      ["row", "???"]
 +      ["row", "integer index of the highlighted row in the data table, starting from 0"],
 +      ["seriesName", "name of the highlighted series, only present if highlightSeriesOpts is set."]
      ]
    },
    "drawHighlightPointCallback": {
      "default": "null",
      "labels": ["Data Line display"],
      "type": "function(g, seriesName, canvasContext, cx, cy, color, pointSize)",
-     "description": "Draw a custom item when a point is highlighted. Default is a small dot matching the series color."
+     "parameters": [
+       [ "g" , "the reference graph" ],
+       [ "seriesName" , "the name of the series" ],
+       [ "canvasContext" , "the canvas to draw on" ],
+       [ "cx" , "center x coordinate" ],
+       [ "cy" , "center y coordinate" ],
+       [ "color" , "series color" ],
+       [ "pointSize" , "the radius of the image." ]
+     ],
+     "description": "Draw a custom item when a point is highlighted. \
+         Default is a small dot matching the series color. This method \
+         should constrain drawing to within pointSize pixels from (cx, cy) \
+         Also see <a href='#drawPointCallback'>drawPointCallback</a>"
    },
 +  "highlightSeriesOpts": {
 +    "default": "null",
 +    "labels": ["Interactive Elements"],
 +    "type": "Object",
 +    "description": "When set, the options from this object are applied to the timeseries closest to the mouse pointer for interactive highlighting. See also 'highlightCallback'. Example: highlightSeriesOpts: { strokeWidth: 3 }."
 +  },
 +  "highlightSeriesBackgroundFade": {
 +    "default": "0",
 +    "labels": ["Interactive Elements"],
 +    "type": "number",
 +    "description": "When nonzero, dim the background while highlighting series. 0=fully visible, 1=hidden"
 +  },
 +  "highlightSeriesAnimate": {
 +    "default": "false",
 +    "labels": ["Interactive Elements"],
 +    "type": "boolean",
 +    "description": "Animate the background dimming for nonzero highlightSeriesBackgroundFade."
 +  },
    "includeZero": {
      "default": "false",
      "labels": ["Axis display"],
    "strokeWidth": {
      "default": "1.0",
      "labels": ["Data Line display"],
 -    "type": "integer",
 +    "type": "float",
      "example": "0.5, 2.0",
      "description": "The width of the lines connecting data points. This can be used to increase the contrast or some graphs."
    },
      "example": "[10, 2, 5, 2]",
      "description": "A custom pattern array where the even index is a draw and odd is a space in pixels. If null then it draws a solid line. The array should have a even length as any odd lengthed array could be expressed as a smaller even length array."
    },
 +  "strokeBorderWidth": {
 +    "default": "null",
 +    "labels": ["Data Line display"],
 +    "type": "float",
 +    "example": "1.0",
 +    "description": "Draw a border around graph lines to make crossing lines more easily distinguishable. Useful for graphs with many lines."
 +  },
 +  "strokeBorderColor": {
 +    "default": "white",
 +    "labels": ["Data Line display"],
 +    "type": "string",
 +    "example": "red, #ccffdd",
 +    "description": "Color for the line border used if strokeBorderWidth is set."
 +  },
    "wilsonInterval": {
      "default": "true",
      "labels": ["Error Bars"],