dyi 0.0.2 → 1.0.0

data/CHANGES

@@ -1,5 +1,18 @@
 = DYI Changelog
 
+== Version 1.0.0 / 2011-09-05
+
+* Major Enhancements
+  * Support events on SVG.
+  * Support animations on SVG.
+  * Support scripts (ex. ECMAScript) on SVG.
+  * Support hyperlinks on SVG.
+  * Support a SVG file that includes style-sheet (ex. CSS, XLST).
+  * Support PNG output. (Needs rsvg-convert)
+  * Support raster image handling (ex. PNG, JPEG) on SVG.
+  * Add Pie-Chart options.
+  * Modify the handling of Reader classes.
+
 == Version 0.0.2 / 2011-09-05
 
 * Minor Enhancements

data/examples/animation.rb

@@ -0,0 +1,28 @@
+# -*- encoding: UTF-8 -*-
+
+require 'rubygems'
+require 'dyi'
+
+canvas = DYI::Canvas.new(400, 300)
+
+rect = DYI::Drawing::Brush.new(:color=>'#51ADE2').draw_rectangle(canvas, [10,10], 300, 200)
+rect.add_painting_animation(:from => {:fill => '#51ADE2'},
+                            :to => {:fill => 'red'},
+                            :duration => 3,
+                            :begin_event => DYI::Event.mouseover(rect),
+                            :end_event => DYI::Event.mouseout(rect),
+                            :fill => 'freeze')
+text = DYI::Drawing::Brush.new.draw_text(canvas,
+                                         [100,250],
+                                         'click me!',
+                                         :show_border => true,
+                                         :border_color=>'#325BA8',
+                                         :padding => 8,
+                                         :border_rx => 10,
+                                         :border_width => 3,
+                                         :background_color=>'#A5C7F8')
+rect.add_painting_animation(:to => {:fill => 'green'},
+                            :begin_event => DYI::Event.click(text),
+                            :fill => 'freeze')
+
+canvas.save('output/animation.svg')

data/examples/class_diagram.rb

@@ -78,7 +78,7 @@ class ArrowPen < DYI::Drawing::Pen
   end
 end
 
-canvas = DYI::Drawing::Canvas.new 1300, 1300
+canvas = DYI::Canvas.new 1300, 1300
 
 pen = ArrowPen.new
 dashed_pen = ArrowPen.new(:stroke_dasharray => [3])

data/examples/css.rb

@@ -0,0 +1,34 @@
+# -*- encoding: UTF-8 -*-
+
+require 'rubygems'
+require 'dyi'
+
+canvas = DYI::Canvas.new(300, 250)
+
+pen = DYI::Drawing::Pen.new(:color => 'red')
+pen.draw_rectangle(canvas, [20, 20], 240, 100)
+pen.draw_rectangle(canvas, [20, 140], 240, 100, :css_class => 'sample-css')
+pen = DYI::Drawing::Brush.new(:color => 'red')
+pen.draw_circle(canvas, [120, 130], 40)
+pen.draw_circle(canvas, [230, 130], 40, :css_class => 'transparent')
+
+css =<<-EOS
+rect {
+  fill: yellow;
+  stroke-dasharray: 10 5;
+}
+rect.sample-css {
+  fill: skyblue;
+  stroke: blue;
+  stroke-width: 5;
+}
+.transparent {
+  fill: none;
+  stroke: green;
+  stroke-width: 3;
+}
+EOS
+
+canvas.add_stylesheet(css)
+
+canvas.save 'output/css.svg'

data/examples/line_and_bar.rb

@@ -13,13 +13,12 @@ chart = DYI::Chart::LineChart.new 800,500,
   :chart_types => [:line, :bar],
   :line_width => 3,
   :show_dropshadow => true,
-  :color_columns => [nil, 2],
 #  :represent_3d => true,
 #  :_3d_settings => {:dx => 30, :dy => -10},
   :show_legend => false,
   :legend_point => [50, 480]
 
-reader = DYI::Chart::CsvReader.read('data/money.csv', :data_types => [:number, :number, :string], :title_column=>0, :column_skip => 1)
+reader = DYI::Chart::CsvReader.read('data/money.csv', :data_types => [:string, :number, :number, :string], :schema => [:name, :value, :value, :color])
 chart.load_data reader
 
 chart.save 'output/line_and_bar.svg'

data/examples/line_chart.rb

@@ -10,19 +10,18 @@ gr.add_color(1, '#D5EEF2')
 chart = DYI::Chart::LineChart.new 720,300,
 #  :represent_3d => true,
   :axis_format => '#,##0',
-  :data_columns => [0, 3, 1],
-  :use_y_second_axises => [nil, nil, true],
-  :chart_types => [:line, :line, :area],
+  :use_y_second_axises => [false, true, false],
+  :chart_types => [:line, :area, :line],
   :x_axis_format => '%Y/%m/%d',
   :axis_font => {:font_family => 'HGPGOTHICM', :size => 12},
   :show_legend => true,
 #  :axis_settings => {:min=>4000, :max=> 16000},
-  :chart_colors => ['#F68C23', '#89C549', gr],
+  :chart_colors => ['#F68C23', gr, '#89C549'],
   :line_width => 3,
   :legend_font => {},
-  :legend_texts => ['Constant value (left axis)', 'Constant value of Dividend  Reinvestment (left axis)', 'Net Assets (right axis)']
+  :legend_texts => ['Constant value (left axis)', 'Net Assets (right axis)', 'Constant value of Dividend  Reinvestment (left axis)']
 
-reader = DYI::Chart::ExcelReader.read('data/03311056.xlsx', :sheet => 'Sheet2', :title_column=>1, :column_skip=>2, :title_row=>1, :row_skip=>2)
+reader = DYI::Chart::ExcelReader.read('data/03311056.xlsx', :sheet => 'Sheet2', :schema => [:name, :value, :value, :profit, :value], :column_range => 1..5, :row_range => 2..-1 )
 chart.load_data reader
 
 chart.save 'output/line_chart.svg'

data/examples/logo.rb

@@ -3,7 +3,7 @@
 require 'rubygems'
 require 'dyi'
 
-canvas = DYI::Drawing::Canvas.new(287.008, 162.637)
+canvas = DYI::Canvas.new(287.008, 162.637)
 
 DYI::Drawing::Brush.new(:color=>'#51ADE2').draw_closed_path(canvas, [287.008,0]) {|path|
   path.rline_to([0,162.637], [-39.41,0])

data/examples/pie_chart.rb

@@ -4,14 +4,21 @@ require 'rubygems'
 require 'dyi'
 
 chart = DYI::Chart::PieChart.new 400,500,
-  :data_label_format => "{name}\n{percent}",
+  :data_label_format => "{?name}\n{?percent}",
+  :data_label_font => {:size => 20, :font_family=>'Serif'},
   :represent_3d => true,
-  :moved_elements => [0.2,nil,nil,0.5],
-  :chart_colors => ['blue', 'red', 'yellow', 'green'],
+  :show_data_label => false,
+  :show_baloon => true,
+  :baloon_opacity => 0.3,
+  :baloon_format => "{?name}\n{?percent}",
+#  :moved_elements => [0.2,nil,nil,0.5],
+#  :chart_colors => ['blue', 'red', 'yellow', 'green'],
   :_3d_settings => {:dy => 30},
+  :background_image_opacity => 0.1,
+  :legend_format => "{?name}\t{!e}{?value:#,##0}\t{!e}({?percent:0.00%})",
   :chart_stroke_color => 'white'
 
-reader = DYI::Chart::ExcelReader.read('data/currency.xlsx', :title_column=>0, :column_skip=>1)
+reader = DYI::Chart::ExcelReader.read('data/currency.xlsx', :schema => [:name, :value])
 chart.load_data reader
 
 chart.save 'output/pie_chart.svg'

data/examples/simple_shapes.rb

@@ -3,7 +3,7 @@
 require 'rubygems'
 require 'dyi'
 
-canvas = DYI::Drawing::Canvas.new(500, 500)
+canvas = DYI::Canvas.new(500, 500)
 
 pen = DYI::Drawing::Pen.new(:color => 'blue')
 pen.draw_rectangle(canvas, [30, 30], 30, 30)

data/lib/dyi.rb

@@ -21,7 +21,7 @@
 
 
 module DYI
-  VERSION = '0.0.2'
+  VERSION = '1.0.0'
   URL = 'http://sourceforge.net/projects/dyi/'
 end
 
@@ -36,8 +36,14 @@ dyi/font
 dyi/matrix
 dyi/type
 dyi/svg_element
-dyi/drawing
+dyi/element
+dyi/canvas
 dyi/shape
+dyi/drawing
+dyi/event
+dyi/animation
+dyi/script
+dyi/stylesheet
 dyi/formatter
 dyi/chart
 

data/lib/dyi/animation.rb

@@ -0,0 +1,259 @@
+# -*- encoding: UTF-8 -*-
+
+# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+#
+# Author:: Mamoru Yuo
+#
+# This file is part of DYI.
+#
+# DYI is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# DYI is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with DYI.  If not, see <http://www.gnu.org/licenses/>.
+#
+# == Overview
+#
+# This file provides the classes of animation.  The event becomes effective
+# only when it is output by SVG format.
+#
+# @since 1.0.0
+
+module DYI #:nodoc:
+  module Animation #:nodoc:
+
+    # Base class for animation classes.
+    # @abstract
+    # @attr [Object] from a starting value of the animation
+    # @attr [Object] to a ending value of the animation
+    # @attr [Numeric] duration a simple duration of the animation
+    # @attr [Numeric] begin_offset a offset that determine the animation begin
+    # @attr [Event] begin_event an event that determine the element begin
+    # @attr [Numeric] end_offset a offset that determine the animation end
+    # @attr [Event] end_event an event that determine the element end
+    # @attr [String] fill the effect of animation when the animation is over,
+    #       either 'freeze' or 'remove'
+    # @attr [String] additive a value that means whether or not the animation is
+    #       additive, either 'replace' or 'sum'
+    # @attr [String] restart a value for the restart, either 'always',
+    #       'whenNotActive'or 'never'
+    class Base
+      IMPLEMENT_ATTRIBUTES = [:from, :to, :duration, :begin_offset,
+                              :begin_event, :end_offset, :end_event, :fill,
+                              :additive, :restart]
+      VALID_VALUES = {
+        :fill => ['freeze','remove'],
+        :additive => ['replace', 'sum'],
+        :restart => ['always', 'whenNotActive', 'never']
+      }
+
+      attr_reader *IMPLEMENT_ATTRIBUTES
+
+      VALID_VALUES.each do |attr, valid_values|
+        define_method("#{attr.to_s}=") {|value|
+          if (value = value.to_s).size == 0
+            instance_variable_set("@#{attr}", nil)
+          else
+            unless VALID_VALUES[attr].include?(value)
+              raise ArgumentError, "`#{value}' is invalid #{attr}"
+            end
+            instance_variable_set("@#{attr}", value)
+          end
+        }
+      end
+
+      def duration=(duration)
+        @duration = duration
+      end
+
+      def begin_offset=(offset)
+        @begin_offset = offset
+      end
+
+      def begin_event=(event)
+        @begin_event = event
+      end
+
+      def end_offset=(offset)
+        @end_offset = offset
+      end
+
+      def end_event=(event)
+        @end_event = event
+      end
+
+      # @param [Shape::Base] shape a target element for an animation
+      # @param [Hash] options an option for an animation
+      def initialize(shape, options)
+        raise ArgumentError, "`:to' option is required" unless options.key?(:to)
+        @shape = shape
+        options.each do |attr, value|
+          if IMPLEMENT_ATTRIBUTES.include?(attr.to_sym)
+            __send__("#{attr}=", value)
+          end
+        end
+      end
+    end
+
+    # Class representing an animation of a painting
+    # @attr [Painting] from a starting value of the animation
+    # @attr [Painting] to a ending value of the animation
+    class PaintingAnimation < Base
+
+      def from=(painting)
+        @from = painting && DYI::Painting.new(painting)
+      end
+
+      def to=(painting)
+        @to = DYI::Painting.new(painting)
+      end
+
+      def animation_attributes
+        DYI::Painting::IMPLEMENT_ATTRIBUTES.inject({}) do |result, attr|
+          from_attr, to_attr = @from && @from.__send__(attr), @to.__send__(attr)
+          if to_attr && from_attr != to_attr
+            result[attr] = [from_attr, to_attr]
+          end
+          result
+        end
+      end
+
+      def write_as(formatter, shape, io=$>)
+        formatter.write_painting_animation(self, shape, io,
+                                           &(block_given? ? Proc.new : nil))
+      end
+    end
+
+    # Class representing an animation of transform
+    # @attr [Symbol] type a type of transform, either 'translate', 'scale',
+    #       'rotate', 'skewX' or 'skewY'
+    # @attr [Numeric|Array] from a starting value of the animation
+    # @attr [Numeric|Array] to a ending value of the animation
+    class TransformAnimation < Base
+      IMPLEMENT_ATTRIBUTES = [:type]
+      VALID_VALUES = {
+        :type => [:translate, :scale, :rotate, :skewX, :skewY]
+      }
+
+      attr_reader *IMPLEMENT_ATTRIBUTES
+
+      VALID_VALUES.each do |attr, valid_values|
+        define_method("#{attr.to_s}=") {|value|
+          if (value = value.to_s).size == 0
+            instance_variable_set("@#{attr}", nil)
+          else
+            unless VALID_VALUES[attr].include?(value)
+              raise ArgumentError, "`#{value}' is invalid #{attr}"
+            end
+            instance_variable_set("@#{attr}", value)
+          end
+        }
+      end
+
+      def from=(value)
+        case type
+        when :translate
+          case value
+          when Array
+            case value.size
+              when 2 then @from = value.map{|v| v.to_f}
+              else raise ArgumentError, "illegal size of Array: #{value.size}"
+            end
+          when Numeric, Length
+            @from = [value.to_f, 0]
+          when nil
+            @from = nil
+          else
+            raise TypeError, "illegal argument: #{value}"
+          end
+        when :scale
+          case value
+          when Array
+            case value.size
+              when 2 then @from = value.map{|v| v.to_f}
+              else raise ArgumentError, "illegal size of Array: #{value.size}"
+            end
+          when Numeric
+            @from = [value.to_f, value.to_f]
+          when nil
+            @from = nil
+          else
+            raise TypeError, "illegal argument: #{value}"
+          end
+        when :rotate, :skewX, :skewY
+          @from = value.nil? ? nil : value.to_f
+        end
+      end
+
+      def to=(value)
+        case type
+        when :translate
+          case value
+          when Array
+            case value.size
+              when 2 then @to = value.map{|v| v.to_f}
+              else raise ArgumentError, "illegal size of Array: #{value.size}"
+            end
+          when Numeric, Length
+            @to = [value.to_f, 0]
+          else
+            raise TypeError, "illegal argument: #{value}"
+          end
+        when :scale
+          case value
+          when Array
+            case value.size
+              when 2 then @to = value.map{|v| v.to_f}
+              else raise ArgumentError, "illegal size of Array: #{value.size}"
+            end
+          when Numeric
+            @to = [value.to_f, value.to_f]
+          else
+            raise TypeError, "illegal argument: #{value}"
+          end
+        when :rotate, :skewX, :skewY
+          @to = value.to_f
+        end
+      end
+
+      def initialize(shape, type, options)
+        @type = type
+        super(shape, options)
+      end
+
+      def write_as(formatter, shape, io=$>)
+        formatter.write_transform_animation(self, shape, io,
+                                            &(block_given? ? Proc.new : nil))
+      end
+
+      class << self
+        def translate(shape, options)
+          new(shape, :translate, options)
+        end
+
+        def scale(shape, options)
+          new(shape, :scale, options)
+        end
+
+        def scale(rotate, options)
+          new(shape, :rotate, options)
+        end
+
+        def skew_x(rotate, options)
+          new(shape, :skewX, options)
+        end
+
+        def skew_y(rotate, options)
+          new(shape, :skewY, options)
+        end
+      end
+    end
+  end
+end