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 win big in Slots Deluxe
Cheating while gambling is illegal and morally wrong, and in some parts of the world it leads to men with names like Vinnie "Six Knuckles" Manchenzo beating you to a pulp in a dark alley. [Read more] | Read more »
How to take over the world in Dictator 2
Running a country isn't easy - especially when you're a dictator who wants to take over the world and crush everyone in your path while you do it. [Read more] | Read more »
Tips and tricks to get a higher score in...
Tank.iois - you guessed it! - another multiplayer arena battler likeAgar.io and Slither.io. It does differentiate itself by putting you in a tiny tank though, so it's not exactly the same. To help you get that all-important high score, we've got a... | Read more »
How to unlock characters in One Tap Tenn...
As the title suggests, One Tap Tennis requires only a single tap to play its particular brand of tennis, and rewards you with a ton of unlockable characters if you perform well. Fortunately for you, we at 148Apps have got a few tips and tricks to... | Read more »
Grab it now: Game Craft’s Legend of War...
The real time strategy game is now available for you to sink your teeth into, through the App Store and Google Play. Combining elements of skill, strategy and empire building, Legend of War is a real gamers’ game. [Read more] | Read more »
Skateboard Party 3 ft. Greg Lutzka (Gam...
Skateboard Party 3 ft. Greg Lutzka 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Skateboard Party is back! This third edition of the popular sports franchise features professional skater... | Read more »
Cubious (Games)
Cubious 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: Cubious – How smart are you? How high is your IQube? Solve the impossible puzzles to find out, and help a lost little cube find his... | Read more »
Goat Simulator Waste of Space (Games)
Goat Simulator Waste of Space 1.1 Device: iOS Universal Category: Games Price: $4.99, Version: 1.1 (iTunes) Description: ** IMPORTANT - SUPPORTED DEVICESiPhone 4S, iPad 2, iPod Touch 5 or better.** | Read more »
Wildfulness - Unwind in nature and calm...
Wildfulness - Unwind in nature and calm your mind with nature sounds and illustrations 1.0 Device: iOS Universal Category: Healthcare & Fitness Price: $1.99, Version: 1.0 (iTunes) Description: Spending time in nature helps you to... | Read more »
Dr. Panda Racers (Education)
Dr. Panda Racers 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: STEP ON THE GAS, RACE AND WIN!Fasten your seat belts and get ready to race! Speed your way to the finish line while doing... | Read more »

Price Scanner via MacPrices.net

Enterprise Workers Pick Technology Over Perks...
New Adobe study shows surprising attitudes about office jobs and where the future of work is heading. Adobe has released survey findings revealing that a surprising 70 percent of U.S. office workers... Read more
Goal Zero and OtterBox Partner to Expand iPh...
Goal Zero, specialists in portable power, have announced a partnership with OtterBox, brand smartphone case protection, to offer the Slide and Slide Plus Batteries as modules compatible with the new... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has 15″ Retina MacBook Pros on sale for up to $210 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off MSRP - 15″ 2.5GHz Retina... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $799... Read more
Apple refurbished Apple TVs available for up...
Apple has Certified Refurbished 32GB and 64GB Apple TVs available for up to $30 off the cost of new models. Apple’s standard one-year warranty is included with each model, and shipping is free: -... Read more
21-inch iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ iMacs on sale for up to $120 off MSRP including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1379.99 $120 off MSRP - 21″ 2.8GHz iMac: $1189 $110 off MSRP - 21″ 1... Read more
Kanex Introduces GoPower USB-C Rechargeable B...
Kanex has announced its GoPower USB-C portable battery for the USB-C MacBook, featuring the new industry standard connector and cable used for connectivity and power. Providing users with a new... Read more
Convertible and Detachable Devices Winning Ov...
According to the latest figures published by International Data Corporation (IDC), Western European shipments of ultraslim convertibles and detachables posted positive growth (44.7%) to account for... Read more
New MacBook Pros And Will MacBook Air Be Upgr...
With my mid-2013 13-inch MacBook Air closing on its third anniversary come November, I’m in system upgrade mode. Actually the Haswell CPU equipped Air is still doing a fine job, but my good wife is... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free, and... Read more

Jobs Board

*Apple* Project Engineer - Smart Source Inc...
SmartSource is in need of an Apple Project Engineer for a 12 month contract opportunity in Pittsburg, PA. Role: Apple Project Engineer Location: Pittsburg, PA Read more
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
Service Assistant - *Apple* Chevrolet *App...
Apple Automotive is one of the fastest growing dealer...and it shows. Consider making the switch to the Apple Automotive Group today! At Apple Automotive, we Read more
Editor, *Apple* News - APPLE (United States...
Job Summary The Apple News team is looking for a passionate and knowledgeable editor with experience covering entertainment/pop culture and experience running social Read more
*Apple* Nissan Service Technicians - Apple A...
Apple Automotive is one of the fastest growing dealer...and it shows. Consider making the switch to the Apple Automotive Group today! At Apple Automotive , Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.