totalspaces2 2.0.3 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fef721df45dd16cb94c6d20cc5794c07b9594b29
-  data.tar.gz: 48000e5f3c609db3eac831593cb618e8b11f2bef
+  metadata.gz: 0f3ddbebf28e2e9743d6fe6d61c761e6268bc975
+  data.tar.gz: 713cce61a7e38741d5a7f8c5185d7c6171cce93a
 SHA512:
-  metadata.gz: a7f195209c9866777288c61b8bf52a2a99611492fa79701da58af70afc9a5564ad5bb44153ea3541095be3a166b27758027984e7f3c7192e8bacc6fbb46d5ae5
-  data.tar.gz: 67bc4ea8980d48580618c47da9cad93dcb4a0e502946552fe9f112568a14e8f0c1306bd9bf099ae942900ea05b5a3a18b05cb12a39497532f83bcd2b245e96a4
+  metadata.gz: 44ea68c12359088a5c4d9ec63d71192c6788c85afd69c4fc414506e915116f786ea7aaf176a952eb9b823ca7d8bfb41332a7f6f6e7d14b5e5195083c877817ff
+  data.tar.gz: 1bf43400af7a477760785af3dbf51b66aa50ba9446e623347368a74be98974a3cb0214893aa25ee5a3a4e576800859cda0eceaabaf7e2ccf4250f71e3cc85677

data/README.rdoc

@@ -1,8 +1,6 @@
 = TotalSpaces2 - Ruby API bindings for TotalSpaces2 from BinaryAge
 
-== PRERELEASE: You can only use the API with versions 2.1 and above of TotalSpaces2.
-
-Version 2.1+ of TotalSpaces2 is available by ticking the "Include pre-releases" checkbox in General Preferences and then selecting "Check for updates" from the menu.
+== You can only use the API with versions 2.1 and above of TotalSpaces2.
 
 This gem enables you to get information from and to control {TotalSpaces2}[link:http://totalspaces.binaryage.com]
 

data/lib/TSLib.h

@@ -87,17 +87,39 @@ void tsapi_freeDisplayList(struct tsapi_displays *displayList);
 /*
  * The number of the current space.
  *
- * If the current space is the dashboard, 0 is returned.
+ * Numbering starts at 1.
  */
 unsigned int tsapi_currentSpaceNumberOnDisplay(CGDirectDisplayID displayID);
 
 /*
  * The name for the given space number.
  *
+ * The name is either the custom one that has been set, or a name generated by TotalSpaces 
+ * such as "Desktop 3".
  * You must call tsapi_freeString when you have finished with the returned string.
  */
 const char *tsapi_spaceNameForSpaceNumberOnDisplay(unsigned int spaceNumber, CGDirectDisplayID displayID);
 
+/*
+ * The custom name for the given space number. If the space has no custom name set in,
+ * TotalSpaces2, NULL is returned.
+ *
+ * You must call tsapi_freeString when you have finished with the returned string.
+ */
+const char *tsapi_customNameForSpaceNumberOnDisplay(unsigned int spaceNumber, CGDirectDisplayID displayID);
+
+typedef enum {
+  SpaceTypeDesktop,
+  SpaceTypeFullScreen,
+  SpaceTypeDashboard,
+} SpaceType;
+
+/*
+ * The type of the space.
+ *
+ */
+SpaceType tsapi_spaceTypeForSpaceNumberOnDisplay(unsigned int spaceNumber, CGDirectDisplayID displayID);
+
 /*
  * The uuid for the given space number. This uniquely identifies the space, even when
  * it is moved to a different position or to another monitor.
@@ -275,5 +297,20 @@ bool tsapi_removeDesktopsOnDisplay(unsigned int numberToRemove, CGDirectDisplayI
  */
 void tsapi_setFrontWindow(unsigned int windowID);
 
+/*
+ * Move a window
+ * Use the origin from the frame given in the tsapi_window struct
+ * as the starting point to make adustments. There is no validation,
+ * you can place a window far off the screen if you wish.
+ */
+void tsapi_moveWindow(unsigned int windowID, float x, float y);
+
+/*
+ * Bind an app to a particular space.
+ * Set spaceUUID to NULL to remove a binding for a partular app.
+ * Set spaceUUID to "AllSpaces" to make an app appear on every space.
+ */
+void tsapi_bindAppToSpace(char *bundleID, char *spaceUUID);
+
 #endif
 

data/lib/totalspaces2.rb

@@ -113,6 +113,9 @@ module TSApi  #:nodoc:
   attach_function :tsapi_removeDesktopsOnDisplay, [:uint, :uint], :bool
   
   attach_function :tsapi_setFrontWindow, [:uint], :void
+  attach_function :tsapi_moveWindow, [:uint, :float, :float], :void
+  
+  attach_function :tsapi_bindAppToSpace, [:string, :string], :void
 end
 
 module TotalSpaces2
@@ -177,7 +180,7 @@ module TotalSpaces2
     
     public
     
-    # Returns the version of the dylib, a string such as "1.0"
+    # Returns the version of the dylib, a string such as "1.0.1"
     # You should be using the same dylib major version number as that returned by the api_version call
     #
     #   puts "libTotalSpaces2 version: #{TotalSpaces2.lib_total_spaces_version}"
@@ -192,8 +195,8 @@ module TotalSpaces2
       string_and_free(TSApi.tsapi_libTotalSpacesVersion)
     end
 
-    # Returns the version of the api present in TotalSpaces2, a string such as "1.0"
-    # You should be using the same dylib version as that returned by the this call
+    # Returns the version of the api present in TotalSpaces2, a string such as "1.0.1"
+    # You should be using the same dylib major version number as that returned by the this call
     #
     #   puts "TotalSpaces2 API version: #{TotalSpaces2.api_version}"
     #
@@ -620,5 +623,32 @@ module TotalSpaces2
     def set_front_window(window_id)
       TSApi.tsapi_setFrontWindow(window_id)
     end
+
+    # Move a particular window to a new position.
+    # Use the origin from the frame given by window_list
+    # as the starting point to make adustments. There is no validation,
+    # you can place a window far off the screen if you wish.
+    #
+    # For instance, if the frame or window id 123 is "{{146, 23}, {1133, 754}}", 
+    # the origin is (146, 23). To move the window down 20 pixels, you would do this:
+    #
+    #   TotalSpaces2.move_window(123, 146, 43)
+    #
+    def move_window(window_id, x, y)
+      TSApi.tsapi_moveWindow(window_id, x, y)
+    end
+
+    # Bind an app to a space.
+    # The bundle_id is normally in the format "com.apple.mail"
+    # Setting the space_uuid to AllSpaces will result in an app
+    # appearing on every desktop.
+    # Setting the space_uuid to nil will delete the setting for the
+    # given bundle_id.
+    #
+    #   TotalSpaces2.bind_app_to_space("com.apple.mail", "AllSpaces")
+    #
+    def bind_app_to_space(bundle_id, space_uuid)
+      TSApi.tsapi_bindAppToSpace(bundle_id, space_uuid)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: totalspaces2
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.2.1
 platform: ruby
 authors:
 - Stephen Sykes
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-07 00:00:00.000000000 Z
+date: 2015-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -63,7 +63,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: TotalSpaces2 control from ruby