TweetFollow Us on Twitter

Tools Plus
Volume Number:12
Issue Number:7
Column Tag:Programming Tools

Tools Plus 3.0

Paradise for “control” freaks

By Rich Parker

Everyone Wants
to Program the Mac

Almost all Mac owners, at one point or another, harbor a desire to program their own machine. Some may be well served by products like HyperCard, but others just can’t wait to learn C, C++, or Pascal, so that they can write the next “killer” application.

If they start programming by buying books that illustrate programs that use the standard ANSI libraries, they might make quite a bit of progress in learning the language and writing routines that use a “console” interface. At some point, though, the realization sinks in that these aren’t “real” Mac applications, and then the trouble begins. The age-old question that I see over and over again on the online services is: “How do I get started writing ‘real’ Mac programs?”

Most people are directed to read one of Dave Mark’s or Dan Sydow’s fine books on the subject of Mac programming for their favorite language, but these books provide only the basic information needed to write “real” Mac programs. At some point, the (now quite distressed) user is directed to the almighty gospel of Inside Macintosh to further his or her knowledge. This is the point at which most budding programmers wimp out, and I don’t really blame them. I think you will agree that trying to learn to program the Mac by reading Inside Macintosh is like learning to play the piano by studying the details of music composition.

So What’s the Alternative?

I think it’s well known in the developer community that I favor the use of application frameworks. Developing Mac applications using PowerPlant, TCL, or MacApp is something that comes easily to me. But I also recognize the negative aspects of these frameworks, and readily admit that they are not a solution for all people or all applications.

In the first place, most application frameworks demand much more memory than would be required if one had the time to read, understand, and apply all of the appropriate built-in Mac toolbox routines to the problem. But the difficulty of understanding the Mac toolbox is equaled only by the steep learning curve of most of the current application frameworks. So we are left with an almost insoluble problem - whether to spend endless hours reading Inside Macintosh or to spend equally endless hours studying the structure and functionality of an application framework.

Tools Plus to the Rescue!

Steve Makohin, Steven Waters, and the folks at Water’s Edge Software realized that programming the Mac wasn’t easy. After all, they ran into these problems themselves when they first started. So they set out to create a set of high-level functions that would enable others to program the Mac much more easily, without having to worry about handling some of the more difficult aspects of Mac programming. The result was a set of binary libraries that could be included in projects for your favorite development environment, whose routines could be called to implement and manage exceedingly sophisticated Mac user interfaces. (After all, it’s the user interface that is the most complex aspect of any Mac application development.)

The first Tools Plus product was developed as a result of an R&D project in 1989. By 1992, after considerable prodding from various contractors and project managers, Makohin and Waters decided to polish their product to commercial readiness. A year later, Water’s Edge Software was formalized to become the delivery vehicle for Tools Plus, and to support its users.

The product has been continually enhanced, and version 3.0 of the Tools Plus product is even more capable than any previous version. It comes with a wealth of features that promise to make almost any Mac programming project a pleasure, rather than a pain.

What’s It All About?

Tools Plus version 3.0 consists of a set of GUI Building/Event-Managing libraries for Macintosh programmers using any of the following compilers:

• Metrowerks CodeWarrior C/C++ and CodeWarrior Pascal for either 680x0-based or Power Macintosh systems. All versions of CodeWarrior from 6.0 through 8.0 are supported. The Power Mac libraries are native for both C/C++ and Pascal.

• THINK Pascal version 4.0.2 or later for 68K development only.

• THINK C version 5.0.4 or later for 68K development only.

• Symantec C/C++ version 6.0.1 or later for 68K development only. This includes the newly released Symantec version 8.1, which supports 68K development with the Symantec Project Manager; however, in contrast to the CodeWarrior situation, where the PPC-native Tools Plus libraries have been available since mid-1995, native Power Macintosh libraries are not yet available in version 3.0 of Tools Plus for the SPM. [Portions of the Tools Plus source are in Pascal, and until recently there wasn’t SPM PPC-native Pascal support. Water’s Edge feels that the LS Pascal translator needs some maturing before they can release the code it generates. - man]

To use the Tools Plus product, you include the libraries and the ToolsPlus.c file in your Symantec or Metrowerks project (the ToolsPlus.h file is also needed). In the case of Pascal-based projects, the ToolsPlus.p file is added to the project along with the ToolsPlus libraries. Starter project files and all other requisite files (e.g., ToolsPlus.c, ToolsPlus.h, ToolsPlus.p) are provided in the product that you purchase. The products offered by Water’s Edge are as follows:

• Libraries for Symantec compilers (68K only), including THINK C and SPM v8.1 ($149).

• Libraries for the THINK Pascal compiler for 68K development ($149).

• Libraries for both THINK C/SPM and THINK Pascal for 68K development ($199).

• Libraries for Metrowerks CodeWarrior Bronze (68K only), including C, C++, and Pascal ($199).

• Libraries for Metrowerks CodeWarrior Gold (68K and PPC), including C, C++, and Pascal ($249).

• Tools Plus v3.0 Academic for any of the foregoing environments ($99 each).

• Super CDEFs, a collection of special “Control Definition” resources that you can include in your applications for any Macintosh ($89 when purchased alone, $39 for those with an academic discount, or free with the purchase of any non-academic Tools Plus developer kit).

What Features Do the Libraries Provide?

The Tools Plus libraries provide a comprehensive set of user interface elements and event-management features. Every control is created with a single statement in your application. The user interface elements include windows of various types, including all standard window types, floating palettes, movable modal dialogs, buttons, editing fields, raised or sunken 3D panels, and many other features. The best way to show you some of the things you’re likely to use is to display some screen shots of the Demo program that ships with every copy of the Tools Plus product, and is also available on all of the major online services (along with its source code). I built the demo application inside CodeWarrior version 8.0 for the PowerMac. The project file for that build is shown in Figure 1. You can see from the figure that the Demo program’s project file contains several of the standard Metrowerks libraries, as well as the Tools Plus.Lib library. The Demo program is 228K in size and runs in a partition of 384K. It includes examples of many of the features that are available in the Tools Plus product.

Figure 1. CodeWarrior project file for Demo program

The window in Figure 2 describes itself. When you move the cursor into the “Plus” cursor zone, the cursor changes into a plus-sign. When you move the cursor into the “Cross” cursor zone, the cursor changes into a cross. The lists demonstrate the use of different fonts with text in any selected color, and the buttons demonstrate the ability to create both standard and non-standard buttons. The checkboxes in the lower left corner demonstrate the ability to disable the “Two And Three” checkbox while the “Second Choice” checkbox is unchecked.

Figure 2. One of the Demo program’s feature demonstrations

Figure 3. More features from the Demo program

In Figure 3, various types of text field are shown. It also demonstrates the use of “live” scroll bars: instead of displaying a “ghost” outline of the thumb when it is dragged, the thumb of the horizontal scroll bar is redrawn in real time as you drag it. (The thumb of the vertical scroll bar displays the normal appearance of an outline when the thumb is dragged.)

Figure 4 simulates a setup window for a MIDI interface, with the two icon buttons selecting a port and the three radio buttons selecting the interface’s speed. (Despite the window’s name, I didn’t see any “Cursor Zones” in this example; the cursor remained in the shape of an arrow within the window.)

In Figure 5 the watch cursor is animated while the progress indicator (“thermometer”) is advancing.

Figure 4. Icon button example

Figure 5. Pretending to sort

Figure 6. Color-independent drawing

Figure 7. Self-sizing alert

Figure 6 illustrates how the Tools Plus library compensates for the color abilities (or lack thereof) of your Macintosh. When the figure is drawn on a monochrome monitor, the picture and accompanying text are drawn so that they are still entirely readable. I didn’t have two monitors to demonstrate to myself that one-half of the window would be drawn in monochrome and the other in color, but I did change the Monitors control panel settings to verify that the color text and the picture are perfectly readable when using the “Black & White” setting.

The alert shown in Figure 7 illustrates that you can put whatever text you want displayed, including carriage-return characters, and the Tools Plus libraries will create a dialog that’s exactly the right width and height to hold that text. (Carriage-return characters are specified as '\r' in the text string.)

The alert shown in Figure 8 demonstrates that dynamic alerts can contain any icon you choose, including the System’s standard icons. After pressing the Continue button in this alert, you are given the opportunity to see other examples of alerts, even alerts with no associated buttons. Clicking the mouse inside the alert dismisses it.

The Tools Plus libraries include a variety of pop-up menus (Figure 9). These can contain words, icons and words, icons only, what Water’s Edge calls “Pop-Down” menus that are used to specify immediate actions to perform, as well as pop-up menus of any size, using any font.

Figure 8. Self-sizing alert with icon of your choice

Figure 9. Various pop-up menus

Figure 10. A plethora of picture pushers

You might think that you’ve seen it all, but we’re just getting to the good stuff. The Tools Plus libraries also contain a large selection of picture buttons. A number of these are illustrated in Figure 10. (Sorry about the caption for the figure, but I couldn’t resist!) The variety of picture buttons available in the Tools Plus libraries is just amazing. Every one of these is created by a single line of code. The 3D buttons in the lower left are examples of CD-ROM controls. The buttons at the top of the window show some of the features of text-editor and drawing programs. The middle set of buttons in the top panel illustrate various text justification styles.

The “Step” and “Scroll” buttons in the middle of the figure illustrate how the values shown on the buttons can be modified by clicking on either the top or bottom of the button. Clicking on or near the plus-symbol or minus-symbol in one of the buttons causes the numerical value in that button to increment or decrement, respectively; plus, the “Step” button changes value each time it is clicked, whereas the “Scroll” button continues to increase or decrease in value as long as the mouse button is held down.

The button at the far right, in the middle of the window, has an associated value whose minimum, initial, and maximum are specified when the button is created. If the button is clicked near its right edge, then the button’s value is increased. If the button is clicked near its left edge, then the button’s value is decreased. (The display of “0š” below the button is managed separately and, according to the specifications for the “Globe” button, can vary from -179° to +180°.) The button is also specified to have medium acceleration, meaning that the value changes more and more quickly the longer the button is pressed. (An acceleration rate can be specified as slow, medium, or fast.) The “Globe” button is created by a single line of code:

NewPictButton( GlobeButton, 410, 153, GlobeIcon, 
 picbutRepeatEvents + picbutAutoValueChg + 
 picbutScaleMedAccel + picbutValueWrap + 
 picbutLeftRightSplit + picbutSelectAltImage +
 picbutDimUsingWhite, enabled, notSelected, -179, 0, 180);

Figure 11. Large text fields

Most of the style settings here are specified as symbolic names. The button’s ID (GlobeButton) is a unique value that identifies the button whenever it is referenced. The Demo program defines the GlobeButton symbol as the value 16. The icon for the button can be anything you want and is indicated by the GlobeIcon symbol, which is defined to refer to a 'cicn' resource of 460. The 410 and 153 values refer to the left and top positions of the button, and the numeric values in the last three arguments refer to the minimum, initial, and maximum values that the button can contain.

Figure 10 also shows an ON/OFF button whose caption changes whether it is on or off and also a toggle-switch which changes its appearance depending upon whether it is clicked to the left or right. It’s safe to say that the figure illustrates only a few of the multitude of picture button possibilities.

Some applications require text fields that exceed the standard 255 character-width provided by Str255 variables. The Tools Plus libraries provide text fields that are up to 32K characters in width. These are illustrated by Figure 11. You can display panes that contain quite large text fields. The lower pane in the figure illustrates a field that has both vertical and horizontal scroll bars. Each of the text panes has its own font, size, style, color, and justification. The horizontal scroll bar can occupy the entire width of the window, or it can be offset by any multiple of fifteen pixels, from 15 to 225. The offset is from the left edge of the window. There are so many options with each of these elements that it’s impossible to list all of the features here.

Figure 12. Panels and a 3D look

Water’s Edge saved the best window for last in its Demo menu; it shows how 3D panels can be used to spruce up your user interface (Figure 12). I like the raised and inset panels best. This figure shows how button groups and lists with a variety of appearances can be created easily by using the Tools Plus libraries. Once again, each of the elements in the figure was created with a single statement in the Demo program’s source code; this is clear testimony to the power of the libraries.

There are more features shown in the Demo program than are pictured here. Tools Plus provides floating palettes that are oriented either horizontally or vertically, and also tool bars that nestle directly under the menu bar in your application. All in all, it’s an incredibly rich collection of tools.

The product comes with a 392-page printed spiral-bound manual. It’s comprehensive and well written, and includes prototypes (in both C and Pascal) for calling the functions, plus examples and tips. It’s really good. And you also have the source code for the Demo application to compare against the manual’s explanations. Water’s Edge also provides source code tutorial samples illustrating how to create a “Hello World” application, plus buttons and panels, list boxes, editing fields, pop-up menus, picture buttons, tool bars and floating palettes, and so on. Each tutorial project is simple enough that the relevant features are all in one place.

SuperCDEFs Too!

Water’s Edge also offers a set of custom CDEFs (control definition resources) called SuperCDEFs, implementing many of the custom features of the Tools Plus libraries. As stated earlier, this product is available separately or with the purchase of a Tools Plus Development Kit for any of the listed development environments (not with an academic discount). To paraphrase the SuperCDEFs User’s Manual, it consists of a collection of high-quality contemporary controls, designed and implemented by professional Macintosh developers to be as reliable as Apple’s controls, and just as easy to use. The SuperCDEFs offer a range of styles, from subtle improvements over Apple’s own to a bold 3D appearance.

The CDEFs are arranged in categories encompassing buttons, tabs, sliders, and thermometer controls. 68K, native PPC, and fat versions of the controls are offered. The SuperCDEFs product comes with a comprehensive online user’s manual. I didn’t have a chance to test the CDEFs.

OK, They Did it, But Can I?

I think the answer to this question is: Maybe. It all depends on how much effort you are willing to put into learning the Tools Plus library functions.

One thing you’ll have to get used to is that the Tools Plus libraries provide a higher-level event loop called PollSystem that returns the current event in a special Poll structure. This lets the loop identify directly the element for which the event is destined, rather than requiring you to deal with mouse coordinates, “control parts,” or the like. The Tools Plus manual provides only one example of the main event loop, but it is in Pascal, rather than in both C and Pascal. Water’s Edge didn’t also provide a single library function to initialize the various toolbox managers, so you will have to start your application with the usual toolbox initialization calls. You also have to initialize the Tools Plus components with a call to InitToolsPlus. None of this is hard.

More important, there is no graphical interface for designing the interface. You have to design on graph paper, estimating coordinate values for the various elements - because, instead of using resources to describe the various controls, Water’s Edge requires that you include coordinates and sizes inside the function calls. This also has implications for “tweaking” the interface as the program design progresses - this involves modifying the code and not just the parameters of a resource.

The folks at Water’s Edge are aware of all this, and are currently working on a project code-named “Anthem” that will offer a MacDraw-like user interface design capability, and then generate source code targeted directly at the Tools Plus library function call interfaces. If this sounds like another AppMaker or Visual Architect tool to you, Water’s Edge is quick to point out that their objective is to reduce the complexity and volume of source code in a project, and this includes source code in a class library or code generated by an application builder. We’ll have to wait until the end of 1996 to see what Water’s Edge has in store for us in this regard.

In the meantime, if you are interested in developing applications that have “quality” written all over them, then Tools Plus is for you. It will take some time to get used to writing functions rather than using resources, but the result will be worth the effort. I tested both the CodeWarrior and Symantec versions of the product and found each of them to work perfectly. If I wasn’t hard at work on another book project at this time, I’d be very tempted to write a program using the Tools Plus product.

Water’s Edge Software, 2441 Lakeshore Road West, Box 70022, Oakville, Ontario, Canada, L6L 6M9.

Phone: 1-416-219-5628 Fax: 1-905-847-1638

WaterEdg@interlog.com

http://www.interlog.com/~wateredg

 
AAPL
$100.96
Apple Inc.
-0.83
MSFT
$47.52
Microsoft Corpora
+0.84
GOOG
$596.08
Google Inc.
+6.81

MacTech Search:
Community Search:

Software Updates via MacUpdate

Chromium 37.0.2062.122 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. FreeSMUG-Free OpenSource Mac User Group build is... Read more
Attachment Tamer 3.1.14b9 - Take control...
Attachment Tamer gives you control over attachment handling in Apple Mail. It fixes the most annoying Apple Mail flaws, ensures compatibility with other email software, and allows you to set up how... Read more
Duplicate Annihilator 5.0 - Find and del...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator detects... Read more
jAlbum Pro 12.2 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more
jAlbum 12.2 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results Simply drag and drop photos into groups, choose a design... Read more
Quicken 2015 2.0.4 - Complete personal f...
Quicken 2015 helps you manage all your personal finances in one place, so you can see where you're spending and where you can save. Quicken automatically categorizes your financial transactions,... Read more
iMazing 1.0 - Complete iOS device manage...
iMazing (formerly DiskAid) is the ultimate iOS device manager with capabilities far beyond what iTunes offers. With iMazing and your iOS device (iPhone, iPad, or iPod), you can: Copy music to and... Read more
Xcode 6.0.1 - Integrated development env...
Apple Xcode is Apple Computer's integrated development environment (IDE) for OS X. The full Xcode package is free to ADC members and includes all the tools you need to create, debug, and optimize... Read more
Apple Safari 7.1 - Apple's Web brow...
Apple Safari in OS X Mavericks brings you all-new ways to find and enjoy the best of the web. It works with iCloud to give you a seamless browsing experience across all your devices. It looks out for... Read more
Delivery Status 6.1.2 - Check delivery s...
Delivery Status displays delivery status of packages for a variety of shipment services. Can't wait for your packages to arrive? Don't waste your time checking the site constantly, just open this all... Read more

Latest Forum Discussions

See All

View Source – HTML, JavaScript and CSS...
View Source – HTML, JavaScript and CSS 1.0 Device: iOS Universal Category: Utilities Price: $.99, Version: 1.0 (iTunes) Description: View Source is an app plus an iOS 8 Safari extension that makes it easy to do one key web developer... | Read more »
Avenged Sevenfold’s Hail To The King: De...
Avenged Sevenfold’s Hail To The King: Deathbat is Coming to iOS on October 16th Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Just in time for Halloween, on October 16 Avenged Sevenfold will be launching | Read more »
Talisman Has Gone Universal – Can Now be...
Talisman Has Gone Universal – Can Now be Played on the iPhone Posted by Jessica Fisher on September 19th, 2014 [ permalink ] | Read more »
Tap Army Review
Tap Army Review By Jennifer Allen on September 19th, 2014 Our Rating: :: SHOOT EM ALLUniversal App - Designed for iPhone and iPad Mindless but fun, Tap Army is a lane-based shooter that should help you relieve some stress.   | Read more »
Monsters! Volcanoes! Loot! Epic Island f...
Monsters! Volcanoes! Loot! | Read more »
Plunder Pirates: Tips, Tricks, Strategie...
Ahoy There, Seadogs: Interested in knowing our thoughts on all this plundering and pirating? Check out our Plunder Pirates Review! Have you just downloaded the rather enjoyable pirate-em-up Plunder Pirates and are in need of some assistance? Never... | Read more »
Goat Simulator Review
Goat Simulator Review By Lee Hamlet on September 19th, 2014 Our Rating: :: THE GRUFFEST OF BILLY GOATSUniversal App - Designed for iPhone and iPad Unleash chaos as a grumpy goat in this humorous but short-lived casual game.   | Read more »
A New and Improved Wunderlist is Here fo...
A New and Improved Wunderlist is Here for iOS 8 Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Evernote Update for iOS 8 Adds Web Clipp...
Evernote Update for iOS 8 Adds Web Clipping, Quick Notes, and More Posted by Ellis Spice on September 19th, 2014 [ permalink ] | Read more »
Apple Names Ultimate Productivity Bundl...
Apple Names Ultimate Productivity Bundle by Readdle as the Essential Bundle on the App Store Posted by Jessica Fisher on September 19th, 2014 [ permalink | Read more »

Price Scanner via MacPrices.net

Mac Pros available for up to $260 off MSRP
Adorama has Mac Pros on sale for up to $260 off MSRP. Shipping is free, and Adorama charges sales tax in NY & NJ only: - 4-core Mac Pro: $2839.99, $160 off MSRP - 6-core Mac Pro: $3739.99, $260... Read more
13-inch 2.6GHz/256GB Retina MacBook Pros avai...
B&H Photo has the 13″ 2.6GHz/256GB Retina MacBook Pro on sale for $1379 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Read more
Previous-generation 15-inch 2.0GHz Retina Mac...
B&H Photo has leftover previous-generation 15″ 2.0GHz Retina MacBook Pros now available for $1599 including free shipping plus NY sales tax only. Their price is $400 off original MSRP. B&H... Read more
21″ 2.7GHz iMac available for $1179, save $12...
Adorama has 21″ 2.7GHz Hawell iMacs on sale for $1179.99 including free shipping. Their price is $120 off MSRP. NY and NJ sales tax only. Read more
iOS 8 Adoption Rate Slower than iOS 7, 6, Hit...
Apple began pushing out iOS 8 updates to eligible devices around 1pm ET on September 17, 2014. However, unlike with iOS 7, which boasted a wide variety of differences from its predecessor iOS 6, in... Read more
LIkely Final Definitive OS X 10.9.5 Mavericks...
Apple has released what will almost certainly be the last incremental version number update of OS X 10.9 Mavericks (save for futire security updates) before OS X 10.10 Yosemite is released next month... Read more
Fingerprints, Apple Pay and Identity Theft Wa...
On Sep 9th, CEO Tim Cook unveiled Apple Pay, along with the new iPhone 6 and iWatch. Apple Pay is a newly developed technology that utilizes a near field communication (NFC) to enable customer... Read more
Amazon Introduces Two All-New Kindles
Amazon on Thursday introduced the 7th generation of its Kindle dedicated e-reader device: Kindle Voyage, its top-of-the-line e-reader, and the new $79 Kindle, with a 20% faster processor, twice the... Read more
Save up to $300 on the price of a new Mac wit...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
13-inch 2.8GHz Retina MacBook Pro available f...
B&H Photo has the new 2014 13″ 2.8GHz Retina MacBook Pro on sale for $1699.99 including free shipping plus NY sales tax only. They’ll also include free copies of Parallels Desktop and LoJack for... Read more

Jobs Board

Project Manager, *Apple* Financial Services...
**Job Summary** Apple Financial Services (AFS) offers consumers, businesses and educational institutions ways to finance Apple purchases. We work with national and Read more
*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
*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
*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
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.