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
Quickdraw

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 Shapiro@aol.com

[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.

Dragging

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;
 else
 limitR = screenBits.bounds;

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

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

Zooming

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 */
/*
 IsPositionOK
 
 Description:
 Checks to make sure the passed global rectangle is completely contained 
within the gray region. Pass the window’s portRect in global coordinates.

 Notes:
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 )
 fullWindowR.top -= 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

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 */
/*
 FindDeviceThatSupportsDepth
 
 Returns:
 The GDHandle for a device that supports the passed depth.
 Returns nil if no device found or no color quickdraw.
 
 Notes:
 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 );
 else 
 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 );
 else
 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;
 GrafPtroldPort;

 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).

Summary

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

SoftRAID 5.6.5 - High-quality RAID manag...
SoftRAID allows you to create and manage disk arrays to increase performance and reliability. SoftRAID allows the user to create and manage RAID 4 and 5 volumes, RAID 1+0, and RAID 1 (Mirror) and... Read more
Garmin Express 6.1.2.0 - Manage your Gar...
Garmin Express is your essential tool for managing your Garmin devices. Update maps, golf courses and device software. You can even register your device. Update maps Update software Register your... Read more
Airfoil 5.7.0 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
EtreCheck 4.0.4 - For troubleshooting yo...
EtreCheck is an app that displays the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support Communities to... Read more
WhatsApp 0.2.8361 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
iClock 4.2 - Customize your menubar cloc...
iClock is a menu-bar replacement for Apple's default clock but with 100x features. Have your Apple or Google calendar in the menubar. Have the day, date, and time in different fonts and colors in the... Read more
Things 3.4 - Elegant personal task manag...
Things is a task management solution that helps to organize your tasks in an elegant and intuitive way. Things combines powerful features with simplicity through the use of tags and its intelligent... Read more
Dashlane 5.7.0 - Password manager and se...
Dashlane is an award-winning service that revolutionizes the online experience by replacing the drudgery of everyday transactional processes with convenient, automated simplicity - in other words,... Read more
HoudahSpot 4.3.5 - Advanced file-search...
HoudahSpot is a versatile desktop search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the... Read more
Parallels Desktop 13.3.0 - Run Windows a...
Parallels allows you to run Windows and Mac applications side by side. Choose your view to make Windows invisible while still using its applications, or keep the familiar Windows background and... Read more

Latest Forum Discussions

See All

Here's everything you need to know...
Alto's Odyssey is a really, really good game. If you don't believe me, you should definitely check out our review by clicking this link right here. It takes the ideas from the original Alto's Adventure, then subtly builds on them, creating... | Read more »
Alto's Odyssey (Games)
Alto's Odyssey 1.0.1 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.1 (iTunes) Description: Just beyond the horizon sits a majestic desert, vast and unexplored. Join Alto and his friends and set off on an endless... | Read more »
Vainglory 5v5: Everything you need to kn...
Vainglory just got bigger. [Read more] | Read more »
Check out these 5 games that are a lot l...
So you're in love with Minecraft, but you're looking for something else to play as well? You've come to the right place then, because this list is all about games that are a bit like Minecraft. Some of them, more than others. [Read more] | Read more »
Our top 5 characters from casual RPG Cre...
Creature Quest definitely lives up to its name with a host of collectible creatures based on fantasy tales and world mythologies. To celebrate Creature Quest’s first birthday, we’re going to lay out what we think are the five best characters in the... | Read more »
Around the Empire: What have you missed...
Did you know that Steel Media has a whole swathe of other sites dedicated to all aspects of mobile gaming? Sure you'll get the very best iPhone news, reviews, and opinions right here at 148Apps, but we don't want you missing out on a single piece... | Read more »
All the best games on sale for iPhone an...
Oh hi there, and welcome to our round-up of the best games that are currently on sale for iPhone and iPad. You thought I didn't see you there, did you, skulking behind the bushes? Trust me though, the bushes aren't where the best deals are. The... | Read more »
The Battle of Polytopia Guide - How to H...
A new update just released for The Battle of Polytopia (formerly Super Tribes), which introduces online multiplayer. For all the fans of Midjiwan’s lite take on Civilization, this is certainly welcome news, but playing online isn’t as easy and... | Read more »
Here are the very best mobile games to p...
It's Valentine's Day! Did you get loads of cards and chocolates and other tacky, simple expressions of human affection? Did you send out tat because you find it almost impossible to express emotion unless there's a section dedicated to it at your... | Read more »
Florence (Games)
Florence 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Florence is an interactive storybook from the award-winning lead designer of Monument Valley about the heart-racing highs and... | Read more »

Price Scanner via MacPrices.net

Lowest price of the year: 15″ 2.8GHz Apple Ma...
Amazon has the 2017 Space Gray 15″ 2.8GHz MacBook Pro on sale today for $251 off MSRP. Shipping is free: – 15″ 2.8GHz Touch Bar MacBook Pro Space Gray (MPTR2LL/A): $2148, $251 off MSRP Their price is... Read more
Apple restocks full line of Certified Refurbi...
Apple has restocked a full line of Apple Certified Refurbished 2017 13″ MacBook Pros for $200-$300 off MSRP. A standard Apple one-year warranty is included with each MacBook, and shipping is free.... Read more
Lowest sale price available for 13″ 1.8GHz Ma...
Focus Camera has the 2017 13″ 1.8GHz/128GB Apple MacBook Air on sale today for $829 including free shipping. Their price is $170 off MSRP, and it’s the lowest price available for a current 13″... Read more
21-inch 2.3GHz iMac on sale for $999, $100 of...
B&H Photo has the 2017 21″ 2.3GHz iMac (MMQA2LL/A) in stock and on sale for $999 including free shipping plus NY & NJ tax only. Their price is $100 off MSRP. Read more
Apple refurbished Mac minis in stock again st...
Apple has restocked Certified Refurbished Mac minis starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: – 1.4GHz Mac mini: $419 $80 off MSRP – 2.6GHz Mac... Read more
Tuesday MacBook Deals: $250 off 15″ 2.9GHz Ma...
Adorama has the Silver 15″ 2.9GHz Apple MacBook Pro on sale today for $250 off MSRP. Shipping is free, and Adorama charges sales tax for residents in NY & NJ only: – 15″ 2.9GHz Silver MacBook Pro... Read more
Save up to $350 with these Apple Certified Re...
Apple has a full line of Certified Refurbished iMacs available for up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: – 27... Read more
B&H offers $200 discount on Silver 15″ Ma...
B&H Photo has Silver 15″ Apple MacBook Pros on sale for $200 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 15″ 2.8GHz Touch Bar MacBook Pro Silver (... Read more
12″ Apple iPad Pro Sale of the Year! Models u...
B&H Photo has 12″ #iPad Pros on sale for up to $150 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only: – 12″ 64GB WiFi iPad Pro: $719 $80 off MSRP – 12″ 256GB WiFi... Read more
Deals on 32GB 9″ iPads: Up to $50 off MSRP, s...
B&H Photo has 2017 9.7″ 32GB iPads on sale for $299 including free shipping plus NY & NJ sales tax only. Their price is $30 off MSRP, and it’s currently the lowest price available for these... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Sr. Experience Designer, Today at *Apple* -...
# Sr. Experience Designer, Today at Apple Job Number: 56495251 Santa Clara Valley, California, United States Posted: 18-Jan-2018 Weekly Hours: 40.00 **Job Summary** Read more
*Apple* Technical Specialist - Apple, Inc. (...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Strategist, *Apple* Media Products, Content...
# Strategist, Apple Media Products, Content and Marketing Job Number: 113399632 Santa Clara Valley, California, United States Posted: 20-Feb-2018 Weekly Hours: 40.00 Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.