ambling 0.0.1

data/lib/ambling/utils.rb

@@ -0,0 +1,120 @@
+# Utility methods
+require 'active_support'
+
+module Ambling #:nodoc
+  # Utility methods when generating the settings classes from the XML
+  module Utils
+    # Stores information about the settings as derived from the XML
+    class SettingsSection
+      attr_accessor :key, :comment, :values, :attributes
+      
+      def initialize(key, attributes=[])
+        @key = key
+        @comment = ""
+        @values = ActiveSupport::OrderedHash.new
+        @attributes = attributes
+      end
+      
+      def inspect
+        "<SettingsSection [:key => #{@key}, :comment => #{@comment.inspect}, :values => #{@values.inspect}, :attributes => #{@attributes.inspect}]"
+      end
+      
+      # Generate the class code
+      def to_class_s(indent = 0)
+        cdef = "\n#\n"
+        cdef << @comment.split(/\n/).map {|l| "# #{l.strip}"}.join("\n") << "\n"
+        cdef << "#\nclass #{key.camelize}\n"
+        cbody = "\ninclude Base\n\n"
+        cbody << "VALUES = [#{@values.keys.collect {|k| ':' + k}.join(',')}]\n"
+        cbody << "ATTRIBUTES = [#{@attributes.collect {|k| ':' + k}.join(',')}]\n" if !@attributes.empty?
+        subclasses = []
+        @values.each do |k,v|
+          cbody << "#\n"
+          cbody << v.comment.split(/\n/).map {|l| "# #{l}"}.join("\n") << "\n"
+          cbody << "#\nattr_accessor :#{k}\n\n"
+          subclasses << v if not v.values.empty?
+        end
+        @attributes.each do |a|
+          cbody << "#\n# xml attribute\n#\nattr_accessor :#{a}\n\n"
+        end
+        subclasses.each do |sc|
+          cbody << sc.to_class_s
+        end
+        indent(cdef, indent) + indent(cbody, indent + 2) + indent("\nend\n", indent)
+      end
+      
+      # Indent the str n spaces
+      def indent(str, n)
+        str.split(/\n/).collect {|s| spaces(n) + s}.join("\n")
+      end
+      
+      # Generate n spaces
+      def spaces(n)
+        " " * n
+      end
+    end
+    #
+    # generate a ruby class from the amchart settings XML
+    class SettingsGenerator
+      # Turn the provided xml into a class for chart_type
+      def generate(chart_type, xml)
+        require 'xmlparser'
+        @parser=XML::Parser.new
+        class <<@parser
+          # enable additional events
+          attr_accessor :comment, :xmlDecl
+        end
+        
+        current_section_data = section_data = SettingsSection.new("xml")
+        section_data_stack = []
+        current_element = nil
+        last_element = nil
+        # Sam Ruby has code that does something very much like this
+        @parser.parse(xml) do |type, name, data|
+          case type
+          when XML::Parser::START_ELEM
+            # name = element name  ; data = hash of attributes
+            if not current_section_data.values[name]
+              current_section_data.values[name] = SettingsSection.new(name, data ? data.keys : [])
+            end
+            section_data_stack << current_section_data
+            current_section_data = current_section_data.values[name]
+            current_element = name
+            last_element = nil
+          when XML::Parser::END_ELEM
+            # name = element name  ; data = nil
+            end_section_data = current_section_data
+            current_section_data = section_data_stack.pop
+            last_element = current_element
+            current_element = nil
+          when XML::Parser::COMMENT                           
+            # name = nil           ; data = string
+            if current_section_data.values.empty?
+              current_section_data.comment = data
+            else
+              if current_section_data.values[last_element]
+                current_section_data.values[last_element].comment = data
+              end
+            end
+          end
+        end
+        
+        top_level = section_data.values.first.last
+        top_level.comment = section_data.comment if top_level.comment.blank?
+        
+        cdef = "# Auto generated from XML file\n"
+        cdef << "require 'ambling/base'\nmodule Ambling\n  class #{chart_type.to_s.camelize}\n"
+        cdef << top_level.to_class_s(4)
+        cdef << "\n  end\nend\n"
+      end
+    end
+  end
+end
+
+if __FILE__ == $0
+  if 2 != ARGV.size
+    STDERR.puts "Usage: #{$0} chart_type settings.xml"
+    exit(2)
+  end
+  puts Ambling::Utils::SettingsGenerator.new.generate(ARGV.first, File.read(ARGV.last))
+end

data/lib/ambling/version.rb

@@ -0,0 +1,3 @@
+module Ambling
+  VERSION = "0.0.1"
+end

data/lib/ambling/xy.rb

@@ -0,0 +1,1511 @@
+# Auto generated from XML file
+require 'ambling/base'
+module Ambling
+  class Xy
+    
+    #
+    # "!" before x or y position (for example: <x>!20</x>) means that the coordinate will be calculated from the right side or the bottom 
+    #
+    class Settings      
+      include Base
+      
+      VALUES = [:data_type,:csv_separator,:skip_rows,:font,:text_size,:text_color,:decimals_separator,:thousands_separator,:digits_after_decimal,:redraw,:reload_data_interval,:preloader_on_reload,:add_time_stamp,:depth,:angle,:link_target,:mask,:colors,:background,:plot_area,:grid,:values,:axes,:date_formats,:balloon,:bullets,:scroller,:zoom,:help,:legend,:export_as_image,:error_messages,:strings,:context_menu,:labels,:graphs]
+      #
+      #  [xml] (xml / csv) 
+      #
+      attr_accessor :data_type
+      
+      #
+      #  [;] (string) csv file data separator (you need it only if you are using csv file for your data) 
+      #
+      attr_accessor :csv_separator
+      
+      #
+      #  [0] (Number) if you are using csv data type, you can set the number of rows which should be skipped here 
+      #
+      attr_accessor :skip_rows
+      
+      #
+      #  [Arial] (font name) use device fonts, such as Arial, Times New Roman, Tahoma, Verdana... 
+      #
+      attr_accessor :font
+      
+      #
+      #  [11] (Number) text size of all texts. Every text size can be set individually in the settings below 
+      #
+      attr_accessor :text_size
+      
+      #
+      #  [#000000] (hex color code) main text color. Every text color can be set individually in the settings below
+      #
+      attr_accessor :text_color
+      
+      #
+      #  [,] (string) decimal separator. Note, that this is for displaying data only. Decimals in data xml file must be separated with a dot 
+      #
+      attr_accessor :decimals_separator
+      
+      #
+      #  [ ] (string) thousand separator. use "none" if you don't want to separate 
+      #
+      attr_accessor :thousands_separator
+      
+      #
+      #  [] (Number) if your value has less digits after decimal then is set here, zeroes will be added 
+      #
+      attr_accessor :digits_after_decimal
+      
+      #
+      #  [false] (true / false) if your chart's width or height is set in percents, and redraw is set to true, the chart will be redrawn then screen size changes 
+      #
+      attr_accessor :redraw
+      
+      #
+      #  [0] (Number) how often data should be reloaded (time in seconds) 
+      #
+      attr_accessor :reload_data_interval
+      
+      #
+      #  [false] (true / false) Whether to show preloaded when data or settings are reloaded 
+      #
+      attr_accessor :preloader_on_reload
+      
+      #
+      #  [false] (true / false) if true, a unique number will be added every time flash loads data. Mainly this feature is useful if you set reload _data_interval 
+      #
+      attr_accessor :add_time_stamp
+      
+      #
+      #  [0] (Number) the depth of chart and columns (for 3D effect) 
+      #
+      attr_accessor :depth
+      
+      #
+      #  [30] (0 - 90) angle of chart area and columns (for 3D effect) 
+      #
+      attr_accessor :angle
+      
+      #
+      #  [] (_blank, _top ...) 
+      #
+      attr_accessor :link_target
+      
+      #
+      #  [true] if true, bubbles, data labels will be masked within plot area. If the <zoom> is enabled, this setting is always "true" 
+      #
+      attr_accessor :mask
+      
+      #
+      #  [#FF6600,#FCD202,#B0DE09,#0D8ECF,#2A0CD0,#CD0D74,#CC0000,#00CC00,#0000CC,#DDDDDD,#999999,#333333,#990000] Colors of graphs. if the graph color is not set, color from this array will be used 
+      #
+      attr_accessor :colors
+      
+      #
+      #  BACKGROUND 
+      #
+      attr_accessor :background
+      
+      #
+      #  PLOT AREA (the area between axes) 
+      #
+      attr_accessor :plot_area
+      
+      #
+      #  GRID 
+      #
+      attr_accessor :grid
+      
+      #
+      #  VALUES 
+      #
+      attr_accessor :values
+      
+      #
+      #  axes 
+      #
+      attr_accessor :axes
+      
+      #
+      #  these settings are important only if your axis type is date or duration 
+      #
+      attr_accessor :date_formats
+      
+      #
+      #  BALLOON 
+      #
+      attr_accessor :balloon
+      
+      #
+      # 
+      #
+      attr_accessor :bullets
+      
+      #
+      # 
+      #
+      attr_accessor :scroller
+      
+      #
+      # 
+      #
+      attr_accessor :zoom
+      
+      #
+      #  HELP button and balloon 
+      #
+      attr_accessor :help
+      
+      #
+      #  LEGEND 
+      #
+      attr_accessor :legend
+      
+      #
+      #  export_as_image feature works only on a web server 
+      #
+      attr_accessor :export_as_image
+      
+      #
+      #  "error_messages" settings will be applied for all error messages except the one which is showed if settings file wasn't found 
+      #
+      attr_accessor :error_messages
+      
+      #
+      # 
+      #
+      attr_accessor :strings
+      
+      #
+      #  <menu function_name="printChart" title="Print chart"></menu> 
+      #
+      attr_accessor :context_menu
+      
+      #
+      #  labels can also be added in data xml file, using exactly the same structure like it is here 
+      #
+      attr_accessor :labels
+      
+      #
+      #  if graph settings are defined both here and in data file, the ones from data file are used 
+      #
+      attr_accessor :graphs
+      
+      
+      #
+      # BACKGROUND 
+      #
+      class Background  
+        include Base
+        
+        VALUES = [:color,:alpha,:border_color,:border_alpha,:file]
+        #
+        #  [#FFFFFF] (hex color code) Separate color codes with comas for gradient 
+        #
+        attr_accessor :color
+        
+        #
+        #  [0] (0 - 100) use 0 if you are using custom swf or jpg for background 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#000000] (hex color code) 
+        #
+        attr_accessor :border_color
+        
+        #
+        #  [0] (0 - 100) 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  The chart will look for this file in "path" folder ("path" is set in HTML) 
+        #
+        attr_accessor :file
+      end
+      #
+      # PLOT AREA (the area between axes) 
+      #
+      class PlotArea  
+        include Base
+        
+        VALUES = [:color,:alpha,:border_color,:border_alpha,:margins]
+        #
+        #  [#FFFFFF](hex color code) Separate color codes with comas for gradient 
+        #
+        attr_accessor :color
+        
+        #
+        #  [0] (0 - 100) if you want it to be different than background color, use bigger than 0 value 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#000000] (hex color code) 
+        #
+        attr_accessor :border_color
+        
+        #
+        #  [0] (0 - 100) 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  plot area margins 
+        #
+        attr_accessor :margins
+        
+        
+        #
+        # plot area margins 
+        #
+        class Margins  
+          include Base
+          
+          VALUES = [:left,:top,:right,:bottom]
+          #
+          #  [60](Number) 
+          #
+          attr_accessor :left
+          
+          #
+          #  [60](Number) 
+          #
+          attr_accessor :top
+          
+          #
+          #  [60](Number) 
+          #
+          attr_accessor :right
+          
+          #
+          #  [80](Number) 
+          #
+          attr_accessor :bottom
+        end
+      end
+      #
+      # GRID 
+      #
+      class Grid  
+        include Base
+        
+        VALUES = [:x,:y]
+        #
+        #  x axis grid 
+        #
+        attr_accessor :x
+        
+        #
+        #  y axis grid 
+        #
+        attr_accessor :y
+        
+        
+        #
+        # x axis grid 
+        #
+        class X  
+          include Base
+          
+          VALUES = [:color,:alpha,:dashed,:dash_length,:approx_count,:fill_color,:fill_alpha]
+          #
+          #  [#000000] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [15] (0 - 100) 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [false] (true / false) 
+          #
+          attr_accessor :dashed
+          
+          #
+          #  [5] (Number) 
+          #
+          attr_accessor :dash_length
+          
+          #
+          #  [10] (Number) approximate number of gridlines 
+          #
+          attr_accessor :approx_count
+          
+          #
+          #  [#FFFFFF] (hex color code) every second area between gridlines will be filled with this color (you will need to set fill_alpha > 0) 
+          #
+          attr_accessor :fill_color
+          
+          #
+          #  [0] (0 - 100) opacity of fill 
+          #
+          attr_accessor :fill_alpha
+        end
+        #
+        # y axis grid 
+        #
+        class Y  
+          include Base
+          
+          VALUES = [:color,:enabled,:alpha,:dashed,:dash_length,:approx_count,:fill_color,:fill_alpha]
+          #
+          #  [#000000] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [true] (true / false) 
+          #
+          attr_accessor :enabled
+          
+          #
+          #  [15] (0 - 100) 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [false] (true / false) 
+          #
+          attr_accessor :dashed
+          
+          #
+          #  [5] (Number) 
+          #
+          attr_accessor :dash_length
+          
+          #
+          #  [10] (Number) approximate number of gridlines 
+          #
+          attr_accessor :approx_count
+          
+          #
+          #  [#FFFFFF] (hex color code) every second area between gridlines will be filled with this color (you will need to set fill_alpha > 0) 
+          #
+          attr_accessor :fill_color
+          
+          #
+          #  [0] (0 - 100) opacity of fill 
+          #
+          attr_accessor :fill_alpha
+        end
+      end
+      #
+      # VALUES 
+      #
+      class Values  
+        include Base
+        
+        VALUES = [:x,:y]
+        #
+        #  x axis 
+        #
+        attr_accessor :x
+        
+        #
+        #  y axis 
+        #
+        attr_accessor :y
+        
+        
+        #
+        # x axis 
+        #
+        class X  
+          include Base
+          
+          VALUES = [:enabled,:type,:reverse,:min,:max,:strict_min_max,:frequency,:rotate,:skip_first,:skip_last,:color,:text_size,:unit,:unit_position,:integers_only,:inside]
+          #
+          #  [true] (true / false) 
+          #
+          attr_accessor :enabled
+          
+          #
+          #  "date" means that your axis will display dates (you must specify date formats in <date_formats>) 
+          #
+          attr_accessor :type
+          
+          #
+          #  [false] (true / false) whether to reverse this axis values or not. If set to true, values will start from biggest number and will end with a smallest number 
+          #
+          attr_accessor :reverse
+          
+          #
+          #  [] (Number) minimum value of this axis. If empty, this value will be calculated automatically. 
+          #
+          attr_accessor :min
+          
+          #
+          #  [] (Number) maximum value of this axis. If empty, this value will be calculated automatically 
+          #
+          attr_accessor :max
+          
+          #
+          #  [false] (true / false) by default, if your values are bigger then defined max (or smaller then defined min), max and min is changed so that all the chart would fit to chart area. If you don't want this, set this option to true. 
+          #
+          attr_accessor :strict_min_max
+          
+          #
+          #  [1] (Number) how often values should be placed, 1 - near every gridline, 2 - near every second gridline... 
+          #
+          attr_accessor :frequency
+          
+          #
+          #  [0] (0 - 90) angle of rotation. If you want to rotate by degree from 1 to 89, you must have font.swf file in fonts folder 
+          #
+          attr_accessor :rotate
+          
+          #
+          #  [true] (true / false) to skip or not first value 
+          #
+          attr_accessor :skip_first
+          
+          #
+          #  [false] (true / false) to skip or not last value 
+          #
+          attr_accessor :skip_last
+          
+          #
+          #  [text_color] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [text_size] (Number) 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [] (text) 
+          #
+          attr_accessor :unit
+          
+          #
+          #  [right] (right / left) 
+          #
+          attr_accessor :unit_position
+          
+          #
+          #  [false] (true / false) if set to true, values with decimals will be omitted 
+          #
+          attr_accessor :integers_only
+          
+          #
+          #  [false] (true / false) if set to true, axis values will be displayed inside plot area. This setting will not work for values rotated by 1-89 degrees (0 and 90 only) 
+          #
+          attr_accessor :inside
+        end
+        #
+        # y axis 
+        #
+        class Y  
+          include Base
+          
+          VALUES = [:enabled,:type,:reverse,:min,:max,:strict_min_max,:frequency,:rotate,:skip_first,:skip_last,:color,:text_size,:unit,:unit_position,:integers_only,:inside]
+          #
+          #  [true] (true / false) 
+          #
+          attr_accessor :enabled
+          
+          #
+          #  "date" means that your axis will display dates (you must specify date formats in <date_formats>) 
+          #
+          attr_accessor :type
+          
+          #
+          #  [false] (true / false) whether to reverse this axis values or not. If set to true, values will start from biggest number and will end with a smallest number 
+          #
+          attr_accessor :reverse
+          
+          #
+          #  [] (Number) minimum value of this axis. If empty, this value will be calculated automatically. 
+          #
+          attr_accessor :min
+          
+          #
+          #  [] (Number) maximum value of this axis. If empty, this value will be calculated automatically 
+          #
+          attr_accessor :max
+          
+          #
+          #  [false] (true / false) by default, if your values are bigger then defined max (or smaller then defined min), max and min is changed so that all the chart would fit to chart area. If you don't want this, set this option to true. 
+          #
+          attr_accessor :strict_min_max
+          
+          #
+          #  [1] (Number) how often values should be placed, 1 - near every gridline, 2 - near every second gridline... 
+          #
+          attr_accessor :frequency
+          
+          #
+          #  [0] (0 - 90) angle of rotation. If you want to rotate by degree from 1 to 89, you must have font.swf file in fonts folder 
+          #
+          attr_accessor :rotate
+          
+          #
+          #  [true] (true / false) to skip or not first value 
+          #
+          attr_accessor :skip_first
+          
+          #
+          #  [false] (true / false) to skip or not last value 
+          #
+          attr_accessor :skip_last
+          
+          #
+          #  [text_color] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [text_size] (Number) 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [] (text) 
+          #
+          attr_accessor :unit
+          
+          #
+          #  [right] (right / left) 
+          #
+          attr_accessor :unit_position
+          
+          #
+          #  [false] (true / false) if set to true, values with decimals will be omitted 
+          #
+          attr_accessor :integers_only
+          
+          #
+          #  [false] (true / false) if set to true, axis values will be displayed inside plot area. This setting will not work for values rotated by 1-89 degrees (0 and 90 only) 
+          #
+          attr_accessor :inside
+        end
+      end
+      #
+      # axes 
+      #
+      class Axes  
+        include Base
+        
+        VALUES = [:x,:y]
+        #
+        #  x axis 
+        #
+        attr_accessor :x
+        
+        #
+        #  y axis 
+        #
+        attr_accessor :y
+        
+        
+        #
+        # x axis 
+        #
+        class X  
+          include Base
+          
+          VALUES = [:color,:alpha,:width,:tick_length,:logarithmic]
+          #
+          #  [#000000] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [2] (Number) line width, 0 for hairline 
+          #
+          attr_accessor :width
+          
+          #
+          #  [7] (Number) 
+          #
+          attr_accessor :tick_length
+          
+          #
+          #  [false] (true / false) If set to true, this axis will use logarithmic scale instead of linear 
+          #
+          attr_accessor :logarithmic
+        end
+        #
+        # y axis 
+        #
+        class Y  
+          include Base
+          
+          VALUES = [:color,:alpha,:width,:tick_length,:logarithmic]
+          #
+          #  [#000000] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [2] (Number) line width, 0 for hairline 
+          #
+          attr_accessor :width
+          
+          #
+          #  [7] (Number) 
+          #
+          attr_accessor :tick_length
+          
+          #
+          #  [false] (true / false) If set to true, this axis will use logarithmic scale instead of linear 
+          #
+          attr_accessor :logarithmic
+        end
+      end
+      #
+      # these settings are important only if your axis type is date or duration 
+      #
+      class DateFormats  
+        include Base
+        
+        VALUES = [:date_input,:duration_input,:axis_values,:balloon,:data_labels]
+        #
+        #  [YYYY-MM-DD hh:mm:ss] (YYYY, MM, DD, hh, mm, ss) date format of your data 
+        #
+        attr_accessor :date_input
+        
+        #
+        #  [ss] (DD, mm, hh, ss) duration unit of your data (this is important only if your axis type is "duration") 
+        #
+        attr_accessor :duration_input
+        
+        #
+        #  when axis type is "date", you must specify date formats for different intervals. "first" describes date format of the first grid line, "regular" - of all other grid lines 
+        #
+        attr_accessor :axis_values
+        
+        #
+        #  [month DD, YYYY] balloon date format 
+        #
+        attr_accessor :balloon
+        
+        #
+        #  [month DD, YYYY] data labels date format 
+        #
+        attr_accessor :data_labels
+        
+        
+        #
+        # when axis type is "date", you must specify date formats for different intervals. "first" describes date format of the first grid line, "regular" - of all other grid lines 
+        #
+        class AxisValues  
+          include Base
+          
+          VALUES = [:ss,:mm,:hh,:DD,:MM,:YYYY]
+          #
+          #  [first="month DD, YYYY" regular="hh:mm:ss"] date formats when interval is second 
+          #
+          attr_accessor :ss
+          
+          #
+          #  [first="month DD, YYYY" regular="hh:mm"] date formats when interval is minute 
+          #
+          attr_accessor :mm
+          
+          #
+          #  [first="month DD, YYYY" regular="hh:mm"] date formats when interval is hour 
+          #
+          attr_accessor :hh
+          
+          #
+          #  [first="month DD, YYYY" regular="month DD"] date formats when interval is day 
+          #
+          attr_accessor :DD
+          
+          #
+          #  [first="month, YYYY" regular="month"] date formats when interval is month 
+          #
+          attr_accessor :MM
+          
+          #
+          #  [first="YYYY" regular="YYYY"] date formats when interval is year 
+          #
+          attr_accessor :YYYY
+        end
+      end
+      #
+      # BALLOON 
+      #
+      class Balloon  
+        include Base
+        
+        VALUES = [:enabled,:color,:alpha,:text_color,:text_size,:max_width,:corner_radius,:border_width,:border_alpha,:border_color]
+        #
+        #  [true] (true / false) 
+        #
+        attr_accessor :enabled
+        
+        #
+        #  [] (hex color code) balloon background color. If empty, slightly darker then current column color will be used 
+        #
+        attr_accessor :color
+        
+        #
+        #  [100] (0 - 100) 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#FFFFFF] (hex color code) 
+        #
+        attr_accessor :text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :text_size
+        
+        #
+        #  [220] (Number) 
+        #
+        attr_accessor :max_width
+        
+        #
+        #  [0] (Number) Corner radius of a balloon. If you set it > 0, the balloon will not display arrow 
+        #
+        attr_accessor :corner_radius
+        
+        #
+        #  [0] (Number) 
+        #
+        attr_accessor :border_width
+        
+        #
+        #  [balloon.alpha] (Number) 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  [balloon.color] (hex color code) 
+        #
+        attr_accessor :border_color
+      end
+      #
+      #
+      #
+      class Bullets  
+        include Base
+        
+        VALUES = [:hover_brightness,:grow_time,:sequenced_grow,:grow_effect]
+        #
+        #  [0] (from -255 to 255) the bullet may darken/lighten when the use rolls over it. The intensity may be set here 
+        #
+        attr_accessor :hover_brightness
+        
+        #
+        #  [0] (Number) the time of animation of the bullets, in seconds. Leave 0 to appear instantly 
+        #
+        attr_accessor :grow_time
+        
+        #
+        #  [false] (true / false) whether to animate all bullets at the same time or one after another 
+        #
+        attr_accessor :sequenced_grow
+        
+        #
+        #  [elastic] (elastic, regular, strong) 
+        #
+        attr_accessor :grow_effect
+      end
+      #
+      #
+      #
+      class Scroller  
+        include Base
+        
+        VALUES = [:enabled,:color,:alpha,:bg_color,:bg_alpha,:height]
+        #
+        #  [true] (true / false) whether to show scroller when chart is zoomed or not 
+        #
+        attr_accessor :enabled
+        
+        #
+        #  [#DADADA] (hex color code) scrollbar color. Separate color codes with comas for gradient 
+        #
+        attr_accessor :color
+        
+        #
+        #  [100] (Number) scrollbar alpha 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#F0F0F0] (hex color code) scroller background color. Separate color codes with comas for gradient 
+        #
+        attr_accessor :bg_color
+        
+        #
+        #  [100] (Number) scroller background alpha 
+        #
+        attr_accessor :bg_alpha
+        
+        #
+        #  [10] (Number) scroller height 
+        #
+        attr_accessor :height
+      end
+      #
+      #
+      #
+      class Zoom  
+        include Base
+        
+        VALUES = [:enabled,:max_factor,:border_color,:border_alpha,:bg_color,:bg_alpha,:target]
+        #
+        #  [true] (true / false) whether the user can select the area to zoom-in 
+        #
+        attr_accessor :enabled
+        
+        #
+        #  [20] (Number) The maximum zoom level 
+        #
+        attr_accessor :max_factor
+        
+        #
+        #  [#BBBB00] color of a zoom box border 
+        #
+        attr_accessor :border_color
+        
+        #
+        #  [100] (Number) zoom box border opacity 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  [#BBBB00] zoom box background color 
+        #
+        attr_accessor :bg_color
+        
+        #
+        #  [25] zoom box background opacity 
+        #
+        attr_accessor :bg_alpha
+        
+        #
+        #  [true] whether to show target when the mouse is over plot area or not 
+        #
+        attr_accessor :target
+      end
+      #
+      # HELP button and balloon 
+      #
+      class Help  
+        include Base
+        
+        VALUES = [:button,:balloon]
+        #
+        #  help button is only visible if balloon text is defined 
+        #
+        attr_accessor :button
+        
+        #
+        #  help balloon 
+        #
+        attr_accessor :balloon
+        
+        
+        #
+        # help button is only visible if balloon text is defined 
+        #
+        class Button  
+          include Base
+          
+          VALUES = [:x,:y,:color,:alpha,:text_color,:text_color_hover,:text_size,:text]
+          #
+          #  [] (Number / Number% / !Number) x position of help button, if not defined, will be aligned to right of chart area 
+          #
+          attr_accessor :x
+          
+          #
+          #  [] (Number / Number% / !Number) y position of help button, if not defined, will be aligned to top of chart area 
+          #
+          attr_accessor :y
+          
+          #
+          #  [#000000] (hex color code) background color 
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) background alpha 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [#FFFFFF] (hex color code) button text color 
+          #
+          attr_accessor :text_color
+          
+          #
+          #  [#BBBB00](hex color code) button text roll over color 
+          #
+          attr_accessor :text_color_hover
+          
+          #
+          #  [] (Number) button text size 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [?] (text) 
+          #
+          attr_accessor :text
+        end
+        #
+        # help balloon 
+        #
+        class Balloon  
+          include Base
+          
+          VALUES = [:color,:alpha,:width,:text_color,:text_size,:text]
+          #
+          #  [#000000] (hex color code) background color 
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) background alpha 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [300] (Number) 
+          #
+          attr_accessor :width
+          
+          #
+          #  [#FFFFFF] (hex color code) button text color 
+          #
+          attr_accessor :text_color
+          
+          #
+          #  [] (Number) button text size 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [] (text) some html tags may be used (supports <b>, <i>, <u>, <font>, <br/>. Enter text between []: <![CDATA[your <b>bold</b> and <i>italic</i> text]]>
+          #
+          attr_accessor :text
+        end
+      end
+      #
+      # LEGEND 
+      #
+      class Legend  
+        include Base
+        
+        VALUES = [:enabled,:x,:y,:width,:max_columns,:color,:alpha,:border_color,:border_alpha,:text_color,:text_size,:spacing,:margins,:reverse_order,:align,:key]
+        #
+        #  [true] (true / false) 
+        #
+        attr_accessor :enabled
+        
+        #
+        #  [] (Number / Number% / !Number) if empty, will be equal to left margin 
+        #
+        attr_accessor :x
+        
+        #
+        #  [] (Number / Number% / !Number) if empty, will be below plot area 
+        #
+        attr_accessor :y
+        
+        #
+        #  [] (Number / Number%) if empty, will be equal to plot area width 
+        #
+        attr_accessor :width
+        
+        #
+        #  [] (Number) the maximum number of columns in the legend 
+        #
+        attr_accessor :max_columns
+        
+        #
+        #  [#FFFFFF] (hex color code) background color. Separate color codes with comas for gradient 
+        #
+        attr_accessor :color
+        
+        #
+        #  [0] (0 - 100) background alpha 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#000000] (hex color code) border color 
+        #
+        attr_accessor :border_color
+        
+        #
+        #  [0] (0 - 100) border alpha 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  [text_color] (hex color code) 
+        #
+        attr_accessor :text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :text_size
+        
+        #
+        #  [10] (Number) vertical and horizontal gap between legend entries 
+        #
+        attr_accessor :spacing
+        
+        #
+        #  [0] (Number) legend margins (space between legend border and legend entries, recommended to use only if legend border is visible or background color is different from chart area background color) 
+        #
+        attr_accessor :margins
+        
+        #
+        #  [false] (true / false) whether to sort legend entries in a reverse order 
+        #
+        attr_accessor :reverse_order
+        
+        #
+        #  [left] (left / center / right) alignment of legend entries 
+        #
+        attr_accessor :align
+        
+        #
+        #  KEY (the color box near every legend entry) 
+        #
+        attr_accessor :key
+        
+        
+        #
+        # KEY (the color box near every legend entry) 
+        #
+        class Key  
+          include Base
+          
+          VALUES = [:size,:border_color]
+          #
+          #  [16] (Number) key size
+          #
+          attr_accessor :size
+          
+          #
+          #  [] (hex color code) leave empty if you don't want to have border 
+          #
+          attr_accessor :border_color
+        end
+      end
+      #
+      # export_as_image feature works only on a web server 
+      #
+      class ExportAsImage  
+        include Base
+        
+        VALUES = [:file,:target,:x,:y,:color,:alpha,:text_color,:text_size]
+        #
+        #  [] (filename) if you set filename here, context menu (then user right clicks on flash movie) "Export as image" will appear. This will allow user to export chart as an image. Collected image data will be posted to this file name (use amxy/export.php or amxy/export.aspx) 
+        #
+        attr_accessor :file
+        
+        #
+        #  [] (_blank, _top ...) target of a window in which export file must be called 
+        #
+        attr_accessor :target
+        
+        #
+        #  [0] (Number / Number% / !Number) x position of "Collecting data" text 
+        #
+        attr_accessor :x
+        
+        #
+        #  [] (Number / Number% / !Number) y position of "Collecting data" text. If not set, will be aligned to the bottom of flash movie 
+        #
+        attr_accessor :y
+        
+        #
+        #  [#BBBB00] (hex color code) background color of "Collecting data" text 
+        #
+        attr_accessor :color
+        
+        #
+        #  [0] (0 - 100) background alpha 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [text_color] (hex color code) 
+        #
+        attr_accessor :text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :text_size
+      end
+      #
+      # "error_messages" settings will be applied for all error messages except the one which is showed if settings file wasn't found 
+      #
+      class ErrorMessages  
+        include Base
+        
+        VALUES = [:enabled,:x,:y,:color,:alpha,:text_color,:text_size]
+        #
+        #  [true] (true / false) 
+        #
+        attr_accessor :enabled
+        
+        #
+        #  [] (Number / Number% / !Number) x position of error message. If not set, will be aligned to the center 
+        #
+        attr_accessor :x
+        
+        #
+        #  [] (Number / Number% / !Number) y position of error message. If not set, will be aligned to the center 
+        #
+        attr_accessor :y
+        
+        #
+        #  [#BBBB00] (hex color code) background color of error message. Separate color codes with comas for gradient 
+        #
+        attr_accessor :color
+        
+        #
+        #  [100] (0 - 100) background alpha 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#FFFFFF] (hex color code) 
+        #
+        attr_accessor :text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :text_size
+      end
+      #
+      #
+      #
+      class Strings  
+        include Base
+        
+        VALUES = [:no_data,:export_as_image,:collecting_data,:ss,:mm,:hh,:DD,:months]
+        #
+        #  [No data for selected period] (text) if data is missing, this message will be displayed 
+        #
+        attr_accessor :no_data
+        
+        #
+        #  [Export as image] (text) text for right click menu 
+        #
+        attr_accessor :export_as_image
+        
+        #
+        #  [Collecting data] (text) this text is displayed while exporting chart to an image 
+        #
+        attr_accessor :collecting_data
+        
+        #
+        #  [] unit of seconds 
+        #
+        attr_accessor :ss
+        
+        #
+        #  [:] unit of minutes 
+        #
+        attr_accessor :mm
+        
+        #
+        #  [:] unit of hours 
+        #
+        attr_accessor :hh
+        
+        #
+        #  [d ] unit of days 
+        #
+        attr_accessor :DD
+        
+        #
+        # 
+        #
+        attr_accessor :months
+        
+        
+        #
+        #
+        #
+        class Months  
+          include Base
+          
+          VALUES = [:month1,:month2,:month3,:month4,:month5,:month6,:month7,:month8,:month9,:month10,:month11,:month12]
+          #
+          # 
+          #
+          attr_accessor :month1
+          
+          #
+          # 
+          #
+          attr_accessor :month2
+          
+          #
+          # 
+          #
+          attr_accessor :month3
+          
+          #
+          # 
+          #
+          attr_accessor :month4
+          
+          #
+          # 
+          #
+          attr_accessor :month5
+          
+          #
+          # 
+          #
+          attr_accessor :month6
+          
+          #
+          # 
+          #
+          attr_accessor :month7
+          
+          #
+          # 
+          #
+          attr_accessor :month8
+          
+          #
+          # 
+          #
+          attr_accessor :month9
+          
+          #
+          # 
+          #
+          attr_accessor :month10
+          
+          #
+          # 
+          #
+          attr_accessor :month11
+          
+          #
+          # 
+          #
+          attr_accessor :month12
+        end
+      end
+      #
+      # <menu function_name="printChart" title="Print chart"></menu> 
+      #
+      class ContextMenu  
+        include Base
+        
+        VALUES = [:default_items]
+        #
+        # 
+        #
+        attr_accessor :default_items
+        
+        
+        #
+        #
+        #
+        class DefaultItems  
+          include Base
+          
+          VALUES = [:zoom,:print]
+          #
+          #  [true] (true / false) to show or not flash players zoom menu 
+          #
+          attr_accessor :zoom
+          
+          #
+          #  [true] (true / false) to show or not flash players print menu 
+          #
+          attr_accessor :print
+        end
+      end
+      #
+      # labels can also be added in data xml file, using exactly the same structure like it is here 
+      #
+      class Labels  
+        include Base
+        
+        VALUES = [:label]
+        #
+        # 
+        #
+        attr_accessor :label
+        
+        
+        #
+        #
+        #
+        class Label  
+          include Base
+          
+          VALUES = [:x,:y,:rotate,:width,:align,:text_color,:text_size,:text]
+          ATTRIBUTES = [:lid]
+          #
+          #  [0] (Number / Number% / !Number) 
+          #
+          attr_accessor :x
+          
+          #
+          #  [0] (Number / Number% / !Number) 
+          #
+          attr_accessor :y
+          
+          #
+          #  [false] (true, false) 
+          #
+          attr_accessor :rotate
+          
+          #
+          #  [] (Number / Number%) if empty, will stretch from left to right untill label fits 
+          #
+          attr_accessor :width
+          
+          #
+          #  [left] (left / center / right) 
+          #
+          attr_accessor :align
+          
+          #
+          #  [text_color] (hex color code) button text color 
+          #
+          attr_accessor :text_color
+          
+          #
+          #  [text_size](Number) button text size 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [] (text) html tags may be used (supports <b>, <i>, <u>, <font>, <a href="">, <br/>. Enter text between []: <![CDATA[your <b>bold</b> and <i>italic</i> text]]>
+          #
+          attr_accessor :text
+          
+          #
+          # xml attribute
+          #
+          attr_accessor :lid
+        end
+      end
+      #
+      # if graph settings are defined both here and in data file, the ones from data file are used 
+      #
+      class Graphs  
+        include Base
+        
+        VALUES = [:graph]
+        #
+        #  if you are using XML data file, graph "gid" must match graph "gid" in data file 
+        #
+        attr_accessor :graph
+        
+        
+        #
+        # if you are using XML data file, graph "gid" must match graph "gid" in data file 
+        #
+        class Graph  
+          include Base
+          
+          VALUES = [:title,:color,:alpha,:width,:data_labels,:balloon_text,:bullet_max_size,:bullet_min_size,:bullet,:bullet_size,:bullet_color,:bullet_alpha,:visible_in_legend]
+          ATTRIBUTES = [:gid]
+          #
+          #  [] (graph title) 
+          #
+          attr_accessor :title
+          
+          #
+          #  [] (hex color code)  
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) line alpha. WIll not affect bullets. Set to 0 if you want the line to be invisible 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [0] (Number) line width 
+          #
+          attr_accessor :width
+          
+          #
+          #  [] ({title} {value} {description} {x} {y} {percents}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. 
+          #
+          attr_accessor :data_labels
+          
+          #
+          #  [] ({title} {value} {description} {x} {y} {percents}) You can format any data label: {title} will be replaced with real title, {value} - with value and so on. You can add your own text or html code too. You can also use {title}, {value} and other tags in description. 
+          #
+          attr_accessor :balloon_text
+          
+          #
+          #  [50] maximum size of a bullet (balloon) The bullet with the highest value will be equal to this size 
+          #
+          attr_accessor :bullet_max_size
+          
+          #
+          #  [0] minimum size of a bullet (balloon) 
+          #
+          attr_accessor :bullet_min_size
+          
+          #
+          #  [] (square, round, square_outlined, round_outlined,  bubble, square_outline, round_outline, x. triangle_up, triangle_down, romb filename.swf) can be used predefined bullets or loaded custom bullets. Leave empty if you don't want to have bullets at all. Outlined bullets use plot area color for outline color 
+          #
+          attr_accessor :bullet
+          
+          #
+          #  [] (Number) bullet size. This param is only used if your values are not set in data file 
+          #
+          attr_accessor :bullet_size
+          
+          #
+          #  [] (hex color code) bullet color. If not defined, graph color is used 
+          #
+          attr_accessor :bullet_color
+          
+          #
+          #  [100] (Number) 
+          #
+          attr_accessor :bullet_alpha
+          
+          #
+          #  [true] (true / false) whether to show legend entry for this graph or not 
+          #
+          attr_accessor :visible_in_legend
+          
+          #
+          # xml attribute
+          #
+          attr_accessor :gid
+        end
+      end    
+    end
+  end
+end