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

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Arq 5.7.2 - Online backup to Google Driv...
Arq is super-easy online backup for Mac and Windows computers. Back up to your own cloud account (Amazon Cloud Drive, Google Drive, Dropbox, OneDrive, Google Cloud Storage, any S3-compatible server... Read more
Spotify 1.0.47.13. - Stream music, creat...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
Together 3.7.3 - Store and organize all...
Together helps you organize your Mac, giving you the ability to store, edit and preview your files in a single clean, uncluttered interface. Features Smart storage. With simple drag-and-drop... Read more
Cocktail 10.2 - General maintenance and...
Cocktail is a general purpose utility for macOS that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Sierra Cache Cleaner 11.0.3 - Clear cach...
Sierra Cache Cleaner is an award-winning general purpose tool for macOS X. SCC makes system maintenance simple with an easy point-and-click interface to many macOS X functions. Novice and expert... Read more
NeoFinder 7.0.1 - Catalog your external...
NeoFinder (formerly CDFinder) rapidly organizes your data, either on external or internal disks, or any other volumes. It catalogs all your data, so you stay in control of your data archive or disk... Read more
Sketch 42 - Design app for UX/UI designe...
Sketch is an innovative and fresh look at vector drawing for the Mac. Its intentionally minimalist design is based upon a drawing space of unlimited size and layers, free of palettes, panels, menus,... Read more
Quicken 4.4.3 - Complete personal financ...
Quicken makes managing your money easier than ever. Whether paying bills, upgrading from Windows, enjoying more reliable downloads, or getting expert product help, Quicken's new and improved features... Read more
Apple Safari 10.0.3 - Apple's Web b...
Note: The direct download link is currently unavailable. It is available in the OS X 10.11.6 release, as well as in the Apple Security Updates. Apple Safari is Apple's web browser that comes with OS... Read more
Apple iTunes 12.5.5 - Play Apple Music a...
Apple iTunes lets you organize and stream Apple Music, download and watch video and listen to Podcasts. It can automatically download new music, app, and book purchases across all your devices and... Read more

Clash Royale gets some serious balance u...
| Read more »
Ironhide Game Studio prepares for a busy...
Kingdom Rush breathed fresh life into the tired tower defense genre way back in 2012. The game was a robust challenge that somehow managed to lift you up, rather than leaving you feeling crushed and hopeless. The rich array of unit types and... | Read more »
Collect pets and sling arrows in Arcane...
Mobile gaming is a crowded market, but regular updates are a good way to keep us attention-short players keen. The brand new content in Arcane Online is a prime example. Published by Japanese developer Gala, Arcane Online is a fantasy MMO that... | Read more »
Super Mario Run dashes onto Android in M...
Super Mario Run was one of the biggest mobile launches in 2016 before it was met with a lukewarm response by many. While the game itself plays a treat, it's pretty hard to swallow the steep price for the full game. With that said, Android users... | Read more »
WarFriends Beginner's Guide: How to...
Chillingo's new game, WarFriends, is finally available world wide, and so far it's a refreshing change from common mobile game trends. The game's a mix of tower defense, third person shooter, and collectible card game. There's a lot to unpack here... | Read more »
Super Gridland (Entertainment)
Super Gridland 1.0 Device: iOS Universal Category: Entertainment Price: $1.99, Version: 1.0 (iTunes) Description: Match. Build. Survive. "exquisitely tuned" - Rock Paper Shotgun No in-app purches, and no ads! | Read more »
Red's Kingdom (Games)
Red's Kingdom 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Mad King Mac has kidnapped your father and stolen your golden nut! Solve puzzles and battle goons as you explore and battle your... | Read more »
Turbo League Guide: How to tame the cont...
| Read more »
Fire Emblem: Heroes coming to Google Pla...
Nintendo gave us our first look at Fire Emblem: Heroes, the upcoming mobile Fire Emblem game the company hinted at last year. Revealed at the Fire Emblem Direct event held today, the game will condense the series' tactical RPG combat into bite-... | Read more »
ReSlice (Music)
ReSlice 1.0 Device: iOS Universal Category: Music Price: $9.99, Version: 1.0 (iTunes) Description: Audio Slice Machine Slice your audio samples with ReSlice and create flexible musical atoms which can be triggered by MIDI notes or... | Read more »

Price Scanner via MacPrices.net

HDRtist NX 1.0 For macOS Next Generation HDR...
Ohanaware Co., Ltd. have announced the immediate release of their latest High Dynamic Range Imaging software “HDRtist NX”. HDRtist NX is the third installment in the HDRtist series of applications... Read more
Built To Last Maverick Leather Laptop Messeng...
Wild West melds with modern in San Francisco designer-manufacturer of custom laptop sleeves, bags and cases WaterField Designs’ new Maverick Leather Laptop Messenger. This luxury laptop bag blends... Read more
Logitech Sets Company Record With 15 GOOD DES...
Logitech has announced that it has won 15 GOOD DESIGN 2016 awards. This marks the sixth consecutive year Logitech products have been recognized by the GOOD DESIGN awards, and the most award wins for... Read more
13-inch Touch Bar MacBook Pros in stock for $...
B&H Photo has the new 2016 13″ Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.9GHz/512GB Touch Bar... Read more
9-inch 32GB Space Gray iPad Pro on sale for $...
B&H Photo has the 9.7″ 32GB Space Gray Apple iPad Pro on sale for $549 for a limited time. Shipping is free, and B&H charges NY sales tax only. Read more
15-inch 2.2GHz Retina MacBook Pro on sale for...
Amazon has 2015 15″ 2.2GHz Retina MacBook Pros (MJLQ2LL/A) on sale for $1749.99 including free shipping. Apple charges $1999 for this model, so Amazon’s price is represents a $250 savings. Read more
Deal alert! 13-inch 2.0GHz MacBook Pros for $...
B&H Photo has the new 2016 13″ 2.0GHz non-Touch Bar MacBook Pros in stock today and on sale for $225 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro... Read more
Free LibreOffice Portable 5.2.4 Complete Offi...
PortableApps.com and The Document Foundation have announce the release of LibreOffice Portable 5.2.4. LibreOffice Portable is an Open Source full-featured office suite — including a word processor,... Read more
Apple Planning Three New Tablets For 2017 – D...
Digitimes’ Rebecca Kuo and Joseph Tsai say that unnamed insider sources report Apple having three new tablets in the pipeline for 2017 release: a 9.7-inch model with a friendly price range, a new mid... Read more
Roundup of 15-inch Touch Bar MacBook Pro sale...
B&H Photo has the new 2016 15″ Apple Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.7GHz Touch Bar... Read more

Jobs Board

*Apple* & PC Desktop Support Technician...
APPLE & PC DESKTOP SUPPORT TECHNICIAN JOB IN STAMFORD, CT! We have immediate job openings for several Desktop Support Technicians with one of our most well-known Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Manhattan, NY Introduction: We have immediate job openings for several Desktop Support Technicians with one of our most Read more
*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Stamford, CT We have immediate job openings for several Desktop Support Technicians with one of our most well-known Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.