TweetFollow Us on Twitter

Apr 94 Tips
Volume Number:10
Issue Number:4
Column Tag:Tips & Tidbits

Tips & Tidbits

Edited by Scott Boyd, Editor

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Tip Of The Month

MPW C Navigation Time Saver

MPW has a nice feature for C programmers: Using the tool CMarker, you can make a list of marks for all the functions in a source file.

Unfortunately, when you open the Mark menu, you can wind up with something unusable. For example, the list could be so long that it takes too much time to find what you’re looking for. Moreover, you are often looking for a function because you are in a piece of code in which you see it being called. It’s right there in front of you. It would be nice to be able to use that piece of context to get you to the function itself.

The following MPW Shell statement sets up a function key which jumps to a function when you highlight its name and press control-enter (or any other key you wish).


/* 1 */
setkey control-enter 'find `catenate "{Active}".§`"{Active}"'

Be sure to get all of the quotes right. MPW cares about the different quotes. Reading from left-to-right, the quotes are straight-, back-, double-, double-, back-, double-, double-, and single-quotes. The § character is option-6.

- Manuel Carlos Alcoba

Informacion, Integracion, Inteligencia

Madrid, Spain

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.

INLINE ASSEMBLY IN PASCAL

Knowing how to write inline assembly within your pascal code can sometimes save you time and trouble. For example, I use an Inline routine that returns the current stack address for debugging purposes. The routine looks like this:

 
/* 2 */
INTERFACE
  FUNCTION GetStackTop: LongInt; INLINE
   $2E8F;
My code calls it just as if it were a regular function:
VAR
 stackAddress: LongInt;
...
stackAddress := GetStackTop;

When used properly, Inline assembly provides considerable speed improvements and allows you to enhance your Pascal code in ways not possible with straight Pascal.

Define your inline routines in the INTERFACE part of a file. In my example, the hexadecimal number $2E8F represents the instruction MOVE.L A7,(A7). The compiler places this instruction directly into the code. This reduces the number of instructions needed to write and compile this routine in assembly language and also avoids calling overhead for a function. No calling overhead simply means no JSR instructions are generated in the code. When I was learning how to write inline assembly, the biggest obstacle was lack of documentation on how to obtain the hexadecimal format (e.g. $2E8F) of assembly language instructions. You can laboriously try to compose the hexadecimal instruction from some 68000 assembly books, but this usually takes several minutes, is error prone, and requires that you know exactly what you are doing. There is a much easier way to obtain the hexadecimal format of any assembly language instruction, provided you have MPW assembler. This is what you need to do:

Suppose you want to find the hexadecimal format of the MOVE.L A7,(A7) instruction.

1) In MPW, create a new file called Example.a and enter the text:

/* 3 */
RoutineName PROC
 MOVE.L A7,(A7)
 END

2) Create a ‘.o’ file with the MPW ASM tool. In this case I call the file Example.a and the ASM tool creates an Example.a.o file:

/* 4 */
 Asm Example.a

3) Now disassemble the Example.a.o file with the dumpObj MPW tool. The dumpObj takes whatever is inside a compiled file and disassembles it back into assembly language instructions. In this case it disassembles the file Example.a.o into a file called Example.o.a:

/* 5 */
dumpobj 'Example.a.o' > 'Example.o.a'

4) The disassembled file contains the line

/* 6 */
00000000: 2E8F           '..'              MOVE.L     A7,(A7)

The second number on that line, “i.e. 2E8F”, is the hexadecimal format of the assembly instruction.

From now on, anytime you need a hexadecimal format of an instruction, just add the instruction to Example.a file and execute the ASM and dumpObj MPW tools. After you do this a couple of times you will realize this is a simple repetitious process. This usually takes less than a minute and is much easier and quicker than finding the instruction from a book.

- Marek Hajek

Champaign, Illinois

Another hex-for-opcode trick

Finding the hex for an instruction can be useful in a number of situations. One situation I’ve found myself in is sitting in Macsbug on a machine and needing to change a single instruction. For example, suppose Igot a branch condition backwards, and want to change the sense of the conditional branch from BLE to BGT. I’d like to change the instruction with a SM (set memory) Macsbug command, but first I have to figure out the value to set. I could guess (don’t laugh, I’ve done it before, and even got it right after just a few guesses on a couple of occasions), but a better way is to let someone do all the guessing (or table lookups) for me. The fastest tool I’ve found is TMONPro on some handy nearby machine. Here’s how:

1) Open up an assembly window. Set its address to PlayMem. That’s a chunk of memory that TMON sets aside when it loads. It’s there for you to play with.

2) Select the first line. It probably reads something like ORI.B #$00,D0. Regardless, select the whole line.

3) Now type in the instruction you want. It replaces the selection. Now press return or enter.

4) TMONPro assembles your instruction right then and there.

5) Open a memory window and point it at PlayMem. An easy way to do that is to command-click on PlayMem’s address over on the left-hand side of the assembly window. The memory window now shows the hex values for the instruction you just typed in.

Of course, you might also just use it on the machine you’re debugging. That’s even faster because now you can simply type over the line of assembly, press enter, and the code changes in place.

- Ned Flanders

Springfield

Playing a sound asynchronously and continuously

When allocating your channel, pass a callbackproc. When playing the sound using bufferCmd, immediately play a callbackCmd as well. Your callback will be called when there is about 50ms of sound left to play, and can queue a new bufferCmd in the same channel (even though it's at interrupt time).

- Jon W{tte

Sweden

[When asked about the { in his name, Jon replied :

“For reference, it's option-u a, or a-umlaut - ä. However, I'm trying to push the brace as the next character to be included in the Swedish naming character set :-)” ]

 
AAPL
$118.31
Apple Inc.
+0.71
MSFT
$47.46
Microsoft Corpora
-0.01
GOOG
$539.90
Google Inc.
-1.18

MacTech Search:
Community Search:

Software Updates via MacUpdate

RapidWeaver 6.0.3 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
iPhoto Library Manager 4.1.10 - Manage m...
iPhoto Library Manager lets you organize your photos into multiple iPhoto libraries. Separate your high school and college photos from your latest summer vacation pictures. Or keep some photo... Read more
iExplorer 3.5.1.9 - View and transfer al...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
MacUpdate Desktop 6.0.3 - Discover and i...
MacUpdate Desktop 6 brings seamless 1-click installs and version updates to your Mac. With a free MacUpdate account and MacUpdate Desktop 6, Mac users can now install almost any Mac app on macupdate.... Read more
SteerMouse 4.2.2 - Powerful third-party...
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
iMazing 1.1 - Complete iOS device manage...
iMazing (was DiskAid) is the ultimate iOS device manager with capabilities far beyond what iTunes offers. With iMazing and your iOS device (iPhone, iPad, or iPod), you can: Copy music to and from... Read more
PopChar X 7.0 - Floating window shows av...
PopChar X helps you get the most out of your font collection. With its crystal-clear interface, PopChar X provides a frustration-free way to access any font's special characters. Expanded... Read more
Carbon Copy Cloner 4.0.3 - Easy-to-use b...
Carbon Copy Cloner backups are better than ordinary backups. Suppose the unthinkable happens while you're under deadline to finish a project: your Mac is unresponsive and all you hear is an ominous,... Read more
ForeverSave 2.1.3 - Universal auto-save...
ForeverSave auto-saves all documents you're working on while simultaneously doing backup versioning in the background. Lost data can be quickly restored at any time. Losing data, caused by... Read more
Voila 3.8.1 - Capture, annotate, organiz...
Voila is a screen-capture, recording, and annotation tool that is a full-featured replacement for Mac's screen-capture and screen-recording capabilities. It has a large and robust set of editing,... Read more

Latest Forum Discussions

See All

Black Friday has Started Early – Lots an...
It’s almost turkey time! Which means lots and lots of food but also lots and lots of sales. Some sales have even started a few days early, which is why we’ve put together a list of iOS games that are currently discounted (sometimes by a lot).... | Read more »
Loose Leaf Review
Loose Leaf Review By Jennifer Allen on November 26th, 2014 Our Rating: :: SIMPLE SKETCHINGiPad Only App - Designed for the iPad Sketch out ideas with simple drawing tools, courtesy of Loose Leaf.   | Read more »
Screeny (Utilities)
Screeny 1.0 Device: iOS iPhone Category: Utilities Price: $.99, Version: 1.0 (iTunes) Description: Screeny is an utility app that helps you save space consumed by screenshots. It screens your camera roll and helps you to filter and... | Read more »
Tilt to Live Bundle Set to Arrive This T...
Tilt to Live Bundle Set to Arrive This Thanksgiving Posted by Ellis Spice on November 25th, 2014 [ permalink ] One Man Left has unveiled an upcoming Tilt to Live bundle, allowing players to get the series for a di | Read more »
BattleLore: Command (Entertainment)
BattleLore: Command 1.0 Device: iOS Universal Category: Entertainment Price: $9.99, Version: 1.0 (iTunes) Description: ***NOTE: Compatible with iPad 2/iPad mini, iPod touch 5 and up and iPhone 4S and up – WILL NOT RUN ON EARLIER... | Read more »
Weather Or Not Review
Weather Or Not Review By Jennifer Allen on November 25th, 2014 Our Rating: :: STYLISH WEATHER REPORTINGiPhone App - Designed for the iPhone, compatible with the iPad Check the weather quickly and conveniently with Weather or Not... | Read more »
The All-New Football Manager Handheld 20...
The All-New Football Manager Handheld 2015 is Available Now Posted by Jessica Fisher on November 25th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Six iOS Games to Get You Ready for Thank...
Image Source: Friends Wiki At this point in the month, you or at least a few people you know are probably getting ready to scramble around (or are already scrambling around) for Thanksgiving Dinner. It’s a hectic day of precise oven utilization, but... | Read more »
Call of Duty: Heroes: Tips, Tricks, and...
Hello Heroes: What’d we think of Call of Duty‘s take on Clash of Clans? Check out our Call of Duty: Heroes review to find out! Just downloaded Call of Duty: Heroes and need some handy tips and tricks on how to get ahead of the rest? As we often do,... | Read more »
Call of Duty: Heroes Review
Call of Duty: Heroes Review By Jennifer Allen on November 25th, 2014 Our Rating: :: CLASH OF FRANCHISESUniversal App - Designed for iPhone and iPad Mix Clash of Clans with Call of Duty, and this is what you get.   | Read more »

Price Scanner via MacPrices.net

Early Black Friday Mac Pro sale, 6-Core 3.5GH...
 B&H Photo has the 6-Core 3.5GHz Mac Pro on sale today for $3499 including free shipping plus NY sales tax. Their price is $500 off MSRP, and it’s the lowest price available for this model from... Read more
Early Black Friday sale price: 15-inch 2.2GHz...
 B&H Photo has the 2014 15″ 2.2GHz Retina MacBook Pro on sale today for $1699.99. Shipping is free, and B&H charges NY sales tax only. Their price is $300 off MSRP, equalling Best Buy’s price... Read more
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple Certified Refurbished 13″ 2.5GHz MacBook Pros available for $170 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz... Read more
Early Black Friday iPad mini 3 sale: $75 off...
 Best Buy has iPad mini 3s on sale for $75 off MSRP on their online store for a limited time. Choose free shipping or free local store pickup (if available). Sale prices available for online orders... Read more
Early Black Friday MacBook Pro sale: 15-inch...
 Best Buy has posted early Black Friday prices on 15″ Retina MacBook Pros, with models on sale for $300 off MSRP on their online store for a limited time. Choose free local store pickup (if available... Read more
A9 Chips Already?
It’s barely more than a couple of months since Apple got the first A8 systems-on-chip into consumer hands, but rumor and news focus is already turning to the next-generation A9 SoC. Apple Daily... Read more
NewerTech Announces NuGuard KXs Impact X-Orbi...
NewerTech has announced updates to its family of Impact X-Orbing Screen Armor bringing military grade, triple layer protection to Apple’s new iPhone 6 and 6 Plus. Like all models in the NuGuard KXs... Read more
13-inch 1.4GHz MacBook Air on sale for $889,...
 B&H Photo has the 13″ 1.4GHz/128GB MacBook Air on sale for $889 including free shipping plus NY tax only. Their price is $110 off MSRP. B&H will also include free copies of Parallels Desktop... Read more
Save up to $300 on Macs and iPads with your A...
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
Apple refurbished Mac Pros available for up t...
The Apple Store is offering Apple Certified Refurbished Mac Pros for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, 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
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.