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

SyncTwoFolders 2.0.9b1 - Syncs two user-...
SyncTwoFolders simply synchronizes two folders. It supports synchronization across mounted network drives and it is a possibility to run a simulation showing in a log what will be done. Please visit... Read more
VueScan 9.5.09 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Airmail 2.1 - Powerful, minimal email cl...
Airmail 2 is a new mail client designed for OS X 10.10 Yosemite with fast performance and intuitive interaction. Support for iCloud, MS Exchange, Gmail, Google Apps, IMAP, POP3, Yahoo!, AOL, Outlook.... Read more
Logitech Control Center 3.9.2 - Keyboard...
Logitech Control Center (LCC) is designed to support OS X and allows you to take full advantage of your Logitech keyboard, mouse, or trackball. With the LCC you can: Browse the Internet using... Read more
Adobe Acrobat Pro 15.007.20033 - Powerfu...
Acrobat Pro DC is available only as a part of Adobe Creative Cloud, and can only be installed and/or updated through Adobe's Creative Cloud app. Adobe Acrobat Pro DC with Adobe Document Cloud... Read more
CleanMyMac 3.0.1 - Delete files that was...
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
Evernote 6.0.10 - Create searchable note...
Evernote allows you to easily capture information in any environment using whatever device or platform you find most convenient, and makes this information accessible and searchable at anytime, from... Read more
CleanApp 5.0.1 - Application deinstaller...
CleanApp is an application deinstaller and archiver.... Your hard drive gets fuller day by day, but do you know why? CleanApp 5 provides you with insights how to reclaim disk space. There are... Read more
Quicken 2015 2.5.0 - Complete personal f...
Quicken 2015 helps you manage all your personal finances in one place, so you can see where you're spending and where you can save. Quicken automatically categorizes your financial transactions,... Read more
Tonality Pro 1.1.4 - Professional-grade...
Tonality Pro gives you the power to create stunning and dramatic black & white images. This is a complete monochrome image editor with more than 150 one-click style presets, totally unique... Read more

Grim Fandango Remastered (Games)
Grim Fandango Remastered 1.0.0 Device: iOS iPhone Category: Games Price: $9.99, Version: 1.0.0 (iTunes) Description: | Read more »
This Week at 148Apps: April 27-May 1, 20...
May Merriment at 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out above... | Read more »
The Ensign, Prequel to A Dark Room, is C...
Amirali Rajan's The Ensign is the prequel to the text-based adventure A Dark Room, and it's gone free for a couple of days. [Read more] | Read more »
Streamline - calendar (Productivity)
Streamline - calendar 1.0 Device: iOS iPhone Category: Productivity Price: $3.99, Version: 1.0 (iTunes) Description: Do you dare to break conventions? Streamline is the first real evolution from the paper diary. It is a patented and... | Read more »
Plants vs. Zombies Celebrates its Sixth...
It's pretty wild to think that the  Plants vs. Zombies  series has been around for six years already. To celebrate this mildly unconventional milestone, Popcap is giving players some free stuff in Plants vs. Zombies 2. Because they got the whole "... | Read more »
Dropbox Adds MS Office Documents and Mor...
Dropbox, the popular file storage solution, has announced an update that adds three new features for you to enjoy. [Read more] | Read more »
The All-Consuming Snake is Back and Hung...
Taneli Armanto, the designer of Nokia 6110 Snake, is back to work. Together with Rumilus Design, he's working on a new Snake game titled Snake Rewind. [Read more] | Read more »
WAVE Personal Calendar Now Connects You...
WAVE Calendar, by e-sites, has added an interesting new feature: real life personal assistants. The e-sites webpage has been redesigned so personal assistants can apply to work directly with WAVE. [Read more] | Read more »
Find Your Vacation Home With Dwellable
Dwellable is a new travel app that helps you to find rental homes for your vacation, allowing you to swipe your way through listings from over 15,000 destinations worldwide. [Read more] | Read more »
Play Endless Golf in Flick Golf Free...
Full Fat has released a new update for Flick Golf! Free. The ‘Eliminator’ update brings a whole new way to play with its endless round. [Read more] | Read more »

Price Scanner via MacPrices.net

Millennials’ Social Networking Habits Pose T...
Research indicates young people may be threat to corporate information-security, says tech expert Karl Volkmann, Chief Technical Officer of Chicago-based SRV Network, Inc. From Facebook to Twitter,... Read more
BuyVia Releases Apple Watch Shopping App
San Mateo, California-based BuyVia (http://www.buyvia.com), the first website and mobile app that combines in-store and online shopping across smart phones, tablets and laptops to help shoppers get... Read more
Apple Certified Refurbished iMacs available f...
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $2119 $... Read more
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.... Read more
New 2015 MacBook Airs on sale for up to $80 o...
Save up to $80 on the purchase of a new 2015 13″ or 11″ 1.6GHz MacBook Air at the following resellers. Shipping is free with each model: 11" 128GB MSRP $899 11" 256GB... Read more
College Student Deals: Additional $50 off Mac...
Take an additional $50 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through May 9, 2015. Anyone with a valid .EDU email address can take advantage of... Read more
Save up to $300 on a new Mac, $30 on an iPad,...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
iPad-Based iLynn Program Provides A Private U...
Lynn University of Boca Raton, Florida has announced that its innovative iPad-powered online bachelor’s degree program will be called iLynn. Beginning in fall 2015, Lynn U. says the new program will... Read more
iPad mini 4 Rumors Begin To Gel
First, I’ve been really hoping there will even be an iPad mini 4 at all. The smallest iPad has reportedly been hit pretty hard by iPhone 6 Plus cannibalization, along with getting caught in the... Read more
Mac Pros on sale for up to $260 off MSRP
B&H Photo has Mac Pros on sale for up to $260 off MSRP. Shipping is free, and B&H charges sales tax in NY only: - 3.7GHz 4-core Mac Pro: $2799, $200 off MSRP - 3.5GHz 6-core Mac Pro: $3719.99... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Senior Identity Architect - *Apple* Pay - A...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
Hardware Systems Integration Engineer - *App...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
Senior Identity Architect - *Apple* Pay - A...
Changing the world is all in a day039s work at Apple . If you love innovation, here039s your chance to make a career of it. You039ll work hard. But the job comes with Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.