motion-popup 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 956fa4f7b20fe96de2493b8e49229b05c25e171c
+  data.tar.gz: 8df7870f25b784728a4794c8d60a6db51f742cb6
+SHA512:
+  metadata.gz: 61cc869b3b688cb2c3f7e6ea51dd27aa86c51e9331dae9ca713313639308eed8ed1fc214db582b8cbde1e195757ef20f3faaa72329e100f67aecaed5e400a534
+  data.tar.gz: 1919d1f5bb96c7324fc7ee81312e91ac0fa370f2e115aba0faffaaf7adc436b5867132137c868ea3345344eaa02356dfa953f9fb92bc2e6cf3760470829d0f15

data/README.md

@@ -0,0 +1,88 @@
+# motion-popup
+
+Customisable fancy popup window for your Mac OS X status bar apps
+
+## Requirements
+
+* RubyMotion
+* RubyGems
+
+## Setup
+
+Add to your Gemfile:
+
+``` shell
+gem 'motion-popup'
+```
+
+Or install manually:
+
+* gem install motion-popup
+
+## Usage
+
+You can create a popup window within your app like this:
+
+``` ruby
+@window = Motion::Popup::Panel.alloc.initPopup(POPUP_WIDTH, POPUP_HEIGHT)
+```
+
+You can customise how the background panel is drawn by setting the following values (the values shown here are the defaults):
+
+``` ruby
+@window.background.arrow_height = 12
+@window.background.arrow_width = 15
+@window.background.line_thickness = 1
+@window.background.corner_radius = 20
+```
+
+arrow_height and arrow_width refer to the arrow pointer on the top of the panel that'll point to the status bar menu item. line_thickness is the outer border for the panel, and corner_radius affects the drawing of the rounded corners for the panel.
+
+You can then fill the window with additional views using:
+
+``` ruby
+@window.contentView.addSubview(my_other_view)
+```
+
+Lastly, you can toggle showing the window using:
+
+``` ruby
+@window.toggle
+```
+
+For example, you can set the window as the delegate for your status menu item, and set the action to toggle so it triggers the window:
+
+``` ruby
+@status_item = NSStatusBar.systemStatusBar.statusItemWithLength(NSVariableStatusItemLength).init
+@status_item.setTarget(@window)
+@status_item.setAction('toggle')
+```
+
+This handles updating the windows position to sit under the menu item, with the arrow pointer directly in the middle. The window itself handles hiding itself when it loses focus, and ensuring the toggle then allows it to be reshown when the menu is clicked again.
+
+## Contributors
+
+* Elliott Draper
+
+## License
+
+Copyright 2014 Elliott Draper <el@kickcode.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/motion-popup.rb

@@ -0,0 +1,7 @@
+unless defined?(Motion::Project::Config)
+  raise "This file must be required within a RubyMotion project Rakefile."
+end
+
+Motion::Project::App.setup do |app|
+  app.files = [Dir.glob(File.join(File.dirname(__FILE__), "motion/**/*.rb")), app.files].flatten
+end

data/lib/motion/popup/background.rb

@@ -0,0 +1,64 @@
+# Drawing code for the popup panel background ported from this excellent Obj-C popup demo code
+# https://github.com/shpakovski/Popup / http://blog.shpakovski.com/2011/07/cocoa-popup-window-in-status-bar.html
+class Motion::Popup::Background < NSView
+  attr_accessor :arrow_height, :arrow_width, :line_thickness, :corner_radius
+
+  def initWithFrame(frame)
+    self.arrow_height = 12
+    self.arrow_width = 15
+    self.line_thickness = 1
+    self.corner_radius = 20
+
+    super(frame)
+  end
+
+  def drawRect(rect)
+    return unless @arrow_x
+    content_rect = NSInsetRect(self.bounds, self.line_thickness, self.line_thickness)
+    path = NSBezierPath.bezierPath
+
+    path.moveToPoint(NSMakePoint(@arrow_x, NSMaxY(content_rect)))
+    path.lineToPoint(NSMakePoint(@arrow_x + self.arrow_width / 2, NSMaxY(content_rect) - self.arrow_height))
+    path.lineToPoint(NSMakePoint(NSMaxX(content_rect) - self.corner_radius, NSMaxY(content_rect) - self.arrow_height))
+
+    top_right_corner = NSMakePoint(NSMaxX(content_rect), NSMaxY(content_rect) - self.arrow_height)
+    path.curveToPoint(NSMakePoint(NSMaxX(content_rect), NSMaxY(content_rect) - self.arrow_height - self.corner_radius), controlPoint1: top_right_corner, controlPoint2: top_right_corner)
+
+    path.lineToPoint(NSMakePoint(NSMaxX(content_rect), NSMinY(content_rect) + self.corner_radius))
+
+    bottom_right_corner = NSMakePoint(NSMaxX(content_rect), NSMinY(content_rect))
+    path.curveToPoint(NSMakePoint(NSMaxX(content_rect) - self.corner_radius, NSMinY(content_rect)), controlPoint1: bottom_right_corner, controlPoint2: bottom_right_corner)
+
+    path.lineToPoint(NSMakePoint(NSMinX(content_rect) + self.corner_radius, NSMinY(content_rect)))
+
+    path.curveToPoint(NSMakePoint(NSMinX(content_rect), NSMinY(content_rect) + self.corner_radius), controlPoint1: content_rect.origin, controlPoint2: content_rect.origin)
+
+    path.lineToPoint(NSMakePoint(NSMinX(content_rect), NSMaxY(content_rect) - self.arrow_height - self.corner_radius))
+
+    top_left_corner = NSMakePoint(NSMinX(content_rect), NSMaxY(content_rect) - self.arrow_height)
+    path.curveToPoint(NSMakePoint(NSMinX(content_rect) + self.corner_radius, NSMaxY(content_rect) - self.arrow_height), controlPoint1: top_left_corner, controlPoint2: top_left_corner)
+
+    path.lineToPoint(NSMakePoint(@arrow_x - self.arrow_width / 2, NSMaxY(content_rect) - self.arrow_height))
+    path.closePath
+
+    NSColor.whiteColor.setFill
+    path.fill
+
+    NSGraphicsContext.saveGraphicsState
+
+    clip = NSBezierPath.bezierPathWithRect(self.bounds)
+    clip.appendBezierPath(path)
+    clip.addClip
+
+    path.setLineWidth(self.line_thickness * 2)
+    NSColor.lightGrayColor.setStroke
+    path.stroke
+
+    NSGraphicsContext.restoreGraphicsState
+  end
+
+  def setArrowX(value)
+    @arrow_x = value
+    self.setNeedsDisplay(true)
+  end
+end

data/lib/motion/popup/panel.rb

@@ -0,0 +1,43 @@
+class Motion::Popup::Panel < NSPanel
+  attr_accessor :background
+
+  def initPopup(width, height)
+    self.initWithContentRect([[0, 0], [width, height]],
+      styleMask: NSBorderlessWindowMask,
+      backing: NSBackingStoreBuffered,
+      defer: false)
+    self.title = NSBundle.mainBundle.infoDictionary['CFBundleName']
+    self.delegate = self
+    self.setBackgroundColor(NSColor.clearColor)
+    self.setOpaque(false)
+
+    self.background = Motion::Popup::Background.alloc.initWithFrame(self.frame)
+    self.setContentView(self.background)
+
+    self
+  end
+
+  def toggle
+    if self.isVisible
+      self.orderOut(false)
+    else
+      event_frame = NSApp.currentEvent.window.frame
+      window_frame = self.frame
+      window_top_left_position = CGPointMake(event_frame.origin.x + (event_frame.size.width / 2) - (window_frame.size.width / 2), event_frame.origin.y)
+      self.setFrameTopLeftPoint(window_top_left_position)
+
+      self.background.setArrowX(window_frame.size.width / 2)
+
+      NSApp.activateIgnoringOtherApps(true)
+      self.makeKeyAndOrderFront(self)
+    end
+  end
+
+  def canBecomeKeyWindow
+    true
+  end
+
+  def windowDidResignKey(sender)
+    self.orderOut(false)
+  end
+end

data/lib/motion/popup/version.rb

@@ -0,0 +1,5 @@
+module Motion
+  module Popup
+    VERSION = 1.0
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: motion-popup
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Elliott Draper
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-03 00:00:00.000000000 Z
+dependencies: []
+description: motion-popup provides an easy to use popup window with customisable nice
+  looking background panel to use in Mac OS X status bar apps.
+email: el@kickcode.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/motion/popup/background.rb
+- lib/motion/popup/panel.rb
+- lib/motion/popup/version.rb
+- lib/motion-popup.rb
+- README.md
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Customisable fancy popup window for your Mac OS X status bar apps
+test_files: []