wxruby3-shapes 0.9.0.pre.beta.3

data/lib/wx/shapes/thumbnail.rb

@@ -0,0 +1,234 @@
+# Wx::SF::Thumbnail - canvas thumbnail class
+# Copyright (c) M.J.N. Corino, The Netherlands
+
+module Wx::SF
+
+  class Thumbnail < Wx::Panel
+
+    # Internally used IDs
+    module ID
+      include Wx::IDHelper
+		  UPDATETIMER = self.next_id
+		  M_SHOWELEMENTS = self.next_id
+		  M_SHOWCONNECTIONS = self.next_id
+    end
+
+    # Thumbnail style 
+    class THUMBSTYLE < Wx::Enum
+		  # Show diagram elements (excluding connections) in the thumbnail.
+		  SHOW_ELEMENTS = self.new(1)
+		  # Show diagram connections in the thumbnail.
+		  SHOW_CONNECTIONS = self.new(2)
+    end
+
+    def initialize(parent)
+      super(parent, Wx::ID_ANY, size: [200, 150], style: Wx::TAB_TRAVERSAL | Wx::FULL_REPAINT_ON_RESIZE)
+      set_extra_style(Wx::WS_EX_BLOCK_EVENTS)
+      set_size_hints([10, 10])
+
+      @canvas = nil
+      @scale = 1.0
+      @thumb_style = THUMBSTYLE::SHOW_ELEMENTS | THUMBSTYLE::SHOW_CONNECTIONS
+      @prev_mouse_pos = nil
+
+      @update_timer = Wx::Timer.new(self, ID::UPDATETIMER)
+
+      set_background_style(Wx::BG_STYLE_PAINT)
+
+      evt_paint :_on_paint
+      evt_erase_background :_on_erase_background
+      evt_motion :_on_mouse_move
+      evt_left_down :_on_left_down
+      evt_right_down :_on_right_down
+      evt_timer(ID::UPDATETIMER, :_on_timer)
+      evt_update_ui(ID::M_SHOWELEMENTS, :_on_update_show_elements)
+      evt_update_ui(ID::M_SHOWCONNECTIONS, :_on_update_show_connections)
+      evt_menu(ID::M_SHOWELEMENTS, :_on_show_elements)
+      evt_menu(ID::M_SHOWCONNECTIONS, :_on_show_connections)
+    end
+
+    # Access (get/set) thumbnail style.
+    attr_accessor :thumb_style
+
+	  # Set canvas managed by the thumbnail.
+	  # @param [ShapeCanvas] canvas shape canvas
+    def set_canvas(canvas)
+      @canvas = canvas
+
+      if @canvas
+        @update_timer.start(100)
+      else
+        @update_timer.stop
+        refresh(false)
+      end
+    end
+	
+	  # Implementation of drawing of the thumbnail's content. This virtual function can be overridden
+    # by the user for customization of the thumbnail appearance.
+	  # @param [Wx::DC] dc Reference to output device context
+    def draw_content(dc)
+      # HINT: overload it for custom actions...
+      bmp_pen = nil
+      @canvas.get_diagram.get_all_shapes.each do |shape|
+        if (@thumb_style & THUMBSTYLE::SHOW_CONNECTIONS) != 0 && shape.is_a?(LineShape)
+          shape.draw(dc, WITHOUTCHILDREN)
+        elsif (@thumb_style & THUMBSTYLE::SHOW_ELEMENTS) != 0
+          if shape.is_a?(BitmapShape)
+            bmp_pen ||= Wx::Pen.new(Wx::BLACK, 1, Wx::PENSTYLE_DOT)
+            dc.with_pen(bmp_pen) do
+              dc.with_brush(Wx::WHITE_BRUSH) do
+                dc.draw_rectangle(shape.get_bounding_box)
+              end
+            end
+          elsif !shape.is_a?(LineShape)
+            shape.draw(dc, WITHOUTCHILDREN)
+          end
+        end
+      end
+    end
+
+    protected
+
+    # Internally used event handler.
+    # @param [Wx::PaintEvent] _event
+    def _on_paint(_event)
+      paint_buffered do |dc|
+        # clear background
+        dc.set_background(Wx::Brush.new(Wx::Colour.new(150, 150, 150)))
+        dc.clear
+        
+        if @canvas
+          sz_canvas = @canvas.get_client_size
+          vsx, vsy = @canvas.get_virtual_size
+          sz_canvas_offset = get_canvas_offset
+          sz_thumb = get_client_size
+          
+          # scale and copy bitmap to DC
+          cx = vsx.to_f
+          cy = vsy.to_f
+          tx = sz_thumb.x
+          ty = sz_thumb.y
+          
+          if (tx/ty) > (cx/cy)
+            @scale = ty/cy
+          else
+            @scale = tx/cx
+          end
+      
+          # draw virtual canvas area
+          dc.with_pen(Wx::WHITE_PEN) do
+            dc.with_brush(Wx::Brush.new(Wx::Colour.new(240, 240, 240))) do
+              dc.draw_rectangle(0, 0, (cx*@scale).to_i, (cy*@scale).to_i)
+
+              # draw top level shapes
+              Wx::ScaledDC.draw_on(dc, @scale * @canvas.get_scale)  do |sdc|
+                draw_content(sdc)
+              end
+
+              # draw canvas client area
+              dc.set_pen(Wx::RED_PEN)
+              dc.set_brush(Wx::TRANSPARENT_BRUSH)
+              dc.draw_rectangle((sz_canvas_offset.x.to_f*@scale).to_i, (sz_canvas_offset.y.to_f*@scale).to_i, (sz_canvas.x.to_f*@scale).to_i, (sz_canvas.y.to_f*@scale).to_i)
+            end
+          end
+        end
+        
+        dc.set_background(Wx::NULL_BRUSH)
+      end
+    end
+
+    # Get offset (view start) of managed shape canvas defined in pixels.
+    # @return [Wx::Size] Canvas offset in pixels
+    def get_canvas_offset
+      if @canvas
+        ux, uy = @canvas.get_scroll_pixels_per_unit
+        offset_x, offset_y = @canvas.get_view_start
+
+        return Wx::Size.new(offset_x*ux, offset_y*uy)
+      end
+      Wx::Size.new
+    end
+
+    private
+
+    # Internally used event handler.
+    # @param [Wx::EraseEvent] _event
+    def _on_erase_background(_event)
+      # noop
+    end
+
+    # Internally used event handler.
+    # @param [Wx::MouseEvent] event
+    def _on_mouse_move(event)
+      if @canvas && is_shown && event.dragging
+        ux, uy = @canvas.get_scroll_pixels_per_unit
+        
+        sz_delta = @prev_mouse_pos ? event.get_position - @prev_mouse_pos : event.get_position
+        sz_canvas_offset = get_canvas_offset
+        
+        @canvas.scroll(((sz_delta.x/@scale + sz_canvas_offset.x)/ux).to_i, ((sz_delta.y/@scale + sz_canvas_offset.y)/uy).to_i)
+        
+        @prev_mouse_pos = event.get_position
+        
+        refresh(false)
+      end
+    end
+
+    # Internally used event handler.
+    # @param [Wx::MouseEvent] event
+    def _on_left_down(event)
+      @prev_mouse_pos = event.get_position
+    end
+
+    # Internally used event handler.
+    # @param [Wx::MouseEvent] event
+    def _on_right_down(event)
+      menu_popup = Wx::Menu.new
+
+      menu_popup.append_check_item(IDM_SHOWELEMENTS, 'Show elements')
+      menu_popup.append_check_item(IDM_SHOWCONNECTIONS, 'Show connections')
+
+      popup_menu(menu_popup, event.get_position)
+    end
+
+    # Internally used event handler.
+    # @param [Wx::TimerEvent] _event
+    def _on_timer(_event)
+      refresh(false) if @canvas && is_shown
+    end
+
+    # Internally used event handler.
+    # @param [Wx::CommandEvent] _event
+    def _on_show_elements(_event)
+      if (@thumb_style & THUMBSTYLE::SHOW_ELEMENTS) != 0
+        @thumb_style &= ~THUMBSTYLE::SHOW_ELEMENTS
+      else
+        @thumb_style |= THUMBSTYLE::SHOW_ELEMENTS
+      end
+    end
+
+    # Internally used event handler.
+    # @param [Wx::CommandEvent] _event
+    def _on_show_connections(_event)
+      if (@thumb_style & THUMBSTYLE::SHOW_CONNECTIONS) != 0
+        @thumb_style &= ~THUMBSTYLE::SHOW_CONNECTIONS
+      else
+        @thumb_style |= THUMBSTYLE::SHOW_CONNECTIONS
+      end
+    end
+
+    # Internally used event handler.
+    # @param [Wx::UpdateUIEvent] event
+    def _on_update_show_elements(event)
+      event.check((@thumb_style & THUMBSTYLE::SHOW_ELEMENTS) != 0)
+    end
+
+    # Internally used event handler.
+    # @param [Wx::UpdateUIEvent] event
+    def _on_update_show_connections(event)
+      event.check((@thumb_style & THUMBSTYLE::SHOW_CONNECTIONS) != 0)
+    end
+
+  end
+
+end

data/lib/wx/shapes/version.rb

@@ -0,0 +1,12 @@
+# Wx::SF version
+# Copyright (c) M.J.N. Corino, The Netherlands
+
+module Wx
+
+  module SF
+
+    VERSION = '0.9.0-beta.3'
+
+  end
+
+end

data/lib/wx/shapes/wx.rb

@@ -0,0 +1,29 @@
+# Wx - extensions
+# Copyright (c) M.J.N. Corino, The Netherlands
+
+module Wx
+
+  class Wx::RealPoint
+
+    # Returns distance from this point to given point.
+    # @param [Wx::RealPoint,Wx::Point,Array(Integer,Integer)] pt2
+    # @return [Float] distance to given point
+    def distance_to(pt2)
+      if Array === pt2 && pt2.size == 2
+        to_x, to_y = pt2
+      else
+        to_x = pt2.x; to_y = pt2.y
+      end
+      Math.sqrt((to_x - self.x)*(to_x - self.x) + (to_y - self.y)*(to_y - self.y))
+    end
+    alias :distance :distance_to
+
+    # Returns this point as a Wx::Size
+    # @return [Wx::Size]
+    def to_size
+      Wx::Size.new(self.x.to_i, self.y.to_i)
+    end
+
+  end
+
+end

data/lib/wx/shapes.rb

@@ -0,0 +1,18 @@
+# Wx::SF loader for wxRuby3/Shapes
+# Copyright (c) M.J.N. Corino, The Netherlands
+
+require 'wx/core'
+require 'wx/prt'
+
+require 'wx/shapes/version'
+require 'wx/shapes/core'
+require 'wx/shapes/wx'
+require 'wx/shapes/base'
+require 'wx/shapes/serializable'
+require 'wx/shapes/connection_point'
+require 'wx/shapes/shape_list'
+require 'wx/shapes/shape'
+require 'wx/shapes/events'
+require 'wx/shapes/diagram'
+require 'wx/shapes/auto_layout'
+require 'wx/shapes/thumbnail'

data/lib/wx/wx-shapes/base.rb

@@ -0,0 +1,87 @@
+# wx-shapes command handler base
+# Copyright (c) M.J.N. Corino, The Netherlands
+
+require 'optparse'
+require "rbconfig"
+
+module WxShapes
+
+  RUBY = ENV["RUBY"] || File.join(
+    RbConfig::CONFIG["bindir"],
+    RbConfig::CONFIG["ruby_install_name"] + RbConfig::CONFIG["EXEEXT"]).sub(/.*\s.*/m, '"\&"')
+
+  module Commands
+
+    class << self
+
+      def commands
+        @commands ||= ::Hash.new do |hash, key|
+          STDERR.puts "Unknown command #{key} specified."
+          exit(1)
+        end
+      end
+      private :commands
+
+      def options
+        @options ||= {
+          :verbose => false
+        }
+      end
+      private :options
+
+      def register(cmdid, cmdhandler)
+        commands[cmdid.to_s] = case
+                               when Proc === cmdhandler || Method === cmdhandler
+                                 cmdhandler
+                               when cmdhandler.respond_to?(:run)
+                                 Proc.new { |args| cmdhandler.run(args) }
+                               else
+                                 raise RuntimeError, "Invalid wx-shapes command handler : #{cmdhandler}"
+                               end
+      end
+
+      def describe_all
+        puts "    wx-shapes commands:"
+        commands.each do |id, cmd|
+          puts
+          puts cmd.call(:describe)
+        end
+        puts
+      end
+
+      def run(cmdid, args)
+        commands[cmdid.to_s].call(args)
+      end
+
+      def parse_args(args)
+        opts = OptionParser.new
+        opts.banner = "Usage: wx-shapes [global options] COMMAND [arguments]\n\n" +
+            "    COMMAND\t\t\tSpecifies wx-shapes command to execute."
+        opts.separator ''
+        opts.on('-v', '--verbose',
+                'Show verbose output') { |v| ::WxShapes::Commands.options[:verbose] = true }
+        opts.on('-h', '--help',
+                 'Show this message.') do |v|
+          puts opts
+          puts
+          describe_all
+          exit(0)
+        end
+        opts.raise_unknown = false
+        opts.parse!(args)
+      end
+    end
+  end
+
+  def self.run(argv = ARGV)
+    # parse global options (upto first command)
+    argv = WxShapes::Commands.parse_args(argv)
+    while !argv.empty?
+      WxShapes::Commands.run(argv.shift, argv)
+    end
+  end
+end
+
+Dir[File.join(__dir__, 'cmd', '*.rb')].each do |file|
+  require file
+end

data/lib/wx/wx-shapes/cmd/sampler.rb

@@ -0,0 +1,58 @@
+# wx-shapes sampler command handler
+# Copyright (c) M.J.N. Corino, The Netherlands
+#--------------------------------------------------------------------
+
+require 'fileutils'
+
+module WxShapes
+  module Commands
+    class Sampler
+      OPTIONS = {
+        save_path: nil
+      }
+
+      def self.description
+        "    sampler help|[SAMPLE [copy PATH]]\tRun wxRuby3/Shapes sample application (or copy sample)."
+      end
+
+      def self.run(argv)
+        if argv == :describe
+          description
+        else
+          arg = argv.shift || 'demo'
+          if arg == 'help'
+            puts "Usage: wx-shapes [global options] sampler help|[SAMPLE [copy PATH]]\n\n" +
+                 "\twhere SAMPLE := optional name of the sample to run or copy (sample1/2/3/4 or demo; default is 'demo')\n" +
+                 "\t      PATH := optional path to copy sample to"
+          else
+            if arg != 'copy'
+              sample = arg
+              arg = argv.shift
+            else
+              sample = 'demo'
+            end
+            sample_dir = File.join(WxShapes::ROOT, 'samples', sample)
+            unless File.directory?(sample_dir)
+              STDERR.puts "ERROR: Unknown sample #{sample}"
+              exit(1)
+            end
+            if arg == 'copy'
+              dest = argv.shift
+              unless dest && File.directory?(dest)
+                STDERR.puts "ERROR: Invalid destination folder #{dest}"
+                exit(1)
+              end
+              Dir[File.join(sample_dir, '*')].each do |fp|
+                FileUtils.cp_r(fp, dest, verbose: true)
+              end
+            else
+              exec(RUBY, File.join(sample_dir, sample.gsub(/\d+/, '')+'.rb'))
+            end
+          end
+        end
+      end
+    end
+
+    self.register('sampler', Sampler)
+  end
+end

data/lib/wx/wx-shapes/cmd/test.rb

@@ -0,0 +1,27 @@
+# wx-shapes unit test command handler
+# Copyright (c) M.J.N. Corino, The Netherlands
+#--------------------------------------------------------------------
+
+require 'fileutils'
+
+module WxShapes
+  module Commands
+    class Test
+      def self.description
+        "    test\t\t\tRun wxRuby3/Shapes regression tests."
+      end
+
+      def self.run(argv)
+        if argv == :describe
+          description
+        else
+          Dir[File.join(WxShapes::ROOT, 'tests', 'test_*.rb')].each do |test|
+            system(RUBY, test)
+          end
+        end
+      end
+    end
+
+    self.register('test', Test)
+  end
+end

data/rakelib/yard/templates/default/fulldoc/html/css/wxruby3.css

@@ -0,0 +1,7 @@
+
+blockquote {
+    background: #f7f7f9;
+    border-left: .25em solid #e1e1e8;
+    margin: 14px;
+    padding-left: 14px;
+}

data/rakelib/yard/templates/default/layout/html/setup.rb

@@ -0,0 +1,5 @@
+
+def stylesheets
+  # Load the existing stylesheets while appending the custom one
+  super + %w(css/wxruby3.css)
+end

data/rakelib/yard/yard/relative_markdown_links/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module YARD
+  module RelativeMarkdownLinks
+    # Current version of the yard-relative_markdown_links gem.
+    VERSION = "0.4.1"
+  end
+end

data/rakelib/yard/yard/relative_markdown_links.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+require "uri"
+require "yard"
+require_relative 'relative_markdown_links/version'
+
+module YARD # rubocop:disable Style/Documentation
+  # GitHub and YARD render Markdown files differently. In particular, relative
+  # links between Markdown files that work in GitHub don't work in YARD.
+  # For example, if you have `[hello](FOO.md)` in your README, YARD renders it
+  # as `<a href="FOO.md">hello</a>`, creating a broken link in your docs.
+  #
+  # With this plugin enabled, you'll get `<a href="file.FOO.html">hello</a>`
+  # instead, which correctly links through to the rendered HTML file.
+  module RelativeMarkdownLinks
+    # Resolves relative links from Markdown files.
+    # @param [String] text the HTML fragment in which to resolve links.
+    # @return [String] HTML with relative links to extra files converted to `{file:}` links.
+    def resolve_links(text)
+      html = Nokogiri::HTML.fragment(text)
+      html.css("a[href]").each do |link|
+        href = URI(link["href"])
+
+        if href.relative? && options.files
+          fnames = options.files.map(&:filename)
+          if fnames.include?(href.path)
+            link.replace "{file:#{href} #{link.inner_html}}"
+          elsif href.path.end_with?('_md.html') && (fname = fnames.find {|fnm| fnm.end_with?(href.path.sub(/_md.html\Z/, '.md')) })
+            link.replace "{file:#{fname} #{link.inner_html}}"
+          end
+        end
+      end
+      super(html.to_s)
+    end
+  end
+
+  Templates::Template.extra_includes << RelativeMarkdownLinks
+end

data/rakelib/yard/yard-custom-templates.rb

@@ -0,0 +1,2 @@
+
+YARD::Templates::Engine.register_template_path File.join(__dir__, 'templates')

data/rakelib/yard/yard-relative_markdown_links.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+# Adapted from the 'yard-relative_markdown_links' gem; Copyright © 2018 Andrew Haines
+
+require_relative 'yard/relative_markdown_links'

data/samples/demo/art/AlignBottom.xpm

@@ -0,0 +1,35 @@
+/* XPM */
+static const char * AlignBottom_xpm[] = {
+"16 16 16 1",
+" 	c #000000",
+".	c #800000",
+"+	c #008000",
+"@	c #808000",
+"#	c #000080",
+"$	c #800080",
+"%	c None",
+"&	c #808080",
+"*	c #C0C0C0",
+"=	c #FF0000",
+"-	c #00FF00",
+";	c #FFFF00",
+">	c #0000FF",
+",	c #FF00FF",
+"'	c #00FFFF",
+")	c #FFFFFF",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%      %%",
+"%%%%%%%% )))) %%",
+"%%%%%%%% )))) %%",
+"%%%%%%%% )))) %%",
+"%%     % )))) %%",
+"%% ))) % )))) %%",
+"%% ))) % )))) %%",
+"%% ))) % )))) %%",
+"%% ))) % )))) %%",
+"%% ))) % )))) %%",
+"%              %",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%"};

data/samples/demo/art/AlignCenter.xpm

@@ -0,0 +1,35 @@
+/* XPM */
+static const char * AlignCenter_xpm[] = {
+"16 16 16 1",
+" 	c #000000",
+".	c #800000",
+"+	c #008000",
+"@	c #808000",
+"#	c #000080",
+"$	c #800080",
+"%	c None",
+"&	c #808080",
+"*	c #C0C0C0",
+"=	c #FF0000",
+"-	c #00FF00",
+";	c #FFFF00",
+">	c #0000FF",
+",	c #FF00FF",
+"'	c #00FFFF",
+")	c #FFFFFF",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%% %%%%%%%%",
+"%%%%       %%%%%",
+"%%%% )) )) %%%%%",
+"%%%% )) )) %%%%%",
+"%%%% )) )) %%%%%",
+"%%%%       %%%%%",
+"%%%%%%% %%%%%%%%",
+"%%           %%%",
+"%% )))) )))) %%%",
+"%% )))) )))) %%%",
+"%% )))) )))) %%%",
+"%% )))) )))) %%%",
+"%%           %%%",
+"%%%%%%% %%%%%%%%",
+"%%%%%%%%%%%%%%%%"};

data/samples/demo/art/AlignLeft.xpm

@@ -0,0 +1,35 @@
+/* XPM */
+static const char * AlignLeft_xpm[] = {
+"16 16 16 1",
+" 	c #000000",
+".	c #800000",
+"+	c #008000",
+"@	c #808000",
+"#	c #000080",
+"$	c #800080",
+"%	c None",
+"&	c #808080",
+"*	c #C0C0C0",
+"=	c #FF0000",
+"-	c #00FF00",
+";	c #FFFF00",
+">	c #0000FF",
+",	c #FF00FF",
+"'	c #00FFFF",
+")	c #FFFFFF",
+"%%%%%%%%%%%%%%%%",
+"%% %%%%%%%%%%%%%",
+"%%       %%%%%%%",
+"%% ))))) %%%%%%%",
+"%% ))))) %%%%%%%",
+"%% ))))) %%%%%%%",
+"%%       %%%%%%%",
+"%% %%%%%%%%%%%%%",
+"%%           %%%",
+"%% ))))))))) %%%",
+"%% ))))))))) %%%",
+"%% ))))))))) %%%",
+"%% ))))))))) %%%",
+"%%           %%%",
+"%% %%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%"};

data/samples/demo/art/AlignMiddle.xpm

@@ -0,0 +1,35 @@
+/* XPM */
+static const char * AlignMiddle_xpm[] = {
+"16 16 16 1",
+" 	c #000000",
+".	c #800000",
+"+	c #008000",
+"@	c #808000",
+"#	c #000080",
+"$	c #800080",
+"%	c None",
+"&	c #808080",
+"*	c #C0C0C0",
+"=	c #FF0000",
+"-	c #00FF00",
+";	c #FFFF00",
+">	c #0000FF",
+",	c #FF00FF",
+"'	c #00FFFF",
+")	c #FFFFFF",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%",
+"%%      %%%%%%%%",
+"%% )))) %%%%%%%%",
+"%% )))) %     %%",
+"%% )))) % ))) %%",
+"%% )))) % ))) %%",
+"%              %",
+"%% )))) % ))) %%",
+"%% )))) % ))) %%",
+"%% )))) %     %%",
+"%% )))) %%%%%%%%",
+"%%      %%%%%%%%",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%",
+"%%%%%%%%%%%%%%%%"};