ziya 1.0.0 → 2.0.0

data/lib/ziya/gauges/radial.rb

@@ -0,0 +1,18 @@
+# -----------------------------------------------------------------------------
+# Abstract class representing a radial based gauge
+#
+# Author: Fernand
+# -----------------------------------------------------------------------------
+module Ziya::Gauges
+  class Radial < Base
+    
+    # =========================================================================
+    protected
+
+    # converts degrees to radiants    
+  	def deg2rad( degrees )
+  	  degrees * Math::PI / 180
+  	end
+
+  end
+end

data/lib/ziya/gauges/signal.rb

@@ -0,0 +1,138 @@
+# -----------------------------------------------------------------------------
+# Meter gauge 
+#
+# Records current value from 0..10 and variance of changes of value between
+# ticks.
+#
+# Author: Fernand
+# -----------------------------------------------------------------------------
+module Ziya::Gauges
+  class Signal < Radial
+  
+    # -------------------------------------------------------------------------
+    # ctor
+    def initialize( license, design_id="signal" )
+      super( license, design_id )
+      options[:delta] = options[:signal] - options[:previous]      
+    end
+
+    # -------------------------------------------------------------------------
+    # set signal prefs  
+    def set_preferences( opts={} )
+      super( opts )
+      options[:delta] = options[:signal] - options[:previous]
+    end
+  
+    # =========================================================================
+    protected
+        
+      # -----------------------------------------------------------------------
+      # setup signal gauge default options
+      def default_options
+        { 
+          :x            => 20,
+          :y            => 20,
+          :signal       => 5,
+          :previous     => 0,
+          :average      => nil,
+          :gauge_colors => %w[17ff00 49ff00 7cff00 aeff00 e1ff00 ffea00 ffb700 ff8300 ff5000 ff1c00 ff0000]
+        }
+      end
+
+    # =========================================================================
+    private    
+    
+      # draws signal polygons
+      def signal_indicator( x, y, radius, width, length, start_angle, end_angle, tick_count, thickness, color )
+        buff  = []
+        rank  = options[:signal]
+        avg   = options[:average]
+        i     = start_angle    
+        j     = start_angle + width
+        count = 1
+        while( i < end_angle ) do      
+          fill_alpha = (rank < count) ? 40 : 100
+          fill_color = colorizer( rank )      
+          if ( avg and avg == count )
+            fill_color = "0CFF00"
+            fill_alpha = 70
+          end
+          x1, y1 = x+Math::sin(deg2rad(i))*(radius)       , y-Math::cos(deg2rad(i))*(radius)
+          x2, y2 = x+Math::sin(deg2rad(i))*(radius+length), y-Math::cos(deg2rad(i))*(radius+length)
+          x3, y3 = x+Math::sin(deg2rad(j))*(radius+length), y-Math::cos(deg2rad(j))*(radius+length)           
+          x4, y4 = x+Math::sin(deg2rad(j))*(radius)       , y-Math::cos(deg2rad(j))*(radius)
+      
+          polygon = Ziya::Gauges::Support::Polygon.new( 
+            :fill_color => fill_color, :fill_alpha => fill_alpha,
+            :line_color => fill_color, :line_alpha => fill_alpha,
+            :components => YAML::Omap[
+              "rpt_#{count}_1".to_sym, Ziya::Gauges::Support::Point.new( :x => x1, :y => y1 ),
+              "rpt_#{count}_2".to_sym, Ziya::Gauges::Support::Point.new( :x => x2, :y => y2 ),
+              "rpt_#{count}_3".to_sym, Ziya::Gauges::Support::Point.new( :x => x3, :y => y3 ),
+              "rpt_#{count}_4".to_sym, Ziya::Gauges::Support::Point.new( :x => x4, :y => y4 )
+            ]
+          )
+          # dump polygon to yaml rep
+          buff << "#{indent}#{polygon.to_comp_yaml( "r_poly_#{count}", 2 )}"              
+          i += (end_angle-start_angle)/(tick_count)
+          j = i + width
+          count += 1
+        end
+        buff.join( "\n" )
+    	end
+
+      # -----------------------------------------------------------------------
+      # draws signal change indicator
+      def delta_indicator( x, y )
+        buff        = []
+        fill_color  = 'ff0000'
+        fill_alpha  = 50
+        spacer      = 10.0
+        height      = 7.0
+        start       = y
+        fill_alphas = calc_change_alpha( options[:delta] )
+        6.times do |i|
+          fill_color = ( i < 3 ) ? 'ff0000' : '00ff00'
+          fill_alpha = fill_alphas[i]
+                        
+          x1, y1 = x, start
+          if i < 3
+            x2, y2 = x+height/2, start-height
+          else
+            x2, y2 = x+height/2, start+height
+          end
+          x3, y3 = x+height, start
+      
+          polygon = Ziya::Gauges::Support::Polygon.new( 
+            :fill_color => fill_color, :fill_alpha => fill_alpha,
+            :line_color => fill_color, :line_alpha => fill_alpha,
+            :components => YAML::Omap[
+              "mpt_#{i}_1".to_sym, Ziya::Gauges::Support::Point.new( :x => x1, :y => y1 ),
+              "mpt_#{i}_2".to_sym, Ziya::Gauges::Support::Point.new( :x => x2, :y => y2 ),
+              "mpt_#{i}_3".to_sym, Ziya::Gauges::Support::Point.new( :x => x3, :y => y3 )
+            ]
+          )       
+          buff << "#{indent}#{polygon.to_comp_yaml( "m_poly_#{i}", 2 )}"    
+          start += (i+1) == 3 ? 5 : spacer
+        end
+        buff.join( "\n" )
+      end
+
+      # calculates the change delta for this one to previous
+      def calc_change_alpha( change )
+        alphas = []
+        indexes = case change.abs
+          when 0..1   : change >= 0 ? [2] : [3]
+          when 1..5   : change >= 0 ? [1, 2] : [3,4]
+          when 5...10 : change >= 0 ? [0, 1, 2] : [3,4,5]
+        end
+        6.times { |i| alphas[i] = indexes.include?(i) ? 100 : 10 }
+        alphas
+      end
+
+      # colororize color wheel
+      def colorizer( rank )
+        options[:gauge_colors][rank]
+      end
+  end
+end

data/lib/ziya/gauges/support/area.rb

@@ -0,0 +1,13 @@
+# -----------------------------------------------------------------------------

+# Draws a clickable area for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Area < Base  
+    has_attribute :x, :y, :width, :height, :url, :target, :text, :font, :bold, :size,
+                  :color, :background_color, :alpha, :stop_sound
+  end
+end

data/lib/ziya/gauges/support/base.rb

@@ -0,0 +1,33 @@
+module Ziya::Gauges::Support
+  class Base < Ziya::Components::Base
+    include Ziya::Helpers::BaseHelper
+    
+    # -----------------------------------------------------------------------
+    # converts component to yaml style component for yaml parser consumption
+    def to_comp_yaml( name, indent_multiplier=1 )
+      buff = []
+      tab  = indent( indent_multiplier )
+      buff << "#{dial( demodulize( self.class.name ), name )}"
+      options.each_pair do |k,v|
+        if v.is_a? YAML::Omap
+          buff << "#{tab}#{indent}#{dials}"
+          v.each do |name, comp|
+            buff << "#{tab}#{indent(2)}#{dial( demodulize(comp.class.name), name )}"
+            comp.options.each_pair { |k,v| buff << "#{tab}#{indent(4)}#{k}: #{v}"}
+          end          
+        else
+          buff << "#{tab}#{indent(1)}#{k}: #{v}" if options[k] and !options[k].to_s.empty?
+        end
+      end
+    
+      # if ( self.respond_to? :dials )
+      #   buff << "#{tab}dials:"
+      #   for dial in dials do
+      #     buff << "#{tab}#{dial( demodulize( dial.class.name ) )}"
+      #     dial.options.each_pair { |k,v| buff << "#{tab}#{tab}#{k}: #{v}"}
+      #   end
+      # end
+      buff.join( "\n" )
+    end        
+  end
+end

data/lib/ziya/gauges/support/circle.rb

@@ -0,0 +1,14 @@
+# -----------------------------------------------------------------------------

+# Draws a circle for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Circle < Base  
+    has_attribute :x, :y, :radius, :start, :end,
+                  :fill_color, :fill_alpha, :line_color, :line_alpha,
+                  :line_thickness              
+  end
+end

data/lib/ziya/gauges/support/design.rb

@@ -0,0 +1,5 @@
+module Ziya::Gauges::Support
+  class Design < Base
+    has_attribute :components
+  end
+end

data/lib/ziya/gauges/support/image.rb

@@ -0,0 +1,12 @@
+# -----------------------------------------------------------------------------

+# Draws an image for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Image < Base  
+    has_attribute :url, :x, :y, :width, :height, :rotation, :alpha, :retry, :timeout
+  end
+end

data/lib/ziya/gauges/support/line.rb

@@ -0,0 +1,12 @@
+# -----------------------------------------------------------------------------

+# Draws a line for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Line < Base  
+    has_attribute :x1, :y1, :x2, :y2, :color, :alpha, :thickness
+  end
+end

data/lib/ziya/gauges/support/link.rb

@@ -0,0 +1,24 @@
+# -----------------------------------------------------------------------------

+# Create a link on a component
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Link < Base  
+    has_attribute :components
+    
+    # has_attribute :areas
+    # attr_accessor :areas
+
+    # -------------------------------------------------------------------------
+    # Dump has_attribute into xml element
+    # def flatten( xml )      
+    #   xml.link do  
+    #     areas.each { |area| area.flatten( xml ) } if areas and !areas.empty?
+    #   end
+    # end
+                  
+  end  
+end

data/lib/ziya/gauges/support/move.rb

@@ -0,0 +1,15 @@
+# -----------------------------------------------------------------------------

+# Create an animation to move a component
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Move < Base  
+    has_attribute :start_x_offset, :start_y_offset, :end_x_offset, :end_y_offset, :step, 
+                  :shake_span, :shake_frequency, :shake_snap,
+                  :shadow_alpha, :shadow_x_offset, :shadow_y_offset, 
+                  :components
+  end  
+end

data/lib/ziya/gauges/support/point.rb

@@ -0,0 +1,12 @@
+# -----------------------------------------------------------------------------

+# Draws a point for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Point < Base  
+    has_attribute :x, :y
+  end
+end

data/lib/ziya/gauges/support/polygon.rb

@@ -0,0 +1,13 @@
+# -----------------------------------------------------------------------------

+# Draws a polygon for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Polygon < Base  
+    has_attribute :fill_color, :fill_alpha, :line_color, :line_alpha, 
+                  :line_thickness, :components              
+  end
+end

data/lib/ziya/gauges/support/radial_base.rb

@@ -0,0 +1,21 @@
+# -----------------------------------------------------------------------------

+# Draws things in a circular layout. This is an abstract class and should not
+# be used directly.
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class RadialBase < Base  
+    has_attribute :x, :y, :radius, :start_angle, :end_angle, :ticks, :color, :alpha
+    
+    # =========================================================================
+    protected
+    
+      # converts degrees to radiant
+      def deg2rad( degrees )
+        degrees * Math::PI / 180
+      end
+  end
+end  

data/lib/ziya/gauges/support/radial_numbers.rb

@@ -0,0 +1,41 @@
+# -----------------------------------------------------------------------------

+# Draws a set of numbers in a circular layout
+#
+# BOZO !! use components to render ??
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/radial_base'
+
+module Ziya::Gauges::Support
+  class RadialNumbers < RadialBase  
+    has_attribute :start_num, :end_num, 
+                  :font, :size, :bold, :width, :height, :align
+
+    # overrides flatten to generate a series of radial tick marksß
+    def flatten( xml )
+      number = start_num
+      i      = start_angle
+      while( i <= end_angle ) do
+        angle = deg2rad( i )
+        hash = { :x         => (x + Math::sin( angle ) * radius).to_i,
+                 :y         => (y - Math::cos( angle ) * radius).to_i,
+                 :width     => width ||  20,
+                 :height    => height || 20,
+                 :font      => font || "Arial",
+                 :size      => size || 10,
+                 :bold      => bold || true,
+                 :alpha     => alpha,                 
+                 :rotation  => i, 
+                 :align     => align || "left",
+                 :color     => color }
+        xml.text( hash ) do
+          xml.text! number.to_s
+        end
+        i      += (end_angle-start_angle)/(ticks-1)
+        number += (end_num-start_num)/(ticks-1)
+      end
+    end      
+        
+  end
+end  

data/lib/ziya/gauges/support/radial_ticks.rb

@@ -0,0 +1,29 @@
+# -----------------------------------------------------------------------------

+# Draws a circle with ticks
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/radial_base'
+
+module Ziya::Gauges::Support
+  class RadialTicks < RadialBase  
+    has_attribute :length, :thickness
+
+    # overrides flatten to generate a series of radial tick marks
+    def flatten( xml )
+      i = start_angle   
+      while( i <= end_angle ) do
+        angle = deg2rad( i )
+        hash = { :x1        => (x + Math::sin( angle ) * radius).to_i,
+                 :y1        => (y - Math::cos( angle ) * radius).to_i,
+                 :x2        => (x + Math::sin( angle ) * (radius + length)).to_i,
+                 :y2        => (y - Math::cos( angle ) * (radius + length)).to_i,
+                 :thickness => thickness,
+                 :color     => color }
+        xml.line( hash )
+        i += (end_angle-start_angle)/(ticks-1)
+      end
+    end
+    
+  end
+end

data/lib/ziya/gauges/support/rect.rb

@@ -0,0 +1,14 @@
+# -----------------------------------------------------------------------------

+# Draws a rectangle for a gauge
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Rect < Base  
+    has_attribute :x, :y, :width, :height, :rotation,
+                  :fill_color, :fill_alpha, :line_color, :line_alpha,
+                  :line_thickness              
+  end
+end

data/lib/ziya/gauges/support/rotate.rb

@@ -0,0 +1,15 @@
+# -----------------------------------------------------------------------------

+# Create an animation to rotate a component
+#
+# Author:: Fernand Galiana
+# -----------------------------------------------------------------------------
+require 'ziya/gauges/support/base'
+
+module Ziya::Gauges::Support
+  class Rotate < Base  
+    has_attribute :x, :y, :start, :step, :span, 
+                  :shake_span, :shake_frequency, :shake_snap,
+                  :shadow_alpha, :shadow_x_offset, :shadow_y_offset, 
+                  :components
+  end  
+end