• Diff for "Plugins/Vpswitch"
  • Immutable Page
  • Info
  • Attachments
Differences between revisions 1 and 2
Revision 1 as of 2007-09-05 21:13:27
Size: 232
Editor: 205
Comment:
Revision 2 as of 2008-01-27 22:21:19
Size: 3303
Editor: dsl
Comment: Review vpswitch's functionality in much greater detail
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
The '''Viewport Mouse Switch plugin''' switches viewports by scrolling the mouse wheel over an empty portion of the desktop. You can also grab the desktop cube and rotate it freely by holding down the mouse wheel over the desktop. [[Card(Plugin align=right, name=Viewport Switcher, icon=plugin-vpswitch.png, pack=[:PluginsMain:Main Plugins], cat=Desktop, hist=)]]

The '''Viewport Switcher''' plugin allows you to switch viewports by scrolling the mouse wheel over an empty portion of the desktop. When using the '''[:Plugins/Cube:Desktop Cube]''', you can also grab the cube to rotate it freely by middle-clicking over an empty portion of the desktop.

[[TableOfContents]]

== Using the Viewport Switcher ==

The Viewport Switcher can be used in 4 ways. As mentioned in the introduction, it allows you to switch viewports by scrolling the mouse wheel over an empty portion of the desktop when used in conjunction with a plugin that provides multiple viewports such as the '''[:Plugins/Cube:Desktop Cube]''', '''[:Plugins/Wall:Desktop Wall]''', or '''[:Plugins/Plane:Desktop Plane]'''.

When using the '''[:Plugins/Cube:Desktop Cube]''', you can also grab the cube to rotate it freely by middle-clicking over an empty portion of the desktop. This behaviour can be adjusted to trigger other actions in other plugins; refer to the Configuration section for [#plugin_action more information].

You can assign key bindings that allow you to jump directly to any specific viewport without stopping by other viewports along the way.

Finally, you can assign a key binding that causes Compiz to wait for you to enter the number of the viewport to which you want to switch. To use it, press and hold the keys specified in the binding, then type in a number. Let go over the keys specified in the binding to jump to that viewport.

== Configuration ==

=== Desktop-based Viewport Switching ===

This tab can be used to assign key and mouse bindings that allow you to move to an adjacent viewport in a specific direction, as well as access the next and previous viewports in order.

==== Plugin Actions ====

[[Anchor(plugin_action)]] There is also a mouse binding that allows you to trigger a specific action from a specific plugin when the binding is press over an empty portion of the desktop. The default behaviour allows you to grab the desktop cube for free rotation with a middle-click, but that can be configured.
|| [[Anchor(initiate_button)]] ''Initiate plugin action'' || Mouse binding that triggers the plugin action when pressed over an empty part of the desktop. ||
|| [[Anchor(init_plugin)]] ''Plugin for initiate action'' || The name of the plugin whose action should be triggered. ||
|| [[Anchor(init_action)]] ''Action name for initiate'' || The name of the action that should be triggered. ||
By assigning different values to ''[#init_plugin Plugin for initiate action]'' and ''[#init_action Action name for initiate]'', you can completely repurpose this functionality. For example, middle-clicking over the desktop can be made to trigger '''[:Plugins/Expo:Expo]''' by setting the plugin to "`expo`" and the action to "`expo_key`".

=== Go to specific viewport ===

This tab can be used to assign key bindings that allow you to jump directly to a specific viewport, from Viewport 1 up to Viewport 12.

=== Number-Based Viewport Switching ===

This tab can be used to assign a key binding that causes Compiz to wait for you to enter the number of the viewport to which you want to switch.

Card(Plugin align=right, name=Viewport Switcher, icon=plugin-vpswitch.png, pack=[:PluginsMain:Main Plugins], cat=Desktop, hist=)

The Viewport Switcher plugin allows you to switch viewports by scrolling the mouse wheel over an empty portion of the desktop. When using the [:Plugins/Cube:Desktop Cube], you can also grab the cube to rotate it freely by middle-clicking over an empty portion of the desktop.

TableOfContents

Using the Viewport Switcher

The Viewport Switcher can be used in 4 ways. As mentioned in the introduction, it allows you to switch viewports by scrolling the mouse wheel over an empty portion of the desktop when used in conjunction with a plugin that provides multiple viewports such as the [:Plugins/Cube:Desktop Cube], [:Plugins/Wall:Desktop Wall], or [:Plugins/Plane:Desktop Plane].

When using the [:Plugins/Cube:Desktop Cube], you can also grab the cube to rotate it freely by middle-clicking over an empty portion of the desktop. This behaviour can be adjusted to trigger other actions in other plugins; refer to the Configuration section for [#plugin_action more information].

You can assign key bindings that allow you to jump directly to any specific viewport without stopping by other viewports along the way.

Finally, you can assign a key binding that causes Compiz to wait for you to enter the number of the viewport to which you want to switch. To use it, press and hold the keys specified in the binding, then type in a number. Let go over the keys specified in the binding to jump to that viewport.

Configuration

Desktop-based Viewport Switching

This tab can be used to assign key and mouse bindings that allow you to move to an adjacent viewport in a specific direction, as well as access the next and previous viewports in order.

Plugin Actions

Anchor(plugin_action) There is also a mouse binding that allows you to trigger a specific action from a specific plugin when the binding is press over an empty portion of the desktop. The default behaviour allows you to grab the desktop cube for free rotation with a middle-click, but that can be configured.

Anchor(initiate_button) Initiate plugin action

Mouse binding that triggers the plugin action when pressed over an empty part of the desktop.

Anchor(init_plugin) Plugin for initiate action

The name of the plugin whose action should be triggered.

Anchor(init_action) Action name for initiate

The name of the action that should be triggered.

By assigning different values to [#init_plugin Plugin for initiate action] and [#init_action Action name for initiate], you can completely repurpose this functionality. For example, middle-clicking over the desktop can be made to trigger [:Plugins/Expo:Expo] by setting the plugin to "expo" and the action to "expo_key".

Go to specific viewport

This tab can be used to assign key bindings that allow you to jump directly to a specific viewport, from Viewport 1 up to Viewport 12.

Number-Based Viewport Switching

This tab can be used to assign a key binding that causes Compiz to wait for you to enter the number of the viewport to which you want to switch.

Plugins/Vpswitch (last edited 2008-03-30 18:33:49 by localhost)