wads 0.1.2 → 0.2.2

data/lib/wads.rb

@@ -4,4 +4,4 @@ require_relative "wads/version"
 require_relative "wads/data_structures"
 require_relative "wads/widgets"
 require_relative "wads/textinput"
-
+require_relative "wads/app"

data/run-graph

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+ruby samples/graph.rb

data/run-star-wars

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+ruby samples/star_wars.rb

data/run-stocks

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+ruby samples/stocks.rb

data/run-theme-test

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+ruby samples/theme_test.rb $1 $2 $3

data/samples/basic_gosu_with_graph_widget.rb

@@ -0,0 +1,66 @@
+require 'gosu'
+require_relative '../lib/wads'
+
+include Wads
+    #
+    # The WadsApp class provides a simple starting point to quickly build a native
+    # Ruby application using Gosu as an underlying library. It provides all the necessary
+    # hooks to get started. All you need to do is supply the parent Wads widget using
+    # the set_display(widget) method. See one of the Wads samples for example usage.
+    #
+    class BasicGosuAppWithGraph < Gosu::Window
+        def initialize
+            super(800, 600)
+            self.caption = 'Basic Gosu App with Graph Widget'
+            @font = Gosu::Font.new(22)
+            @graph_widget = GraphWidget.new(10, 110,           # x, y coordinate of top left corder
+                                            780, 480,          # width x height
+                                            create_graph,
+                                            GRAPH_DISPLAY_EXPLORER) 
+            @update_count = 0
+        end 
+
+        def create_graph
+            g = Graph.new 
+            g.add("A")
+            g.add("B")
+            g.add("C")
+            g.add("D")
+            g.add("E")
+            g.add("F")
+            g.connect("A", "B")
+            g.connect("A", "C")
+            g.connect("B", "D")
+            g.connect("B", "E")
+            g.connect("E", "F")
+            g
+        end
+
+        def update
+            # Calling handle_update on the grpah widget is required if you want interactivity
+            # specifically, for drag and drop of the nodes
+            @update_count = @update_count + 1
+            @graph_widget.handle_update @update_count, mouse_x, mouse_y
+        end 
+    
+        def draw
+            @font.draw_text("Sample App with Wads Graph Widget", 240, 49, 1, 1, 1, COLOR_WHITE)
+            @graph_widget.draw
+        end
+
+        def button_down id
+            close if id == Gosu::KbEscape
+            # Delegate button events to the graph widget if you want the
+            # user to be able to interact with it
+            @graph_widget.button_down id, mouse_x, mouse_y
+        end
+    
+        def button_up id
+            # Delegate button events to the graph widget if you want the
+            # user to be able to interact with it
+            @graph_widget.button_up id, mouse_x, mouse_y
+        end
+    end 
+
+
+BasicGosuAppWithGraph.new.show

data/samples/gosu_bouncing_ball.rb

@@ -0,0 +1,34 @@
+require 'gosu'
+ 
+class AppWindow < Gosu::Window
+  def initialize
+    super(800, 600)
+    self.caption = 'Bouncing Ball'
+    @img = Gosu::Image.new("media/CircleYellow.png")
+    @x = 400
+    @y = 300
+    @delta_x = 2
+    @delta_y = 2
+  end
+ 
+  def update 
+    @x = @x + @delta_x
+    @y = @y + @delta_y
+    if @x < 0
+      @delta_x = 2
+    elsif @x > 800 - @img.width
+      @delta_x = -2
+    end
+    if @y < 0
+      @delta_y = 2
+    elsif @y > 600 - @img.height
+      @delta_y = -2
+    end
+  end 
+
+  def draw
+    @img.draw @x, @y, 1
+  end
+end
+ 
+AppWindow.new.show

data/samples/gosu_hello_world.rb

@@ -0,0 +1,16 @@
+require 'gosu'
+ 
+class GameWindow < Gosu::Window
+  def initialize
+    super(400, 300)
+    self.caption = 'Hello World App'
+    @font = Gosu::Font.new(24)
+  end
+ 
+  def draw
+    @font.draw_text("Hello World", 144, 120, 1)
+  end
+end
+ 
+window = GameWindow.new
+window.show

data/samples/gosu_reaction_time.rb

@@ -0,0 +1,121 @@
+require 'gosu'
+
+AVERAGE_RESPONSE_TIME = 284.to_f     # Per humanbenchmark.com, in milliseconds
+GAME_STATE_PROMPT_TO_START = 0
+GAME_STATE_RED = 1
+GAME_STATE_YELLOW = 2
+GAME_STATE_GREEN = 3
+GAME_STATE_OVER = 4
+
+class AppWindow < Gosu::Window
+  def initialize
+    super(600, 300)
+    self.caption = 'Reaction Time Game'
+    @update_count = 0
+    @next_light_count = 0
+    @messages = []
+    @font = Gosu::Font.new(32)
+    @red_light = Gosu::Image.new("media/CircleRed.png")
+    @yellow_light = Gosu::Image.new("media/CircleYellow.png")
+    @green_light = Gosu::Image.new("media/CircleGreen.png")
+    #  game state            0           1           2              3             4
+    #  state                 Prompt      Red         Yellow         Green         Game over
+    @traffic_light_images = [@red_light, @red_light, @yellow_light, @green_light, @green_light]
+    @traffic_light_color = GAME_STATE_PROMPT_TO_START
+  end
+ 
+  def update
+    @update_count = @update_count + 1
+    @traffic_light_image = @traffic_light_images[@traffic_light_color]
+
+    # Once the game is started, the lights progress automatically until green
+    if @traffic_light_color > GAME_STATE_PROMPT_TO_START
+      next_traffic_light unless @update_count < @next_light_count
+      @button_text = "Click when the light turns green" unless @traffic_light_color > GAME_STATE_GREEN
+    end
+  end
+
+  def draw
+    @font.draw_text("Reaction Time Game", 180, 10, 1)
+    @traffic_light_image.draw(248, 60, 1)
+    
+    if @traffic_light_color == GAME_STATE_PROMPT_TO_START
+      @font.draw_text("Press 'p' to play", 200, 200, 1)
+    elsif @traffic_light_color == GAME_STATE_OVER
+      @font.draw_text("Press 'p' to play again", 50, 200, 1)
+    else 
+      draw_button(@button_text) unless @button_text.nil?
+    end
+
+    y = 232
+    @messages.each do |msg|
+      @font.draw_text(msg, 50, y, 1)
+      y = y + 32
+    end
+  end
+
+  def button_down id
+    close if id == Gosu::KbEscape 
+
+    if @traffic_light_color == GAME_STATE_PROMPT_TO_START or @traffic_light_color == GAME_STATE_OVER
+      if id == Gosu::KbP
+        next_traffic_light
+      end
+      return
+    end
+    
+    if id == Gosu::MsLeft and button_contains_click
+      if @traffic_light_color < GAME_STATE_YELLOW 
+        next_traffic_light
+      elsif @traffic_light_color == GAME_STATE_YELLOW 
+        @traffic_light_color = GAME_STATE_OVER
+        @messages = ["Sorry, you were too early"]
+        @button_text = "Click to play again"
+      elsif @traffic_light_color == GAME_STATE_GREEN
+        @button_text = nil
+        time_since_green = ((Time.now - @mark_time) * 1000.to_f).round(3)
+        @messages = ["Response time: #{time_since_green} ms"]
+        diff_from_average = (((time_since_green - AVERAGE_RESPONSE_TIME) / AVERAGE_RESPONSE_TIME) * 100).round
+        if diff_from_average > 0
+          @messages << "#{diff_from_average}% slower than the average human"
+        elsif diff_from_average < 0
+          @messages << "#{-diff_from_average}% faster than the average human"
+        else 
+          @messages << "Wow, that is exactly the human average."
+        end 
+        @button_text = "Click to play again"
+        @traffic_light_color = GAME_STATE_OVER
+      else 
+        @traffic_light_color = GAME_STATE_PROMPT_TO_START
+        @messages = []
+      end 
+    end
+  end
+
+  def next_traffic_light 
+    return unless @traffic_light_color < GAME_STATE_GREEN
+    @traffic_light_color = @traffic_light_color + 1
+    @mark_time = Time.now
+    @next_light_count = @update_count + 60 + rand(100)
+  end
+
+  def button_contains_click 
+    mouse_x > 100 and mouse_x < 500 and mouse_y > 198 and mouse_y < 232
+  end 
+
+  def draw_button(text)
+    text_width = @font.text_width(text)
+    draw_box(100, 198, 500, 232)
+    text_x = (600 - text_width) / 2
+    @font.draw_text(@button_text, text_x, 200, 1)
+  end 
+
+  def draw_box(x1, y1, x2, y2, color = Gosu::Color::WHITE)
+    Gosu::draw_line x1, y1, color, x2, y1, color, 1
+    Gosu::draw_line x1, y1, color, x1, y2, color, 1
+    Gosu::draw_line x1, y2, color, x2, y2, color, 1
+    Gosu::draw_line x2, y1, color, x2, y2, color, 1
+  end
+end
+ 
+AppWindow.new.show

data/samples/graph.rb

@@ -0,0 +1,72 @@
+require 'gosu'
+require_relative '../lib/wads'
+
+include Wads 
+
+class SampleGraphApp < WadsApp
+
+    SAMPLE_GRAPH_DEFINITION_FILE = "./data/sample_graph.csv"
+
+    def initialize
+        super(800, 600, "Wads Sample Graph App", GraphDisplay.new(create_sample_graph))
+    end 
+
+    #
+    # Below are three different ways you can construct a graph
+    #
+    def create_sample_graph
+        g = Graph.new 
+        g.add("A")
+        g.add("B")
+        g.add("C")
+        g.add("D")
+        g.add("E")
+        g.add("F")
+        g.connect("A", "B")
+        g.connect("A", "C")
+        g.connect("B", "D")
+        g.connect("B", "E")
+        g.connect("E", "F")
+        g
+    end
+
+    def create_sample_graph_using_nodes
+        root = Node.new("A")
+        b = root.add("B")
+        b.add("D")
+        b.add("E").add("F")
+        root.add("C")
+        Graph.new(root)
+    end
+
+    def create_sample_graph_from_file
+        Graph.new(SAMPLE_GRAPH_DEFINITION_FILE)
+    end
+end
+
+class GraphDisplay < Widget
+
+    def initialize(graph)
+        super(0, 0, 800, 600)
+        set_layout(LAYOUT_TOP_MIDDLE_BOTTOM)
+        @graph = graph
+
+        image = get_layout.add_image("./media/Banner.png", { ARG_SECTION => SECTION_TOP})
+        image.add_text("Wads Sample App", 10, 20, nil, true)
+        image.add_text("Version #{Wads::VERSION}", 13, 54)
+
+        panel = get_layout.add_horizontal_panel({ ARG_SECTION => SECTION_BOTTOM})
+        panel.add_button("Exit", 0, panel.height - 30) do
+            WidgetResult.new(true)
+        end
+        panel.center_children
+        panel.disable_border
+
+        @graph_display = get_layout.add_graph_display(@graph, GRAPH_DISPLAY_EXPLORER,
+                                                      { ARG_SECTION => SECTION_CENTER})
+        disable_border
+    end 
+end
+
+#WadsConfig.instance.set_current_theme(WadsNoIconTheme.new)
+SampleGraphApp.new.show

data/samples/star_wars.rb

@@ -0,0 +1,112 @@
+require 'gosu'
+require 'json'
+require_relative '../lib/wads'
+
+include Wads 
+
+class SampleStarWarsApp < WadsApp
+    
+    STAR_WARS_DATA_FILE = "./data/starwars-episode-4-interactions.json"
+
+    def initialize
+        super(800, 800, "Wads Sample Star Wars App", StarWarsDisplay.new(process_star_wars_data))
+    end 
+
+    def process_star_wars_data 
+        star_wars_json = File.read(STAR_WARS_DATA_FILE)
+        data_hash = JSON.parse(star_wars_json)
+        characters = data_hash['nodes']
+        interactions = data_hash['links']
+
+        # The interactions in the data set reference the characters by their
+        # zero based index, so we keep a reference in our graph by index.
+        # The character's value is the number of scenes in which they appear.
+        graph = Graph.new
+        characters.each do |character|
+            node_tags = {}
+            node_color_str = character['colour']
+            # This is a bit of a hack, but our background is black so black text
+            # will not show up. Change this to white
+            if node_color_str == "#000000"
+                node_color_str = "#FFFFFF"
+            end
+            # Convert hex string (ex. "#EE00AA") into int hex representation
+            # understood by Gosu color (ex. 0xFFEE00AA)
+            node_color = "0xFF#{node_color_str[1..-1]}".to_i(16)
+            node_tags['color'] = node_color
+            graph.add_node(Node.new(character['name'], character['value'], node_tags))
+        end
+        interactions.each do |interaction| 
+            character_one = graph.node_by_index(interaction['source'])
+            character_two = graph.node_by_index(interaction['target'])
+            number_of_scenes_together = interaction['value']
+            edge_tags = {}
+            edge_tags["scenes"] = number_of_scenes_together
+            graph.add_edge(character_one, character_two, edge_tags)
+        end
+        graph
+    end
+end
+
+class StarWarsDisplay < Widget
+    attr_accessor :graph
+
+    def initialize(graph)
+        super(0, 0, 800, 800)
+        set_layout(LAYOUT_TOP_MIDDLE_BOTTOM)
+        @graph = graph
+
+        image = get_layout.add_image("./media/Banner.png", { ARG_SECTION => SECTION_TOP})
+        image.add_text("Wads Sample App", 10, 20, nil, true)
+        image.add_text("Version #{Wads::VERSION}", 13, 54)
+
+        get_layout.add_document(sample_content, { ARG_SECTION => SECTION_CENTER})
+
+        panel = get_layout.add_horizontal_panel({ ARG_SECTION => SECTION_BOTTOM})
+        panel.add_button("Exit", 0, panel.height - 30) do
+            WidgetResult.new(true)
+        end
+        panel.center_children
+        panel.disable_border
+
+        @data_table = get_layout.add_single_select_table(
+            ["Character", "Number of Scenes"], 4, { ARG_SECTION => SECTION_CENTER})
+
+        @graph.node_list.each do |character|
+            @data_table.add_row([character.name, character.value], character.get_tag(ARG_COLOR))
+        end
+        @graph_display = get_layout.add_graph_display(@graph, GRAPH_DISPLAY_EXPLORER,
+                                                      { ARG_SECTION => SECTION_CENTER})
+
+        disable_border
+    end
+
+    def sample_content
+        <<~HEREDOC
+          This sample analysis shows the interactions between characters in the Star Wars
+          Episode 4: A New Hope. Click on a character to see more detail.
+        HEREDOC
+    end
+
+    def handle_key_press id, mouse_x, mouse_y
+        if id == Gosu::KbUp
+            @data_table.scroll_up
+        elsif id == Gosu::KbDown
+            @data_table.scroll_down
+        end 
+        WidgetResult.new(false)
+    end
+
+    def handle_mouse_down mouse_x, mouse_y
+        if @data_table.contains_click(mouse_x, mouse_y)
+            val = @data_table.set_selected_row(mouse_y, 0)
+            if not val.nil?
+                node = @graph.find_node(val)
+                #@graph_display.set_center_node(node, 2)
+                @graph_display.set_explorer_display(node)
+            end  
+        end
+    end
+end
+
+SampleStarWarsApp.new.show

data/samples/stocks.rb

@@ -0,0 +1,126 @@
+require 'gosu'
+require_relative '../lib/wads'
+
+include Wads 
+
+class SampleStocksApp < WadsApp
+    
+    STOCKS_DATA_FILE = "./data/NASDAQ.csv"
+
+    def initialize
+        super(800, 600, "Wads Sample Stocks App", StocksDisplay.new(process_stock_data))
+    end 
+
+    def process_stock_data 
+        # The data file comes from https://finance.yahoo.com
+        # The format of this file is as follows:
+        #
+        # Date,Open,High,Low,Close,Adj Close,Volume
+        # 2000-01-03,4186.189941,4192.189941,3989.709961,4131.149902,4131.149902,1510070000
+        # 2000-01-04,4020.000000,4073.250000,3898.229980,3901.689941,3901.689941,1511840000
+        # ...
+        # 2020-12-30,12906.509766,12924.929688,12857.759766,12870.000000,12870.000000,5292210000
+        # 2020-12-31,12877.089844,12902.070313,12821.230469,12888.280273,12888.280273,4771390000
+        
+        stats = Stats.new("NASDAQ")
+        previous_close = nil
+        
+        puts "Read the data file #{STOCKS_DATA_FILE}"
+        File.readlines(STOCKS_DATA_FILE).each do |line|
+            line = line.chomp  # remove the carriage return
+
+            # Ignore header and any empty lines, process numeric data lines
+            if line.length > 0 and line[0].match(/[0-9]/)
+                values = line.split(",")
+                date = Date.strptime(values[0], "%Y-%m-%d")
+                weekday = Date::DAYNAMES[date.wday]
+
+                open_value = values[1].to_f
+                close_value = values[4].to_f
+
+                if previous_close.nil?
+                    # Just use the first day to set the baseline
+                    previous_close = close_value
+                else 
+                    change_from_previous_close = close_value - previous_close
+                    change_intraday = close_value - open_value
+                    change_overnight = open_value - previous_close
+                    
+                    change_percent = change_from_previous_close / previous_close
+
+                    stats.add(weekday, change_percent)
+                    stats.add("#{weekday} prev close", change_from_previous_close)
+                    stats.add("#{weekday} intraday", change_intraday)
+                    stats.add("#{weekday} overnight", change_overnight)
+
+                    previous_close = close_value
+                end
+            end
+        end
+
+        stats
+    end
+end
+
+class StocksDisplay < Widget
+
+    def initialize(stats)
+        super(0, 0, 800, 600)
+        set_layout(LAYOUT_TOP_MIDDLE_BOTTOM)
+
+        image = get_layout.add_image("./media/Banner.png", { ARG_SECTION => SECTION_TOP})
+        image.add_text("Wads Sample App", 10, 20, nil, true)
+        image.add_text("Version #{Wads::VERSION}", 13, 54)
+
+        get_layout.add_document(sample_content, { ARG_SECTION => SECTION_CENTER})
+
+        panel = get_layout.add_horizontal_panel({ ARG_SECTION => SECTION_BOTTOM})
+        panel.add_button("Exit", 0, panel.height - 30) do
+            WidgetResult.new(true)
+        end
+        panel.center_children
+
+        @data_table = get_layout.add_single_select_table(         
+                ["Day", "Min", "Avg", "StdDev", "Max", "p10", "p90"], 5,
+                { ARG_SECTION => SECTION_CENTER})
+        Date::DAYNAMES[1..5].each do |day|
+            min = format_percent(stats.min(day))
+            avg = format_percent(stats.average(day))
+            std = format_percent(stats.std_dev(day))
+            max = format_percent(stats.max(day))
+            p10 = format_percent(stats.percentile(day, 0.1))
+            p90 = format_percent(stats.percentile(day, 0.90))
+            @data_table.add_row([day, min, avg, std, max, p10, p90])
+        end
+
+        @selection_text = nil
+    end 
+
+    def format_percent(val)
+        "#{(val * 100).round(3)}%"
+    end
+
+    def sample_content
+        <<~HEREDOC
+          This sample stock analysis uses NASDAQ data from https://finance.yahoo.com looking
+          at closing data through the years 2000 to 2020. The percent gain or loss is broken
+          down per day, as shown in the table below.
+        HEREDOC
+    end
+
+    def render 
+        @selection_text.draw unless @selection_text.nil?
+    end 
+
+    def handle_mouse_down mouse_x, mouse_y
+        if @data_table.contains_click(mouse_x, mouse_y)
+            val = @data_table.set_selected_row(mouse_y, 0)
+            if not val.nil?
+                @selection_text = Text.new(relative_x(5), relative_y(500), "You selected #{val}, a great day!")
+            end    
+        end
+    end 
+end
+
+WadsConfig.instance.set_current_theme(WadsAquaTheme.new)
+SampleStocksApp.new.show