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

CleanMyMac 3.9.0 - $39.95
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac lets you safely and intelligently scan and clean your entire system, delete large, unused files... Read more
Apple High Sierra 10.13 - The latest OS...
macOS High Sierra introduces new core technologies that improve the most important functions of your Mac. From rearchitecting how it stores your data to improving the efficiency of video streaming to... Read more
OmniGraffle Pro 7.4.3 - Create diagrams,...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
OmniGraffle 7.4.3 - Create diagrams, flo...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
VueScan 9.5.86 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
ExpanDrive 6.1.0 - Access cloud storage...
ExpanDrive builds cloud storage in every application, acts just like a USB drive plugged into your Mac. With ExpanDrive, you can securely access any remote file server directly from the Finder or... Read more
Yojimbo 4.1 - Data information organizer...
Yojimbo empowers Mac users to manage, effortlessly and securely, the onslaught of information encountered every day at work and at home, even across multiple computers. Yojimbo stores different data... Read more
Airmail 3.5 - Powerful, minimal email cl...
Airmail is an mail client with fast performance and intuitive interaction. Support for iCloud, MS Exchange, Gmail, Google Apps, IMAP, POP3, Yahoo!, AOL, Outlook.com, Live.com. Airmail was designed... Read more
Cocktail 11.0 - General maintenance and...
Cocktail is a general purpose utility for macOS that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Numi 3.17.2 - Menu-bar calculator suppor...
Numi is a calculator that magically combines calculations with text, and allows you to freely share your computations. Numi combines text editor and calculator Support plain English. For example, '5... Read more

The best visual novels on mobile
Narrative games have been around for ages, but only now have they been creeping into the mainstream spotlight. These games tell some of the industry's finest stories, and they break new ground in terms of gameplay and mechanics regularly. Here are... | Read more »
The best new games we played this week -...
It's pretty much been one big release after another. We were privy to a bunch of surprises this week, with a lot of games we'd been waiting for quite some time dropping unexpectedly. We hope you're free this weekend, because there is a lot for... | Read more »
Stormbound: Kingdom Wars guide - how to...
Stormbound: Kingdom Wars is an excellent new RTS turned card battler out now on iOS and Android. Lovers of strategy will get a lot of enjoyment out of Stormbound's chess-like mechanics, and it's cardbased units are perfect for anyone who loves the... | Read more »
The best AR apps and games on iOS right...
iOS 11 has officially launched, and with it comes Apple's ARKit, a helpful framework that makes it easier than ever for developers to create mobile AR experiences. To celebrate the occassion, we're featuring some of the best AR apps and games on... | Read more »
Phoenix Wright: Ace Attorney - Spirit of...
Phoenix Wright: Ace Attorney - Spirit of Justice 1.00.00 Device: iOS Universal Category: Games Price: $.99, Version: 1.00.00 (iTunes) Description: ************************************************※IMPORTANT※・Please read the “When... | Read more »
Kpressor (Utilities)
Kpressor 1.0.0 Device: iOS Universal Category: Utilities Price: $4.99, Version: 1.0.0 (iTunes) Description: The ultimate ZIP compression application for iPhone and iPad. - Full integration of iOS 11 with support for multitasking.-... | Read more »
Find out how you can save £35 and win a...
Nothing raises excitement like a good competition, and we’re thrilled to announce our latest contest. We’ll be sending one lucky reader and a friend to the Summoners War World Arena Championship at Le Comedia in Paris on October 7th. It’s the... | Read more »
Another Lost Phone: Laura's Story...
Another Lost Phone: Laura's Story 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Another Lost Phone is a game about exploring the social life of a young woman whose phone you have just... | Read more »
The Witness (Games)
The Witness 1.0 Device: iOS Universal Category: Games Price: $9.99, Version: 1.0 (iTunes) Description: You wake up, alone, on a strange island full of puzzles that will challenge and surprise you. You don't remember who you are, and... | Read more »
Egg, Inc. guide - how to build your gold...
Egg, Inc.'s been around for some time now, but don't you believe for one second that this quirky clicker game has gone out of style. The game keeps popping up on Reddit and other community forums thanks to the outlandish gameplay (plus, the... | Read more »

Price Scanner via MacPrices.net

Snag a Certified Refurbished Apple Pencil for...
Apple has Certified Refurbished Apple Pencils available for $85 including free shipping. Their price is $14 off MSRP, and it’s the lowest price available for a Pencil. Read more
12-inch 64GB iPad Pro on sale for $749, save...
Adorama has 12″ 64GB iPad Pros on sale today for $749 including free shipping plus NY & NJ sales tax only. Their price is $50 off MSRP. Read more
Apple Certified Refurbished iPad minis availa...
Apple has Certified Refurbished 128GB iPad minis available today for $339 including free shipping. Apple’s standard one-year warranty is included. Their price is $60 off MSRP. Read more
12-inch 1.2GHz Retina MacBook Pros on sale fo...
B&H Photo has 2017 12″ 1.2GHz Retina MacBooks on sale for $100 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only: 12″ 1.2GHz Space Gray MacBook: $1199 $100 off MSRP 12... Read more
Sunday sale: 13-inch 3.1GHz MacBook Pros for...
Amazon has 2017 13″ 3.1GHz MacBook Pros on sale today for up to $150 off MSRP, each including free shipping: – 13″ 3.1GHz/256GB Space Gray MacBook Pro (MPXV2LL/A): $1649.99 $150 off MSRP – 13″ 3.1GHz... Read more
Looking for a 2017 12″ Retina MacBook? Save $...
Apple has Certified Refurbished 2017 12″ Retina MacBooks available for $200-$240 off the cost of new models. Apple will include a standard one-year warranty with each MacBook, and shipping is free.... Read more
Apple Offering Up To $455 Credit Toward iPhon...
iPhone 8 and 8 Plus are now available at the Apple Store, and you can receive up to $375 credit toward a new iPhone purchase when you trade in your eligible smartphone. Photo Courtesy Apple Just... Read more
AnyTrans Offers iOS Users Three Ways For Movi...
iMobie Inc. today announceed AnyTrans v6.0.1, which now can help iOS users move all data to iPhone 8/8 Plus seamlessly. The software is available both on Mac and Windows and fully able to move all... Read more
Snag a 13-inch 2.3GHz MacBook Pro for $100 of...
B&H Photo has 2017 13″ 2.3GHz MacBook Pros in stock today and on sale for $100 off MSRP, each including free shipping plus NY & NJ sales tax only: – 13-inch 2.3GHz/128GB Space Gray MacBook... Read more
Verizon offers new iPhone 8 for $100-$300 off...
Verizon is offering the new iPhone 8 for up to $300 off MSRP with an eligible trade-in: • $300 off: iPhone 6S/6S Plus/7/7 Plus, Google Pixel XL, LG G6, Moto Z2 Force, Samsung Galaxy S7/S7 edge/S8/S8... Read more

Jobs Board

Data Engineer - *Apple* Media Products - Ap...
Job Summary Apple is seeking a highly skilled data engineer to join the Data Engineering team within Apple Media Products. AMP (home to Apple Music, App Read more
Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 Read more
Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 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
Instructional Designer, *Apple* Product Doc...
Job Summary The Apple Product Documentation team is looking for an instructional designer or a video editor to write user documentation for its professional video Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.