reflexion 0.5.3 → 0.7.0

data/include/reflex/window.h

@@ -18,6 +18,7 @@ namespace Reflex
 {
 
 
+	class Menu;
 	class View;
 
 
@@ -33,19 +34,35 @@ namespace Reflex
 			enum Flag
 			{
 
-				FLAG_CLOSABLE    = Xot::bit(0),
+				FLAG_CLOSABLE            = Xot::bit(0),
 
-				FLAG_MINIMIZABLE = Xot::bit(1),
+				FLAG_MINIMIZABLE         = Xot::bit(1),
 
-				FLAG_RESIZABLE   = Xot::bit(2),
+				FLAG_RESIZABLE           = Xot::bit(2),
 
-				FLAG_FULLSCREEN  = Xot::bit(3),
+				FLAG_TITLEBAR_BUTTONS    = Xot::bit(3),
 
-				FLAG_PORTRAIT    = Xot::bit(4),
+				FLAG_TITLEBAR_BACKGROUND = Xot::bit(4),
 
-				FLAG_LANDSCAPE   = Xot::bit(5),
+				FLAG_UNLISTED            = Xot::bit(5),
 
-				FLAG_LAST        = FLAG_LANDSCAPE
+				FLAG_SHADOW              = Xot::bit(6),
+
+				FLAG_TRANSPARENT         = Xot::bit(7),
+
+				FLAG_FULLSCREEN          = Xot::bit(8),
+
+				FLAG_ALWAYS_ON_TOP       = Xot::bit(9),
+
+				FLAG_ALWAYS_ON_BOTTOM    = Xot::bit(10),
+
+				FLAG_POINTER_THROUGH     = Xot::bit(11),
+
+				FLAG_PORTRAIT            = Xot::bit(12),
+
+				FLAG_LANDSCAPE           = Xot::bit(13),
+
+				FLAG_LAST                = FLAG_LANDSCAPE
 
 			};// Flag
 
@@ -65,6 +82,8 @@ namespace Reflex
 
 			virtual Point   to_screen (const Point& point) const;
 
+			virtual bool active () const;
+
 			virtual void    set_title (const char* title);
 
 			virtual const char* title () const;
@@ -75,7 +94,17 @@ namespace Reflex
 
 			virtual Bounds   frame () const;
 
-			virtual void    set_flag (uint flags);
+			virtual void    set_menu (Menu* menu);
+
+			virtual       Menu* menu ();
+
+			virtual const Menu* menu () const;
+
+			virtual void set_pointer_through_alpha (float alpha);
+
+			virtual float    pointer_through_alpha () const;
+
+			virtual void    set_flags (uint flags);
 
 			virtual uint        flags () const;
 
@@ -99,16 +128,16 @@ namespace Reflex
 
 			virtual const Painter* painter () const;
 
-			virtual void on_activate   (Event* e);
-
-			virtual void on_deactivate (Event* e);
-
 			virtual void on_show (Event* e);
 
 			virtual void on_hide (Event* e);
 
 			virtual void on_close (Event* e);
 
+			virtual void on_activate   (Event* e);
+
+			virtual void on_deactivate (Event* e);
+
 			virtual void on_update (UpdateEvent* e);
 
 			virtual void on_draw   (DrawEvent* e);
@@ -123,6 +152,12 @@ namespace Reflex
 
 			virtual void on_key_up   (KeyEvent* e);
 
+			virtual void on_text         (TextEvent* e);
+
+			virtual void on_text_preedit (TextEvent* e);
+
+			virtual void on_text_commit  (TextEvent* e);
+
 			virtual void on_pointer        (PointerEvent* e);
 
 			virtual void on_pointer_down   (PointerEvent* e);
@@ -133,8 +168,18 @@ namespace Reflex
 
 			virtual void on_pointer_cancel (PointerEvent* e);
 
+			virtual void on_pointer_enter  (PointerEvent* e);
+
+			virtual void on_pointer_leave  (PointerEvent* e);
+
 			virtual void on_wheel (WheelEvent* e);
 
+			virtual void on_file      (FileEvent* e);
+
+			virtual void on_file_open (FileEvent* e);
+
+			virtual void on_file_save (FileEvent* e);
+
 			virtual void on_midi (MIDIEvent* e);
 
 			virtual void on_note     (NoteEvent* e);

data/include/reflex.h

@@ -15,14 +15,22 @@
 #include <reflex/style.h>
 #include <reflex/timer.h>
 #include <reflex/shape.h>
+#include <reflex/pin.h>
+#include <reflex/constraint.h>
 #include <reflex/filter.h>
 
 #include <reflex/application.h>
 #include <reflex/window.h>
 #include <reflex/view.h>
+#include <reflex/menu.h>
 #include <reflex/screen.h>
+#include <reflex/clipboard.h>
+#include <reflex/file_dialog.h>
+#include <reflex/color_picker.h>
 
 #include <reflex/device.h>
+#include <reflex/midi.h>
+#include <reflex/gamepad.h>
 
 #include <reflex/image_view.h>
 

data/lib/reflex/application.rb

@@ -33,11 +33,11 @@ module Reflex
 
     private
 
-      def call_start_block()
-        return unless @start_block
-        Xot::BlockUtil.instance_eval_or_block_call self, &@start_block
-        @start_block = nil
-      end
+    def call_start_block()
+      return unless @start_block
+      Xot::BlockUtil.instance_eval_or_block_call self, &@start_block
+      @start_block = nil
+    end
 
   end# Application
 

data/lib/reflex/autoinit.rb

@@ -1,6 +1,8 @@
-require 'rays/autoinit'
+# load reflex_ext before Rays.init! to set pre_init_fun
 require 'reflex/ext'
 
+require 'rays/autoinit'
+
 
 unless defined?($REFLEX_NOAUTOINIT) && $REFLEX_NOAUTOINIT
   Reflex.init!

data/lib/reflex/button.rb

@@ -63,9 +63,9 @@ module Reflex
 
     private
 
-      def pressing?()
-        capturing? :pointer
-      end
+    def pressing?()
+      capturing? :pointer
+    end
 
   end# Button
 

data/lib/reflex/chase_constraint.rb

@@ -0,0 +1,15 @@
+require 'reflex/ext'
+require 'reflex/constraint'
+
+
+module Reflex
+
+
+  class ChaseConstraint < Constraint
+
+    universal_accessor :target, :force
+
+  end# ChaseConstraint
+
+
+end# Reflex

data/lib/reflex/clipboard.rb

@@ -0,0 +1,19 @@
+require 'xot/universal_accessor'
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class Clipboard
+
+    class << self
+
+      universal_accessor :text
+
+    end
+
+  end# Clipboard
+
+
+end# Reflex

data/lib/reflex/color_event.rb

@@ -0,0 +1,16 @@
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class ColorEvent < Event
+
+    def inspect()
+      "#<Reflex::ColorEvent color:#{color}>"
+    end
+
+  end# ColorEvent
+
+
+end# Reflex

data/lib/reflex/color_picker.rb

@@ -0,0 +1,45 @@
+require 'xot/setter'
+require 'xot/hookable'
+require 'xot/block_util'
+require 'xot/universal_accessor'
+require 'xot/inspectable'
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class ColorPicker
+
+    include Xot::Setter
+    include Xot::Hookable
+    include Xot::Inspectable
+
+    def initialize(options = nil, &block)
+      super()
+      set options if options
+      Xot::BlockUtil.instance_eval_or_block_call self, &block if block
+    end
+
+    universal_accessor :owner, alpha: {reader: :alpha?}
+
+    def pick_color(initial = nil, &block)
+      @color_block = block ? -> e {block.call e.color, e} : nil
+      pick_color! initial
+      self
+    end
+
+    private
+
+    def call_color_block(e)
+      @color_block&.call e
+    end
+
+    def clear_color_block()
+      @color_block = nil
+    end
+
+  end# ColorPicker
+
+
+end# Reflex

data/lib/reflex/constraint.rb

@@ -0,0 +1,29 @@
+require 'xot/setter'
+require 'xot/universal_accessor'
+require 'reflex/ext'
+require 'reflex/helper'
+
+
+module Reflex
+
+
+  class Constraint
+
+    include Xot::Setter
+    include HasTags
+
+    def pins()
+      [get_pin(0), get_pin(1)]
+    end
+
+    def views()
+      pins.map(&:view)
+    end
+
+    universal_accessor :name, :selector,
+      :spring, :damping, collide: {reader: :collide?}
+
+  end# Constraint
+
+
+end# Reflex

data/lib/reflex/control_change_event.rb

@@ -0,0 +1,17 @@
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class ControlChangeEvent < Event
+
+    def inspect()
+      "#<Reflex::ControlChangeEvent channel:%d controller:%d value:%f time:%f captured?:%s>" %
+        [channel, controller, value, time, captured?]
+    end
+
+  end# ControlChangeEvent
+
+
+end# Reflex

data/lib/reflex/extension.rb

@@ -6,7 +6,7 @@ module Reflex
     module_function
 
     def name(downcase = false)
-      super().split('::')[-2].then {|s|
+      super().split('::')[..-2].join.then {|s|
         downcase ? s.gsub(/([a-z])([A-Z])/) {"#{$1}-#{$2}"}.downcase : s
       }
     end

data/lib/reflex/file_dialog.rb

@@ -0,0 +1,70 @@
+require 'xot/setter'
+require 'xot/hookable'
+require 'xot/block_util'
+require 'xot/universal_accessor'
+require 'xot/inspectable'
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class FileDialog
+
+    include Xot::Setter
+    include Xot::Hookable
+    include Xot::Inspectable
+
+    def initialize(options = nil, &block)
+      super()
+      set options if options
+      Xot::BlockUtil.instance_eval_or_block_call self, &block if block
+    end
+
+    universal_accessor :owner, :title, :extensions
+
+    def open_file(dir = nil, &block)
+      @file_block = block ? -> e {block.call e.paths.first, e} : nil
+      open_file! expand(dir)
+      self
+    end
+
+    def open_files(dir = nil, &block)
+      @file_block = block ? -> e {block.call e.paths, e} : nil
+      open_files! expand(dir)
+      self
+    end
+
+    def open_directory(dir = nil, &block)
+      @file_block = block ? -> e {block.call e.paths.first, e} : nil
+      open_directory! expand(dir)
+      self
+    end
+
+    def save_file(dir = nil, name: nil, &block)
+      @file_block = block ? -> e {block.call e.paths.first, e} : nil
+      save_file! expand(dir), name
+      self
+    end
+
+    alias open_dir open_directory
+
+    private
+
+    def expand(dir)
+      dir ? File.expand_path(dir.to_s) : nil
+    end
+
+    def call_file_block(e)
+      block, @file_block = @file_block, nil
+      block&.call e
+    end
+
+    def call_cancel_block()
+      @file_block = nil
+    end
+
+  end# FileDialog
+
+
+end# Reflex

data/lib/reflex/file_event.rb

@@ -0,0 +1,37 @@
+require 'xot/const_symbol_accessor'
+require 'reflex/ext'
+
+
+module Reflex
+
+
+  class FileEvent < Event
+
+    alias get_action action
+
+    const_symbol_reader :action, **{
+      none: ACTION_NONE,
+      open: FileEvent::OPEN,
+      save: FileEvent::SAVE
+    }
+
+    def path()
+      paths.first
+    end
+
+    def open?()
+      get_action == FileEvent::OPEN
+    end
+
+    def save?()
+      get_action == FileEvent::SAVE
+    end
+
+    def inspect()
+      "#<Reflex::FileEvent #{action} paths:#{paths}>"
+    end
+
+  end# FileEvent
+
+
+end# Reflex

data/lib/reflex/helper.rb

@@ -1,11 +1,37 @@
 require 'xot/universal_accessor'
+require 'reflex/ext'
 require 'reflex/point'
 require 'reflex/bounds'
+require 'reflex/text_event'
 
 
 module Reflex
 
 
+  MODIFIER_SYMBOLS = {
+    shift:    MOD_SHIFT,
+    control:  MOD_CONTROL,
+    alt:      MOD_ALT,
+    win:      MOD_WIN,
+    option:   MOD_OPTION,
+    command:  MOD_COMMAND,
+    help:     MOD_HELP,
+    function: MOD_FUNCTION,
+    numpad:   MOD_NUMPAD,
+    caps:     MOD_CAPS,
+    scroll:   MOD_SCROLL
+  }.freeze
+
+  SHORTCUT_MODIFIER_SYMBOLS = MODIFIER_SYMBOLS.slice(
+    :shift,
+    :control,
+    :alt,
+    :win,
+    :option,
+    :command
+  ).freeze
+
+
   module HasFrame
 
     def move_to(*args)
@@ -84,4 +110,57 @@ module Reflex
   end# HasTags
 
 
+  # keeps the text being composed by the input method. defining the hooks
+  # below is also what lets the view accept text input.
+  module HasTextPreedit
+
+    def preedit()
+      @preedit ||= ''
+    end
+
+    def preedit_selection()
+      @preedit_selection
+    end
+
+    def preedit?()
+      !preedit.empty?
+    end
+
+    def on_text_preedit(e)
+      @preedit, @preedit_selection = e.text, e.selection
+      redraw
+    end
+
+    def on_text_commit(e)
+      return unless preedit?
+
+      @preedit, @preedit_selection = '', nil
+      redraw
+    end
+
+    # draws the composing text underlined, with a double underline under the
+    # clause being converted, in the painter's current font and fill color.
+    def draw_preedit(painter, x, y, height: nil)
+      return unless preedit?
+
+      font     = painter.font
+      height ||= font.height
+      width    = font.width preedit
+      uy       = y + height - 1
+
+      painter.push stroke: painter.fill do |p|
+        p.text preedit, x, y
+        p.line x, uy, x + width, uy
+
+        if preedit_selection
+          sx = x + font.width(preedit[0...preedit_selection.begin] || '')
+          sw =     font.width(preedit[preedit_selection]           || '')
+          p.line sx, uy - 2, sx + sw, uy - 2
+        end
+      end
+    end
+
+  end# HasTextPreedit
+
+
 end# Reflex

data/lib/reflex/key_event.rb

@@ -1,6 +1,7 @@
 require 'xot/bit_flag_accessor'
 require 'xot/const_symbol_accessor'
 require 'reflex/ext'
+require 'reflex/helper'
 
 
 module Reflex
@@ -16,18 +17,16 @@ module Reflex
       up:   UP
     }
 
-    bit_flag_reader :modifiers, **{
-      shift:    MOD_SHIFT,
-      control:  MOD_CONTROL,
-      alt:      MOD_ALT,
-      win:      MOD_WIN,
-      option:   MOD_OPTION,
-      command:  MOD_COMMAND,
-      help:     MOD_HELP,
-      function: MOD_FUNCTION,
-      numpad:   MOD_NUMPAD,
-      caps:     MOD_CAPS,
-    }
+    bit_flag_reader :modifiers, **MODIFIER_SYMBOLS
+    private alias_method :get_modifiers!, :modifiers
+
+    def modifiers(all: false)
+      all ? get_modifiers! : (get_modifiers!.select {SHORTCUT_MODIFIER_SYMBOLS.key? _1})
+    end
+
+    def key()
+      Reflex.get_key_symbol! code
+    end
 
     def down?()
       get_action == DOWN
@@ -42,12 +41,13 @@ module Reflex
     end
 
     def inspect()
-      "#<Reflex::KeyEvent action:%s chars:%s key:%s code:0x%X mod:%s repeat:%d captured?:%s>" % [
+      "#<Reflex::KeyEvent %p chars:%s key:%s code:0x%X mod:%p repeat:%d captured?:%p>" %
+      [
         action,
         chars ? "'#{chars}'" : :nil,
         key ? key : :nil,
         code,
-        modifiers.join(','),
+        modifiers(all: true),
         repeat,
         captured?
       ]

data/lib/reflex/link_constraint.rb

@@ -0,0 +1,31 @@
+require 'reflex/ext'
+require 'reflex/constraint'
+
+
+module Reflex
+
+
+  class LinkConstraint < Constraint
+
+    def range=(range)
+      case range
+      when nil     then clear_range!
+      when Range   then set_range! range.begin, range.end
+      when Numeric then set_range! range,       range
+      else raise ArgumentError, "invalid range: #{range.inspect}"
+      end
+    end
+
+    def range()
+      has_range! ? Range.new(range_min!, range_max!) : nil
+    end
+
+    universal_accessor :axis, :distance, :range, :motor, :force
+
+    alias dist= distance=
+    alias dist  distance
+
+  end# LinkConstraint
+
+
+end# Reflex