Class: Gruff::Bar

Inherits:
Base
  • Object
show all
Defined in:
lib/gruff/bar.rb

Direct Known Subclasses

Mini::Bar

Constant Summary

Constants inherited from Base

Gruff::Base::DEFAULT_MARGIN, Gruff::Base::DEFAULT_TARGET_WIDTH, Gruff::Base::LABEL_MARGIN, Gruff::Base::LEGEND_MARGIN, Gruff::Base::THOUSAND_SEPARATOR

Instance Attribute Summary collapse

Attributes inherited from Base

#additional_line_values, #bold_title, #bottom_margin, #center_labels_over_point, #colors, #font, #font_color, #has_left_labels, #hide_legend, #hide_line_markers, #hide_line_numbers, #hide_title, #label_max_size, #label_stagger_height, #label_truncation_style, #labels, #left_margin, #legend_at_bottom, #legend_box_size, #legend_font_size, #legend_margin, #marker_color, #marker_count, #marker_font_size, #marker_shadow_color, #maximum_value, #minimum_value, #no_data_message, #right_margin, #sort, #sorted_drawing, #title, #title_font, #title_font_size, #title_margin, #top_margin, #use_data_label, #x_axis_increment, #x_axis_label, #y_axis_increment, #y_axis_label

Instance Method Summary collapse

Methods inherited from Base

#add_color, #data, #initialize, #margins=, #replace_colors, #theme=, #theme_37signals, #theme_greyscale, #theme_keynote, #theme_odeo, #theme_pastel, #theme_rails_keynote, #to_blob, #write

Constructor Details

This class inherits a constructor from Gruff::Base

Instance Attribute Details

#bar_spacingObject

Spacing factor applied between bars.



8
9
10
# File 'lib/gruff/bar.rb', line 8

def bar_spacing
  @bar_spacing
end

#group_spacingObject

Spacing factor applied between a group of bars belonging to the same label.



11
12
13
# File 'lib/gruff/bar.rb', line 11

def group_spacing
  @group_spacing
end

#label_formattingObject

Set the number output format for labels using sprintf. Default is “%.2f”.



15
16
17
# File 'lib/gruff/bar.rb', line 15

def label_formatting
  @label_formatting
end

#show_labels_for_bar_valuesObject

Output the values for the bars on a bar graph. Default is false.



19
20
21
# File 'lib/gruff/bar.rb', line 19

def show_labels_for_bar_values
  @show_labels_for_bar_values
end

Instance Method Details

#drawObject



29
30
31
32
33
34
35
36
37
38
39
# File 'lib/gruff/bar.rb', line 29

def draw
  # Labels will be centered over the left of the bar if
  # there are more labels than columns. This is basically the same
  # as where it would be for a line graph.
  @center_labels_over_point = (@labels.keys.length > column_count)

  super
  return unless data_given?

  draw_bars
end

#spacing_factor=(space_percent) ⇒ Object

Can be used to adjust the spaces between the bars. Accepts values between 0.00 and 1.00 where 0.00 means no spacing at all and 1 means that each bars’ width is nearly 0 (so each bar is a simple line with no x dimension).

Default value is 0.9.

Raises:

  • (ArgumentError)


47
48
49
50
51
# File 'lib/gruff/bar.rb', line 47

def spacing_factor=(space_percent)
  raise ArgumentError, 'spacing_factor must be between 0.00 and 1.00' unless (space_percent >= 0) && (space_percent <= 1)

  @spacing_factor = (1 - space_percent)
end