TweetFollow Us on Twitter

January 92 - UOrnaments: Half-price Icons

UOrnaments: Half-price Icons

Thomas E. Burns

What if you want to display a bunch of icons, but find that TIcons are too big and slow? This type of situation calls for a class of objects that know how to draw themselves, but don't process events. To minimize memory usage, it's nice if these classes require only one instance per icon, no matter how many places an icon appears within a view.

I developed two classes for this purpose, TOrnament and TOrnamentServer, have proven useful. TOrnament is a simple abstract class that defines objects that know how to draw themselves within a view, but do not respond to events. Because of their simplicity, ornaments are about twice as fast at drawing and consume far less memory than similar views. TOrnamentServers make using ornaments easy and efficient by managing their creation and imaging.

Using ornaments

Adding ornaments to a view is straight-forward. First, by modifying your ISomeView and IRes methods, ask the appropriate OrnamentServer, gPictureOrnamentServer for pictures or gIconOrnamentServer for icons, to load the ornament. The AddOrnament method will either create and initialize the ornament, if it hasn't already been created, or increment the ornament's reference count.
gPictureOrnamentServer->AddOrnament( kTestPicture );

Then add code to your view's Draw method that draws the ornament. This example draws the ornament kTestPicture in your view(this) at location where with highlighting hlOff:

gPictureOrnamentServer->Draw( this, kTestPicture, where, hlOff );

The final step is to delete the ornament in the view's free method. DeleteOrnament will decrement the ornament's reference count and, if the reference count is zero, free the ornament.

gPictureOrnamentServer->DeleteOrnament( kTestPicture );

Even though ornaments do a lot of work for you, only four methods are needed to implement a new subclass. I will stroll through the implementation of TPictureOrnament and TPictureOrnamentServer to demonstrate the creation of new ornament subclasses.

Implementing TPictureOrnament

Subclasses of TOrnament are used to implement specific, resource-based images, such as pictures and icons. Because TOrnament implements the methods used for reference counting, Add and Delete, its subclasses need to implement only three methods: IPictureOrnament, Draw and GetExtent.

The IPictureOrnament calls IOrnament and then loads the picture resource. IOrnament merely calls IObject, sets the reference count to zero and sets fRsrcId to rsrcId. The essential code (without failure handling) for the IPictureOrnament method is:

virtual pascal void
TPictureOrnament::IPictureOrnament
(
    short   rsrcId
)
{
    this->IOrnament( pictureRsrcId );
    fPicture = GetPicture( fRsrcId );   // fPicture holds the
                                        // picture
    FailNILResource( (Handle)fPicture );
}

The Draw method is the core of an ornament. Its implementation will, of course, vary greatly for different classes of ornaments. Typically, a Draw method will call inherited::Draw (which calls PenNormal()), load and make unpurgeable the ornament's resource, and then draw with the appropriate highlighting. Because the code for drawing pictures is rather long and specific for 'PICT' resources, I will only show the definition for the method.

UOrnaments
virtual pascal void
Draw
(
    TView*              theView,    // view to draw in
    const VPoint&       where,      // top,left corner to draw at
    HLState             hilite      // the hilite to use
);

The next method, GetExtent, returns an ornament's size in a Point. This method is usually very similar to Draw. It must load and make unpurgeable the ornament's resource and then calculate its extent. Here's TOrnament's definition of this method:

virtual pascal Point
GetExtent
(
    void
);

The next step for creating a new ornament is to make a subclass of TOrnamentServer that overrides the DoMakeOrnament method. The function of TOrnamentServers is to manage the interactions between views and ornaments. A view never needs to refer to an ornament directly; it always uses an ornaments resource number instead. The advantages of this setup are:

  • A view can assume that it always needs to load and unload an ornament because TOrnamentServer will only do what is necessary. TOrnamentServer loads an ornament only once and then unloads it only after all views are finished with it.
  • There is no need for a view to add instance variables just to keep track of all the ornaments it is using.
  • Memory is saved because an ornament is loaded only once, no matter how many views are using it.

TOrnamentServers need to create ornaments when a new one is added to its list. To maintain the "object-oriented" nature of this unit, I didn't want to make TOrnamentServer know about all the possible types of ornaments. Therefore, TOrnamentServer has a DoMakeOrnament method that returns a new TOrnament of the appropriate subclass. This method for TPictureOrnamentServer is:

pascal TOrnament*
TPictureOrnamentServer::DoMakeOrnament
(
    short       rsrcId
)
{
    TPictureOrnament*       pictureOrnament;

    pictureOrnament = new TPictureOrnament;
    pictureOrnament->IPictureOrnament( rsrcId );
    return( pictureOrnament );
}

As an optional last step, write the InitPictureOrnamentServer function. This function creates and initializes an instance of the TPictureOrnamentServer class.

pascal void
InitPictureOrnamentServer
(
    void
)
{
    if ( gPictureOrnamentServer == NULL )
    {
        gPictureOrnamentServer = new TPictureOrnamentServer;
        gPictureOrnamentServer->IPictureOrnamentServer();
    }
}

Good indications

While it only required a couple of hours to write the original UOrnaments unit, it has proven to be a useful tool. The project I was working on when creating this unit, a robot controller, requires frequent use of indicators that can appear many, many times within a view. Full fledged views would be too big and slow to be practical. I hope ornaments prove to be as useful for you.
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

WhatsApp 0.2.4238 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
VOX 2.8.24 - Music player that supports...
VOX just sounds better! The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all audio formats you should ever need.... Read more
Dropbox 24.4.17 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
OmniPlan Pro 3.7.1 - Professional-grade...
With OmniPlan Pro, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success... Read more
OmniPlan 3.7.1 - Robust project manageme...
With OmniPlan, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success,... Read more
Adium 1.5.10.4 - Popular instant messagi...
Adium is a fast and free instant messaging client which supports AIM, ICQ, Jabber, MSN, Yahoo!, Google Talk, Yahoo! Japan, Bonjour, Gadu-Gadu, Novell Groupwise, SIP/SIMPLE (Text), and Lotus Sametime... Read more
SteerMouse 5.1 - Powerful third-party mo...
SteerMouse is an advanced driver for USB and Bluetooth mice. It also supports Apple Mighty Mouse very well. SteerMouse can assign various functions to buttons that Apple's software does not allow,... Read more
File Juicer 4.57 - $18.00
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. In computer... Read more
1Password 6.7 - Powerful password manage...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
CleanMyMac 3.8.1 - $39.95
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac lets you safely and intelligently scan and clean your entire system, delete large, unused files... Read more

Latest Forum Discussions

See All

Olli by Tinrocket (Photography)
Olli by Tinrocket 1.0 Device: iOS iPhone Category: Photography Price: $2.99, Version: 1.0 (iTunes) Description: Get drawn in with Olli by TinrocketOlli instantly turns your everyday moments into hand-drawn art and animations. • Watch... | Read more »
Penarium (Games)
Penarium 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: | Read more »
Fire Emblem Heroes is way more profitabl...
Profits for Nintendo's mobile game Fire Emblem Heroes are apparently impressive enough to beat out other Nintendo titles likeSuper Mario Run, despite having 10 times fewer downloads. [Read more] | Read more »
Classic series Robot Unicorn Attack 3 no...
The classic Adult Swim browser game, Robot Unicorn Attack, branched off into a series of popular mobile games. Now, the latest entry into the series, Robot Unicorn Attack 3, is available for iOS and Android mobile devices. [Read more] | Read more »
Sudoku Sweeper (Games)
Sudoku Sweeper 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A minimalist mashup of Minesweeper and Sudoku. Logic puzzle perfection. Every row, column and zone contains a bomb and one of... | Read more »
Under Leaves (Games)
Under Leaves 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Journey into the forest, the jungle or the depths of the deep blue sea. Find chestnuts for the pigs, a caterpillar for the... | Read more »
Ninja Pizza Girl (Games)
Ninja Pizza Girl 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: In the not-so-distant future, rampart traffic congestion has resulted in only one way to deliver pizzas across town in thirty... | Read more »
SCRAP (Games)
SCRAP 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: That day, for no apparent reason, SCRAP decided to wake up and run. He had to, because his activation was a mistake the "Factory" could... | Read more »
The Bunker (Games)
The Bunker 1.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.1 (iTunes) Description: The critically acclaimed console hit "The Bunker" comes to iOS, The groundbreaking live-action thriller adventure set in a real... | Read more »
Die With Glory (Games)
Die With Glory 1.2.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2.0 (iTunes) Description: Die with Glory is an epic adventure game where your goal is to die in glorious fashion. You must help Sigurd, a brave old... | Read more »

Price Scanner via MacPrices.net

New System Clock for macOS by B-Eng Now Avail...
Fehraltorf, Switzerland based B-Eng has announced the release and immediate availability of System Clock, the company’s new system monitor and information app developed exclusively for macOS. System... Read more
DEVONtechnologies Celebrates 15th Anniversary...
DEVONtechnologies celebrates its 15th company anniversary with a 30% discount on all its software products from May 1st through 5th, 2017. In spring 2002, DEVONtechnologies opened its website and... Read more
WaterField Designs Invites Customers to Help...
San Francisco based WaterField Designs invites customers and air travelers to participate in developing the next generation in-flight travel case, the Air Porter. Frustrated with limited legroom,... Read more
Save up to $260 with Apple refurbished 12-inc...
Apple has Certified Refurbished 2016 12″ Retina MacBooks available for $200-$260 off MSRP. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The following... Read more
Digital Paper Tablet Offers Distraction Free...
I typically spend 8-10 hours a day gazing at the screens in my laptops and iPad, as tools of my livelihood, I don’t as a rule use electronic devices for pleasure reading. I subscribe to a daily... Read more
“Today at Apple” Bringing New Educational Ses...
Apple has announced plans to launch dozens of new educational sessions next month in all 495 Apple Stores ranging in topics from photo and video to music, coding, art and design, and more. The hands-... Read more
Smart Finance Free Comprehensive Personal Fin...
Moscow-based indie developer, Alexander Survillo has announced the release and immediate availability of Smart Finance: Personal Finance, Budget & Money 1.1.4, an update to his comprehensive... Read more
12-inch 1.1GHz Retina MacBooks on sale for $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $100 off MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1199.99 $100 off MSRP - 12... Read more
13-inch 2.7GHz Retina MacBook Pro on sale for...
B&H Photo has the 13″ 2.7GHz Retina MacBook Pro on sale for $130 off MSRP. Shipping is free, and B&H charges NY & NJ tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro (MF839LL/A): $1169 $... Read more
15-inch 2.2GHz Retina MacBook Pros available...
B&H Photo has the 15″ 2.2GHz Retina MacBook Pro available for $200 off MSRP including free shipping plus NY & NJ sales tax only: - 15″ 2.2GHz Retina MacBook Pro (MJLQ2LL/A): $1799.99 $200 off... Read more

Jobs Board

*Apple* Mac Computer Technician - GeekHampto...
…complex computer issues over the phone and in person? GeekHampton, Long Island's Apple Premium Service Provider, is looking for you! Come work with our crew Read more
*Apple* Retail - Multiple Positions- Chicago...
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* Systems Engineer - California Polyte...
Cal Poly, San Luis Obispo Apple Systems Engineer Department: ITS - Customer & Tech Support (134900) College/Division: Academic Affairs Salary Range: Position Read more
*Apple* Mobile Master - Best Buy (United Sta...
**501042BR** **Job Title:** Apple Mobile Master **Location Number:** 000416-East Lansing-Store **Job Description:** **What does a Best Buy Apple Mobile Master Read more
Best Buy *Apple* Computing Master - Best Bu...
**501195BR** **Job Title:** Best Buy Apple Computing Master **Location Number:** 000211-Colorado Blvd-Store **Job Description:** **What does a Best Buy Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.