TweetFollow Us on Twitter

DeeMaker
Volume Number:8
Issue Number:2
Column Tag:Tools of the Trade

Related Info: Dialog Manager Window Manager

DeeMaker for DeeManager

A new refreshing way to create human interfaces

By Dave Kelly, MacTutor Regular Contributing Author Don Bresee, MacTutor Technical Editor

If you’re tired of dealing with the Dialog Manager and wish that it would do more than it does, Dees are the answer. With Dees, you get all the functionality of the Dialog Manager and much more. DeeMaker for DeeManager version 1.0.4 enhances the standard Macintosh user interface without sacrificing the standard. [As of print time, n Dimensions is now shipping DeeMaker Version 1.1. - Ed.]

DeeMaker is a unique dialog creation tool designed to quickly develop robust, professional fixed layout windows. The three fixed layout constructs of the human interface are: modal, modeless and floating windows (windoids). DeeMaker has taken a big step forward in providing you with a MacDraw-like interface and the power of the best draw applications. Each data type has been crafted carefully so that runtime calls are minimized as you specify your intention with this high level tool. What’s really neat is that you’ve got a transparent way to substantially modify your human interface, without affecting your code and its recompilation.

DeeManager is designed from scratch to work with an object-driven model. Each item is an instance of an object. As objects, all items share several important attributes. One of these attributes is the item method interface.

Each Dee item is completely customizable because DeeManager has a full-range messaging system. With DeeMaker you specify the messages that your method wants to receive and install (or engage) the method by calling the DeeManager function EngageMethod(ProcPtr theMethod; id: Integer). All methods are of the form: MyMethod(Var DeeMessages: msg). This allows creation of just about any human interface effect you could want.

The on_Action message is especially important because it allows you to create modeless windows whose entire action code resides in a separate method. You would never need to fix your main event loop. This and other design factors of DeeManager will let you create very clean and maintainable programs.

Each item has an optional member list. The simplest member list is a string list, such as a STR# resource. Suppose you had a check box that could have one of three titles. You would just assign three members and change the items current member to change the title. The member list is part of the item object itself and thus all the data that could ever appear on the screen will reside in one place. You may have buttons, static text items, or windows with several titles.

Member list elements are objects too, by default they contain a string, but could have other data. This is how DeeManager implements the Alert mechanism for you. You assign an “alert meaning” to each string of a member list associated with a static text item. The meaning being, Note, Stop or Caution Alert. Then, with a single call to DeeManager: DeeAlert(deeId: Integer; member: Integer), an alert is displayed with the appropriate alert icon. Changing later the type of an alert is done with DeeMaker and is transparent to the program.

Parameter substitution capabilities are far and above the Dialog Manager also. DeeManager allows 26 parameters instead of 4. Button, CheckBox, Radio, and Window titles, as well as static text items are analyzed by DeeManager for parameter substitution. The key sequence being “=a” thru “=z” (instead of “^0” thru “^3”). Any of the built-in 26 params can be loaded at runtime with one of several DeeManager parameter loader functions.

Figure 1: Method Interface Editor

Another feature of each item object is its ShineThrough™ property. This is perhaps the most profound feature of this development tool. You have seen conventional Draw/CAD applications that give multiple views. The interface paradigm there is the creation of layers without addressing the physical aspect of space. DeeMaker’s paradigm is the use of a view space. You don’t have to create layers - as each Dee is automatically postulated to have a view space (currently 32 views). This presupposed space allows for the ShineThrough™ phenomena to occur and for the easiest most intuitive way we have ever seen of addressing the problem of superimposition of human interface elements. With DeeMaker you simply assign a ShineThrough™ vector to an item, to allow the item to be active through every view it shines through.

Figure 2: Member Editor

What’s really great about DeeMaker is that it was actually created with itself, and it uses ShineThrough™ to implement its elegant type editors. For example, the Text editor has another view for setting edit type attributes. When the EditTypes button is pressed, some 40 elements swiftly change position. In conventional tools you would have to write 40 calls in your program to physically move the items. Here, you just call DeeManager SetView(2) and what you saw in the DeeMaker editing environment is what you get at runtime: all items which either belong to view 2 or shine through to view 2 from view 1 are presented, all others are hidden. No item is physically moved anywhere; rather, you, the observer, moves to another view or dimension. There is a tremendous time saving here. Using DeeMaker, a non-programmer could easily stupefy an experienced developer who could spend hours to implement, in hard coded sweat, the movement of items.

Here is a small example of view usage. This is the modeless handler method of DeeMaker’s ShortCuts taken from its manual. Such a handler would process any number of shortcut views (up to 32) without any change to code.

{1}

Procedure ShortCutsHandler(Var Msg: DeeMessage);
CONST
 bNext  = OK;
 bPrev  = 2;

VAR
 whichView: Integer;
 whichIsBold: Integer;

BEGIN
 WITH Msg, dResult DO
 CASE dMessage OF
 on_Activate:
 BEGIN
 IF LastDeeView(whichView) THEN
 whichIsBold := bPrev
 ELSE
 whichIsBold := bNext;
 DimItem(Not dActivate, whichIsBold)
 END;

 On_Action:
 CASE Id OF
 bPrev:
 BEGIN
 whichView := TheDeeView;
 {previous button belongs to view 2}
 IF whichView = 2 THEN  
 SetDeeKey(Char(13), bNext);
 SetView(whichView - 1);
 END;
 
 bNext:
 BEGIN
 whichView := TheDeeView;
 SetView(whichView + 1);
 IF LastDeeView(whichView) THEN
 SetDeeKey(Char(13), bPrev);
 END
 END
 END
END; {of ShortCutsHandler}

Figure 3: DeeMaker Tool Palette

DeeManager includes support for windoids. These windoids are defined with DeeMaker to have a windoid frame and otherwise are Dees with all the benefits of being a Dee. n Dimensions has solved a very sticky problem here for the entire developer community: how to implement easily any number of floating windows that might be either modeless (such as DeeMaker’s tool palette) or appear in modal contexts (being removed when the modal window is removed from the screen). A brilliant idea was implemented here to allow your code to be orderly and modular. A windoid may be linked with the DeeManager function Link_Windoid(theWindoid, theDee: DeePtr). After this function call, the windoid is linked to a Dee owner, and actions in the windoids are reported to the controlling code of the owner. Not only that, any windoid can be torn off any menu by calling Link_Menu(theWindoid: DeePtr; theMenu: MenuHandle). DeeManager tears off the windoid palette for you and when MenuSelect returns -1, you call Tear_Windoid() to physically move the windoid to a new place.

All the sticky problems of having another floating window layer on top of regular windows are seamlessly handled by DeeManager. You only need to substitute in your event loop at the critical places, old window manager calls with matching DeeManager calls. Thus HideWindow, SelectWindow, DragWindow are replaced with Hide_Window, Select_Window and Drag_Window. Once you write a “DeeManager compatible event loop” (Examples are provided) - any number of windoids and modeless windows can be added to your interface as your project develops. Consider that you can change a modeless window to be floating without affecting your program. This change that would otherwise result in hundreds of source line changes, is entirely transparent using the DeeMaker development tool.

At the heart of DeeMaker is a powerful toolkit called DeeManager (25K). This is the runtime package which supports your Dee dialogs. You almost can’t tell that DeeManager wasn’t originally a part of the Macintosh Toolbox, because DeeManager has A-Trap interface. This is the first commercial product to come with such an interface. All DeeManager functions are inline substituted for A-Trap code. (To do that only a single patch is performed. The original Dialog/Window managers are untouched and are fully operable.)

You will gain access to DeeManager through a small object file, DeeLib.o (1K), which is linked to your modules. DeeLib.o contains the glue functions, OpenDeeMgr and CloseDeeMgr, to establish communication between DeeManager which resides in a ‘DeeM’ resource and your code. DeeManager was written entirely in 68000 macro assembly language. Efficiency was designed into it from the very start.

DeeManager was designed with System 7.0 in mind. Balloon help is provided by adding a help member to your item object. The developers of DeeMaker for DeeManager have kept up with the latest and greatest System developments. Many of the concepts you see in DeeMaker were taken from observing how the HyperCard interface works. In the manual, n Dimensions formally acknowledges HyperCard as a great source of inspiration.

However inspirational, regretfully, DeeManager 1.0.4 doesn’t yet work with HyperCard 2.0. (Previous versions such as HyperCard 1.x.x use DeeManager correctly.) This is not because anything is wrong with DeeManager, but rather the architects of HyperCard have limited the freedom of external windows. Hopefully, someday Claris will rectify this.

DeeMaker moves far beyond the limits of the Dialog Manager that we are familiar with (including all the prototypers which generate code for it). You still have the traditional tools, but now you use them in a new way. DeeMaker allows you to choose flow of control, dimming, hiding, edit types, styles, window frames, grouping, command keys, initializers, ornamentation, automated edit sorting, fixed item identities, Extended List Format™, accurate alignments and other capabilities. In addition, you can easily assign key equivalents to any radio button, check box or button.

DeeMaker’s Group command permits all the necessary grouping you will need. You simply select the items and choose the Group command. Thus, Radios, Buttons, Edit Texts, CheckBoxes, PopUp and EditText items, can be grouped. Each group has its own distinct meaning implemented by DeeManager and your methods.

The following Dee is presented by DeeMaker when you select the GetInfo command for a Dee resource. The Attributes are implemented by grouping the CheckBoxes and assigning to each (with DeeMaker CheckBox editor) its InsideMac (Resource Manager chapter) bit value. The program need only have 2 lines of code to create the proper program interchange. theAttrs := GetCGroup(cResAttr); or SetCGroup(theAttrs , cResAttr). The synopsis was created with parameter substitution and member lists.

Figure 4: Dee Info

And if you wonder what is Extended List Format (ELF). It is DeeMaker’s concept of having its List items extend the familiar List Manager to create many types of Lists without having to write LDEFs. Lists are also part of a Dee’s TabTrail™ (System 7.0 feature) and receive keyboard events just like Editable text items. ELF format has allowed DeeManager to be able to integrate the Menu Manager and List Manager, supplying Menu2List and List2Menu which preserve all information. This is another way DeeManager has become like a master manager on top of the old toolbox, uniting distant formats into harmony.

DeeMaker has many features and we could not possibly cover all of them here. Each data type gives you more power than you would ever expect to get. All of these add tremendous savings in time and effort and return your investment in the product very quickly.

There is one problem that you will encounter if you use QuicKeys (and I hate not having my QuicKeys). DeeManager does not use the Control Manager for buttons (push buttons, check boxes and radio buttons). This means the “Buttons” feature in QuicKeys will not work with any Dee. You can sometimes overcome this by using the “Click” feature but not in most cases. All other features of QuicKeys seem to work fine with Dees. I did discover that floating windows cause a general confusion problem with QuicKeys, this is not due to Dees but instead will happen with any application that uses floating windows. This is due to the fact that the active window, whether it is a dialog (modal or modeless) or a document window, will not be the first window in the window list if floating windows are present. QuicKeys usually locates the desired window by counting windows starting with the frontmost. However, QuicKeys can also locate the desired window by title. This is only useful if the title never changes.

The package comes in an expensive customized three ring notebook. Pascal, C and Motorola 68000, are the preferred environments. But you could easily adapt DeeManager to work in any environment that uses A-Trap interface, such as Common Lisp or Fortran. The manual has three major sections: (1) Touring Dee Dialogs which covers all Dee human interface concepts as an introduction to Dee dialogs; (2) DeeMaker tutorial which describes the attributes of Dees and their capabilities, and (3) Inside DeeManager - a description of all DeeManager resources, data types and functions. A summary of all DeeManager functions and procedures is given for 68000, Pascal, and C. Unfortunatly, no index is provided and as with many programming tool manuals, some sections or statements don’t make a great deal of sense until you have actually played with the code. A few additional examples in other languages (e.g. Pascal) would be extremely helpful and at least one should be in an old fashioned procedural environment (for us dummies who are still a bit inexperienced with objects).

A few examples are provided in the manual but the DeeMaker bundle comes with a complete C++ example, DeeApp™, and all the source code that is necessary to immediately start deriving professional programs. This collection of classes demonstrates very clearly the usage of DeeManager. It also includes a very useful MPW tool MenuRez for allowing DeeApp applications to have menu command numbers independent of menu id and item position.

A final note about the screen shots in this article. DeeManager has a very convenient function SnapDee(theDee: DeePtr): PictHandle. DeeMaker implements its snapshot commands by calling this DeeManager function which takes any Dee and translates it to QuickDraw PICT format. Instead of taking screen snapshots which are bitmaps, DeeMaker’s RedSnapper (Cmd-Shift-7), provides the same effect only with PICT opcodes which take 1/10 of the space of the picture as bits, allowing you to print to a PostScript printer any Dee window (SnapDee snaps window frames too) with laser quality. This is how we generated the above snapshots for this article.

Bottom Line

DeeManager is a very powerful development tool with a well thought out design. The tool is set up in a logical manner allowing for easy customization of the basic behavior of Dees. DeeMaker is an effective design tool that allows even the novice programmer to quickly and easily design a full-featured, working interface in almost no time. It is complete and it is fast. The product’s only drawbacks are that buttons won’t work with utilities such as QuicKeys because controls are not always implemented using the Control Manager. In fairness, n Dimensions is aware of this and will be working on the problem. Overall, two thumbs up!

DeeMaker for DeeManager includes a license to make 100 copies of DeeManager. A flat fee is available for unlimited copies per end user. DeeMaker is licensed for use on one computer just as most commercial software is. Site licenses may be purchased for additional copies.

n Dimensions has a permanent folder on AppleLink at location: “Software Sampler:3rd Party Demos/Updates:Software Updates:n Dimensions.” You may download from that location an unabridged copy of DeeMaker.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Firefox 37.0 - Fast, safe Web browser. (...
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more
Arq 4.11 - Online backup to Google Drive...
Arq is super-easy online backup for the Mac. Back up to your own Google Drive storage (15GB free storage), your own Amazon Glacier ($.01/GB per month storage) or S3, or any SFTP server. Arq backs up... Read more
MacFamilyTree 7.3.4 - 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
Yummy FTP 1.10.2 - FTP/SFTP/FTPS client...
Yummy FTP is an FTP + SFTP + FTPS file transfer client which focuses on speed, reliability and productivity. Whether you need to transfer a few files or a few thousand, schedule automatic backups, or... Read more
VueScan 9.5.08 - 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
Iridient Developer 3.0.1 - Powerful imag...
Iridient Developer (was RAW Developer) is a powerful image conversion application designed specifically for OS X. Iridient Developer gives advanced photographers total control over every aspect of... Read more
Air Video Server HD 2.1.0 - Stream video...
Air Video Server HD streams videos instantly from your computer on your iPhone, iPad, iPod touch or Apple TV. No need to worry about converting or transferring files. We took everything that was... Read more
Duplicate Annihilator 5.7.5 - Find and d...
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... Read more
BusyContacts 1.0.2 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Capture One Pro 8.2.0.82 - RAW workflow...
Capture One Pro 8 is a professional RAW converter offering you ultimate image quality with accurate colors and incredible detail from more than 300 high-end cameras -- straight out of the box. It... Read more

2K Announces WWE 2K, Mobile's First...
It seems like this month has been pretty big for wrestling. First Wrestlemania, then 2K has announces that they're releasing  WWE 2K for iOS. It's a simulation-based WWE game where you'll get to play with several WWE superstars such as John Cena, ... | Read more »
How the Apple Watch Could Change the Fac...
The Apple Watch is still a ways out, but my previous musings on the wearable’s various features got me thinking: what might it be like a year after launch? Two years? Five years? What if it becomes a symbiotic part of the iOS framework to the point... | Read more »
Pie In The Sky: A Pizza Odyssey (Games)
Pie In The Sky: A Pizza Odyssey 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A game about delivering pizza. In space. | Read more »
Chosen Gives Hopeful Singers, Songwriter...
If YouTube videos and reality TV shows like The Voice have taught us one thing, it’s that there are a lot of people out there who are anxious to show the world their talents. And if they’ve taught us a second thing, it’s that there’s an almost... | Read more »
Android's Popular OfficeSuite Now A...
Once only available for Android devices, OfficeSuite has finally landed on the app store. The Mobile Systems app lets you view, edit, create, and share Word, Excel, and PowerPoint documents as well as convert them to/from PDFs. It's touted as being... | Read more »
Warhammer: Arcane Magic is Coming Soon,...
Turbo Tape Games has announced that they're joining forces with Games Workshop to bring the turn-based strategy board game, Warhammer: Arcane Magic, to life on the iOS. | Read more »
Fast & Furious: Legacy's Creati...
| Read more »
N-Fusion and 505's Ember is Totally...
| Read more »
These are All the Apple Watch Apps and G...
The Apple Watch is less than a month from hitting store shelves, and once you get your hands on it you're probably going to want some apps and games to install. Fear not! We've compiled a list of all the Apple Watch apps and games we've been able to... | Read more »
Appy to Have Known You - Lee Hamlet Look...
Being at 148Apps these past 2 years has been an awesome experience that has taught me a great deal, and working with such a great team has been a privilege. Thank you to Rob Rich, and to both Rob LeFebvre and Jeff Scott before him, for helping me... | Read more »

Price Scanner via MacPrices.net

Adobe Brings Powerful Layout-Design Capabilit...
Adobe today announced the availability of Adobe Comp CC, a free iPad app that enables rapid creation of layout concepts for mobile, Web and print projects. With Comp CC, designers can rough out and... Read more
Apple offering refurbished 27-inch 5K iMacs f...
The Apple Store is offering Apple Certified Refurbished 27″ 3.5GHz 5K iMacs for $2119 including free shipping. Their price is $380 off the price of new models, and it’s the lowest price available for... Read more
16GB iPad mini on sale for $199, save $50
Walmart has 16GB iPad minis (1st generation) available for $199.99 on their online store, including free shipping. Their price is $50 off MSRP. Online orders only. Read more
New 128GB MacBook Airs on sale for $50 off MS...
 B&H Photo has 128GB 11″ and 13″ 2015 MacBook Airs on sale today for $50 off MSRP including free shipping plus NY sales tax only: - 11″ 1.6GHz/128GB MacBook Air (Model #MJVM2LL/A): $849 $50 off... Read more
13-inch 2.6GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished 13″ 2.6GHz/128GB Retina MacBook Pros available for $979 including free shipping. Original MSRP for this model was $1299. Read more
Save up to $600 with Apple refurbished Mac Pr...
The Apple Store is offering Apple Certified Refurbished Mac Pros 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... Read more
Samsung Galaxy S 6 and Galaxy S 6 edge U.S. P...
Samsung Electronics America, Inc. has announced the Galaxy S 6 and Galaxy S 6 edge will be available in the U.S. beginning April 10, with pre-orders being accepted now. “We have completely reimagined... Read more
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple 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.... Read more
Save up to $80 on iPad Air 2s, NY tax only, f...
 B&H Photo has iPad Air 2s on sale for $80 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $469.99 $30 off - 64GB iPad Air 2 WiFi: $549.99 $50 off - 128GB iPad... Read more
iMacs on sale for up to $205 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1019 $80 off - 21″ 2.7GHz iMac: $1189 $110 off - 21″ 2.9GHz... Read more

Jobs Board

DevOps Software Engineer - *Apple* Pay, iOS...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring 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
Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
Lead *Apple* Solutions Consultant - Retail...
**Job Summary** Job Summary The Lead ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store Read more
*Apple* Pay - Site Reliability Engineer - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.