Index: third_party/flot/FAQ.md |
diff --git a/third_party/flot/FAQ.md b/third_party/flot/FAQ.md |
new file mode 100644 |
index 0000000000000000000000000000000000000000..9131e043985f8281cc5b0c4eec06b84447e9eb67 |
--- /dev/null |
+++ b/third_party/flot/FAQ.md |
@@ -0,0 +1,75 @@ |
+## Frequently asked questions ## |
+ |
+#### How much data can Flot cope with? #### |
+ |
+Flot will happily draw everything you send to it so the answer |
+depends on the browser. The excanvas emulation used for IE (built with |
+VML) makes IE by far the slowest browser so be sure to test with that |
+if IE users are in your target group (for large plots in IE, you can |
+also check out Flashcanvas which may be faster). |
+ |
+1000 points is not a problem, but as soon as you start having more |
+points than the pixel width, you should probably start thinking about |
+downsampling/aggregation as this is near the resolution limit of the |
+chart anyway. If you downsample server-side, you also save bandwidth. |
+ |
+ |
+#### Flot isn't working when I'm using JSON data as source! #### |
+ |
+Actually, Flot loves JSON data, you just got the format wrong. |
+Double check that you're not inputting strings instead of numbers, |
+like [["0", "-2.13"], ["5", "4.3"]]. This is most common mistake, and |
+the error might not show up immediately because Javascript can do some |
+conversion automatically. |
+ |
+ |
+#### Can I export the graph? #### |
+ |
+You can grab the image rendered by the canvas element used by Flot |
+as a PNG or JPEG (remember to set a background). Note that it won't |
+include anything not drawn in the canvas (such as the legend). And it |
+doesn't work with excanvas which uses VML, but you could try |
+Flashcanvas. |
+ |
+ |
+#### The bars are all tiny in time mode? #### |
+ |
+It's not really possible to determine the bar width automatically. |
+So you have to set the width with the barWidth option which is NOT in |
+pixels, but in the units of the x axis (or the y axis for horizontal |
+bars). For time mode that's milliseconds so the default value of 1 |
+makes the bars 1 millisecond wide. |
+ |
+ |
+#### Can I use Flot with libraries like Mootools or Prototype? #### |
+ |
+Yes, Flot supports it out of the box and it's easy! Just use jQuery |
+instead of $, e.g. call jQuery.plot instead of $.plot and use |
+jQuery(something) instead of $(something). As a convenience, you can |
+put in a DOM element for the graph placeholder where the examples and |
+the API documentation are using jQuery objects. |
+ |
+Depending on how you include jQuery, you may have to add one line of |
+code to prevent jQuery from overwriting functions from the other |
+libraries, see the documentation in jQuery ("Using jQuery with other |
+libraries") for details. |
+ |
+ |
+#### Flot doesn't work with [insert name of Javascript UI framework]! #### |
+ |
+Flot is using standard HTML to make charts. If this is not working, |
+it's probably because the framework you're using is doing something |
+weird with the DOM or with the CSS that is interfering with Flot. |
+ |
+A common problem is that there's display:none on a container until the |
+user does something. Many tab widgets work this way, and there's |
+nothing wrong with it - you just can't call Flot inside a display:none |
+container as explained in the README so you need to hold off the Flot |
+call until the container is actually displayed (or use |
+visibility:hidden instead of display:none or move the container |
+off-screen). |
+ |
+If you find there's a specific thing we can do to Flot to help, feel |
+free to submit a bug report. Otherwise, you're welcome to ask for help |
+on the forum/mailing list, but please don't submit a bug report to |
+Flot. |