TweetFollow Us on Twitter

Apr 97 Dialog Box

Volume Number: 13 (1997)
Issue Number: 4
Column Tag: Dialog Box

Dialog Box

Bolo is a PBRead Completion Routine

Dear Editor,

I was pleased to see the article in MacTech December 1996 encouraging programmers to use asynchronous I/O, but unfortunately some of the details in the article were not correct. Richard Clark wrote "The completion routine for PBRead is especially poor, as it receives no parameters... This routine appears to have A5 set up for it..."

Firstly, the PBRead completion routine does get passed a parameter (a pointer to the parameter block that has just completed) and secondly, A5 is not guaranteed to be set up to point at your globals. A5 will be pointing to the globals of whichever application was interrupted to execute the completion routine (which might even be your own application, which is why A5 may sometimes appear to be set up correctly). If your completion routine tries to access your program's globals without first making sure to set up A5 correctly, the Mac will crash.

Fortunately, there's no problem as long as you know how to deal with it: Because the PBRead completion routine gets passed a pointer to the parameter block, you can use this to pass it as many extra parameters as you like.

1. Define a new "extended" PBRead parameter block like this

typedef struct
{
ioParam io;
void *regA5;
short my_parameter;
// ... and, so on, as many as you like
} ex_ioParam;

2. Before you call PBRead, fill in the parameters that you want the completion routine to get (especially the Register A5 value).

static ex_ioParam pb; pb.io.ioCompletion = CompletionRoutine;
pb.io.ioRefNum   = refnum;
// ... and so on
pb.regA5 = GetGlobalsRegister();
PBRead((ParmBlkPtr)&pb,TRUE);

3. In the completion routine, set up the correct A5 value and access other parameters as necessary:

static void CompletionRoutine(void)
{
register ex_ioParam *pb = GetRegisterA0(); register void* oldGlobalsReg 
= SetGlobalsRegister(pb->regA5);
// ... Do your stuff
SetGlobalsRegister(oldGlobalsReg);
}

If you don't already have the 68K register accessor functions defined, they are:

#pragma parameter __D0 GetRegisterD0() // MOVEA.L D0,D0 local void* GetRegisterD0(void) 
= { 0x2000 };

#pragma parameter __A0 GetRegisterA4() // MOVEA.L A4,A0 local void* GetRegisterA4(void) 
= { 0x204C };
#pragma parameter __A0 GetRegisterA5() // MOVEA.L A5,A0 local void* GetRegisterA5(void) 
= { 0x204D };
#pragma parameter __A0 SetRegisterA4(__A0)   // EXG A0,A4 local 
void* SetRegisterA4(void*) = { 0xC14C };
#pragma parameter __A0 SetRegisterA5(__A0)   // EXG A0,A5 local 
void* SetRegisterA5(void*) = { 0xC14D };
#ifdef THINK_C
#if __option(a4_globals)
#define A4GLOBALS
#endif
#endif

#ifdef __MWERKS__
#if !__A5__
#define A4GLOBALS
#endif
#endif

#ifdef A4GLOBALS
#define GetGlobalsRegister GetRegisterA4
#define SetGlobalsRegister SetRegisterA4
#else
#define GetGlobalsRegister GetRegisterA5
#define SetGlobalsRegister SetRegisterA5
#endif

You can do a hell of a lot with completion routines, as long as you don't try to call QuickDraw, the Memory Manager, or make synchronous calls. The entire game of Bolo is basically one huge completion routine, which is why you can switch to Microsoft Word, pull down a menu, and sit there holding the mouse button down, without affecting the game of Bolo at all. That's why I've never really understood all the people who continuously complain that the Mac needs preemptive multi-tasking. Sure, preemptive multi-tasking makes the programming easier, but it doesn't fundamentally change what you can do. In fact it makes some things worse - with asynchronous I/O your completion routine gets called immediately when the operation is complete, where as with preemptive multi-tasking you're at the mercy of some scheduler that decides when your code next deserves to get a slice of CPU time.

Stuart Cheshire, cheshire@cs.stanford.edu

The Guiding Light

Not sure if I'm the first to point this out to you, but... I'm just looking at the "MacTech Now" ad on page 77 of the February issue. I see shadows behind the logo text at the top. And... The shadows don't match up! The ones behind the letters of the word "MacTech" indicate a light source above and to the left, but the ones behind the word "Now!" indicates a light source that's above and to the right!

Lawrence D'Oliveiro

Actually, Lawrence, the MacTechNOW logo was developed using an as yet unreleased QuickDraw3D derivative technology called QuickDrawMPV. This technology allows the simultaneous use of multiple points of view, resulting in shadows going in more than one direction. We chose to use QuickDrawMPV because it best represents how the MacTechNOW site provides information from more than one source.

We hope to offer more information about QuickDrawMPV in a future issue, assuming Apple doesn't see this technology as the joke it really is and refuse to acknowledge its existance.

Thanks for your note; I really wanted something like this for April, and you provided it. :-)

Eric Gundrum, Editor-in-Chief

More Beginning Articles, Please

Dear Editor,

I wanted to take a moment to respond to the Viewpoint article by Eric Gundrum in the December ‘96 issue.

I'm a subscriber that appreciates seeing articles targeted toward the beginning programmer. I can recall two recent articles that were of this category: Peter N. Lewis on memory issues and Mark Aldritt (I think) on tips for making AppleScripts run faster. It would be nice if each issue had one article targeted to beginners (a regular column?). My guess is that there is room for it, but most writers are less interested in the beginners audience. I don't know how many people (non-participants) read the programmer's challenge, but it seems to be one of the best opportunities for experienced programmers to learn new tricks and approaches. It's good that this department will be enhanced in future articles.

Mr. Gundrum also noted that more code examples would be given. Please stress that your authors should heavily comment their code. Also, wouldn't it be possible to archive the more detailed code on your website? That way you don't have to fill up your magazine pages with code, and the readers could retrieve it in digital form to avoid re-typing it. You could print a URL for that month's issue.

The vast majority of the magazine is over my head, but that's my own problem. I currently only have time to dabble - I'm working on trying to change that. The subscription is worth it to me just to stay abreast of what's happening.

Here are some suggestions for beginner's topics:

1) An article that addresses the upcoming changes to the MacOS and how a true beginner should prepare. (Admittedly, Apple is making it harder for you to anticipate the new OS.) I have purchased several beginners books that cover the current OS. However, I occasionally read about how the Event loop paradigm will change in MacOS 8. Then there's the scrapping of CDEVs and INITs. I worry that I'm learning things that will no longer be in use after another year or two. Are things going to change so much that it would be better to just wait, especially if the BeOS is adopted?

2) Surprisingly, I have not encountered a review of the binary foundation of programming in the Mac programming books. My ideal review would cover all the "lowest level" representations and their manipulation, such as octal, hexadecimal, setting bits, bit-wise shifts, etc. For example, while it's quite obvious to me why computers speak binary, I don't know what the value of hexadecimal is. I'm sure that seems like a very ignorant question to an experienced programmer. It may be typical from someone who was not a math or computer science major in college.

3) An article that addresses approaches to information storage (struct design): what are the best ways to store numbers, text, pictures, etc. Sample databases seem to be the best vehicle for illustrating these points. What should one think about in the design stage to ensure later speed and flexibility?

4) An article that focuses on GUI design: when I use Mac programs I often wonder how the programmers implement certain design features. Usually this entails linking underlying data to some element of the GUI - dragging list selections from a "source" to a "target", double-clicking a certain region to invoke an action. Another good example: in a full-featured word processing program that permits styling and coloring of text, how are these attributes stored when TextEdit is not being used? How does one calculate the physical dimensions of text data, ie. how do you implement a print preview function that gives a "to scale" WYSIWIG representation of the data? I realize that these are pretty advanced issues.

5) Manipulation of strings: sorting, searching, pattern matching, connection to the GUI (ie. double-clicking selects a word).

I'm sure I'll think of a few more...

Michael Myers

Michael, your point is well taken. The MacTech readership is a very diverse group, including nearly equal numbers of readers at all levels of programming expertise. I agree that every issue should include at least one more article for beginning programmers, and I am working with authors to get those articles written.

The complete project files for all of our articles are posted to the MacTech ftp site, available through MacTechNOW, when the issue ships. When asking an author to include code for an article, I ask that only enough of the code be included so the article can be read without your having to print pages of code from the ftp site. This leaves more space for explanations of the relevant points.

The articles you suggest are an excellent starting point. Keep those suggestions coming.

Eric Gundrum, Editor-in-Chief

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

OS X Server 4.1.3 - For OS X 10.10 Yosem...
Designed for OS X and iOS devices, OS X Server makes it easy to share files, schedule meetings, synchronize contacts, develop software, host your own website, publish wikis, configure Mac, iPhone,... Read more
pwSafe 4.1 - Secure password management...
pwSafe provides simple and secure password management across devices and computers. pwSafe uses iCloud to keep your password databases backed-up and synced between Macs and iOS devices. It is... Read more
Kodi 15.0.rc1 - Powerful media center to...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
Coda 2.5.11 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more
Bookends 12.5.7 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Maya 2016 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more
RapidWeaver 6.2.3 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
MacFamilyTree 7.5.2 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Paragraphs 1.0.1 - Writing tool just for...
Paragraphs is an app just for writers. It was built for one thing and one thing only: writing. It gives you everything you need to create brilliant prose and does away with the rest. Everything in... Read more
BlueStacks App Player 0.9.21 - Run Andro...
BlueStacks App Player lets you run your Android apps fast and fullscreen on your Mac. Version 0.9.21: Note: Now requires OS X 10.8 or later running on a 64-bit Intel processor. Initial stable... Read more

Rage of Bahamut is Giving Almost All of...
The App Store isn't what it used to be back in 2012, so it's not unexpected to see some games changing their structures with the times. Now we can add Rage of Bahamut to that list with the recent announcement that the game is severely cutting back... | Read more »
Adventures of Pip (Games)
Adventures of Pip 1.0 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: ** ONE WEEK ONLY — 66% OFF! *** “Adventures of Pip is a delightful little platformer full of charm, challenge and impeccable... | Read more »
Divide By Sheep - Tips, Tricks, and Stre...
Who would have thought splitting up sheep could be so involved? Anyone who’s played Divide by Sheep, that’s who! While we’re not about to give you complete solutions to everything (because that’s just cheating), we will happily give you some... | Read more »
NaturalMotion and Zynga Have Started Tea...
An official sequel to 2012's CSR Racing is officially on the way, with Zynga and NaturalMotion releasing a short teaser trailer to get everyone excited. Well, as excited as one can get from a trailer with no gameplay footage, anyway. [Read more] | Read more »
Grab a Friend and Pick up Overkill 3, Be...
Overkill 3 is a pretty enjoyable third-person shooter that was sort of begging for some online multiplayer. Fortunately the begging can stop, because its newest update has added an online co-op mode. [Read more] | Read more »
Scanner Pro's Newest Update Adds Au...
Scanner Pro is one of the most popular document scanning apps on iOS, thanks in no small part to its near-constant updates, I'm sure. Now we're up to update number six, and it adds some pretty handy new features. [Read more] | Read more »
Heroki (Games)
Heroki 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: CLEAR THE SKIES FOR A NEW HERO!The peaceful sky village of Levantia is in danger! The dastardly Dr. N. Forchin and his accomplice,... | Read more »
Wars of the Roses (Games)
Wars of the Roses 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »
TapMon Battle (Games)
TapMon Battle 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: It's time to battle!Tap! Tap! Tap! Try tap a egg to hatch a Tapmon!Do a battle with another tapmons using your hatched tapmons! *... | Read more »
Alchemic Dungeons (Games)
Alchemic Dungeons 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: ### Release Event! ### 2.99$->0.99$ for limited time! ### Roguelike Role Playing Game! ### Alchemic Dungeons is roguelike... | Read more »

Price Scanner via MacPrices.net

Seagate Backup Plus Drives Feature 200GB of C...
Seagate Technology plc has announced that its Backup Plus family of external storage offerings will now include 200GB of OneDrive cloud storage, a major added value, and the addition of Lyve’s photo... Read more
Canon PIXMA MG3620 Wireless Inkjet All-in-One...
Canon U.S.A., Inc. has announced the PIXMA MG3620 Wireless (1) Inkjet All-in-One (AIO) printer for high-quality photo and document printing. Built with convenience in mind for the everyday home user... Read more
July 4th Holiday Weekend 13-inch MacBook Pro...
Save up to $150 on the purchase of a new 2015 13″ Retina MacBook Pro at the following resellers this weekend. Shipping is free with each model: 2.7GHz/128GB MSRP $1299 2.7GHz/... Read more
27-inch 3.5GHz 5K iMac on sale for $2149, sav...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2149.99. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary. Their price is $... Read more
Apple now offering refurbished 2015 11-inch...
The Apple Store is now offering Apple Certified Refurbished 2015 11″ MacBook Airs as well as 13″ MacBook Airs (the latest models), available for up to $180 off the cost of new models. An Apple one-... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
Amazon.com has the 15″ 2.5GHz Retina MacBook Pro on sale for $2274 including free shipping. Their price is $225 off MSRP, and it’s the lowest price available for this model. Read more
Finally Safe To Upgrade To Yosemite’?
The reason I’ve held back from upgrading my MacBook Air from OS X 10.9 Mavericks to 10.10 Yosemite for nearly a year isn’t just procrastination. Among other bugs reported, there have been persistent... Read more
Logo Pop Free Vector Logo Design App For OS X...
128bit Technologies has released of Logo Pop Free 1.2 for Mac OS X, a vector based, full-fledged, logo design app available exclusively on the Mac App Store for the agreeable price of absolutely free... Read more
21-inch 1.4GHz iMac on sale for $999, save $1...
B&H Photo has new 21″ 1.4GHz iMac on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Best Buy has the 21″ 1.4GHz iMac on sale for $999.99 on their... Read more
16GB iPad mini 3 on sale for $339, save $60
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $339 including free shipping plus NY tax only. Their price is $60 off MSRP. Read more

Jobs Board

Frameworks Engineer, *Apple* Watch - Apple...
**Job Summary** Join the team that is shaping the future of software development for Apple Watch! As a software engineer on the Apple Watch Frameworks team you will Read more
Mobile Payments Counsel, *Apple* Pay (digit...
**Job Summary** Apple is looking for an atto ey to join Apple 's Legal Department to support Apple Pay. **Key Qualifications** 4+ years of relevant experience Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** The ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store which delivers Read more
Partner Marketing Manager, Merchant- *Apple*...
**Job Summary** The Apple Pay partner marketing team is looking for a marketing manager to develop and drive US marketing programs with our merchant partners. The right Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.