dyi 0.0.2 → 1.0.0

data/lib/dyi/color.rb

@@ -23,7 +23,7 @@ module DYI #:nodoc:
 
   class Color
     @@named_colors = {'aliceblue'=>[240,248,255],'antiquewhite'=>[250,235,215],'aqua'=>[0,255,255],'aquamarine'=>[127,255,212],'azure'=>[240,255,255],'beige'=>[245,245,220],'bisque'=>[255,228,196],'black'=>[0,0,0],'blanchedalmond'=>[255,235,205],'blue'=>[0,0,255],'blueviolet'=>[138,43,226],'brown'=>[165,42,42],'burlywood'=>[222,184,135],'cadetblue'=>[95,158,160],'chartreuse'=>[127,255,0],'chocolate'=>[210,105,30],'coral'=>[255,127,80],'cornflowerblue'=>[100,149,237],'cornsilk'=>[255,248,220],'crimson'=>[220,20,60],'cyan'=>[0,255,255],'darkblue'=>[0,0,139],'darkcyan'=>[0,139,139],'darkgoldenrod'=>[184,134,11],'darkgray'=>[169,169,169],'darkgreen'=>[0,100,0],'darkgrey'=>[169,169,169],'darkkhaki'=>[189,183,107],'darkmagenta'=>[139,0,139],'darkolivegreen'=>[85,107,47],'darkorange'=>[255,140,0],'darkorchid'=>[153,50,204],'darkred'=>[139,0,0],'darksalmon'=>[233,150,122],'darkseagreen'=>[143,188,143],'darkslateblue'=>[72,61,139],'darkslategray'=>[47,79,79],'darkslategrey'=>[47,79,79],'darkturquoise'=>[0,206,209],'darkviolet'=>[148,0,211],'deeppink'=>[255,20,147],'deepskyblue'=>[0,191,255],'dimgray'=>[105,105,105],'dimgrey'=>[105,105,105],'dodgerblue'=>[30,144,255],'firebrick'=>[178,34,34],'floralwhite'=>[255,250,240],'forestgreen'=>[34,139,34],'fuchsia'=>[255,0,255],'gainsboro'=>[220,220,220],'ghostwhite'=>[248,248,255],'gold'=>[255,215,0],'goldenrod'=>[218,165,32],'gray'=>[128,128,128],'grey'=>[128,128,128],'green'=>[0,128,0],'greenyellow'=>[173,255,47],'honeydew'=>[240,255,240],'hotpink'=>[255,105,180],'indianred'=>[205,92,92],'indigo'=>[75,0,130],'ivory'=>[255,255,240],'khaki'=>[240,230,140],'lavender'=>[230,230,250],'lavenderblush'=>[255,240,245],'lawngreen'=>[124,252,0],'lemonchiffon'=>[255,250,205],'lightblue'=>[173,216,230],'lightcoral'=>[240,128,128],'lightcyan'=>[224,255,255],'lightgoldenrodyellow'=>[250,250,210],'lightgray'=>[211,211,211],'lightgreen'=>[144,238,144],'lightgrey'=>[211,211,211],'lightpink'=>[255,182,193],'lightsalmon'=>[255,160,122],'lightseagreen'=>[32,178,170],'lightskyblue'=>[135,206,250],'lightslategray'=>[119,136,153],'lightslategrey'=>[119,136,153],'lightsteelblue'=>[176,196,222],'lightyellow'=>[255,255,224],'lime'=>[0,255,0],'limegreen'=>[50,205,50],'linen'=>[250,240,230],'magenta'=>[255,0,255],'maroon'=>[128,0,0],'mediumaquamarine'=>[102,205,170],'mediumblue'=>[0,0,205],'mediumorchid'=>[186,85,211],'mediumpurple'=>[147,112,219],'mediumseagreen'=>[60,179,113],'mediumslateblue'=>[123,104,238],'mediumspringgreen'=>[0,250,154],'mediumturquoise'=>[72,209,204],'mediumvioletred'=>[199,21,133],'midnightblue'=>[25,25,112],'mintcream'=>[245,255,250],'mistyrose'=>[255,228,225],'moccasin'=>[255,228,181],'navajowhite'=>[255,222,173],'navy'=>[0,0,128],'oldlace'=>[253,245,230],'olive'=>[128,128,0],'olivedrab'=>[107,142,35],'orange'=>[255,165,0],'orangered'=>[255,69,0],'orchid'=>[218,112,214],'palegoldenrod'=>[238,232,170],'palegreen'=>[152,251,152],'paleturquoise'=>[175,238,238],'palevioletred'=>[219,112,147],'papayawhip'=>[255,239,213],'peachpuff'=>[255,218,185],'peru'=>[205,133,63],'pink'=>[255,192,203],'plum'=>[221,160,221],'powderblue'=>[176,224,230],'purple'=>[128,0,128],'red'=>[255,0,0],'rosybrown'=>[188,143,143],'royalblue'=>[65,105,225],'saddlebrown'=>[139,69,19],'salmon'=>[250,128,114],'sandybrown'=>[244,164,96],'seagreen'=>[46,139,87],'seashell'=>[255,245,238],'sienna'=>[160,82,45],'silver'=>[192,192,192],'skyblue'=>[135,206,235],'slateblue'=>[106,90,205],'slategray'=>[112,128,144],'slategrey'=>[112,128,144],'snow'=>[255,250,250],'springgreen'=>[0,255,127],'steelblue'=>[70,130,180],'tan'=>[210,180,140],'teal'=>[0,128,128],'thistle'=>[216,191,216],'tomato'=>[255,99,71],'turquoise'=>[64,224,208],'violet'=>[238,130,238],'wheat'=>[245,222,179],'white'=>[255,255,255],'whitesmoke'=>[245,245,245],'yellow'=>[255,255,0],'yellowgreen'=>[154,205,50]}
-    @@default_format = ['rgb(%d,%d,%d)', false]
+    @@default_format = ['#%02X%02X%02X', false]
     attr_reader :name
 
     # :call-seq:

data/lib/dyi/drawing.rb

@@ -21,7 +21,6 @@
 
 %w(
 
-canvas
 pen
 pen_3d
 clipping
@@ -30,3 +29,11 @@ color_effect
 ).each do |file_name|
   require File.join(File.dirname(__FILE__), 'drawing', file_name)
 end
+
+module DYI
+  module Drawing
+    # DYI::Drawing::Canvas is depricated; use DYI::Canvas
+    # @deprecated
+    Canvas = DYI::Canvas
+  end
+end

data/lib/dyi/drawing/clipping.rb

@@ -22,15 +22,28 @@
 module DYI #:nodoc:
   module Drawing #:nodoc:
 
-    class Clipping
+    class Clipping < Element
       RULES = ['nonzero', 'evenodd']
       attr_reader :rule, :shapes
+      attr_reader :canvas
 
       def initialize(*shapes)
         @shapes = shapes
         @rules = Array.new(shapes.size)
       end
 
+      def child_elements
+        @shapes
+      end
+
+      def set_canvas(canvas)
+        if @canvas.nil?
+          @canvas = canvas
+        elsif @canvas != canvas
+          raise Arguments, "the clipping is registered to another canvas"
+        end
+      end
+
       def add_shape(shape, rule=nil)
         raise ArgumentError, "\"#{rule}\" is invalid rule" if rule && !RULES.include?(rule)
         unless @shapes.include?(shape)

data/lib/dyi/drawing/pen.rb

@@ -104,6 +104,16 @@ module DYI #:nodoc:
         Shape::Ellipse.create_on_center_radius(center_point, radius_x, radius_y, merge_option(options)).draw_on(canvas)
       end
 
+      # @since 1.0.0
+      def draw_image(canvas, left_top_point, width, height, file_path, options={})
+        Shape::Image.new(left_top_point, width, height, file_path, merge_option(options)).draw_on(canvas)
+      end
+
+      # @since 1.0.0
+      def import_image(canvas, left_top_point, width, height, image_uri, options={})
+        Shape::ImageReference.new(left_top_point, width, height, image_uri, merge_option(options)).draw_on(canvas)
+      end
+
       def draw_sector(canvas, center_point, radius_x, radius_y, start_angle, center_angle, options={})
         raise ArgumentError, "center_angle is out of range: #{center_angle}" if center_angle.abs > 360
         center_point = Coordinate.new(center_point)
@@ -142,7 +152,7 @@ module DYI #:nodoc:
       #:stopdoc:
       ALIAS_ATTRIBUTES =
         Painting::IMPLEMENT_ATTRIBUTES.inject({}) do |hash, key|
-          hash[$'.empty? ? :color : $'.to_sym] = key if key.to_s =~ /^(stroke_|stroke$)/
+          hash[$'.empty? ? :color : $'.to_sym] = key if key.to_s =~ /^(stroke_|stroke$)/ && key != :stroke_opacity
           hash
         end
       #:startdoc:
@@ -193,7 +203,7 @@ module DYI #:nodoc:
       #:stopdoc:
       ALIAS_ATTRIBUTES =
         Painting::IMPLEMENT_ATTRIBUTES.inject({}) do |hash, key|
-          hash[$'.empty? ? :color : $'.to_sym] = key if key.to_s =~ /^(fill_|fill$)/
+          hash[$'.empty? ? :color : $'.to_sym] = key if key.to_s =~ /^(fill_|fill$)/ && key != :fill_opacity
           hash
         end
       #:startdoc:

data/lib/dyi/element.rb

@@ -0,0 +1,167 @@
+# -*- 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 DYI::Element class, which is abstract base class of
+# DYI::Canvas and DYI::Shape::Base.
+#
+# @since 1.0.0
+
+module DYI #:nodoc:
+
+  class Element
+    extend AttributeCreator
+    ID_REGEXP = /\A[:A-Z_a-z][\-\.0-9:A-Z_a-z]*\z/
+
+    # Returns id for the element. If the element has no id yet, makes id and
+    # returns it.
+    # @return [String] id for the element
+    def id
+      @id ||= canvas && canvas.publish_shape_id
+    end
+
+    alias publish_id id
+
+    # Returns id of the element. If the element has no id yet, returns nil.
+    # @return [String] id for the element if it has id, nil if not
+    def inner_id
+      @id
+    end
+
+    # Sets id for the element.
+    # @param [String] value id for the element
+    # @return [String] id that is given
+    # @raise [ArgumentError] value is empty or illegal format
+    def id=(value)
+      # TODO: veryfy that the id is unique.
+      raise ArgumentError, "`#{value}' is empty" if value.to_s.size == 0
+      raise ArgumentError, "`#{value}' is a illegal id" if value.to_s !~ ID_REGEXP
+      @id = value.to_s
+    end
+
+    # Returns the canvas where the shape is drawn
+    # @return [Canvas] the canvas where the shape is drawn
+    def canvas
+      current_node = self
+      loop do
+        return current_node if current_node.nil? || current_node.root_element?
+        current_node = current_node.parent
+      end
+    end
+
+    def child_elements
+      []
+    end
+
+    def include_external_file?
+      false
+    end
+
+    # @return [Boolean] whether the element has a URI reference
+    def has_uri_reference?
+      false
+    end
+  end
+
+  class GraphicalElement < Element
+    attr_reader :css_class
+    CLASS_REGEXP = /\A[A-Z_a-z][\-0-9A-Z_a-z]*\z/
+
+    def css_class=(css_class)
+      classes = css_class.to_s.split(/\s+/)
+      classes.each do |c|
+        if c.to_s !~ CLASS_REGEXP
+          raise ArgumentError, "`#{c}' is a illegal class-name"
+        end
+      end
+      @css_class = classes.join(' ')
+    end
+
+    def css_classes
+      css_class.split(/\s+/)
+    end
+
+    def add_css_class(css_class)
+      if css_class.to_s !~ CLASS_REGEXP
+        raise ArgumentError, "`#{css_class}' is a illegal class-name"
+      end
+      unless css_classes.include?(css_class.to_s)
+        @css_class += " #{css_class}"
+        css_class
+      end
+      nil
+    end
+
+    def remove_css_class(css_class)
+      classes = css_classes
+      if classes.delete(css_class.to_s)
+        @css_class = classes.join(' ')
+        css_class
+      else
+        nil
+      end
+    end
+
+    # Returns event listeners that is associated with the element
+    def event_listeners
+      @event_listeners ||= {}
+    end
+
+    # Adds a animation of painting to the element
+    # @param [Event] an event that is set to the element
+    # @return [void]
+    def set_event(event)
+      @events ||= []
+      @events << event
+      publish_id
+    end
+
+    # @return [Boolean] whether event is set to the element
+    def event_target?
+      !(@events.nil? || @events.empty?)
+    end
+
+    # Associates the element with a event listener
+    # @param [Symbol] event_name a event name
+    # @param [Script::SimpleScript|String] event_listener a event listener
+    # @return [void]
+    def add_event_listener(event_name, event_listener)
+      if event_listeners.key?(event_name)
+        unless event_listeners[event_name].include?(event_listener)
+          event_listeners[event_name] << event_listener
+        end
+      else
+        event_listeners[event_name] = [event_listener]
+      end
+    end
+
+    # Removes asociation with given event listener
+    # @param [Symbol] event_name a event name
+    # @param [Script::SimpleScript|String] event_listener a event listener
+    # @return [void]
+    def remove_event_listener(event_name, event_listener)
+      if event_listeners.key?(event_name)
+        event_listeners[event_name].delete(event_listener)
+      end
+    end
+  end
+end

data/lib/dyi/event.rb

@@ -0,0 +1,148 @@
+# -*- 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 DYI::Event class, which provides event supports for
+# DYI.  The event becomes effective only when it is output by SVG format.
+#
+# See the documentation to the DYI::Length class for more details and
+# examples of usage.
+#
+# @since 1.0.0
+
+module DYI
+
+  # Class representing a event.  The event becomes effective only when it is
+  # output by SVG format.
+  class Event
+    IMPLEMENT_EVENTS = [:focusin,:focusout,:click,:mousedown,:mouseup,
+                        :mouseover,:mousemove,:mouseout,:load]
+
+    # @return [Symbol] event name
+    attr_reader :event_name
+
+    # @return [GraphicalElement] an element to which the event applied
+    attr_reader :target
+
+    # @return [Array] a list of event listener
+    attr_reader :listeners
+
+    # @param [Symbol] event_name event name, one of followings: focusin,
+    #                            focusout, click, mousedown, mouseup, mouseover,
+    #                            mousemove, mouseout, load
+    # @param [GraphicalElement] target a element to which the event applied
+    # @raise [ArgumentError] unknown event name is given
+    def initialize(event_name, target)
+      event_name = event_name.to_sym
+      unless IMPLEMENT_EVENTS.include?(event_name)
+        raise ArgumentError, "`#{event_name}' is unknown event"
+      end
+      @event_name = event_name
+      @listeners = []
+      (@target = target).set_event(self)
+    end
+
+    # Sets a event listener.
+    # @param [Script::EcmaScript::EventListener] event_listener a script to be
+    #           called when the event occurs
+    # @return [void]
+    def set_listener(event_listener)
+      target.add_event_listener(event_name, event_listener)
+      event_listener.related_to(self)
+    end
+
+    # Removes a event listener.
+    # @param [Script::EcmaScript::EventListener] event_listener a script that
+    #           is removed
+    # @return [void]
+    def remove_listener(event_listener)
+      target.remove_event_listener(event_name, event_listener)
+      event_listener.unrelated_to(self)
+    end
+
+    class << self
+
+      # Creates a new focus-in event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new focus-in event
+      def focusin(target)
+        new(:focusin, target)
+      end
+
+      # Creates a new focus-out event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new focus-out event
+      def focusout(target)
+        new(:focusout, target)
+      end
+
+      # Creates a new click event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new click event
+      def click(target)
+        new(:click, target)
+      end
+
+      # Creates a new mouse-down event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new mouse-down event
+      def mousedown(target)
+        new(:mousedown, target)
+      end
+
+      # Creates a new mouse-up event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new mouse-up event
+      def mouseup(target)
+        new(:mouseup, target)
+      end
+
+      # Creates a new mouse-over event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new mouse-over event
+      def mouseover(target)
+        new(:mouseover, target)
+      end
+
+      # Creates a new mouse-move event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new mouse-move event
+      def mousemove(target)
+        new(:mousemove, target)
+      end
+
+      # Creates a new mouse-out event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new mouse-out event
+      def mouseout(target)
+        new(:mouseout, target)
+      end
+
+      # Creates a new load event.
+      # @param target (see Event#initialize)
+      # @return [Event] a new load event
+      def load(target)
+        new(:load, target)
+      end
+    end
+  end
+end

data/lib/dyi/formatter/base.rb

@@ -75,6 +75,10 @@ module DYI #:nodoc:
         raise NotImplementedError
       end
 
+      # @since 1.0.0
+      def write_image(shape, io)
+      end
+
       def write_text(shape, io)
         raise NotImplementedError
       end
@@ -170,10 +174,28 @@ module DYI #:nodoc:
         @level = level
       end
 
-      def instruction
+      def xml_instruction
         %Q{<?xml version="1.0" encoding="UTF-8"?>}
       end
 
+      def stylesheet_instruction(stylesheet)
+        styles = []
+        styles << '<?xml-stylesheet href="'
+        styles << stylesheet.href
+        styles << '" type="'
+        styles << stylesheet.content_type
+        if stylesheet.title
+          styles << '" title="'
+          styles << stylesheet.title
+        end
+        if stylesheet.media
+          styles << '" media="'
+          styles << stylesheet.media
+        end
+        styles << '"?>'
+        styles.join
+      end
+
       def generator_comment
         %Q{<!-- Create with DYI #{DYI::VERSION} (#{DYI::URL}) -->}
       end
@@ -183,8 +205,13 @@ module DYI #:nodoc:
       end
 
       def puts(io=$>)
-        if @canvas.root_node?
-          puts_line(io) {io << instruction}
+        if @canvas.root_element?
+          puts_line(io) {io << xml_instruction}
+          @canvas.stylesheets.each do |stylesheet|
+            if stylesheet.include_external_file?
+              puts_line(io) {io << stylesheet_instruction(stylesheet)}
+            end
+          end
           puts_line(io) {io << generator_comment}
           declaration.each_line do |dec|
             puts_line(io) {io << dec}
@@ -240,6 +267,19 @@ module DYI #:nodoc:
       ensure
         @level -= 1
       end
+
+      # @since 1.0.0
+      def create_cdata_node(io, tag_name, attributes={}, &block) #:nodoc:
+        puts_line(io) {
+          io << '<' << tag_name
+          attributes.each do |key, value|
+            io << ' ' << key << '="' << attr_escape(value) << '"'
+          end
+          io << '><![CDATA['
+        }
+        yield
+        puts_line(io) {io << ']]></' << tag_name << '>'}
+      end
     end
   end
 end