TweetFollow Us on Twitter

May 93 Tips, Tidbits
Volume Number:9
Issue Number:5
Column Tag:Tips & Tidbits

Related Info: Quickdraw Color Quickdraw

Tips & Tidbits

By Neil Ticktin, Editor-in-Chief

This column is your opportunity to spread the word about little bits of information that you find out about. These tidbits can be programming related or they can be user tips that are particularly useful to programmers.

MacTech Magazine will pay $25 for every tip used, and $50 for the Tip of the Month. Or you can take your award in orders or subscriptions.

To submit a tip, send in a letter to the magazine. E-mail is our preferred method, but feel free to send something via the US Mail. See page two for all addresses. If you do send snail mail, enclose a printed copy and a disk copy of the letter so that it does not have to be retyped.

Tip of the Month

DebugFStr and DebugFsStr are C macros that enable developers to drop into a low-level debugger, such as MacsBug or TMON, and display the contents of variables in a formatted manner. One example would be to display a long in hex, decimal or octal notation. Better yet, several variables can be shown together on the same message line that is displayed by a debugger. These macros can be used by both Think C and MPW C. Here's how to use 'em (Think C users):

Add the DebugFStr or DebugFsStr macro to your code. To use either macro, include the ANSI (or ANSI-small) and the MacTraps libraries in your project. You must also include the "stdio.h" header file in any source file in which you intend to use these macros. Don't forget to define 'AND' because it is necessary for the syntax of both macros. Macro definitions:

/* 1 */
#define DebugFStr(x,y,z)  sprintf((char *)x,(char *)y,z);      
 \
 c2pstr((char *)x);\
 DebugStr(x);
#define DebugFsStr(x,y) { Str255 a_temporary_string = "\0";    
 \
 sprintf((char *)a_temporary_string,(char *)x,y);\
 c2pstr((char *)a_temporary_string); \
 DebugStr(a_temporary_string);}
#define AND ,

Place DebugFStr or DebugFsStr calls throughout your code in places where you want to drop into your low-level debugger and view the contents of variables. The syntax for using each macro is:

/* 2 */

DebugFStr((char *)resultString,(const char *)formatString,var1 AND var2 
AND varN)
DebugFsStr((const char *)formatString,var1 AND var2 AND   varN)

When using DebugFStr, you must declare and pass a string variable that will be used by the macro to hold the resulting formatted string. This string is a Str255.

FormatString should be a C string constant, enclosed in double-quotes, and can contain formatting information that is identical to the formatting information used for ANSI C's sprintf function.

The variables var1 through varN must be separated by the word AND and the variables must be ordered to correspond directly to the order of the variables defined in the formatString. See the Think C Standard Libraries Reference guide for more information about the sprintf function.

NOTE: The combined length of the formatString and the formatted variables cannot exceed 255 characters, because both macros call DebugStr which requires a Pascal-style string.

NOTE: Notice in the syntax for both macros that neither is delimited by a semicolon.

The only real difference between DebugFStr and DebugFsStr is that the DebugFsStr macro creates a temporary string variable for the formatted string result and DebugFStr requires you to supply a string which will be used by the macro to store the formatted string result.

Following is a function that demonstrates the use of DebugFStr.

/* 3 */

static void MyFunc(short dummy)
{
 long    tempL1 = 1000;
 long    tempL2 = 20;
 Str255  result;

 DebugFStr((char *)result,"In HEX, tempL1 is %#lX and tempL2 is %#lX.",
 tempL1 AND tempL2)
 tempL1 += tempL2;
 DebugFStr((char *)result,"In decimal, tempL1 is %ld.",templL1) }

In the sample function shown above, MyFunc would drop into your debugger two times. On the first drop, your debugger would display the message: In Hex, tempL1 is 0X3E8 and tempL2 is 0X14. On the second drop, your debugger would display the message: In decimal, tempL1 is 1020.

- Jerry Panagrossi

Int'l Biotech via AppleLink

Adding Touch to MPW

If you work much with makefiles, you may sometimes want an easy way to touch a file's modification date. MPW doesn't include a touch command, but it's easy to add one. Type this command into the MPW Worksheet and press Enter:

 Alias Touch "Setfile -m . "

With this alias, you can touch the last modification date of files by entering commands like "touch filename" (updates just the one filename) or "touch .f" (all files in current folder with names ending in ".f").

After you've tried this and decided it's something you'd like as a permanent feature in MPW, copy the above Alias command to your UserStartup file. That way it will be executed each time you launch MPW.

- Lee D. Rimar

Rochester Hills, MI

Subtle QuickDraw Change

If you are writing code that bypasses QuickDraw and writes directly to the screen, and your code is running under 32-bit QuickDraw, only mask off the upper two bits of the screen’s rowbytes value. Previous to 32-bit QuickDraw, the maximum value for rowbytes was $1FFE (bits 13-15 reserved for flags), but with 32-bit QuickDraw, the maximum restriction has been raised to $3FFE (only bits 14 & 15 are reserved).

In most situations, an application that does its own blits to the screen would not encounter any problems masking off bit 13 BUT the time has arrived where bit 13 is being used. For example, a screen of 2048 32-bit pixels requires a rowbytes value of $2000. Applications that mask off bit 13 will produce a rowbytes value of zero, and will wind up drawing only to the top line of the screen.

By the way, if you did overlook this subtle change to the pixmap structure in Inside Mac IV (Chapter 17, page 5), don't feel left out, as I've found popular commercial applications making the same mistake as well.

- John C. Signa

SuperMac Technology

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

How to upgrade your character in Spellsp...
So you’ve mastered the basics of Spellspire. By which I mean you’ve realised it’s all about spelling things in a spire. What next? Well you’re going to need to figure out how to toughen up your character. It’s all well and good being able to spell... | Read more »
5 slither.io mash-ups we'd love to...
If there's one thing that slither.io has proved, it's that the addictive gameplay of Agar.io can be transplanted onto basically anything and it will still be good fun. It wouldn't be surprising if we saw other developers jumping on the bandwagon,... | Read more »
How to navigate the terrain in Sky Charm...
Sky Charms is a whimsical match-'em up adventure that uses creative level design to really ramp up the difficulty. [Read more] | Read more »
Victorious Knight (Games)
Victorious Knight 1.3 Device: iOS Universal Category: Games Price: $1.99, Version: 1.3 (iTunes) Description: New challenges awaits you! Experience fresh RPG experience with a unique combat mechanic, packed with high quality 3D... | Read more »
Agent Gumball - Roguelike Spy Game (Gam...
Agent Gumball - Roguelike Spy Game 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Someone’s been spying on Gumball. What the what?! Two can play at that game! GO UNDERCOVERSneak past enemy... | Read more »
Runaway Toad (Games)
Runaway Toad 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: It ain’t easy bein’ green! Tap, hold, and swipe to help Toad hop to safety in this gorgeous new action game from the creators of... | Read more »
PsyCard (Games)
PsyCard 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: From the makers och Card City Nights, Progress To 100 and Ittle Dew PSYCARD is a minesweeper-like game set in a cozy cyberpunk... | Read more »
Sago Mini Robot Party (Education)
Sago Mini Robot Party 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: -- Children's Technology Review Editor's Choice -- | Read more »
How to get a high score in every level o...
Sky Charms is an adorable match three puzzler that provides a decent challenge thanks to its creative level design. It regularly presents something new, forcing you to think on your feet. [Read more] | Read more »
Apestorm: Full Bananas (Games)
Apestorm: Full Bananas 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: ***Launch sale – limited time only!*** Fugitive Apes have taken to the skies in search of revenge after humans have... | Read more »

Price Scanner via MacPrices.net

15-inch 2.2GHz Retina MacBook Pro on sale for...
Amazon.com has the 15″ 2.2GHz Retina MacBook Pro on sale for $1699.99 including free shipping. Their price is $300 off MSRP, and it’s the lowest price available for this model from any reseller (and... Read more
Apple Beats Microsoft at Own Game; Amazon Pri...
First quarter seasonality combined with an overall disinterested customer base led to an annual decline of 14.7% in worldwide tablet shipments during the first quarter of 2016 (1Q16). Worldwide... Read more
Aleratec Releases Mac Software Upgrade for 1...
California based Aleratec Inc., designer, developer and manufacturer of Portable Device Management (PDM) charge/sync products for mobile devices and professional-grade duplicators for hard disk... Read more
Sale! Amazon offers 27-inch iMac, 13-inch 2.9...
Amazon has the 27″ 3.2GHz 5K iMac and the 13″ 3.9GHz Retina MacBook Pro on sale for $300 off MSRP, each including free shipping, for a limited time: - 27″ 3.2GHz/1TB HD 5K iMac (model MK462LL/A): $... Read more
Apple refurbished 13-inch Retina MacBook Pros...
Apple has Certified Refurbished 13″ Retina MacBook Pros available for up to $270 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz... Read more
13-inch 2.7GHz/128GB Retina MacBook Pro on sa...
Take $200 off MSRP on the price of a new 13″ 2.7GHz/128GB Retina MacBook Pro (model MF839LL/A) at Amazon. Shipping is free: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1099.99 $200 off MSRP Act now if... Read more
Apple refurbished clearance 15-inch Retina Ma...
Apple has Certified Refurbished 2014 15″ 2.2GHz Retina MacBook Pros available for $1609, $390 off original MSRP. Apple’s one-year warranty is included, and shipping is free. They have refurbished 15... Read more
27-inch 5K iMacs on sale for up to $150 off M...
B&H Photo has 27″ 5K iMacs on sale for up to $150 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2199 $100 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1849.99 $150... Read more
What Does The Refreshed 12-Inch MacBook Tell...
A lot of commentators are complaining that Apple’s update of the 12-Inch MacBook last week is a bit of a damp squib. I don’t know what they were expecting, since it would be very unlike Apple to do a... Read more
Free Wittify Keyboard Now Available On The Ap...
A team of Harvard Business School students have announced that the Wittify Keyboard, a new app utility for iOS devices, is now available on the Apple App Store. The Wittify keyboard and application... Read more

Jobs Board

Automotive Sales Consultant - Apple Ford Linc...
…you. The best candidates are smart, technologically savvy and are customer focused. Apple Ford Lincoln Apple Valley is different, because: $30,000 annual salary 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* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 48260200 Phoenix, Arizona, United States Posted: Apr. 22, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Solutions Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
Simply Mac *Apple* Specialist- Service Repa...
Simply Mac is the largest premier retailer of Apple products in the nation. In order to support our growing customer base, we are currently looking for a driven Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.