ziya 1.0.0 → 2.0.0

data/Manifest.txt

@@ -3,12 +3,16 @@ Manifest.txt
 README.txt
 Rakefile
 bin/ziyafy
+charts/AC_RunActiveContent.js
 charts/charts.swf
+charts/charts_library/ar3d.swf
 charts/charts_library/arno.swf
+charts/charts_library/ars3.swf
 charts/charts_library/arst.swf
 charts/charts_library/brfl.swf
 charts/charts_library/brno.swf
 charts/charts_library/brst.swf
+charts/charts_library/buno.swf
 charts/charts_library/cl3d.swf
 charts/charts_library/clfl.swf
 charts/charts_library/clno.swf
@@ -22,33 +26,22 @@ charts/charts_library/pi3d.swf
 charts/charts_library/pino.swf
 charts/charts_library/pono.swf
 charts/charts_library/scno.swf
-charts/themes/commando/bar_chart.yml
-charts/themes/commando/base_chart.yml
-charts/themes/commando/column_chart.yml
-charts/themes/commando/column_threed_chart.yml
-charts/themes/commando/parallel_threed_column_chart.yml
-charts/themes/commando/pie_chart.yml
-charts/themes/commando/pie_threed_chart.yml
-charts/themes/commando/polar_chart.yml
-charts/themes/commando/stacked_bar_chart.yml
-charts/themes/commando/stacked_column_chart.yml
-charts/themes/commando/stacked_threed_column_chart.yml
-charts/themes/default/bar_chart.yml
-charts/themes/default/base_chart.yml
-charts/themes/default/column_chart.yml
-charts/themes/default/column_threed_chart.yml
-charts/themes/default/parallel_threed_column_chart.yml
-charts/themes/default/pie_chart.yml
-charts/themes/default/pie_threed_chart.yml
-charts/themes/default/polar_chart.yml
-charts/themes/default/stacked_bar_chart.yml
-charts/themes/default/stacked_column_chart.yml
-charts/themes/default/stacked_threed_column_chart.yml
-charts/themes/default/test.yml
+charts/full_screen.swf
+charts/sliders/black.swf
+charts/sliders/preview_handle_1.swf
+charts/sliders/preview_handle_2.swf
+fred.rb
+gauges/designs/circle.yml
+gauges/designs/signal.yml
+gauges/designs/thermo.yml
+gauges/designs/title.yml
+gauges/gauge.swf
 lib/ziya.rb
 lib/ziya/charts/area.rb
+lib/ziya/charts/area_threed.rb
 lib/ziya/charts/bar.rb
 lib/ziya/charts/base.rb
+lib/ziya/charts/bubble.rb
 lib/ziya/charts/candle_stick.rb
 lib/ziya/charts/column.rb
 lib/ziya/charts/column_threed.rb
@@ -64,35 +57,64 @@ lib/ziya/charts/scatter.rb
 lib/ziya/charts/stacked_area.rb
 lib/ziya/charts/stacked_bar.rb
 lib/ziya/charts/stacked_column.rb
+lib/ziya/charts/stacked_threed_area.rb
 lib/ziya/charts/stacked_threed_column.rb
 lib/ziya/components/area.rb
 lib/ziya/components/axis_category.rb
 lib/ziya/components/axis_ticks.rb
 lib/ziya/components/axis_value.rb
 lib/ziya/components/base.rb
+lib/ziya/components/bevel.rb
+lib/ziya/components/blur.rb
 lib/ziya/components/chart_border.rb
 lib/ziya/components/chart_grid_h.rb
 lib/ziya/components/chart_grid_v.rb
+lib/ziya/components/chart_guide.rb
+lib/ziya/components/chart_label.rb
 lib/ziya/components/chart_pref.rb
 lib/ziya/components/chart_rect.rb
 lib/ziya/components/chart_transition.rb
-lib/ziya/components/chart_value.rb
 lib/ziya/components/circle.rb
 lib/ziya/components/draw.rb
+lib/ziya/components/draw_base.rb
+lib/ziya/components/filter.rb
+lib/ziya/components/glow.rb
 lib/ziya/components/image.rb
-lib/ziya/components/legend_label.rb
-lib/ziya/components/legend_rect.rb
-lib/ziya/components/legend_transition.rb
+lib/ziya/components/legend.rb
 lib/ziya/components/line.rb
 lib/ziya/components/link.rb
 lib/ziya/components/link_data.rb
-lib/ziya/components/live_update.rb
 lib/ziya/components/rect.rb
+lib/ziya/components/scroll.rb
 lib/ziya/components/series_color.rb
 lib/ziya/components/series_explode.rb
 lib/ziya/components/series_gap.rb
 lib/ziya/components/series_switch.rb
+lib/ziya/components/shadow.rb
 lib/ziya/components/text.rb
+lib/ziya/components/update.rb
+lib/ziya/gauges/base.rb
+lib/ziya/gauges/radial.rb
+lib/ziya/gauges/signal.rb
+lib/ziya/gauges/support/area.rb
+lib/ziya/gauges/support/base.rb
+lib/ziya/gauges/support/circle.rb
+lib/ziya/gauges/support/design.rb
+lib/ziya/gauges/support/image.rb
+lib/ziya/gauges/support/line.rb
+lib/ziya/gauges/support/link.rb
+lib/ziya/gauges/support/move.rb
+lib/ziya/gauges/support/point.rb
+lib/ziya/gauges/support/polygon.rb
+lib/ziya/gauges/support/radial_base.rb
+lib/ziya/gauges/support/radial_numbers.rb
+lib/ziya/gauges/support/radial_ticks.rb
+lib/ziya/gauges/support/rect.rb
+lib/ziya/gauges/support/rotate.rb
+lib/ziya/gauges/support/scale.rb
+lib/ziya/gauges/support/text.rb
+lib/ziya/gauges/support/update.rb
+lib/ziya/gauges/thermo.rb
 lib/ziya/helpers/base_helper.rb
 lib/ziya/utils/logger.rb
 lib/ziya/utils/text.rb
@@ -102,12 +124,36 @@ spec/charts/base_spec.rb
 spec/charts/chart_type_spec.rb
 spec/components/area_spec.rb
 spec/components/draw_spec.rb
+spec/components/filter_spec.rb
 spec/components/link_spec.rb
 spec/components/series_color_spec.rb
 spec/components/series_explode_spec.rb
 spec/components/series_switch_spec.rb
+spec/designs/circle.yml
+spec/designs/crapping_out.yml
+spec/designs/gauge_1.yml
+spec/designs/gauge_2.yml
+spec/designs/gauge_no_name.yml
+spec/designs/gauge_raw.yml
+spec/designs/thermo.yml
+spec/gauges/base_spec.rb
+spec/gauges/signal_spec.rb
+spec/gauges/support/area_spec.rb
+spec/gauges/support/circle_spec.rb
+spec/gauges/support/image_spec.rb
+spec/gauges/support/line_spec.rb
+spec/gauges/support/link_spec.rb
+spec/gauges/support/move_spec.rb
+spec/gauges/support/polygon_spec.rb
+spec/gauges/support/radial_numbers_spec.rb
+spec/gauges/support/radial_ticks_spec.rb
+spec/gauges/support/rotate_spec.rb
+spec/gauges/support/scale_spec.rb
+spec/gauges/support/text_spec.rb
+spec/gauges/thermo_spec.rb
 spec/helpers/base_helper_spec.rb
 spec/spec_helper.rb
+spec/test_helpers/gauge_2_helper.rb
 spec/themes/default/fred.yml
 spec/themes/default/line_chart.yml
 spec/utils/logger_spec.rb

data/README.txt

@@ -5,15 +5,15 @@ ziya
 == DESCRIPTION:
 
 ZiYa allows you to easily display graphs in your ruby based applications by leveraging
-SWF Charts (http://www.maani.us/xml_charts/index.php). This plugin bundles version 4.7
-of the flash library. Incorporating flash graphs in your app relieves the server by
-allowing for delegating graph rendering to the client side. Using this plugin, you will
+SWF Charts (http://www.maani.us/xml_charts/index.php) and SWF gauges (http://www.maani.us/gauge/index.php). 
+This gem bundles version 5.02 and 1.6 of these flash libraries. Incorporating flash graphs or gauge in your app 
+relieves the server by allowing for delegating graph rendering to the client side. Using this gem, you will
 be able to easily create great looking charts for your application. You will also be able
-to use the charts has a navigation scheme by embedding various link in the chart components
+to use the charts or gauges has a navigation scheme by embedding various link in the graphical components
 thus bring to the table an ideal scheme for reporting and dashboard like applications. Your
 managers will love you for it !!
 
-	Checkout the demo: http://ziya.liquidrail.com
+	Checkout the demo: http://ziya.liquidrail.com ( NEEDS LATEST UPDATE... WORKING ON IT)
 	Video            : http://www.youtube.com/watch?v=axIMmMHdXzo ( Out of date but you'll get the basics... )
 	Documentation    : http://ziya.liquidrail.com/rdoc ( New docs coming soon... )
 	Forum            : http://groups.google.com/group/ziya-plugin
@@ -32,11 +32,12 @@ managers will love you for it !!
 
    NOTE: XML/SWF charts are free of charge unless you need to use special features such
    as embedded links and printing. 
-   The package cost $45 per domain and is well worth the investment.
+   The package cost $45 per domain and is well worth the investment. A similar fee applies
+   to the gauge framework.
 
-*  We are leveraging ERB within the YAML file to provide access to the chart state. State
-   can be passed in via the options hash when the graph is generated.
-   You can also define your own methods in helpers/ZiyaHelpers. You can access these
+*  We are leveraging ERB within the YAML file to provide access to the chart/gauge state. State
+   can be passed in via the options hash when the graph/gauge is generated.
+   You can also define your own methods in helpers/ziya/xxx_helper. Where xxYou can access these
    helper methods in your style file just like you would in a rails template.
 
 *  Theme support. You can change the appearance and behavior of any charts by introducing
@@ -44,13 +45,23 @@ managers will love you for it !!
       
 == SYNOPSIS:
   
+  IMPORTANT: This new gem version requires a client update to flash 9.0 and possibly you will
+  need to get a new license from XML/SWF ( $45.0 for your domain ), if you want to use
+  advanced features like links and live updates.
+  Also some api's have changed. I will try to push a new sample application and more docs in the
+  next few weeks. So make sure you try this out first in a non production environment and report
+  bugs or side effects. I'll do my best to keep up with the demand. If anyone would like to give
+  me a hand with a tutorial app or improving the docs, I am all hears...
+  
+  
+  
   When using within a rails application you will need to create a ziya.rb file in your
   config/initializers directory ( Rails 2.0 )
   
   ziya.rb:
   
     # Pull in the ZiYa gem framework
-    gem "ziya", "~> 1.0.0"
+    gem "ziya", "~> 2.0.0"
     require 'ziya'
 
     # Initializes the ZiYa Framework
@@ -79,7 +90,6 @@ managers will love you for it !!
          chart.add( :axis_category_text, %w[2006 2007 2008] )
          chart.add( :series, "Dogs", [10,20,30] )
          chart.add( :series, "Cats", [5,15,25] )
-         
          respond_to do |fmt|
           fmt.xml => { render :xml => chart.to_xml }
        end
@@ -87,7 +97,6 @@ managers will love you for it !!
      
    blee/index.html.erb
    
-   <!-- Setups up flash in the html template -->
    <%= ziya_chart load_chart_url, :size => "300x200" -%>
    
    config/route.rb
@@ -95,9 +104,78 @@ managers will love you for it !!
    # Creates a named route for the chart.
    map.load_chart '/blee/load_chart', :controller => 'blee', :action => 'load_chart'
    
+* Creating a gauge
+
+  fred_controller.rb
+  
+    class FredController < ApplicationController
+      def load_gauge
+        gauge = Ziya::Gauges::Base.new( @license_key, 'my_gauge' )
+         respond_to do |fmt|
+          fmt.xml => { render :xml => chart.to_xml }
+         end
+      end        
+    end
+    
+   fred/index.html.erb
+   
+   <%= ziya_gauge load_gauge_url, :size => "300x200" -%>
+
+   config/route.rb
+   
+   # Creates a named route for the chart.
+   map.load_chart '/fred/load_gauge', :controller => 'fred', :action => 'load_gauge'
+  
+  public/gauges/designs/my_gauge.yml
+
+  In the design file you will leverage the components defined in the Ziya::Gauges::Support
+  package to create your gauge desgins. You gauges can be animated using rotate, scale and 
+  move operations. In this example we will create a volume control that will rotate to the
+  desired position. In real live you will fetch the volume level from your controller to
+  set the desired position. Looks in the samples/gauges application for the various 
+  possibilities. You can think of a gauge as a portable canvas element where you can draw
+  you own designs using the various provided ZiYa components.
+  
+   <%= gauge :base %>  
+      # specifies the number of ticks to draw in a circular fashion
+      <%= dial :radial_ticks, :volume %>
+          x:              100
+          y:               75
+          radius:          35
+          length:           4
+          start_angle:    235
+          end_angle:      485
+          ticks:           10
+          thickness:        2
+          color:       000000
+      # rotates the volume to the desired position.
+      <%= dial :rotate, :volume_setting %>
+          x:               100
+          y:                75
+          start:           300
+          span:            160
+          step:              5
+          skake_span:       20
+          shadow_alpha:     20
+          shadow_x_offset:   3
+          shadow_y_offset:   3
+          <%= dials %>
+            <%= dial :circle, :circle_1 %>
+                x:             100
+                y:              75
+                radius:         30
+                fill_color: 777777
+                line_thickness: 5
+                line_alpha:     75        
+            <%= dial :circle, :circle_2 %>
+                x:          100
+                y:           55
+                radius:       5
+                fill_alpha:  80
+  
 == REQUIREMENTS:
 
-  ZiYa depends on the logging gem version > 0.7.1  
+  ZiYa depends on the logging gem version > 0.9.0  
 
 == INSTALL:
 
@@ -110,7 +188,6 @@ managers will love you for it !!
   This will copy the necessary themes and flash files to run ziya in your application 
   public/charts directory.
 
-
 == LICENSE:
 
 (The MIT License)

data/Rakefile

@@ -42,4 +42,4 @@ end
 task 'gem:package' => 'manifest:assert'
 
                 
-depend_on "logging", "= 0.7.1"
+depend_on "logging", "= 0.9.0"

data/bin/ziyafy

@@ -18,6 +18,8 @@ module Ziya
     def copy_artifacts
       source_dir = File.expand_path( File.join( File.dirname(__FILE__), %w[.. charts]) )
       FileUtils.cp_r( source_dir, options.public_dir )
+      source_dir = File.expand_path( File.join( File.dirname(__FILE__), %w[.. gauges]) )
+      FileUtils.cp_r( source_dir, options.public_dir )      
     end
     
     # access the options

data/charts/AC_RunActiveContent.js

@@ -0,0 +1,292 @@
+//v1.7
+// Flash Player Version Detection
+// Detect Client Browser type
+// Copyright 2005-2007 Adobe Systems Incorporated.  All rights reserved.
+var isIE  = (navigator.appVersion.indexOf("MSIE") != -1) ? true : false;
+var isWin = (navigator.appVersion.toLowerCase().indexOf("win") != -1) ? true : false;
+var isOpera = (navigator.userAgent.indexOf("Opera") != -1) ? true : false;
+
+function ControlVersion()
+{
+	var version;
+	var axo;
+	var e;
+
+	// NOTE : new ActiveXObject(strFoo) throws an exception if strFoo isn't in the registry
+
+	try {
+		// version will be set for 7.X or greater players
+		axo = new ActiveXObject("ShockwaveFlash.ShockwaveFlash.7");
+		version = axo.GetVariable("$version");
+	} catch (e) {
+	}
+
+	if (!version)
+	{
+		try {
+			// version will be set for 6.X players only
+			axo = new ActiveXObject("ShockwaveFlash.ShockwaveFlash.6");
+			
+			// installed player is some revision of 6.0
+			// GetVariable("$version") crashes for versions 6.0.22 through 6.0.29,
+			// so we have to be careful. 
+			
+			// default to the first public version
+			version = "WIN 6,0,21,0";
+
+			// throws if AllowScripAccess does not exist (introduced in 6.0r47)		
+			axo.AllowScriptAccess = "always";
+
+			// safe to call for 6.0r47 or greater
+			version = axo.GetVariable("$version");
+
+		} catch (e) {
+		}
+	}
+
+	if (!version)
+	{
+		try {
+			// version will be set for 4.X or 5.X player
+			axo = new ActiveXObject("ShockwaveFlash.ShockwaveFlash.3");
+			version = axo.GetVariable("$version");
+		} catch (e) {
+		}
+	}
+
+	if (!version)
+	{
+		try {
+			// version will be set for 3.X player
+			axo = new ActiveXObject("ShockwaveFlash.ShockwaveFlash.3");
+			version = "WIN 3,0,18,0";
+		} catch (e) {
+		}
+	}
+
+	if (!version)
+	{
+		try {
+			// version will be set for 2.X player
+			axo = new ActiveXObject("ShockwaveFlash.ShockwaveFlash");
+			version = "WIN 2,0,0,11";
+		} catch (e) {
+			version = -1;
+		}
+	}
+	
+	return version;
+}
+
+// JavaScript helper required to detect Flash Player PlugIn version information
+function GetSwfVer(){
+	// NS/Opera version >= 3 check for Flash plugin in plugin array
+	var flashVer = -1;
+	
+	if (navigator.plugins != null && navigator.plugins.length > 0) {
+		if (navigator.plugins["Shockwave Flash 2.0"] || navigator.plugins["Shockwave Flash"]) {
+			var swVer2 = navigator.plugins["Shockwave Flash 2.0"] ? " 2.0" : "";
+			var flashDescription = navigator.plugins["Shockwave Flash" + swVer2].description;
+			var descArray = flashDescription.split(" ");
+			var tempArrayMajor = descArray[2].split(".");			
+			var versionMajor = tempArrayMajor[0];
+			var versionMinor = tempArrayMajor[1];
+			var versionRevision = descArray[3];
+			if (versionRevision == "") {
+				versionRevision = descArray[4];
+			}
+			if (versionRevision[0] == "d") {
+				versionRevision = versionRevision.substring(1);
+			} else if (versionRevision[0] == "r") {
+				versionRevision = versionRevision.substring(1);
+				if (versionRevision.indexOf("d") > 0) {
+					versionRevision = versionRevision.substring(0, versionRevision.indexOf("d"));
+				}
+			}
+			var flashVer = versionMajor + "." + versionMinor + "." + versionRevision;
+		}
+	}
+	// MSN/WebTV 2.6 supports Flash 4
+	else if (navigator.userAgent.toLowerCase().indexOf("webtv/2.6") != -1) flashVer = 4;
+	// WebTV 2.5 supports Flash 3
+	else if (navigator.userAgent.toLowerCase().indexOf("webtv/2.5") != -1) flashVer = 3;
+	// older WebTV supports Flash 2
+	else if (navigator.userAgent.toLowerCase().indexOf("webtv") != -1) flashVer = 2;
+	else if ( isIE && isWin && !isOpera ) {
+		flashVer = ControlVersion();
+	}	
+	return flashVer;
+}
+
+// When called with reqMajorVer, reqMinorVer, reqRevision returns true if that version or greater is available
+function DetectFlashVer(reqMajorVer, reqMinorVer, reqRevision)
+{
+	versionStr = GetSwfVer();
+	if (versionStr == -1 ) {
+		return false;
+	} else if (versionStr != 0) {
+		if(isIE && isWin && !isOpera) {
+			// Given "WIN 2,0,0,11"
+			tempArray         = versionStr.split(" "); 	// ["WIN", "2,0,0,11"]
+			tempString        = tempArray[1];			// "2,0,0,11"
+			versionArray      = tempString.split(",");	// ['2', '0', '0', '11']
+		} else {
+			versionArray      = versionStr.split(".");
+		}
+		var versionMajor      = versionArray[0];
+		var versionMinor      = versionArray[1];
+		var versionRevision   = versionArray[2];
+
+        	// is the major.revision >= requested major.revision AND the minor version >= requested minor
+		if (versionMajor > parseFloat(reqMajorVer)) {
+			return true;
+		} else if (versionMajor == parseFloat(reqMajorVer)) {
+			if (versionMinor > parseFloat(reqMinorVer))
+				return true;
+			else if (versionMinor == parseFloat(reqMinorVer)) {
+				if (versionRevision >= parseFloat(reqRevision))
+					return true;
+			}
+		}
+		return false;
+	}
+}
+
+function AC_AddExtension(src, ext)
+{
+  if (src.indexOf('?') != -1)
+    return src.replace(/\?/, ext+'?'); 
+  else
+    return src + ext;
+}
+
+function AC_Generateobj(objAttrs, params, embedAttrs) 
+{ 
+  var str = '';
+  if (isIE && isWin && !isOpera)
+  {
+    str += '<object ';
+    for (var i in objAttrs)
+    {
+      str += i + '="' + objAttrs[i] + '" ';
+    }
+    str += '>';
+    for (var i in params)
+    {
+      str += '<param name="' + i + '" value="' + params[i] + '" /> ';
+    }
+    str += '</object>';
+  }
+  else
+  {
+    str += '<embed ';
+    for (var i in embedAttrs)
+    {
+      str += i + '="' + embedAttrs[i] + '" ';
+    }
+    str += '> </embed>';
+  }
+
+  document.write(str);
+}
+
+function AC_FL_RunContent(){
+  var ret = 
+    AC_GetArgs
+    (  arguments, ".swf", "movie", "clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
+     , "application/x-shockwave-flash"
+    );
+  AC_Generateobj(ret.objAttrs, ret.params, ret.embedAttrs);
+}
+
+function AC_SW_RunContent(){
+  var ret = 
+    AC_GetArgs
+    (  arguments, ".dcr", "src", "clsid:166B1BCA-3F9C-11CF-8075-444553540000"
+     , null
+    );
+  AC_Generateobj(ret.objAttrs, ret.params, ret.embedAttrs);
+}
+
+function AC_GetArgs(args, ext, srcParamName, classid, mimeType){
+  var ret = new Object();
+  ret.embedAttrs = new Object();
+  ret.params = new Object();
+  ret.objAttrs = new Object();
+  for (var i=0; i < args.length; i=i+2){
+    var currArg = args[i].toLowerCase();    
+
+    switch (currArg){	
+      case "classid":
+        break;
+      case "pluginspage":
+        ret.embedAttrs[args[i]] = args[i+1];
+        break;
+      case "src":
+      case "movie":	
+        args[i+1] = AC_AddExtension(args[i+1], ext);
+        ret.embedAttrs["src"] = args[i+1];
+        ret.params[srcParamName] = args[i+1];
+        break;
+      case "onafterupdate":
+      case "onbeforeupdate":
+      case "onblur":
+      case "oncellchange":
+      case "onclick":
+      case "ondblclick":
+      case "ondrag":
+      case "ondragend":
+      case "ondragenter":
+      case "ondragleave":
+      case "ondragover":
+      case "ondrop":
+      case "onfinish":
+      case "onfocus":
+      case "onhelp":
+      case "onmousedown":
+      case "onmouseup":
+      case "onmouseover":
+      case "onmousemove":
+      case "onmouseout":
+      case "onkeypress":
+      case "onkeydown":
+      case "onkeyup":
+      case "onload":
+      case "onlosecapture":
+      case "onpropertychange":
+      case "onreadystatechange":
+      case "onrowsdelete":
+      case "onrowenter":
+      case "onrowexit":
+      case "onrowsinserted":
+      case "onstart":
+      case "onscroll":
+      case "onbeforeeditfocus":
+      case "onactivate":
+      case "onbeforedeactivate":
+      case "ondeactivate":
+      case "type":
+      case "codebase":
+      case "id":
+        ret.objAttrs[args[i]] = args[i+1];
+        break;
+      case "width":
+      case "height":
+      case "align":
+      case "vspace": 
+      case "hspace":
+      case "class":
+      case "title":
+      case "accesskey":
+      case "name":
+      case "tabindex":
+        ret.embedAttrs[args[i]] = ret.objAttrs[args[i]] = args[i+1];
+        break;
+      default:
+        ret.embedAttrs[args[i]] = ret.params[args[i]] = args[i+1];
+    }
+  }
+  ret.objAttrs["classid"] = classid;
+  if (mimeType) ret.embedAttrs["type"] = mimeType;
+  return ret;
+}