add files to project

web/metronic/global/plugins/jquery-knob/README.md

@@ -0,0 +1,135 @@
+jQuery Knob
+=============
+
+- canvas based ; no png or jpg sprites.
+- touch, mouse and mousewheel, keyboard events implemented.
+- downward compatible ; overloads an input element.
+
+Example
+-------
+
+    <input type="text" value="75" class="dial">
+
+    <script>
+    $(function() {
+        $(".dial").knob();
+    });
+    </script>
+
+Options
+-------
+
+Options are provided as attributes 'data-option':
+
+    <input type="text" class="dial" data-min="-50" data-max="50">
+
+... or in the "knob()" call :
+
+    $(".dial").knob({
+                    'min':-50
+                    ,'max':50
+                    });
+
+The following options are supported :
+
+Behaviors :
+* min : min value | default=0.
+* max : max value | default=100.
+* step : step size | default=1.
+* angleOffset : starting angle in degrees | default=0.
+* angleArc : arc size in degrees | default=360.
+* stopper : stop at min & max on keydown/mousewheel | default=true.
+* readOnly : disable input and events | default=false.
+* rotation : direction of progression | default=clockwise.
+
+UI :
+* cursor : display mode "cursor", cursor size could be changed passing a numeric value to the option, default width is used when passing boolean value "true" | default=gauge.
+* thickness : gauge thickness.
+* lineCap : gauge stroke endings. | default=butt, round=rounded line endings
+* width : dial width.
+* displayInput : default=true | false=hide input.
+* displayPrevious : default=false | true=displays the previous value with transparency.
+* fgColor : foreground color.
+* inputColor : input value (number) color.
+* font : font family.
+* fontWeight : font weight.
+* bgColor : background color.
+
+Hooks
+-------
+
+    <script>
+    $(".dial").knob({
+                        'release' : function (v) { /*make something*/ }
+                    });
+    </script>
+
+* 'release' : executed on release
+
+    Parameters :
+    + value : int, current value
+
+* 'change' : executed at each change of the value
+
+    Parameters :
+    + value : int, current value
+
+* 'draw' : when drawing the canvas
+
+    Context :
+    - this.g : canvas context 2D (see Canvas documentation)
+    - this.$ : jQuery wrapped element
+    - this.o : options
+    - this.i : input
+    - ... console.log(this);
+
+* 'cancel' : triggered on [esc] keydown
+
+* 'format' : allows to format output (add unit %, ms ...)
+
+The scope (this) of each hook function is the current Knob instance (refer to the demo code).
+
+Example
+-------
+
+    <input type="text" value="75" class="dial">
+
+    <script>
+    $(".dial").knob({
+                     'change' : function (v) { console.log(v); }
+                    });
+    </script>
+
+
+Dynamically configure
+-------
+
+    <script>
+    $('.dial')
+        .trigger(
+            'configure',
+            {
+            "min":10,
+            "max":40,
+            "fgColor":"#FF0000",
+            "skin":"tron",
+            "cursor":true
+            }
+        );
+    </script>
+
+Set the value
+-------
+
+    <script>
+    $('.dial')
+        .val(27)
+        .trigger('change');
+    </script>
+
+Supported browser
+-------
+
+Tested on Chrome, Safari, Firefox, IE>=8.0 (IE8.0 with excanvas).
+
+![secretplan](https://raw.github.com/aterrien/jQuery-Knob/master/secretplan.jpg)