TweetFollow Us on Twitter

Multiple Monitors
Volume Number:10
Issue Number:7
Column Tag:There’s a right way...

Related Info: Window Manager Dialog Manager Standard File

Multiple Monitors vs. Your Application

Assume one monitor, go to jail...

By Eric Shapiro, Rock Ridge Enterprises

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

About the author

Eric earned fame with his big-hit, glam-hack VideoBeep, first shown at MacHack as a prize-winning entry in the MacHax™ Best Hack contest. When he’s not busy writing his next hack for MacHack, Eric is president of Rock Ridge Enterprises, a Macintosh consulting firm. His other smash hits include Spectator, EzTape, Business Simulator, and (the now illegal) The Grouch.

Eric is currently working on course materials for Apple Developer University’s OpenDoc seminar. He has taught Macintosh Programming Fundamentals and Macintosh Device Drivers seminars for Apple as well. Eric has degrees in both Computer and Electrical Engineering from the University of Michigan and is a past president of MacTechnics Users Group.

You can reach Eric at

[Eric, otherwise way-too-busy-to-write-an-article, found a reason to sound off. The result? A stream-of-consciousness gripe piece with some useful information. If you’d like to see more of these kinds of articles, please let us know. Better yet, pick your favorite gripe about software done the wrong way, and write up your own “There’s a right way ” article. - Ed stb]

I am writing this article because I’ve recently come across 5 new Mac programs in the last few weeks that don’t support multiple monitors correctly. I’m getting sick of rebooting, and of explaining the various problems to the companies involved, so I’m going to send them a copy of this article instead.

Like many programmers, my main screen is a 2-page b&w display while my second screen is a 13” color display. Several of the programs I’ve been running have problems with all 2 monitor systems. Other programs run properly on some 2 monitor setups, but get confused when the main device has a lower depth than the second one.

Here’s a checklist for writing well-behaved Macintosh software:

Open windows on the proper screen

New document windows should be opened on the same screen as the parent window. If there is no parent window, use the main screen (or, if you want to be really cool, use whichever screen was most recently used for a document).

It is easiest to create windows invisibly, add controls and other items to the window, position and resize it, and then make it visible. A new version of one popular developer tool creates the window visibly first, and then quickly snaps it to its new size/location. This is very disconcerting (and somewhat reminiscent of HyperCard).

The Window Manager in System 7 makes it easy to properly place new windows, as long as they don’t need to be resized dynamically. Simply set the Auto-Position field in a WIND or DLOG resource to Parent window or Parent window’s screen.. If your application contains floating palette windows, you’ll have to hide them before calling GetNewWindow or GetNewDialog for this scheme to work.

The standard file box is a particularly nasty dialog, because it’s difficult to center on the proper monitor. The problem is that the size stored in the DLOG resource is unreliable, especially when using utilities like Norton’s “Directory Assistance”. Generally, though, everything works fine if you assume the standard size and place the dialog on the top portion of the designated screen. You will have to use the CustomGetFile call instead of the easier StandardGetFile call to position the dialog on an arbitrary device.

The color picker also needs to be special cased, because it should probably be placed on the deepest device (although this might not be true for all programs). Under recent System versions, this can be accomplished by passing (-1, -1) for the dialog location. Programs like PhotoShop have their own moveable color pickers that the user can drag to any screen.

Default document size

Don’t assume that new document windows should completely fill the main screen. This is very annoying to owners of large displays. Let the user specify a default document size or write a little code to make sure that the default document isn’t oversized.


There are still some programs that don’t allow windows to be dragged to second monitors. While holding down the Cmd/Option keys often overrides this problem, the programs really should be updated. Many programs pass screenBits.bounds to DragWindow as the limit rectangle. This works on multiple monitor systems only because Apple put a kludge in the Window Manager to support old software [It may be a kludge, but Apple would be crazy to change it - Ed stb]. Don’t inset it, just pass screenBits.bounds to DragWindow or use the following “morally correct” code:

/* 1 */
 if ( gHasColorQuickDraw )
 limitR = (**GetGrayRgn()).rgnBBox;
 limitR = screenBits.bounds;

 DragWindow( myWindow, theEvent->where, &limitR );

Reference screenBits.bounds as qd.screenBits.bounds when using either MPW or the universal header files.


See develop Magazine #17 for a good article on proper zooming. Windows should zoom out to their current monitor and not the main monitor.

Remember window positions

Window positions should be stored within the document file for document windows or within the application’s “Preferences” file for non-document windows. When a document is opened, return the window to the saved location. Be sure to check that the window and its title bar still overlap the grayRgn, because the monitor setup may have changed. I’ve seen several programs (including some best sellers) that will open a window positioned completely off all monitors. Other programs will open windows with their title bars underneath the menu bar. The window’s size should never be larger than the device, because it may be impossible for the user to reach the growBox. Forcing the entire window onscreen is not unreasonable. Lastly, make sure your calculations don’t choke on negative window coordinates - this will be the case for monitors positioned to the left or above the main device.

/* 2 */
 Checks to make sure the passed global rectangle is completely contained 
within the gray region. Pass the window’s portRect in global coordinates.

Depends on two regions, gSpareRgn1 and gSpareRgn2, having been allocated 
globally (using NewRgn).
 Your application might want to allow partially offscreen windows. 
Document windows are assumed to have title heights of 20 pixels. There 
are moredynamic ways of handling this, such as positioning the window 
way offscreen and checking its structure region. 
Boolean IsPositionOK( Rect *globalR, Boolean isDocWindow )
 BooleanisOK = false;
 Rect   fullWindowR;
 #define kDocWindowHeight 20// pixels
 // put the window rect into gSpareRgn1
 fullWindowR = *globalR;
 if ( isDocWindow ) -= kDocWindowHeight;
 RectRgn( gSpareRgn1, &fullWindowR );
 // see if the window completely intersects the grayRgn
 SectRgn( GetGrayRgn(), gSpareRgn1, gSpareRgn2 );
 if ( EqualRgn( gSpareRgn1, gSpareRgn2 ) )
 isOK = true;
 return( isOK );


Games are notorious for not running properly on multiple monitor systems. With my particular setup (a b&w main screen and a color 2nd screen), many games look at the main device and put up an error message complaining about the screen depth.

A little extra checking solves this problem. Let’s say your game requires an 8-bit monitor. (Apple says that programs shouldn’t require specific screen depths, but they don’t write games, either [although there was an entire session and a show of support for games at WWDC this year - Ed stb]). If the main screen supports 8-bits, use it. Apple says you shouldn’t force the monitor to a particular depth, but for games it is probably ok. [You can always ask the user whether that’s ok - Ed stb] Use the HasDepth and SetDepth calls to do this and do not call the video drivers directly. If the main screen doesn’t support 8-bit graphics, scan the device list for a device that does. Using the first device you find that supports 8-bit graphics is reasonable, because very few users have 3 monitor systems. If you want to be really cool, though, let the user choose which monitor to play the game on (or play it across several monitors!).

Many games (and other programs a well) use screenBits.bounds to find the size of the monitor. On systems with Color QuickDraw, use the gdRect field of a GDevice instead.

/* 3 */
 The GDHandle for a device that supports the passed depth.
 Returns nil if no device found or no color quickdraw.
 Requires System 6.05 or later.
GDHandle FindDeviceThatSupportsDepth( short theDepth )
 GDHandle aScreen;
 if ( !gHasColorQuickDraw )
 return( nil );

 // first check the main screen - it takes precedence
 aScreen = GetMainDevice();
 if ( DoesDeviceSupportDepth( aScreen, theDepth ) )
 return( aScreen );
 // step through all the screens
 aScreen = GetDeviceList();
 while ( aScreen )
 if ( DoesDeviceSupportDepth( aScreen, theDepth ) )
 return( aScreen );
 aScreen = GetNextDevice( aScreen );

 return( nil );

Boolean DoesDeviceSupportDepth( GDHandle theDevice, short theDepth )
 if (   IsDeviceActive( theDevice ) && 
 HasDepth( theDevice, theDepth, 0/*whichFlags*/, 0 ) )
 return( true );
 return( false );

Boolean IsDeviceActive( GDHandle theDevice )
 if ( !theDevice )
 return( false );

 sometimes newly installed video cards show the main device
 as inactive. we’ll make an extra check for this case.
 if ( theDevice == GetMainDevice() )
 return( true ); // main device is always active
 if (   TestDeviceAttribute( theDevice, screenDevice ) &&
 TestDeviceAttribute( theDevice, screenActive ) )
 return( true );
 return( false );

General drawing

Responding properly to update events on multiple monitor systems is a little tricky. The programs I’ve been using fall under one of the following categories:

1) Work properly on single monitor systems

2) Work properly on multiple monitor systems, as long as windows don’t span 2 screens of different depths

3) Work properly on all systems and window sizes

Your software should fall under category 3, or at least number 2.

Let’s say your program contains 2 versions of all its artwork - one for b&w monitors and one for color monitors (since dithering is so ugly, you don’t want to draw your color pictures on b&w devices). On a single device system, it is easy to choose which picture to display - just look at the main screen’s depth. On a multiple device system, the picture choice must be made by looking at the window’s size and position. If a window spans 2 monitors, you may have to load and draw both the b&w picture and the color picture in response to a single update event.

See develop #13 for an article on the DeviceLoop call and how it will help you handle this problem. For programmers supporting older System versions, it’s not too hard to write your own version of DeviceLoop.

As an example of improper drawing, look at these two screen dumps from America Online. The top one indicates how the b&w artwork should look. The bottom one shows what happens when the color artwork is displayed on a b&w screen.

Screen depth change

Except for games, programs should be able to run at any screen depth. Users can change the depth at will - you should check the monitor depth during update events to see if it has changed. If you keep offscreen buffers, you may have to change their size and depth as well. This can present a problem if the user increases the screen depth and you don’t have enough memory for your offscreen buffers. In that case, consider drawing the window contents without the buffers.

Even games shouldn’t crash if the user changes screen depths. I suggest pausing the game and opening a moveable error dialog explaining the situation.

Minimizing the amount of RAM required for update events is always a good idea. You can spool picture resources instead of loading them completely into RAM. Unfortunately, there’s no simple “DrawSpooledPictureResource” call, so you’ll have to write the spooling code yourself.

“This model’s so fast we had to put speedbumps on the hard drive!”

Use GWorlds and not offscreen CGrafPorts.

In order to draw properly offscreen, you should use either GWorlds or CGrafPort/GDevice combinations. Creating only a CGrafPort is not enough, because QuickDraw will use the current GDevice’s inverse table when drawing to the offscreen buffer. On my machine, the default GDevice is a 1-bit device, so its inverse table is pretty useless (it actually is filled with 0x01). If your graphics appear in a light yellow color on secondary screens, this is likely the cause.

Window PixMaps

Some sample code I recently looked at chose the depth of its offscreen buffers by looking at the portPixMap field within a CWindowRecord. This PixMap always represents the main device, even when a window is on another screen. Color QuickDraw “notices” this when drawing and special cases its drawing calls to work across multiple devices.

To find the desired depth and color table for an offscreen copy of a window’s contents, use a routine like:

/* 4 */
short FindWindowDepth( WindowPtr myWindow )
 Rect   r;
 GDHandle theDevice;
 short  theDepth;

 if ( !gHasColorQuickDraw )
 return( 1 );    // 1-bit if no color quickdraw

 GetPort( &oldPort );// save old port
 SetPort( myWindow );
 // get the window’s content rect in global coords
 r = myWindow->portRect;  
 LocalToGlobal( (Point*) &r );
 LocalToGlobal( 1 + (Point*) &r );

 // find the deepest device intersecting the window
 theDevice = GetMaxDevice( &r );
 theDepth = theDevice ? (**(**theDevice).gdPMap).pixelSize : 1;

 // color table is at: (**(**theDevice).gdPMap).pmTable

 SetPort( oldPort ); // restore port
 return( theDepth );

Hiding the menu bar

Most programs shouldn’t hide the menu bar, but it’s a necessary evil for games, slide shows, and multimedia demos. Be sure to hide the menu bar only if your presentation is running on the main device. Be sure to save/restore the menu bar area on switch events because it will be changed while you are in the background. Many programs incorrectly assume that users won’t be able to “switch out” of their applications because they create windows the same size as the screen. On multi-monitor systems, switching out is as easy as clicking on the desktop on the second monitor. (If you really must prevent switching out, your best bet is to never call GetNextEvent or WaitNextEvent).


If you follow these suggestions, your programs should be multi-monitor friendly. While it may not be trivial to support multiple monitors properly, annoying users is the only alternative. Remember that most PowerMacs have built-in support for 2 monitors, so this issue is more important now than ever.

Besides, this might just be the way to convince your boss to buy you a second screen.


Community Search:
MacTech Search:

Software Updates via MacUpdate

Between 2 Taps - Tap for Tap interview M...
Hello, and welcome back to Between 2 Taps, Tap for Tap’s Indie Dev interview series. [Read more] | Read more »
Facility 47 (Games)
Facility 47 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: You wake up alone and freezing in an icy cell. You try the cell door but it’s locked, it seems that you are stuck with no... | Read more »
The best Photoshop alternative on iPad
Instagram and Lightroom are great and all, but sometimes people need to get extra creative with their image editing.Like, Photoshop creative. If you're one of these people, take a look at our pick for the best mobile Photoshop experience on iPad... | Read more »
The Walking Dead: No Man’s Land guide -...
A new update for The Walking Dead: No Man’s Land was released last week, making it the perfect time for you to head back to your base and take out some walkers. Here’s the lowdown on what’s new to the game, and how to take advantage. [Read more] | Read more »
Goat Rider guide - Tips and tricks to st...
We've all been there. One second, we're riding high on a crazed goat, and the next, we've been tossed off it like someone who's no good at goat ridin'. [Read more] | Read more »
Real Boxing 2 CREED: How to become a gre...
Just in time for Rocky fans who can’t wait to see CREED, the latest movie, we have the official tie-in game,Real Boxing 2 CREED. It builds on the success of its predecessor and there’s lots to take in so we at 148apps thought we’d run you through... | Read more »
CoinOp Heroes 2 guide - How to build an...
CoinOp Heroes 2 justlaunched and, like all clickers, it's dangerously addictive stuff. You have to furiously tap your screen to defeat wave after wave of foes and earn an insane amount of cash to spend on character upgrades and an army of minions... | Read more »
Dr. Panda Firefighters (Education)
Dr. Panda Firefighters 1.0.1 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0.1 (iTunes) Description: FIGHT FIRES AND SAVE THE DAY!Work together with Dr. Panda and his firefighting team to rescue his trapped... | Read more »
Puddle + (Games)
Puddle + 1.0 Device: iOS iPhone Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Puddle is back in a new "+" edition featuring enhanced graphics, new videos and Apple TV support ! No IAP and No Ads. Dive into Puddle... | Read more »
Football Manager Mobile 2016 (Games)
Football Manager Mobile 2016 7.0.0 Device: iOS Universal Category: Games Price: $8.99, Version: 7.0.0 (iTunes) Description: Football Manager Mobile 2016 is designed to be played on the move and is the quickest way to manage your... | Read more »

Price Scanner via

Adorama Black Friday deals: Up to $400 off Ma...
Adorama has released their Black Friday deals for 2015. Save up to $400 on MacBook Pros, $200 on MacBooks and MacBook Airs, and $270 on iMacs. Use code RYBFDEAL during checkout to see these prices.... Read more
B&H Photo Deals: $200 off 12-inch 1.2GHz...
In addition to the B&H Photo Black Friday week sales we posted yesterday, B&H has lowered their price on two products to $200 off MSRP: - 12″ 1.2GHz Gray Retina MacBook: $1399 save $200 - 13... Read more
Best Buy Early Access: Today only, Up to $125...
Best Buy has iPad Air 2s on sale for up to $125 off MSRP and Apple Watch models on sale on their online store for up to $100 off MSRP with special codes through midnight CT tonight. Choose free... Read more
UPPERCASE DESIGNS Premium Ultra Thin Keyboard...
UPPERCASE Designs today announced its new Premium Ultra Thin Keyboard Protector and its Palm Rest Protector Set for the 12-inch MacBook. The accessories provide durable protection for the 12-inch... Read more
Al Jazeera Launches New iOS And Android Mobil...
Doha, Qatar based Al Jazeera has launched new mobile and tablet apps on the iOS and Android systems bringing the latest Al Jazeera news and programmes live together with on-demand personalisation.... Read more
B&H Photo Holiday Sale: Up to $250 off Ma...
B&H Photo has all new Macs on sale for up to $500 off MSRP as part of their Holiday sale including free shipping plus NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off - 15″ 2.... Read more
Free Aura ‘Ultimate’ Mac App For Gmail Update...
Miami, Florida based Crosscoded has announced Aura 1.2.0, an update to the Mac app for Gmail. Aura mixes the power of a native client with the flexibility of the Gmail web app with support for up to... Read more
Apple Will Edge Closer to Samsung in Smartpho...
Total smartphone shipments for 2015 are projected to decline by 9.7% to 1.286 billion units, according to the latest report from global market research firm TrendForce. Though Chinese vendors have... Read more
Sidefari – Split Screen Multitasking In Safar...
Francisco Cantu’s Sidefari is a simple web browser designed to act as a companion to Safari on the iPad. With multitasking in iOS 9, Sidefari uses the new Safari View Controller to show an extra... Read more
12-inch MacBooks in stock for up to $120 off,...
Adorama has 12″ Retina MacBooks in stock for up to $120 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter,... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Merchant Operations Manager: *Apple* Pay -...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more than Read more
*Apple* Pay QA Manager - Apple Inc. (United...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more than Read more
Sr Software Engineer *Apple* Pay - Apple In...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more than Read more
Hardware Systems Architect - *Apple* Watch...
# Hardware Systems Architect - Apple Watch Job Number: 38449977 Santa Clara Valley, Califo ia, United States Posted: Apr. 16, 2015 Weekly Hours: **Job Summary** The Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.