rndk 0.2.0 → 1.0.0

data/examples/07-traverse.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+#
+# This example shows both callbacks and traverse.
+#
+# We show you two scroll bars, each having related
+# items.
+# When you scroll on the first, it shows it's results
+# on the second one.
+#
+require 'rndk/scroll'
+require 'rndk/label'
+
+begin
+  screen = RNDK::Screen.new
+  RNDK::Color.init
+
+  # For each item we have a description
+  items = ["First",
+           "Second",
+           "Third"]
+  descriptions = [["Contents", "of", "first", "item"],
+                  ["here", "we", "have", "the", "second", "one"],
+                  ["Finally", "the", "third"]]
+
+  # Creating the two scroll bars.
+  # Pay attention to their positioning.
+  scroll_1 = RNDK::Scroll.new(screen, {
+                                :x => RNDK::LEFT,
+                                :y => RNDK::CENTER,
+                                :width => RNDK::Screen.width/2 - 1,
+                                :height => 20,
+                                :title => "<C>Items",  # centered
+                                :items => items,
+                                :highlight => RNDK::Color[:red],
+                              })
+
+  scroll_2 = RNDK::Scroll.new(screen, {
+                                :x => RNDK::RIGHT,
+                                :y => RNDK::CENTER,
+                                :width => RNDK::Screen.width/2 - 1,
+                                :height => 20,
+                                :title => "<C>Descriptions", # centered
+                                :items => descriptions.first,
+                                :highlight => RNDK::Color[:cyan]
+                              })
+
+  # Here we define what will happen after we scroll the
+  # first list.
+  # `Scroll#after_processing` makes a block of code
+  # execute right after we process the user input.
+  #
+  # On this case, we're showing the description of the
+  # current item.
+
+  scroll_1.bind_signal(:after_scrolling) do |current|
+
+    desc = descriptions[current]
+    scroll_2.set_items(desc, false) # numbering=false
+    screen.refresh
+  end
+
+  # Simple label to tell the user how to quit the example
+  msg = "</77>Press F10 to quit"
+  label = RNDK::Label.new(screen, {
+                            :x => RNDK::CENTER,
+                            :y => RNDK::TOP,
+                            :text => msg
+                          })
+
+  # Finally, activating the widgets and setting them
+  # up for traversal.
+  #
+  # By traversal we mean that we'll be able to jump
+  # from one widget to another with TAB and Shitf+TAB
+  #
+  # The default key to exit traversal is F10
+
+  screen.refresh
+  RNDK::Traverse.over screen
+
+  RNDK::Screen.finish
+
+# Just in case something bad happens.
+rescue Exception => e
+  RNDK::Screen.finish
+  puts e
+  puts e.inspect
+  puts e.backtrace
+end
+

data/examples/10-all-widgets.rb

@@ -0,0 +1,165 @@
+#!/usr/bin/env ruby
+#
+# All the widgets at once!
+#
+require 'rndk/calendar'
+require 'rndk/label'
+require 'rndk/entry'
+require 'rndk/dialog'
+require 'rndk/scale'
+require 'rndk/graph'
+require 'rndk/itemlist'
+require 'rndk/radio'
+require 'rndk/scroll'
+require 'rndk/slider'
+require 'rndk/viewer'
+require 'rndk/button'
+require 'rndk/buttonbox'
+require 'rndk/alphalist'
+
+begin
+  # All widgets will be attached to this
+  screen = RNDK::Screen.new
+  RNDK::Color.init
+
+  RNDK::Label.new(screen, :text => ["<C></66>Lots of Widgets",
+                                    "</75>tab: <!75>circle  </75>F10: <!75>quit"])
+
+  RNDK::Calendar.new(screen, {
+                       :box   => true,
+                       :y     => 4,
+                       :title => "</77>calendar"
+                     })
+
+  RNDK::Entry.new(screen, {
+                    :x => 24,
+                    :field_width => -44,
+                    :title => "</77>entry",
+                    :label => "</75>type me something "
+                  })
+
+  RNDK::Scale.new(screen, {
+                    :x => 24,
+                    :y => 4,
+                    :title => "</77>scale",
+                    :label => "move me",
+                    :field_width => 5
+                  })
+
+  d = RNDK::Dialog.new(screen, {
+                     :x => 24,
+                     :y => 8,
+                     :text => "</77>dialog",
+                     :highlight => RNDK::Color[:cyan] | RNDK::Color[:reverse],
+                     :buttons => ["Press me", "No, press me!"]
+                   })
+
+  # A sample on how easy it is to customize stuff
+  d.bind_signal(:before_pressing) do |button|
+    message = ["Will press button no #{button}",
+               "Are you sure?"]
+    buttons = ["Yes", "No"]
+
+    choice = screen.popup_dialog(message, buttons)
+
+    # When we return false, we stop pressing the button.
+    false if choice == 1
+  end
+
+  d.bind_signal(:after_pressing) do |button|
+    screen.popup_label "Pressed button no #{button}"
+  end
+
+  RNDK::Graph.new(screen, {
+                    :x => 26,
+                    :y => 13,
+                    :width => 20,
+                    :height => 10
+                  }).set_values([1, 2, 3, 4, 5, 2, 10, 7], true)
+
+
+  RNDK::Itemlist.new(screen, {
+                       :x => 39,
+                       :y => 4,
+                       :title => "</77>itemlist",
+                       :label => "up, down: ",
+                       :items => ["One", "Two", "Three", "Four"]
+                     })
+
+  RNDK::Radio.new(screen, {
+                    :x => 58,
+                    :y => 4,
+                    :title => "</77>radio",
+                    :width => 20,
+                    :height => 8,
+                    :items => ["Item1", "Item2", "Item3"]
+                  })
+
+  RNDK::Scroll.new(screen, {
+                     :x => 58,
+                     :y => 12,
+                     :title => "</77>scroll",
+                     :width => 30,
+                     :height => 10,
+                     :items => (100..120).to_a
+                   })
+
+  RNDK::Slider.new(screen, {
+                     :x => 58,
+                     :y => 22,
+                     :start => 50,
+                     :filler => ' '.ord | RNDK::Color[:cyan] | RNDK::Color[:reverse],
+                     :title => "</77>slider",
+                     :field_width => -58
+                   })
+
+  RNDK::Viewer.new(screen, {
+                     :x => 0,
+                     :y => 16,
+                     :title => "</77>viewer",
+                     :buttons => ["one", "two", "three"],
+                     :width => 24,
+                     :height => 15
+                   }).set_items(`ls -l`.lines, false)
+
+  RNDK::Button.new(screen, {
+                     :x => 50,
+                     :y => 8,
+                     :label => "</77>button",
+                   }).bind_signal(:pressed) { screen.popup_label "Button pressed" }
+
+  RNDK::Alphalist.new(screen, {
+                        :x => 58,
+                        :y => 26,
+                        :width => 40,
+                        :height => 10,
+                        :title => "</77>Alphalist",
+                        :label => "</75>Type first letters here ",
+                        :items => ["Here", "we", "have", "lots",
+                                   "of", "words", "to", "show",
+                                   "how", "awesome", "this", "is"]
+                      })
+
+  RNDK::Buttonbox.new(screen, {
+                        :x => 84,
+                        :y => 4,
+                        :width => 14,
+                        :height => 5,
+                        :title => "</77>buttonbox",
+                        :buttons => ["one", "two", "three", "four"],
+                        :button_rows => 2,
+                        :button_cols => 2,
+                        :highlight => RNDK::Color[:blue] | RNDK::Color[:reverse]
+                      })
+
+  screen.refresh
+  RNDK::Traverse.over screen
+  RNDK::Screen.finish
+
+# Just in case something goes wrong.
+rescue Exception => e
+  RNDK::Screen.finish
+  puts e
+  puts e.backtrace
+end
+

data/examples/calendar.rb

@@ -10,26 +10,24 @@ require 'rndk/calendar'
 
 begin
   # Start RNDK and Colors
-  rndkscreen = RNDK::Screen.new
+  screen = RNDK::Screen.new
   RNDK::Color.init
 
   title = "<C></U>RNDK Calendar Widget\n<C>Demo"
 
   # Declare the calendar widget.
-  calendar = RNDK::Calendar.new(rndkscreen,
-                                RNDK::CENTER, # x
-                                RNDK::CENTER, # y
-                                title,
-                                0, 0, 0, # current date
-                                RNDK::Color[:red_black] | Ncurses::A_BOLD,
-                                RNDK::Color[:green_black] | Ncurses::A_BOLD,
-                                RNDK::Color[:yellow_black] | Ncurses::A_BOLD,
-                                RNDK::Color[:blue_black] | Ncurses::A_REVERSE,
-                                true,
-                                false)
+  calendar = RNDK::Calendar.new(screen, {
+                                  :x           => RNDK::CENTER,
+                                  :y           => RNDK::CENTER,
+                                  :title       => title,
+                                  :day_color   => RNDK::Color[:red_black] | RNDK::Color[:bold],
+                                  :month_color => RNDK::Color[:green_black] | RNDK::Color[:bold],
+                                  :yeah_color  => RNDK::Color[:yellow_black] | RNDK::Color[:bold],
+                                  :highlight   => RNDK::Color[:blue_black] | RNDK::Color[:reverse],
+                                })
 
   if calendar.nil?
-    RNDK::Screen.end_rndk
+    RNDK::Screen.finish
 
     puts 'Cannot create the calendar. Is the window too small?'
     exit 1
@@ -37,36 +35,26 @@ begin
 
   # Here we define the functions that will be
   # executed when the user presses a key.
-  #
-  # They must be lambdas.
+  # Also, binding the keys to actions.
 
   # This adds a marker ot the calendar.
-  create_calendar_mark = lambda do |object_type, calendar, client_data, key|
-    calendar.setMarker(calendar.day, calendar.month, calendar.year)
+  calendar.bind_key('m') do |widget_type, calendar, client_data, key|
+    calendar.set_marker(calendar.day, calendar.month, calendar.year)
     calendar.draw(calendar.box)
     return false
   end
 
   # This removes a marker from the calendar.
-  remove_calendar_mark = lambda do |object_type, calendar, client_data, key|
+  calendar.bind_key('r') do |widget_type, calendar, client_data, key|
     calendar.removeMarker(calendar.day, calendar.month, calendar.year)
     calendar.draw(calendar.box)
     return false
   end
 
-  # Here we bind the keys to the actions.
-  #
-  # They must be lambdas.
-
-  calendar.bind(:calendar, 'm', create_calendar_mark, calendar)
-  calendar.bind(:calendar, 'M', create_calendar_mark, calendar)
-  calendar.bind(:calendar, 'r', remove_calendar_mark, calendar)
-  calendar.bind(:calendar, 'R', remove_calendar_mark, calendar)
-
   calendar.week_base = 0
 
   # Let the user play with the widget.
-  ret_val = calendar.activate([])
+  ret_val = calendar.activate
 
   # Check which day they selected.
   if calendar.exit_type == :ESCAPE_HIT
@@ -75,7 +63,7 @@ begin
             '',
             '<C>Press any key to continue.'
            ]
-    rndkscreen.popup_label mesg
+    screen.popup_label mesg
 
   elsif calendar.exit_type == :NORMAL
     mesg = [
@@ -84,17 +72,17 @@ begin
                                                      calendar.day, calendar.month, calendar.year],
             '<C>Press any key to continue.'
            ]
-    rndkscreen.popup_label mesg
+    screen.popup_label mesg
   end
 
   # Finishing up and printing message
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts 'Selected Time: %s' % ret_val.ctime unless ret_val.nil?
 
 # Just in case something bad happens.
 rescue Exception => e
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts e
   puts e.inspect

data/examples/entry.rb

@@ -8,7 +8,7 @@ require 'rndk/entry'
 
 begin
   # Startup RNDK and Colors
-  rndkscreen = RNDK::Screen.new
+  screen = RNDK::Screen.new
   RNDK::Color.init
 
   # Watch out for that markup
@@ -17,30 +17,25 @@ begin
   label = "</U/5>Oh yeah<!U!5>:"
 
   # Create the entry field widget.
-  entry = RNDK::Entry.new(rndkscreen,
-                          RNDK::CENTER,
-                          RNDK::CENTER,
-                          title,
-                          label,
-                          Ncurses::A_NORMAL,
-                          '.',
-                          :MIXED,   # behavior
-                          40,
-                          0,
-                          256,
-                          true,
-                          false)
-
+  entry = RNDK::Entry.new(screen, {
+                            :x => RNDK::CENTER,
+                            :y => RNDK::CENTER,
+                            :title => title,
+                            :label => label,
+                            :field_width => 40,
+                            :min => 0,
+                            :max => 256
+                          })
   # Is the widget nil?
   if entry.nil?
-    RNDK::Screen.end_rndk
+    RNDK::Screen.finish
 
     puts "Cannot create the entry box. Is the window too small?"
     exit 1
   end
 
   # Draw the screen.
-  rndkscreen.refresh
+  screen.refresh
 
   # Activate the entry field.
   info = entry.activate
@@ -59,14 +54,14 @@ begin
   end
 
   # Quick widget - see example 'quick-widgets.rb' for details
-  rndkscreen.popup_label mesg
+  screen.popup_label mesg
 
   # Quitting
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
 # Just in case something bad happens.
 rescue Exception => e
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts e
   puts e.inspect

data/examples/label.rb

@@ -6,7 +6,7 @@ require 'rndk/label'
 
 begin
   # Starting things up
-  rndkscreen = RNDK::Screen.new
+  screen = RNDK::Screen.new
   RNDK::Color.init
 
   # Set the labels with some nice markup
@@ -17,15 +17,15 @@ begin
           "<C>This line should be set to whatever the screen default is."
          ]
 
-  label = RNDK::Label.new(rndkscreen,
-                          RNDK::CENTER,
-                          RNDK::CENTER,
-                          mesg,
-                          true,
-                          true)
+  label = RNDK::Label.new(screen, {
+                            :x => RNDK::CENTER,
+                            :y => RNDK::CENTER,
+                            :text => mesg,
+                            :shadow => true
+                          })
 
   if label.nil?
-    RNDK::Screen.end_rndk
+    RNDK::Screen.finish
 
     puts 'Cannot create the label. Is the window too small?'
     exit 1
@@ -33,15 +33,15 @@ begin
 
   # Draw the RNDK screen and waits for
   # space to be pressed.
-  rndkscreen.refresh
+  screen.refresh
   label.wait(' ')
 
   # Clean up
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
 # Just in case something bad happens.
 rescue Exception => e
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts e
   puts e.inspect