epall-limelight 0.5.1-java → 0.5.2-java

data/lib/limelight/scene.rb

@@ -88,7 +88,7 @@ module Limelight
     # Creates a new Producer to open the specified Production.
     #
     def open_production(production_path)
-      Thread.new { Studio.open(production_path) }
+      Thread.new { Context.instance.studio.open(production_path) }
     end
 
     # Opens the specified Scene on the Stage currently occupied by this Scene.

data/lib/limelight/specs/spec_helper.rb

@@ -34,7 +34,7 @@ module Spec
         uses_limelight({:scene => scene_name}.merge(options))
       end
       
-      def self.uses_limelight(options, &prop_block)
+      def self.uses_limelight(options = {}, &prop_block)
         include Limelight::Specs::SpecHelper
         
         before(:each) do

data/lib/limelight/specs/test_scene_opener.rb

@@ -1,3 +1,6 @@
+#- Copyright � 2008-2009 8th Light, Inc. All Rights Reserved.
+#- Limelight and all included source files are distributed under terms of the GNU LGPL.
+
 module Limelight
   module Specs
     module SpecHelper

data/lib/limelight/stage.rb

@@ -186,6 +186,7 @@ module Limelight
     # See load_scene
     #
     def open(scene)
+      @current_scene.visible = false if @current_scene
       scene.stage = self
       scene.illuminate
       load_scene(scene)
@@ -197,16 +198,13 @@ module Limelight
     # Closes the Stage. It's window will no longer be displayed on the screen.
     #
     def close
-      @theater.stage_closed(self)
       @frame.close
-      @current_scene.visible = false if @current_scene
-      @current_scene = nil
     end
 
     # Loads a scene on the Stage.  If the Stage is currently hosting a Scene, the original Scene will be removed and
     # the new Scene will replace it.
     #
-    def load_scene(scene)
+    def load_scene(scene)      
       #      @frame.setJMenuBar(scene.menu_bar)
       @frame.load(scene.panel)
       if (has_static_size?(scene.style))
@@ -233,7 +231,7 @@ module Limelight
     def alert(message)
       Thread.new do
         begin
-          Studio.utilities_production.alert(message)
+          Context.instance.studio.utilities_production.alert(message)
         rescue StandardError => e
           puts "Error on alert: #{e}"
         end
@@ -254,6 +252,68 @@ module Limelight
       @current_scene = scene
     end
 
+    # returns true if the stage has been closed.  Closed stages may not be reopened.
+    #
+    def closed?
+      return @frame.closed?
+    end
+
+    # Invoked when the stage is being closed.
+    # System hook that should NOT be called by you.
+    #
+    def closing(e)
+    end
+
+    # Invoked when the stage has been closed.
+    # System hook that should NOT be called by you.
+    #
+    def closed(e)
+      @current_scene.visible = false if @current_scene
+      @current_scene = nil
+      @theater.stage_closed(self)
+    end
+
+    # Invoked when the stage has gained focus on the desktop.  Only 1 stage my have focus at a time.
+    # System hook that should NOT be called by you.
+    #
+    def focus_gained(e)
+      @theater.stage_activated(self)
+    end
+
+    # Invoked when the stage has lost focus on the desktop.  Only 1 stage my have focus at a time.
+    # System hook that should NOT be called by you.
+    #
+    def focus_lost(e)
+    end
+
+    # Invoked when the stage has been iconified.  This occurs when the stage is no longer visible on the desktop
+    # and an icon for the stage has been added to the OS's taskbar or dock.
+    # System hook that should NOT be called by you.
+    #
+    def iconified(e)
+    end
+
+    # Invoked when the stage has been deiconified.  This occurs when the icon for the stage has been removed from the
+    # taskbar or dock, and the stage is again visible on the desktop.  
+    # System hook that should NOT be called by you.
+    #
+    def deiconified(e)
+    end
+
+    # Invoked when the stage has become the active stage on the desktop.  Only 1 stage my be active at a time.
+    # System hook that should NOT be called by you.
+    #
+    def activated(e)
+      @theater.stage_activated(self)
+    end
+
+    # Invoked when the stage has lost status as the active stage.  Only 1 stage my have focus at a time.
+    # System hook that should NOT be called by you.
+    #
+    def deactivated(e)
+      @theater.stage_deactivated(self)  
+    end
+
     protected #############################################
 
     def new_frame

data/lib/limelight/studio.rb

@@ -1,184 +1,53 @@
 #- Copyright � 2008-2009 8th Light, Inc. All Rights Reserved.
 #- Limelight and all included source files are distributed under terms of the GNU LGPL.
-
-require 'limelight/producer'
+raise "studio.rb is present for solely to document it's Java counterpart limelight.Studio.  This file should NOT be loaded in the Ruby runtime."
 
 module Limelight
 
   # A Studio creates Productions.  There is only one instance of Studio per Limelight runtime.  All open productions
-  # are opened by the studio.
+  # are opened and tracked by the studio.
   #
   class Studio
 
-    include Limelight::UI::Api::Studio
-
-    class << self
-
-      def install #:nodoc:
-        Context.instance.studio = instance
-      end
-
-      def instance #:nodoc:
-        @studio = self.new if @studio.nil?
-        return @studio
-      end
-
-      def index(production) #:nodoc:
-        @index = [] if @index.nil?
-        if name_taken?(production.name)
-          assign_unique_name(production)
-        elsif production.name.nil?
-          assign_name_to(production)
-        else
-          error_if_duplicate_name(production.name)
-        end
-        @index << production
-      end
-
-      # Returns the production with the specified name that was previously opened but the Studio.
-      #
-      def [](name)
-        return nil if @index.nil?
-        return @index.find { |production| production.name == name }
-      end
-
-      def name_taken?(name) #:nodoc:
-        return self[name] != nil
-      end
-
-      def reset #:nodoc:
-        @index = []
-        @is_shutdown = false
-        @is_shutting_down = false
-        @studio = nil
-      end
-
-      def error_if_duplicate_name(name) #:nodoc:
-        raise Limelight::LimelightException.new("Production name '#{name}' is already taken") if name_taken?(name)
-      end
-
-      # Opens the production at the specified path.
-      #
-      def open(production_path)        
-        begin
-          producer = Producer.new(production_path)
-          production = producer.production
-          index(production)
-          producer.open
-          return production
-        rescue StandardError => e
-          alert_and_shutdown(e)
-        end
-      end
-
-      # Returns true if all of the open productions allow closing.
-      #
-      def should_allow_shutdown
-        return true if @index.nil?
-        return @index.all? { |production| production.allow_close? }
-      end
-
-      # If allowed (should_allow_shutdown), this will close all open productions and shutdown the limelight runtime.
-      #
-      def shutdown
-        return if @is_shutdown || @is_shutting_down
-        return unless should_allow_shutdown
-        @is_shutting_down = true
-        @index.each { |production| production.close } if @index
-        @utilities_production.close if @utilities_production
-        @is_shutdown = true
-        Thread.new { Context.instance().shutdown }
-      end
-
-      # Called when a production is closed to notify the studio of the event.
-      #
-      def production_closed(production)
-        @index.delete(production) if @index
-        shutdown if @index && @index.empty?
-      end
-
-      # Returns an array of all the productions
-      #
-      def productions
-        return @index.nil? ? [] : @index.dup
-      end
-
-      # Publish the Studio, using DRb, on the specified port.
-      #
-      def publish_on_drb(port)
-        @drb_server = DRb.start_service("druby://0.0.0.0:#{port}", self)
-      end
-
-      # Returns the utilities production; a production used by limelight.
-      #
-      def utilities_production
-        if @utilities_production == nil
-          producer = Producer.new(File.join($LIMELIGHT_LIB, "limelight", "builtin", "utilities_production"))
-          @utilities_production = producer.production
-          producer.open
-        end
-        return @utilities_production
-      end
-
-      # Returns a hash of all the built-in Limglight Styles
-      #
-      def builtin_styles
-        unless @builtin_styles
-          builtin_styles_file = File.join($LIMELIGHT_LIB, "limelight", "builtin", "styles.rb")
-          @builtin_styles = Limelight.build_styles_from_file(builtin_styles_file)
-        end
-        return @builtin_styles
-      end
-
-      private #############################################
+    # Opens the production at the specified path.
+    #
+    def open(production_path)
+    end
 
-      def assign_unique_name(production) #:nodoc:
-        count = 2
-        name = production.name
-        while name_taken?(name)
-          name = "#{production.name}_#{count}"
-          count += 1
-        end
-        production.name = name
-      end
+    # Returns the production with the specified name. If the studio never opened a production by that name, nil
+    # will be returned.
+    #
+    def get(name)
+    end
 
-      def assign_name_to(production) #:nodoc:
-        count = @index.length + 1
-        while name_taken?(count.to_s)
-          count += 1
-        end
-        production.name = count.to_s
-      end
+    # Returns true if all of the open productions allow closing.
+    #
+    def should_allow_shutdown
+    end
 
-      def alert_and_shutdown(e)
-        begin
-          message = "#{e}\n#{e.backtrace.join("\n")}"
-          utilities_production.alert(message)
-          shutdown if @index.nil? || @index.empty?
-        rescue Exception => e
-          puts e
-          puts e.backtrace
-        end
-      end
+    # If allowed (should_allow_shutdown), this will close all open productions and shutdown the limelight runtime.
+    #
+    def shutdown
+    end
 
+    # Called when a production is closed to notify the studio of the event. Developers should not need to call this method.
+    #
+    def production_closed(production)
     end
 
-    # Same as the class level method.
+    # Returns a list of all the productions
     #
-    def open(production_path)
-      self.class.open(production_path)
+    def productions
     end
 
-    # Same as the class level method.
+    # Returns the utilities production; a production used by limelight.
     #
-    def should_allow_shutdown
-      return self.class.should_allow_shutdown
+    def utilities_production
     end
 
-    # Same as the class level method.
+    # Returns true if the Studio has been shutdown.  ie. The procees is exiting.
     #
-    def shutdown
-      self.class.shutdown()
+    def shutdown?
     end
   end
 

data/lib/limelight/styles/style.rb

@@ -0,0 +1,288 @@
+raise "studio.rb is present for solely to document it's Java counterpart limelight.Studio.  This file should NOT be loaded in the Ruby runtime."
+
+module Limelight
+  module Styles
+    class Style
+      # Specifies the Width attribute of a prop.
+      #   type:           dimension
+      #   default_value:  auto
+      attr_accessor :width
+
+      # Specifies the Height attribute of a prop.
+      #   type:           dimension
+      #   default_value:  auto
+      attr_accessor :height
+
+      # Specifies the Min Width attribute of a prop.
+      #   type:           noneable simple dimension
+      #   default_value:  none
+      attr_accessor :min_width
+
+      # Specifies the Min Height attribute of a prop.
+      #   type:           noneable simple dimension
+      #   default_value:  none
+      attr_accessor :min_height
+
+      # Specifies the Max Width attribute of a prop.
+      #   type:           noneable simple dimension
+      #   default_value:  none
+      attr_accessor :max_width
+
+      # Specifies the Max Height attribute of a prop.
+      #   type:           noneable simple dimension
+      #   default_value:  none
+      attr_accessor :max_height
+
+      # Specifies the Vertical Scrollbar attribute of a prop.
+      #   type:           on/off
+      #   default_value:  off
+      attr_accessor :vertical_scrollbar
+
+      # Specifies the Horizontal Scrollbar attribute of a prop.
+      #   type:           on/off
+      #   default_value:  off
+      attr_accessor :horizontal_scrollbar
+
+      # Specifies the Top Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :top_border_color
+
+      # Specifies the Right Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :right_border_color
+
+      # Specifies the Bottom Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :bottom_border_color
+
+      # Specifies the Left Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :left_border_color
+
+      # Specifies the Top Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_border_width
+
+      # Specifies the Right Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :right_border_width
+
+      # Specifies the Bottom Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_border_width
+
+      # Specifies the Left Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :left_border_width
+
+      # Specifies the Top Margin attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_margin
+
+      # Specifies the Right Margin attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :right_margin
+
+      # Specifies the Bottom Margin attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_margin
+
+      # Specifies the Left Margin attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :left_margin
+
+      # Specifies the Top Padding attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_padding
+
+      # Specifies the Right Padding attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :right_padding
+
+      # Specifies the Bottom Padding attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_padding
+
+      # Specifies the Left Padding attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :left_padding
+
+      # Specifies the Background Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #00000000
+      attr_accessor :background_color
+
+      # Specifies the Secondary Background Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #00000000
+      attr_accessor :secondary_background_color
+
+      # Specifies the Background Image attribute of a prop.
+      #   type:           noneable string
+      #   default_value:  none
+      attr_accessor :background_image
+
+      # Specifies the Background Image Fill Strategy attribute of a prop.
+      #   type:           fill strategy
+      #   default_value:  repeat
+      attr_accessor :background_image_fill_strategy
+
+      # Specifies the Gradient attribute of a prop.
+      #   type:           on/off
+      #   default_value:  off
+      attr_accessor :gradient
+
+      # Specifies the Gradient Angle attribute of a prop.
+      #   type:           degrees
+      #   default_value:  90
+      attr_accessor :gradient_angle
+
+      # Specifies the Gradient Penetration attribute of a prop.
+      #   type:           percentage
+      #   default_value:  100%
+      attr_accessor :gradient_penetration
+
+      # Specifies the Cyclic Gradient attribute of a prop.
+      #   type:           on/off
+      #   default_value:  off
+      attr_accessor :cyclic_gradient
+
+      # Specifies the Horizontal Alignment attribute of a prop.
+      #   type:           horizontal alignment
+      #   default_value:  left
+      attr_accessor :horizontal_alignment
+
+      # Specifies the Vertical Alignment attribute of a prop.
+      #   type:           vertical alignment
+      #   default_value:  top
+      attr_accessor :vertical_alignment
+
+      # Specifies the Text Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :text_color
+
+      # Specifies the Font Face attribute of a prop.
+      #   type:           string
+      #   default_value:  Arial
+      attr_accessor :font_face
+
+      # Specifies the Font Size attribute of a prop.
+      #   type:           integer
+      #   default_value:  12
+      attr_accessor :font_size
+
+      # Specifies the Font Style attribute of a prop.
+      #   type:           font style
+      #   default_value:  plain
+      attr_accessor :font_style
+
+      # Specifies the Transparency attribute of a prop.
+      #   type:           percentage
+      #   default_value:  0%
+      attr_accessor :transparency
+
+      # Specifies the Top Right Rounded Corner Radius attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_right_rounded_corner_radius
+
+      # Specifies the Bottom Right Rounded Corner Radius attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_right_rounded_corner_radius
+
+      # Specifies the Bottom Left Rounded Corner Radius attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_left_rounded_corner_radius
+
+      # Specifies the Top Left Rounded Corner Radius attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_left_rounded_corner_radius
+
+      # Specifies the Top Right Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_right_border_width
+
+      # Specifies the Bottom Right Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_right_border_width
+
+      # Specifies the Bottom Left Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :bottom_left_border_width
+
+      # Specifies the Top Left Border Width attribute of a prop.
+      #   type:           pixels
+      #   default_value:  0
+      attr_accessor :top_left_border_width
+
+      # Specifies the Top Right Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :top_right_border_color
+
+      # Specifies the Bottom Right Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :bottom_right_border_color
+
+      # Specifies the Bottom Left Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :bottom_left_border_color
+
+      # Specifies the Top Left Border Color attribute of a prop.
+      #   type:           color
+      #   default_value:  #000000ff
+      attr_accessor :top_left_border_color
+
+      # Specifies the Float attribute of a prop.
+      #   type:           on/off
+      #   default_value:  off
+      attr_accessor :float
+
+      # Specifies the X attribute of a prop.
+      #   type:           x-coordinate
+      #   default_value:  0
+      attr_accessor :x
+
+      # Specifies the Y attribute of a prop.
+      #   type:           y-coordinate
+      #   default_value:  0
+      attr_accessor :y
+
+      # Specifies the Background Image X attribute of a prop.
+      #   type:           x-coordinate
+      #   default_value:  0
+      attr_accessor :background_image_x
+
+      # Specifies the Background Image Y attribute of a prop.
+      #   type:           y-coordinate
+      #   default_value:  0
+      attr_accessor :background_image_y
+
+    end
+  end
+end