ambling 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ambling.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Andrew Hobson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sub license, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

data/README

@@ -0,0 +1,188 @@
+#
+# Ambling is a rails plugin makes it easy to generate XML needed by the wonderfully slick
+# Amcharts[http://www.amcharts.com/].
+#
+# Amcharts has two kinds of XML: the data xml and the settings xml.  Ambling can help with both.
+# 
+# To install, do the usual rails incancation:
+#    ruby script/plugin install svn://rubyforge.org//var/svn/ambling/trunk
+#
+# Ambling expects amcharts to be installed under public/amcharts.  Put the
+# licence key (if any), swf files, fonts and plugins directories under here
+#
+#
+# Amcharts uses swfobject.js, so put that in public/javascripts and include it
+# in your layout.  It does not work with swfobject version 2.x so you'll need
+# to find swfobject 1.x
+# 
+# Ambling uses expressinstall.swf by default, so put that in public/amcharts.
+#
+#
+#
+# Ambling is also now on github: http://github.com/ahobson/ambling/tree/master
+#
+# Examples:
+# 
+# In your controller, generate the data xml for a pie chart
+#  def pie_data
+#    chart = Ambling::Data::Pie.new
+#    FavoriteColor.count(:color, :group => :color).each do |data|
+#      chart.slices << Ambling::Data::Slice.new(data.last, :title => data.first,
+#                                              :url => favorite_colors_path(:color => data.first))
+#    end
+#    render :xml => chart.to_xml
+#  end
+#
+# In your view, embed the flash and customize the settings
+#
+#   <%=
+#   ambling_chart(:pie,  :data_file => url_for(:action => 'pie_data', :escape => false),
+#                           :id => 'pie_data', :width => 290, :height => 200,
+#                           :chart_settings => Ambling::Pie::Settings.new({
+#                             :pie => {
+#                               :x => 110,
+#                               :y => 110,
+#                               :radius => 80,
+#                               :colors => '#B40000,#F7941D,#0265AC',
+#                               :outline_color => '#000000',
+#                               :outline_alpha => 50,
+#                             },
+#                             :animation => {
+#                               :pull_out_on_click => false,
+#                             },
+#                             :data_labels => {
+#                               :show => cdata_section("<b>{value}</b>"), :radius => -30,
+#                             },
+#                             :legend => {
+#                               :enabled => true, :x => 195, :y => 20, :width => 100, :text_color => '#000',
+#                               :max_columns => 1, :spacing => 2, :text_size => 10,
+#                               :key => {:size => 10}
+#                             },
+#                             :labels => {
+#                               :label =>
+#                                 {:x => 40, :y => 5, :text => cdata_section("<b>Favorite Colors</b>"),
+#                                   :text_size => 16, :text_color => '#0265AC'},
+#                             }
+#                           }).to_xml) do
+#                       content_tag('p', "To see this page properly, you need to upgrade your Flash Player")
+#   end
+#   %>
+#
+# How about a combo bar and line graph?
+#
+# In your controller:
+#   def graph_data
+#     avg_attendence = Movies.find_average_attendence_last_thirty_days
+#     colors = %w{#B40000 #F7941D #0265AC #DF5858 #FFC580 #6FAFF3 #5AAB6D #E99393 #9DCFA9 #A4CBF3}
+#     chart = Ambling::Data::ColumnChart.new
+#     chart.graphs << Ambling::Data::LineGraph.new([], :title => "Average Attendence", :color => '#000000')
+#     avg_attendence.each do |day,avg_attendence|
+#       chart.series << Ambling::Data::Value.new(day.to_s(:pretty_day), :xid => day.to_i)
+#       chart.graphs.last << Ambling::Data::Value.new(avg_attendence, :xid => day.to_i)
+#     end
+#     all_movie_names = Movies.find_movie_names
+#     all_movie_names.each_with_index do |movie_name, i|
+#       chart.graphs << Ambling::Data::ColumnGraph.new([], :title => movie_name, :color => colors[i])
+#       movie_attendence = Movies.find_attendence_by_name(movie_name)
+#       movie_attendence.each do |day, attendence|
+#         chart.graphs.last << Ambling::Data::Value.new(attendence, :xid => day.to_i)
+#       end
+#     end
+#      
+#     render :xml => chart.to_xml
+#   end
+#
+# In your view:
+#
+#   <%=
+#   ambling_chart(:column,  :data_file => url_for(:action => 'graph_data', :escape => false),
+#                           :id => "graph_data", :width => 900, :height => 250,
+#                           :chart_settings => Ambling::Column::Settings.new({
+#                             :column => {
+#                               :type => "stacked", :width => 90, :spacing => 5,
+#                               :balloon_text => "{value} people attended the movie {title} on {series}"
+#                             },
+#                             :grid => {
+#                               :category => {:alpha => 0}, :value => {:alpha => 10}
+#                             },
+#                             :values => {
+#                               :category => {:enabled => true, :frequency => 3}
+#                             },
+#                             :plot_area => {
+#                               :margins => {:left => 30, :top => 40, :right => 100, :bottom => 40}
+#                             },
+#                             :legend => {
+#                               :enabled => true, :x => 805, :y => 20, :width => 100, :text_color => '#000',
+#                               :max_columns => 1, :spacing => 2, :text_size => 10,
+#                               :key => {:size => 10}
+#                             },
+#                             :labels => {
+#                               :label => [
+#                                 {:x => 350, :y => 5, :text => cdata_section("<b>Movie Attendence</b>"),
+#                                   :text_size => 16, :text_color => '#0265AC'}
+#                               ]
+#                             },
+#                             :graphs => {
+#                               :graph => [
+#                                 {:type => 'line', :gid => 1, :width => 3}
+#                               ]
+#                             }
+#                           }).to_xml) do
+#                       content_tag('p', "To see this page properly, you need to upgrade your Flash Player")
+#   end
+#   %>
+# 
+# Here's a column example.
+#
+# In your controller:
+#
+#   def column_data
+#     colors = %w{#B40000 #F7941D #0265AC}
+#     chart = Ambling::Data::ColumnChart.new
+#     chart.series << Ambling::Data::Value.new(1, :xid => 1)
+#     [["Chocolate", 55], ["Ice Cream", 34], ["Cookies", 22]].each_with_index do |kv, i|
+#       chart.graphs << Ambling::Data::ColumnGraph.new([], :gid => i, :title => kv.first, :color => color[i])
+#       chart.graphs.last << Ambling::Data::Value.new(kv.last, {:xid => 1})
+#     end
+#     render :xml => chart.to_xml
+#    end
+# 
+# In your view:
+#
+#   <%=
+#   ambling_chart(:column,  :data_file => url_for(:action => 'column_data', :escape => false),
+#                           :id => 'column_data', :width => 290, :height => 200,
+#                           :chart_settings => Ambling::Column::Settings.new({
+#                             :column => {
+#                               :type => "bar", :width => 97, :spacing => 0,
+#                               :balloon_text => cdata_section("{value} people bought {title}")
+#                             },
+#                             :grid => {
+#                               :category => {:alpha => 0}, :value => {:alpha => 10}
+#                             },
+#                             :values => {
+#                               :category => {:enabled => false}
+#                             },
+#                             :plot_area => {
+#                               :margins => {:left => 40, :top => 40, :right => 100, :bottom => 40}
+#                             },
+#                             :legend => {
+#                               :enabled => true, :x => 195, :y => 20, :width => 100, :text_color => '#000',
+#                               :max_columns => 1, :spacing => 1, :text_size => 10,
+#                               :key => {:size => 10}
+#                             },
+#                             :labels => {
+#                               :label => [
+#                                 {:x => 20, :y => 5, :text => cdata_section("<b>Dessert</b>"),
+#                                   :text_size => 16, :text_color => '#0265AC'},
+#                                 {:x => 30, :y => 170, :text => "Sweet Sales", :align => "center", :width => 180,
+#                                   :text_size => 12}
+#                               ]
+#                             }
+#                           }).to_xml) do
+#                       content_tag('p', "To see this page properly, you need to upgrade your Flash Player")
+#   end
+#   %>
+
+# Thanks to the ziya plugin for inspiration
+

data/Rakefile

@@ -0,0 +1,24 @@
+require 'rake/testtask'
+
+task :doc do
+  sh "rdoc -S -m README init.rb lib README"
+end
+
+task :rubyforge => [:doc] do
+  sh "rsync -Car doc/* rubyforge.org:/var/www/gforge-projects/ambling"
+end
+
+
+Rake::TestTask.new(:non_generate_tests) do |t|
+  t.test_files = FileList['test/*_test.rb'].exclude("test/generator_test.rb")
+  t.verbose = true
+end
+
+# The generate tests need to be run separately because they define
+# classes used in the other tests
+Rake::TestTask.new(:generate_tests) do |t|
+  t.test_files = FileList['test/generator_test.rb']
+  t.verbose = true
+end
+
+task :test => [:generate_tests, :non_generate_tests]

data/ambling.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ambling/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ambling"
+  s.version     = Ambling::VERSION
+  s.authors     = ["Daniel Vandersluis"]
+  s.email       = ["daniel@codexed.com"]
+  s.homepage    = "https://github.com/dvandersluis/ambling"
+  s.summary     = %q{Makes generating XML for amcharts through Rails easy.}
+  s.description = %q{Ambling is a rails plugin makes it easy to generate XML needed by the wonderfully slick Amcharts (http://www.amcharts.com/).}
+
+  s.rubyforge_project = "ambling"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/init.rb

@@ -0,0 +1,4 @@
+require File.dirname(__FILE__) + '/lib/ambling'    
+require File.dirname(__FILE__) + '/lib/ambling_helper'    
+
+ActionView::Base.send(:include, Ambling::Helper)

data/lib/ambling.rb

@@ -0,0 +1,10 @@
+module Ambling
+  require 'ambling/railtie' if defined?(Rails)
+end
+
+require 'ambling/base'
+require 'ambling/column'
+require 'ambling/pie'
+require 'ambling/line'
+require 'ambling/xy'
+require 'ambling/data'

data/lib/ambling/base.rb

@@ -0,0 +1,69 @@
+# Base module for settings
+require 'active_support'
+require 'active_support/builder' unless defined?(Builder)
+
+module Ambling #:nodoc
+  # debugging
+  # class BaseLogger
+  #   cattr_accessor :logger, :instance_writer => false
+  # end
+  
+  #
+  # All settings classses include these base functions that populate
+  # the data from a hash and generate the xml
+  #
+  module Base
+    def initialize(hash = {})
+      populate(hash)
+    end
+    
+    #
+    # populate the settings with data from the hash
+    #
+    def populate(hash = {})
+      hash.each do |k,v|
+        val = if v.is_a?(Hash)
+          klass = self.class.const_get(k.to_s.camelize)
+          klass.new(v)
+        elsif v.is_a?(Array)
+          klass = self.class.const_get(k.to_s.camelize)
+          v.collect {|i| klass.new(i)}
+        else
+          v
+        end
+        self.send("#{k}=", val)
+      end
+    end
+    
+    #
+    # Return an xml representation of these settings
+    #
+    def to_xml(builder = nil)
+      builder ||= Builder::XmlMarkup.new
+      tag = self.class.to_s.split("::").last.downcase
+      attr_list = self.class.send(:const_get, :ATTRIBUTES) rescue []
+      attrs = attr_list.inject({}) do |h,a|
+        val = self.send(a)
+        val.nil? ? h : h.merge(a => val)
+      end
+      builder.tag!(tag, attrs) { self.build_xml(builder) }
+      builder.target!
+    end
+    
+    #
+    # build an xml representation of this subcomponent of the settings using the provided builder
+    #
+    def build_xml(builder)
+      self.class.send(:const_get, :VALUES).each do |a|
+        val = self.send(a)
+        if val.respond_to? :build_xml
+          builder.tag!(a) {|b| val.build_xml(b) }
+        elsif val.is_a? Array
+          val.each {|v| builder << v.to_xml }
+        elsif not val.nil?
+          builder.tag! a, val
+        end
+      end
+    end
+  end
+end

data/lib/ambling/column.rb

@@ -0,0 +1,1332 @@
+# Auto generated from XML file
+require 'ambling/base'
+module Ambling
+  class Column
+    
+    #
+    # "!" 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 = [:type,: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,:precision,:depth,:angle,:colors,:column,:line,:background,:plot_area,:grid,:values,:axes,:balloon,:legend,:export_as_image,:error_messages,:strings,:context_menu,:labels,:graphs,:guides]
+      #
+      #  [column] (column / bar) 
+      #
+      attr_accessor :type
+      
+      #
+      #  [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
+      
+      #
+      #  this function is beta, be careful. Legend, buttons labels will not be repositioned if you set your x and y values for these objects 
+      #
+      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
+      
+      #
+      #  [2] (Number) shows how many numbers should be shown after comma for calculated values (percents) 
+      #
+      attr_accessor :precision
+      
+      #
+      #  [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
+      
+      #
+      #  [#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
+      
+      #
+      # 
+      #
+      attr_accessor :column
+      
+      #
+      #  Here are general settings for "line" graph type. You can set most of these settings for individual lines in graph settings below 
+      #
+      attr_accessor :line
+      
+      #
+      #  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
+      
+      #
+      #  BALLOON 
+      #
+      attr_accessor :balloon
+      
+      #
+      #  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
+      
+      #
+      #  guides are straight lines drawn through all plot area at a give value. Can also be filled with color 
+      #
+      attr_accessor :guides
+      
+      
+      #
+      #
+      #
+      class Column  
+        include Base
+        
+        VALUES = [:type,:width,:spacing,:grow_time,:grow_effect,:sequenced_grow,:alpha,:border_color,:border_alpha,:data_labels,:data_labels_text_color,:data_labels_text_size,:data_labels_position,:balloon_text,:link_target,:gradient,:bullet_offset,:hover_brightness]
+        #
+        #  [clustered] (clustered, stacked, 100% stacked, 3d column) 
+        #
+        attr_accessor :type
+        
+        #
+        #  [80] (0 - 100) width of column (in percents)  
+        #
+        attr_accessor :width
+        
+        #
+        #  [5] (Number) space between columns of one category axis value, in pixels. Negative values can be used. 
+        #
+        attr_accessor :spacing
+        
+        #
+        #  [0] (Number) grow time in seconds. Leave 0 to appear instantly 
+        #
+        attr_accessor :grow_time
+        
+        #
+        #  [elastic] (elastic, regular, strong) 
+        #
+        attr_accessor :grow_effect
+        
+        #
+        #  [false] (true / false) whether columns should grow at the same time or one after another 
+        #
+        attr_accessor :sequenced_grow
+        
+        #
+        #  [100] (Number) alpha of all columns 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [#FFFFFF] (hex color code) 
+        #
+        attr_accessor :border_color
+        
+        #
+        #  [0] (Number) 
+        #
+        attr_accessor :border_alpha
+        
+        #
+        #  [] ({title} {value} {series} {percents} {start} {difference} {total}) 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
+        
+        #
+        #  [text_color] (hex color code) 
+        #
+        attr_accessor :data_labels_text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :data_labels_text_size
+        
+        #
+        #  if you set "above" for column chart, the data label will be displayed inside column, rotated  by 90 degrees 
+        #
+        attr_accessor :data_labels_position
+        
+        #
+        #  [] ({title} {value} {series} {percents} {start} {difference} {total}) 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 :balloon_text
+        
+        #
+        #  [] (_blank, _top ...) 
+        #
+        attr_accessor :link_target
+        
+        #
+        #  [vertical] (horizontal / vertical) Direction of column gradient. Gradient colors are defined in graph settings below. 
+        #
+        attr_accessor :gradient
+        
+        #
+        #  [0] (Number) distance from column / bar to the bullet 
+        #
+        attr_accessor :bullet_offset
+        
+        #
+        #  [0] (from -255 to 255) The column may darken/lighten when the use rolls over it. The intensity may be set here 
+        #
+        attr_accessor :hover_brightness
+      end
+      #
+      # Here are general settings for "line" graph type. You can set most of these settings for individual lines in graph settings below 
+      #
+      class Line  
+        include Base
+        
+        VALUES = [:connect,:width,:alpha,:fill_alpha,:bullet,:bullet_size,:data_labels,:data_labels_text_color,:data_labels_text_size,:balloon_text,:link_target]
+        #
+        #  [false] (true / false) whether to connect points if data is missing 
+        #
+        attr_accessor :connect
+        
+        #
+        #  [2] (Number) line width 
+        #
+        attr_accessor :width
+        
+        #
+        #  [100] (Number) line alpha 
+        #
+        attr_accessor :alpha
+        
+        #
+        #  [0] (Number) fill alpha 
+        #
+        attr_accessor :fill_alpha
+        
+        #
+        #  [] (square, round, square_outlined, round_outlined, square_outline, round_outline, 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
+        
+        #
+        #  [8] (Number) bullet size 
+        #
+        attr_accessor :bullet_size
+        
+        #
+        #  [] ({title} {value} {series} {percents} {start} {difference} {total}) 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
+        
+        #
+        #  [text_color] (hex color code) 
+        #
+        attr_accessor :data_labels_text_color
+        
+        #
+        #  [text_size] (Number) 
+        #
+        attr_accessor :data_labels_text_size
+        
+        #
+        #  [] use the same formatting rules as for data labels 
+        #
+        attr_accessor :balloon_text
+        
+        #
+        #  [] (_blank, _top ...) 
+        #
+        attr_accessor :link_target
+      end
+      #
+      # 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 = [:category,:value]
+        #
+        #  category axis grid 
+        #
+        attr_accessor :category
+        
+        #
+        #  value axis grid 
+        #
+        attr_accessor :value
+        
+        
+        #
+        # category axis grid 
+        #
+        class Category  
+          include Base
+          
+          VALUES = [:color,:alpha,:dashed,:dash_length]
+          #
+          #  [#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
+        end
+        #
+        # value axis grid 
+        #
+        class Value  
+          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
+      end
+      #
+      # VALUES 
+      #
+      class Values  
+        include Base
+        
+        VALUES = [:category,:value]
+        #
+        #  category axis 
+        #
+        attr_accessor :category
+        
+        #
+        #  value axis 
+        #
+        attr_accessor :value
+        
+        
+        #
+        # category axis 
+        #
+        class Category  
+          include Base
+          
+          VALUES = [:enabled,:frequency,:start_from,:rotate,:color,:text_size,:inside]
+          #
+          #  [true] (true / false) 
+          #
+          attr_accessor :enabled
+          
+          #
+          #  [1] (Number) how often values should be placed 
+          #
+          attr_accessor :frequency
+          
+          #
+          #  [1] (Number) you can set series from which category values will be displayed 
+          #
+          attr_accessor :start_from
+          
+          #
+          #  [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
+          
+          #
+          #  [text_color] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [text_size] (Number) 
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [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
+        #
+        # value axis 
+        #
+        class Value  
+          include Base
+          
+          VALUES = [:enabled,: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
+          
+          #
+          #  [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 = [:category,:value]
+        #
+        #  category axis 
+        #
+        attr_accessor :category
+        
+        #
+        #  value axis 
+        #
+        attr_accessor :value
+        
+        
+        #
+        # category axis 
+        #
+        class Category  
+          include Base
+          
+          VALUES = [:color,:alpha,:width,:tick_length]
+          #
+          #  [#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
+        end
+        #
+        # value axis 
+        #
+        class Value  
+          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
+      #
+      # 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) The maximum width of a balloon 
+        #
+        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
+      #
+      # 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 amcolumn/export.php or amcolumn/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]
+        #
+        #  [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
+      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 = [:type,:title,:color,:alpha,:data_labels,:gradient_fill_colors,:balloon_color,:balloon_alpha,:balloon_text_color,:balloon_text,:fill_alpha,:width,:bullet,:bullet_size,:bullet_color,:visible_in_legend]
+          ATTRIBUTES = [:gid]
+          #
+          #  [column] (column/line) 
+          #
+          attr_accessor :type
+          
+          #
+          #  [] (graph title) 
+          #
+          attr_accessor :title
+          
+          #
+          #  [] (hex color code) 
+          #
+          attr_accessor :color
+          
+          #
+          #  [column.alpha (line.alpha)] (0 - 100) 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [column.data_labels (line.data_labels)] ({title} {value} {series} {percents} {start} {difference} {total}) 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
+          
+          #
+          #  [] (hex color codes separated by comas) columns can be filled with gradients. Set any number of colors here. Note, that the legend key will be filled with color value, not with gradient. 
+          #
+          attr_accessor :gradient_fill_colors
+          
+          #
+          #  [balloon.color] (hex color code) leave empty to use the same color as graph 
+          #
+          attr_accessor :balloon_color
+          
+          #
+          #  [balloon.alpha] (0 - 100) 
+          #
+          attr_accessor :balloon_alpha
+          
+          #
+          #  [balloon.text_color] (hex color code) 
+          #
+          attr_accessor :balloon_text_color
+          
+          #
+          #  [column(line).balloon.text] ({title} {value} {series} {description} {percents}) You can format any balloon text: {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 :balloon_text
+          
+          #
+          #  [0] (0 - 100) fill alpha (use it if you want to have area chart) 
+          #
+          attr_accessor :fill_alpha
+          
+          #
+          #  [2] (Number) line width 
+          #
+          attr_accessor :width
+          
+          #
+          #  [line.bullet] (round, square, round_outlined, square_outline, round_outline, square_outlined, filename) 
+          #
+          attr_accessor :bullet
+          
+          #
+          #  [line.bullet_size] (Number) bullet size 
+          #
+          attr_accessor :bullet_size
+          
+          #
+          #  [] (hex color code) bullet color. If not defined, line color is used 
+          #
+          attr_accessor :bullet_color
+          
+          #
+          #  [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
+      #
+      # guides are straight lines drawn through all plot area at a give value. Can also be filled with color 
+      #
+      class Guides  
+        include Base
+        
+        VALUES = [:max_min,:guide]
+        #
+        #  [false] (true / false) whether to include guides' values when calculating min and max of a chart 
+        #
+        attr_accessor :max_min
+        
+        #
+        #  there can be any number of quides. guides can also be set in data xml file, using the same syntax as here 
+        #
+        attr_accessor :guide
+        
+        
+        #
+        # there can be any number of quides. guides can also be set in data xml file, using the same syntax as here 
+        #
+        class Guide  
+          include Base
+          
+          VALUES = [:behind,:start_value,:end_value,:title,:width,:color,:alpha,:fill_color,:fill_alpha,:inside,:centered,:rotate,:text_size,:text_color,:dashed,:dash_length]
+          #
+          #  [false] (true / false) whether your guides should appear in front of columns or behind them 
+          #
+          attr_accessor :behind
+          
+          #
+          #  (number) value at which guide should be placed 
+          #
+          attr_accessor :start_value
+          
+          #
+          #  (number) if you set value here too, another quide will be drawn. If you set fill alpha > 0, then the area between these quides will be filled with color 
+          #
+          attr_accessor :end_value
+          
+          #
+          #  (string) text which will be displayed near the guide 
+          #
+          attr_accessor :title
+          
+          #
+          #  [0] (Number) width of a guide line (0 for hairline) 
+          #
+          attr_accessor :width
+          
+          #
+          #  [#000000] (hex color code) color of guide line 
+          #
+          attr_accessor :color
+          
+          #
+          #  [100] (0 - 100) opacity of guide line 
+          #
+          attr_accessor :alpha
+          
+          #
+          #  [guide.color] (hex color code) fill color. If not defined, color of a guide will be used. Separate color codes with comas for gradient 
+          #
+          attr_accessor :fill_color
+          
+          #
+          #  [0] (0 - 100) opacity of a fill 
+          #
+          attr_accessor :fill_alpha
+          
+          #
+          #  [values.value.inside] whether to place title inside plot area 
+          #
+          attr_accessor :inside
+          
+          #
+          #  [true] (true / false) if you have start and end values defined, title can be placed in the middle between these values. If false, it will be placed near start_value 
+          #
+          attr_accessor :centered
+          
+          #
+          #  [values.value.rotate] (0 - 90) angle of rotation of title. 
+          #
+          attr_accessor :rotate
+          
+          #
+          #  [values.value.text_size] (Number)  
+          #
+          attr_accessor :text_size
+          
+          #
+          #  [values.value.color] (hex color code) 
+          #
+          attr_accessor :text_color
+          
+          #
+          #  [false] (true / false) 
+          #
+          attr_accessor :dashed
+          
+          #
+          #  [5] (Number) 
+          #
+          attr_accessor :dash_length
+        end
+      end    
+    end
+  end
+end