TweetFollow Us on Twitter

Fragment of Your Imaginat
Volume Number:12
Issue Number:7
Column Tag:Book Review

Code Fragments Explained

A shared library of procedure pointers for the resourceful programmer

By Mike Scanlin

A Fragment of Your Imagination:
Code Fragments and Code Resources for Power Macintosh and
Macintosh Programmers

copyright line:By Joe Zobkiw
Addison-Wesley, 1995. ISBN 0-201-48358-0.
500 pages (softback with CD ROM). $39.95.

Have you looked at how big the complete set of Inside Macintosh books is nowadays? My incomplete set is over two feet wide and growing. (I prefer paper to on-line help.) Does the very voluminosity of this documentation, as Frederick Brooks of Mythical Man-Month fame would say, represent some new kind of incomprehensibility? I’m not sure. While I find Inside Macintosh indispensable, I also find it somewhat unwieldy at times. Fortunately, there are other, more readable sources of truth available. A Fragment of Your Imagination is one such source.

This book is a kind of a “Cliff’s Notes” for the Code Fragment Manager. It presents you with discussion and source code for any type of code fragment you might want to write: LDEFs, CDEFs, WDEFs, INITs, XMCDs, cdevs, thngs, plug-ins, etc. As do most programming books, it comes with a CD-ROM bearing all the source code in the book plus a version of CodeWarrior Lite.

There’s little doubt that anyone who wants to write a 68K, PPC or fat code fragment would find it useful to have a piece of working sample code to start with. That’s the primary purpose of this book. It gives you examples of each type of code fragment (LDEF, CDEF, etc.) for each environment (68K, PPC, fat). When you think about it, there’s not much that can be said on the subject of stand-alone code fragments. Once you’ve written one or two you pretty much get it and you’re on your way. But it’s nice to have some hand-holding for that first one, and that’s what this book does.

I like the fact that this book focuses on useful examples. The entire second half of the book is source code listings. The first few chapters cover the basics of the Mixed Mode Manager, Universal Procedure Pointers and Shared Libraries. After that, the author gets right into it by showing you how to write a fat INIT called MenuScript that allows you to replace any menu item in any program with an AppleScript. Each of the next eight chapters covers a different type of code resource, explaining the special cases that come up for each kind of code fragment, along with some example source on how to deal with it.

The examples in the book are reasonable. They are one or two steps above minimum working examples, which is what you want in a code example. If you’re trying to learn how to patch a trap, for instance, you don’t need 1000 lines of unrelated code. You just want the minimum to get the job done, plus a little visual feedback code to make sure it’s being called. The author starts most sections by giving you the bare minimum of code necessary to write a particular type of code fragment. He explains how this bit of glue code makes the code fragment work. Then he adds a bit of unrelated code that does something visual so you’ll know the code is being called and working. It’s a good way to learn what the minimum code for a particular fragment type is.

While I liked the straightforward examples, completeness and screen shots, there are some things I did not like. There are too many cute expressions and attempts at humor. For example: “The termination routine couldn’t be much simpler without breaking a law or two.” I guess the author is trying to make the book friendly or funny, but there are so many of these lines that they come off as a bit childish.

After reading the book I couldn’t help but think that it was physically much larger than it needed to be. The outer margins are over two inches wide, but that space is never used for anything. And the leading (vertical space between lines) in the source code examples is too large. I’d rather see more lines of code on the same page so I don’t have to turn so many pages when studying it. By the same token, the commenting style he uses in the second half of the book really spaces the code out vertically. I’d rather have it more compact. Overall, I couldn’t help but feel that the author was told to write a 500-page book and was only able to produce 300 or so pages.

Despite my nit-picking, I have to say this book does the job it set out to do - inform Macintosh programmers (who have a bit of Mac programming experience already) on how to write many kinds of code fragments. It’s a nice distilled version of the relevant tech notes, DTS examples, and Inside Macintosh. I would definitely recommend it for your first or second code fragment. But if you’ve already done a few of those you probably won’t get much out of this book.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Latest Forum Discussions

See All

How to get started with Prisma
If there's one thing people like to do more than taking pictures with their smartphones, it's tinkering with those photos in some way. Numerous apps have sprung up over the last several years that allow you to use filters and special effects to... | Read more »
6 Pokemon GO updates you can expect, acc...
Pokemon GO had a scheduled appearance at this year's San Diego Comic-Con for a while, but it was only relatively close to the show that it was upgraded to a spot in Hall H. That's the biggest venue at SDCC, one usually reserved for the largest... | Read more »
How to evolve Eevee in Pokemon GO
By now, almost everyone should be hip to how to evolve Pokemon in Pokemon GO (and if not, there's a guide for that). Just gather enough candy of the appropriate type, feed them all to the Pokemon, and evolution happens. It's a miracle that would... | Read more »
CSR Racing 2: Guide to all game modes
It might not seem like there are all that many ways to go fast in a straight line, but CSR Racing 2 begs to differ. [Read more] | Read more »
Bulb Boy (Games)
Bulb Boy 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Multi-award winning 2D point & click horror adventure about a boy with a glowing head. | Read more »
5 top free emoji keyboard apps
If we're not at peak emoji yet as a society, it feels like we definitely should be. The emoji concept has gone far beyond what anyone in Japan could have envisioned when the people there unleashed it on an unsuspecting world, but the West has... | Read more »
How to unlock more characters in Disney...
One of the big charms of Disney Emoji Blitz is seeing a wide variety of beloved Disney and Pixar characters transformed into smiling emojis. Even someone like the sneaky Randall from Monsters Inc., who probably never cracked a smile on film, is... | Read more »
Cubway (Games)
Cubway 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Cubway is a journey with an abstract story of lifecycle of rebirth, called Samsara. Guide the cube through the long way full of dangers... | Read more »
Colorcube (Games)
Colorcube 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Turn pieces and blend colours in this minimal yet visually stunning puzzler.Over 200 handcrafted and challenging levels. Features... | Read more »
Doodle God Griddlers (Games)
Doodle God Griddlers 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »

Price Scanner via MacPrices.net

13-inch 1.6GHz/128GB MacBook Air on sale for...
Amazon has the 13″ 1.6GHz/128GB MacBook Air on sale for $200 off MSRP for a limited time. Shipping is free: - 13″ 1.6GHz/128GB MacBook Air (sku MMGF2LL/A): $799.99 $200 off MSRP Their price is the... Read more
13-inch 1.6GHz/256GB MacBook Air on sale for...
Amazon has the 13″ 1.6GHz/256GB MacBook Air on sale for $200 off MSRP for a limited time. Shipping is free: - 13″ 1.6GHz/256GB MacBook Air (sku MMGG2LL/A): $999.99 $200 off MSRP Their price is the... Read more
Free iOS Business App notably* Helps Service...
PayStudio Inc. has introduced their new business app notably* 1.0, developed for iPhone and iPod touch. notably* was specifically developed to help service and trade professionals go digital and... Read more
27-inch iMacs on sale for $200 off MSRP
Amazon has 27″ iMacs on sale for $200 off MSRP including free shipping: - 27″ 3.3GHz iMac 5K: $2099 $200 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1799.99 $200 off MSRP - 27″ 3.2GHz/1TB HD iMac 5K... Read more
Mac Pros on sale for $200 off MSRP
B&H Photo has Mac Pros on sale for $200 off MSRP. Shipping is free, and B&H charges sales tax in NY only: - 3.7GHz 4-core Mac Pro: $2799, $200 off MSRP - 3.5GHz 6-core Mac Pro: $3799, $200... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more
Apple price trackers, updated continuously
Scan our Apple Price Trackers for the latest information on sales, bundles, and availability on systems from Apple’s authorized internet/catalog resellers. We update the trackers continuously: - 15″... Read more
13-inch 2.5GHz MacBook Pro (Apple refurbished...
Apple has Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros... Read more
21-inch iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ iMacs on sale for up to $120 off MSRP including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1379 $120 off MSRP - 21″ 2.8GHz iMac: $1199.99 $100 off MSRP - 21″ 1... Read more
Charitybuzz Set to Auction Unique Apple-1 Com...
Offering an opportunity to own the computer that sparked a revolution, on Monday, July 25, leading online charity auction platform Charitybuzz will auction what is claimed to be the world’s most... Read more

Jobs Board

*Apple* Retail - Multiple Positions, Willow...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Evangelist - JAMF Software (United S...
The Apple Evangelist is responsible for building and cultivating strategic relationships with Apple 's small and mid-market business development field teams. This Read more
*Apple* Solutions Consultant - APPLE (United...
Job Summary As an Apple Solutions Consultant, you'll be the link between our future customers and our products. You'll showcase your entrepreneurial spirit as you Read more
*Apple* Professional Learning Specialist - A...
Job Summary The Apple Professional Learning Specialist is a full-time position for one year with Apple in the Phoenix, AZ area. This position requires a high Read more
*Apple* Picker - Apple Hill Orchard (United...
Apple Hill Orchard, Co. Rte. 21,Whitehall, NY 9/7/16-10/228/16. Pick fresh market or processing apples Productivity of 60 boxes and 80 boxes processing fruit per Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.