Ziya::Charts::Base

     # File lib/ziya/charts/base.rb, line 167
167:     def add( *args )
168:       # TODO Validation categories = series, series = labels, etc...
169:       directive = args.shift
170:       case directive
171:         # BOZO !! Idea - could use a formatter object to specificy how you want to format this series
172:         when :axis_category_text
173:           categories = args.first.is_a?(Array) ? args.shift : []
174:           raise ArgumentError, "Must specify an array of categories" if categories.empty?
175:           # don't side effect the passed in categs
176:           categs = categories.clone
177:           categs.insert( 0, nil )
178:           @options[directive] = categs
179:         # BOZO !! Need to constrain this only scatter and bubble support this !!
180:         when :axis_category_label
181:           labels = args.first.is_a?(Array) ? args.shift : []
182:           raise ArgumentError, "Must specify an array of category labels" if labels.empty?
183:           @options[directive] = labels          
184:         when :composites
185:           composites = args.first.is_a?(Hash) ? args.shift: []
186:           raise ArgumentError, "Must specify a hash of id => url pairs for the composite chart(s)" if composites.empty?
187:           @options[directive] = composites
188:         when :axis_value_label
189:           values = args.first.is_a?(Array) ? args.shift : []
190:           raise ArgumentError, "Must specify an array of values" if values.empty?
191:           @options[directive] = values
192:         when :series
193:           series = {}
194:           legend = args.first.is_a?(String) ? args.shift : ""
195:           if args.first.is_a?( Array )
196:             points = args.shift || []
197:             raise ArgumentError, "Must specify an array of data points" if points.empty?
198:             # don't side effect the passed in series
199:             pts = points.clone
200:             pts.insert( 0, legend )
201:             series[:points] = pts
202:           else
203:             raise ArgumentError, "Must specify an array of data points"
204:           end
205:           url = args.shift          
206:           series[:url] = url if url
207:           @series_desc << series
208:         when :user_data
209:           key = args.first.is_a?(Symbol) ? args.shift : ""
210:           raise ArgumentError, "Must specify a key" if key.to_s.empty?
211:           value = args.shift
212:           # raise ArgumentError, "Must specify a value" if value.empty?
213:           @options[key] = value
214:         when :styles
215:           styles = args.first.is_a?(String) ? args.shift : ""
216:           raise ArgumentError, "Must specify a set of styles" if styles.to_s.empty?          
217:           @options[directive] = styles   
218:         when :chart_types
219:           types = args.first.is_a?(Array) ? args.shift : []
220:           raise ArgumentError, "Must specify a set of chart types" if types.to_s.empty?          
221:           @options[directive] = types                        
222:         when :theme
223:           theme = args.first.is_a?(String) ? args.shift : ""
224:           raise ArgumentError, "Must specify a theme name" if theme.to_s.empty?          
225:           @theme = "#{Ziya.themes_dir}/#{theme}"
226:         when :mode
227:           @render_mode = args.first.is_a?(Integer) ? args.shift : -1
228:           raise ArgumentError, "Must specify a valid generation mode" if @render_mode == -1          
229:         else raise ArgumentError, "Invalid directive must be one of " + 
230:                                  ":axis_category_text, :axis_value, :series, :user_data"
231:       end 
232:     end

     # File lib/ziya/charts/base.rb, line 238
238:     def to_s( options={} )
239:       @partial = options[:partial] || false
240:       @xml     = Builder::XmlMarkup.new
241:       # Forces utf8 encoding on xml stream
242:       @xml.instruct! :xml, :version => "1.0", :encoding => "UTF-8"
243:       @xml.chart do
244:         @xml.license( @license ) unless @license.nil?
245:         if render_parents?
246:           if @type
247:             @xml.chart_type( @type )              
248:           elsif @options[:chart_types].is_a? Array and ! @options[:chart_types].empty?
249:             @xml.chart_type do   
250:               @options[:chart_types].each { |type| @xml.string( type ) }   
251:             end
252:           end
253:         end
254:         setup_lnf
255:         setup_series
256:       end
257:       @xml.to_s.gsub( /<to_s\/>/, '' )
258:     end