Wraparound Icon Wraparound 1.3 Help

Email: wraparound@digicowsoftware.com

Introduction

This document will help you get the most out of Wraparound and its various options to configure screen-cursor-wrapping to best suit your specific needs. This version of Wraparound has been design based on several user suggestions to add the features in which interest has been expressed.

If after reviewing this Help page you have any further questions about using Wraparound, please use the email link above to contact Digital Cow Software.

Features & Options

What Wraparound Does: Wraparound eases mouse-cursor navigation by "wrapping" the cursor from one side of the screen to the other when it reaches the edge of the screen. Wraparound handles all screen configurations: small, large, multiple, even combinations of monitors and televisions.

What Wraparound Does Not Do: Wraparound does not "hack" the system at a low level. Wraparound runs as a normal Mac OS X application, so there are some (normally unnoticable) limitations of its operation, but also the peace of mind of knowing it's never doing anything that can't be stopped by simply quitting the application. Wraparound also does not alter the display, so there is no way that windows can mimic the mouse cursor behavior, wrapping from one side of the screen to the other, straddling the edge. This is particularly noticable for multiple monitor users.


How to use Wraparound
Wraparound begins wrapping immediately when the application is launched, unless it is in disabled status (more on that later). There are two main aspects of its user interface: the menu bar icon & menu, and the Preferences window. The former displays Wraparound's current enabled status, allows you to temporarily stop and restart Wraparound's wrapping function, display the Preferences window, and quit Wraparound. The Preferences window offers a variety of choices and options to customize Wraparound's behavior. There are four ways to cause the Preferences window to be displayed:

How to exit Wraparound
But why would you want to!? If you did come up with a good answer to this question, there are two main ways to exit Wraparound. The most common is to select Quit from the Wraparound menu. The other way is to press command-Q while in the Wraparound Preferences window.

The Preferences Window
The preferences window is divided into four sections: Edges, Settings, Performance, and Auto-Disable.

In the Edges section, you can choose which edges of the screen the mouse cursor can pass through to wrap to the other side. With this version you are no longer limited to choices of Horizontal and Vertical: you can now choose any edge individually. This can even create one-way wrapping scenarios, for example so that you can wrap Up to get to the bottom of the screen, but not wrap Bottom so that you can unhide Dock. Deselecting all four edges will put Wraparound into disabled mode and its menu bar icon will appear greyed out. Wraparound stops checking the cursor position, and you cannot Start it while it is disabled. This section also allows you to set up modifier keys to temporarily enable or disable wrapping of all screen edges while holding that key.

Next is the Settings section, which contains three checkboxes. These checkboxes respectively control whether or not Wraparound launches itself when you log into Mac OS X, displays the Preferences window when it launches, and shows the Wraparound icon and menu on the right side of the menu bar.

The Performance section is very simple. There is a slider that affects how often Wraparound checks for the location of the mouse cursor. Moving it all the way to the left slows down your computer less, but there may be a noticable delay where the mouse seems "stuck" on one side of the screen before it jumps to the other side. Moving it all the way to the right completely eliminates this effect, but may cause other applications to slow down a bit. Most users should be comfortable with this slider in the middle, or slightly to the left of the middle.

Finally, in the Auto-Disable section there are two main components that tell Wraparound when to stop wrapping under certain conditions. First are the familiar corner controls from previous Wraparound versions. Checking the "Near corners" box will prevent Wraparound from wrapping the mouse cursor when it is within that number of pixels of a screen corner. This is useful for hitting the corners to activate screensavers or expose. The second way to activate auto-disabling is through the Applications list. This allows you to have Wraparound automatically stop wrapping when you switch to certain applications, like games. You can use the popup menu to choose whether you want Wraparound to be enabled in all applications, disabled in certain applications, or disabled in all except certain applications. You need to have one of the latter two choices chosen in order to use the + and - buttons below the list, to modify its contents. As of this release, you cannot drop Applications from Finder onto this list, you must use the buttons.

F.A.Q.
Q. Why did you create Wraparound?

A. I've been a dual-monitor user for many years. Once the screens get big enough, it can become annoying to constantly move the entire length of both screens to access certain elements, particularly the menu bar. Wraparound is inspired by an old Mac OS 9 and below extension that offered similar functionality. If anyone knows this extension or its author, please let me know, as I'd like to give credit in Wraparound

Q. You mentioned limitations of Wraparound above. What are you referring to?

A. Because Wraparound runs as a normal application, the wrapping function is not done at the mouse driver or display level. Instead, Wraparound polls the cursor position between 5 and 50 times per second, and if its location is the last pixel of the screen, Wraparound resets the location to the other side. There are three main issues with this approach:

Q. Wow, this new version is exactly what I wanted. How can I show my appreciation?

A. While Wraparound is distributed as freeware, donations are ALWAYS appreciated and inspire more work devoted to Digital Cow Software, which means more/better apps in the future. Donate!

Q. How come my feature/help request was ignored?A. I've been getting a lot of email from users lately and while I want to respond to everyone individually, I don't have a lot of time between my day job and wedding preparations. If you haven't heard anything back from me, shoot me another email. I always enjoy hearing from my users!

Q. What's in store for Wraparound in the future?

A. My plans are for the next version of Wraparound to become a System Preferences pane. I think this would better suit the app and make it easlier to deal with for those who don't want another icon cluttering their menu bar.