TweetFollow Us on Twitter

Jun 96 Tips
Volume Number:12
Issue Number:6
Column Tag:Tips & Tidbits

Tips & Tidbits

By Steve Sisak

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

OpenDoc Frames and Facets

A major difficulty confronting every first time OpenDoc programmer is the difference between Frames and Facets. Both seem to refer to the “portion of a window” concept expressed in PowerPlant as a “pane” and in other frameworks as a “view”. In common frameworks, the pane hierarchy is both an embedding hierarchy and a visual hierarchy. In OpenDoc, the embedding hierarchy (frame) is separated from the visual hierarchy (facet) to allow for more flexibility in imaging.

In order to understand the separate roles for frame and facets, I have found it useful to create my own subtitles:

Frame - a contract for embedding

Facet - a region of a GrafPort

Think of ODFrame, first and foremost, as a relationship between two parts; a frame is a contract between a container and its embedded content. An embedded part is connected to its containing document only through its frames - if all the frames are closed, the part is no longer in the document. The embedding hierarchy alternates between parts and frames: parts have embedded frames, which have parts, which have embedded frames, and so on.

The ODFrame contract covers three primary areas: the shape of the embedded content, the view type (icon, thumbnail, or normal imaging), and the presentation format (particular to the kind of content, e.g. a chart, table, or graph). The container and embedded content mutually agree on these areas during a process called “frame negotiation”.

Either party can initiate frame negotiation. For example, a browser might want to show both an icon and a normal image for a particular embedded part. This container would create two embedding contracts, each with different shapes, view types, and presentations. On the other hand, a game controller might want to negotiate an irregular pod-shaped frame for its alien-like control panels. It would have to ask its containing part to approve this shape.

Frames, however, are an abstract contract. They are not portions of a window. In particular, frames have no GrafPort, no offset location, and no front-to-back ordering. To fulfill the abstraction, the container must make one or more facets for each frame that it wants to display. By making a facet, the container makes the frame visible and allows the user to interact with it.

Think of a facet as a region of a GrafPort. A facet has a coordinate transformation to locate itself in the GrafPort, and a clip region to make sure it does not exceed its bounds. A facet has a z-ordering, and can be highlighted or selected. Facets (and not frames) form the visual hierarchy. Importantly, facets cannot be negotiated. The container has sole control over assigning facets to its embedded frames, though it must respect the negotiated frame shape when it does so.

In most cases, the container creates only one facet per frame. Multiple facets occur in situations where a container has a split-screen view, and the same frame is imaged in multiple locations, with different clip regions. Another common use of facets is in page layout, where a frame might be split between the bottom of one page and the top of the succeeding page. To create the gap between pages, the container assigns upper and lower facets to the frame. But note that if a frame has multiple facets, they must all be in the same GrafPort. If you want to image the same content in two different windows, you must create a second frame (contract) for the second window.

If you think about it, the distinction between frames and facets makes logical sense. Consider a database container that stores thousands of embedded parts. After a search, the database displays 3 or 4 of those embedded parts. In this scenario, only the search results need facets (regions of a GrafPort) for display. But the database needs frames (the contract governing embedding) for all of the thousands of parts. It would likely want to remember the shape, view type, and presentation of each of these parts, so that when it needs to display them, it can show them just as they appeared the last time. Frames represent the persistent contract between the database and its embedded items. Facets represent the visual regions of the currently displayed parts.

For programmers with experience in other frameworks, the most important thing to remember is that a frame is not a portion of a window. It is simply a negotiated contract governing the shape, view, and presentation for an embedded content. This shape, view, and presentation becomes visible only when the container fulfills this contract by creating a facet for the part, thus specifying its GrafPort, origin, and clip shape.

Jeremy Roschelle

Yanking Ingenuity

These days, installing RAM in some of the new Power Macintosh computers is not as easy as it was with the Macintosh II series. So, here’s a tip for you Power Macintosh 8500 owners...

If you need to get access to your motherboard to install RAM, VRAM, or more Cache RAM, you’re going to have to first remove the deep-seated processor card before the motherboard can be removed from the chassis. This card is really difficult to remove because it is in there tight, and there just isn’t a lot of finger space to allow you to get a good grip on the card. After a couple roughed-up knuckles and sore finger tips, I found the following sane approach to solving this headache:

Take two small nylon cable ties (any color will do) and loosely loop them through the sturdy holes in the upper corners of the processor card. Then, you can easily insert your fingers through the two cable tie loops and apply enough equal pressure to carefully remove the processor card.

The good news is you can leave those cable ties in there in case you need future access to the motherboard (unless of course you have some other need for the holes).

Disclaimer: this tip has been thoroughly tested on several Power Macintosh 8500 computers and is bug-free. It is possible that some of the other models could also benefit from this tip.

Mark D. Gerl

[On a related note - the processor daughter card in PowerMac 9500 has a tendency to wander out of its socket if you move the machine around. This is fatal to the processor card. The repair person who fixed mine suggests opening the machine and re-seating the card if you move it to a different office, etc. - sgs ]

Immediate Drag Manager Feedback

The Drag Manager allows a feeback region to be dragged by the mouse. This region is created and passed into the TrackDrag trap:

 TrackDrag(
            DragReference         theDragRef,
            const EventRecord*    theEvent,
            RgnHandle             theRegion);

The Drag Manager doesn’t actually draw this region until the mouse has actually moved. Sometimes it is helpful if this region is drawn immediately. What to do?

Just futz with the where field of theEvent by a few pixels.

        theEvent->where.h += 3;   // the 3 comes from DnD HIG, p. 7
        theEvent->where.v += 3;
        err = TrackDrag(theDragRef, theEvent, theRegion);

...and a comment on the XOR Anti-Tip

One of the problems with the XOR swap (MacTech Magazine 11.10 [October 1995] 96) is that it doesn’t work if the source and destination are the same variables, as could happen with complicated, deeply nested macros.

Chris Sears

 
AAPL
$96.88
Apple Inc.
-0.31
MSFT
$44.47
Microsoft Corpora
-0.41
GOOG
$593.30
Google Inc.
-2.68

MacTech Search:
Community Search:

Software Updates via MacUpdate

Audio Hijack Pro 2.11.0 - Record and enh...
Audio Hijack Pro drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio with Audio Hijack... Read more
Intermission 1.1.1 - Pause and rewind li...
Intermission allows you to pause and rewind live audio from any application on your Mac. Intermission will buffer up to 3 hours of audio, allowing users to skip through any assortment of audio... Read more
Airfoil 4.8.7 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
Microsoft Remote Desktop 8.0.8 - Connect...
With Microsoft Remote Desktop, you can connect to a remote PC and your work resources from almost anywhere. Experience the power of Windows with RemoteFX in a Remote Desktop client designed to help... Read more
xACT 2.30 - Audio compression toolkit. (...
xACT stands for X Aaudio Compression Toolkit, an application that encodes and decodes FLAC, SHN, Monkey’s Audio, TTA, Wavpack, and Apple Lossless files. It also can encode these formats to MP3, AAC... Read more
Firefox 31.0 - Fast, safe Web browser. (...
Firefox for Mac 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... Read more
Little Snitch 3.3.3 - Alerts you to outg...
Little Snitch gives you control over your private outgoing data. Track background activityAs soon as your computer connects to the Internet, applications often have permission to send any... Read more
Thunderbird 31.0 - Email client from Moz...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more
Together 3.2 - Store and organize all of...
Together helps you organize your Mac, giving you the ability to store, edit and preview your files in a single clean, uncluttered interface. Smart storage. With simple drag-and-drop functionality,... Read more
Cyberduck 4.5 - FTP and SFTP browser. (F...
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more

Latest Forum Discussions

See All

Thomas Was Alone Goes Universal, Slashes...
Thomas Was Alone Goes Universal, Slashes Price to $3.99 Posted by Ellis Spice on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Book Your Appointment with F.E.A.R. this...
Book Your Appointment with F.E.A.R. | Read more »
It Came From Canada: Epic Skater
For all the hate that it gets for being a pastime for slackers, skateboarding really does require a lot of skill. All those flips and spins take real athleticism, and there’s all the jargon to memorize. Fortunately for us less extreme individuals,... | Read more »
Cultures Review
Cultures Review By Jennifer Allen on July 24th, 2014 Our Rating: :: SLOW-PACED EMPIRE BUILDINGiPad Only App - Designed for the iPad Cute it might seem, but Cultures is a bit too slow paced when it comes to those pesky timers to... | Read more »
More Paintings Have Been Added to Paint...
More Paintings Have Been Added to Paint it Back! Posted by Jessica Fisher on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
The Order of Souls Review
The Order of Souls Review By Campbell Bird on July 24th, 2014 Our Rating: :: STORY GRINDUniversal App - Designed for iPhone and iPad The Order of Souls is a free-to-play, turn-based RPG with a genre-mixing art style, interesting... | Read more »
Revolution 60 Review
Revolution 60 Review By Jordan Minor on July 24th, 2014 Our Rating: :: LASS EFFECTUniversal App - Designed for iPhone and iPad Revolution 60 is a bold, cinematic action game with ambition to spare.   | Read more »
Matter (Photography)
Matter 1.0.1 Device: iOS Universal Category: Photography Price: $1.99, Version: 1.0.1 (iTunes) Description: Add stunning 3D effects to your photos with real-time shadows and reflections. Export your creations as photos or video loops... | Read more »
Fanatic Earth Review
Fanatic Earth Review By Brittany Vincent on July 24th, 2014 Our Rating: :: BY-THE-NUMBERSUniversal App - Designed for iPhone and iPad Kemco’s stable of mobile RPGs grows, but in Fanatic Earth’s situation it’s a case of quantity... | Read more »
Together for iOS (Productivity)
Together for iOS 1.0 Device: iOS Universal Category: Productivity Price: $9.99, Version: 1.0 (iTunes) Description: Together is an app for keeping things in one place. Notes, documents, images, movies, sounds, web pages and bookmarks... | Read more »

Price Scanner via MacPrices.net

What Should Apple’s Next MacBook Priority Be;...
Stabley Times’ Phil Moore says that after expanding its iMac lineup with a new low end model, Apple’s next Mac hardware decision will be how it wants to approach expanding its MacBook lineup as well... Read more
ArtRage For iPhone Painting App Free During C...
ArtRage for iPhone is currently being offered for free (regularly $1.99) during Comic-Con San Diego #SDCC, July 24-27, in celebration of the upcoming ArtRage 4.5 and other 64-bit versions of the... Read more
With The Apple/IBM Alliance, Is The iPad Now...
Almost since the iPad was rolled out in 2010, and especially after Apple made a 128 GB storage configuration available in 2012, there’s been debate over whether the iPad is a serious tool for... Read more
MacBook Airs on sale starting at $799, free s...
B&H Photo has the new 2014 MacBook Airs on sale for up to $100 off MSRP for a limited time. Shipping is free, and B&H charges NY sales tax only. They also include free copies of Parallels... Read more
Apple 27″ Thunderbolt Display (refurbished) a...
The Apple Store has Apple Certified Refurbished 27″ Thunderbolt Displays available for $799 including free shipping. That’s $200 off the cost of new models. Read more
WaterField Designs Unveils Cycling Ride Pouch...
High end computer case and bag maker WaterField Designs of San Francisco now enters the cycling market with the introduction of the Cycling Ride Pouch – an upscale toolkit with a scratch-free iPhone... Read more
Kingston Digital Ships Large Capacity Near 1T...
Kingston Digital, Inc., the Flash memory affiliate of Kingston Technology Company, Inc.,has announced its latest addition to the SSDNow V300 series, the V310. The Kingston SSDNow V310 solid-state... Read more
Apple’s Fiscal Third Quarter Results; Record...
Apple has announced financial results for its fiscal 2014 third quarter ended June 28, 2014, racking up quarterly revenue of $37.4 billion and quarterly net profit of $7.7 billion, or $1.28 per... Read more
15-inch 2.0GHz MacBook Pro Retina on sale for...
B&H Photo has the 15″ 2.0GHz Retina MacBook Pro on sale for $1829 including free shipping plus NY sales tax only. Their price is $170 off MSRP. B&H will also include free copies of Parallels... Read more
Apple restocks refurbished Mac minis for up t...
The Apple Store has restocked Apple Certified Refurbished Mac minis for up to $150 off the cost of new models. Apple’s one-year warranty is included with each mini, and shipping is free: - 2.5GHz Mac... Read more

Jobs Board

Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
Senior Interaction Designer, *Apple* Online...
**Job Summary** Apple is looking for a hands on Senior…will be a key player in designing for the Apple Online Store. The ideal designer will have a Read more
*Apple* Sales Chat Rep - Apple (United State...
…is looking for motivated, outgoing, and tech savvy individuals who want to offer Apple Customers an unparalleled customer experience over chat. At Apple , we believe Read more
Mac Expert - *Apple* Online Store Mexico -...
…MUST be fluent in English and Spanish to be considered for this position At Apple , we believe that hard work, a fun environment, creativity and innovation fuel the Read more
*Apple* Industrial Design CAD Sculptor - App...
**Job Summary** The Apple Industrial Design team is looking for a CAD sculptor/Digital 3D modeler to create high quality CAD models used in the industrial design process Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.