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 :-)” ]

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

iClock Pro 3.8 - Customize your menubar...
iClock Pro is a menu-bar replacement for Apple's default clock. iClock Pro is an update, total rewrite, and improvement to the popular iClock. Have the day, date, and time in different fonts and... Read more
VirtualBox 5.2.0 - x86 virtualization so...
VirtualBox is a family of powerful x86 virtualization products for enterprise as well as home use. Not only is VirtualBox an extremely feature rich, high performance product for enterprise customers... Read more
Dropbox 37.4.29 - 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
Google Chrome 62.0.3202.62 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
Chromium 62.0.3202.62 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 62.0.3202.62: High CVE-2017-5124: UXSS with... Read more
Fantastical 2.4.3 - Create calendar even...
Fantastical 2 is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event... Read more
Things 3.2.1 - Elegant personal task man...
Things is a task management solution that helps to organize your tasks in an elegant and intuitive way. Things combines powerful features with simplicity through the use of tags and its intelligent... Read more
A Better Finder Attributes 6.06 - Change...
A Better Finder Attributes is the ultimate file-tweaking tool for OS X. It combines photo-shooting date and file date changing along with a few unique tricks of its own. Change EXIF Timestamps at... Read more
MacCleanse 6.0.5 - $29.95
MacCleanse is the product of thousands of hours of intense research and development. It meticulously scans all of the nooks and crannies of a computer for unnecessary junk that can take up huge... Read more
Smultron 10.0.2 - Easy-to-use, powerful...
Smultron 10 is an elegant and powerful text editor that is easy to use. You can use Smultron 10 to create or edit any text document. Everything from a web page, a note or a script to any single piece... Read more

4 of the best Halloween updates for mobi...
Halloween is certainly one of our favorite times for mobile game updates. Many popular titles celebrate this spooky season with fun festivities that can stretch from one week to even the whole month. As we draw closer and closer to Halloween, we'... | Read more »
Fire Rides guide - how to swing to succe...
It's another day, which means another Voodoo game has come to glue our hands to our mobile phones. Yes, it's been an especially prolific month for this particular mobile publisher, but we're certainly not complaining. Fire Rides is yet another... | Read more »
Time Recoil (Games)
Time Recoil 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: Time Recoil is a top-down shooter where you kill to slow time, dominate slow motion gunfights, and trigger devastating special... | Read more »
Campfire Cooking (Games)
Campfire Cooking 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Returner 77 (Games)
Returner 77 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Returner 77 is a cinematic space mystery puzzle game. You are in a giant alien spaceship hovering above Earth, after everything... | Read more »
Dune! guide - how to toe the line and ge...
Publisher Voodoo is at it again with an all new high score chaser -- Dune! In this fast-paced arcade game, you have to propel yourself along sand dunes, gaining enough momentum to jump above the line to score points, while making sure you have... | Read more »
The best deals on the App Store this wee...
Happy Tuesday, dear readers. Your favorite part of the week as officially arrived. It's time to take a look at the best deals in games. Things are admittedly a bit sparse, but there are a few diamonds in the rough to see you through if you're... | Read more »
Be the last person standing in Legacy of...
Yoozoo Games’ popular action MMO Legacy of Discord is getting a huge new update to celebrate its first anniversary. Perhaps the biggest change is the addition of an exciting survival mode titled Last Guardian. This new survival mode will pit you... | Read more »
Home Street guide - how to make friends...
From the creators of Food Street comes Home Street, a new simulation game that tasks you with building a social network and designing a beautiful home. It's a bit like The Sims, but you won't have to worry about the daily chores involved (feeding,... | Read more »
Color Ballz guide - how to bounce to the...
Color Ballz is an addictive new arcade title from Ketchapp Studios. It takes old school mechanics from games like Brickles and puts a fun twist on it. Your job? To catch balls with a paddle and send them back into a chute to be carried back to... | Read more »

Price Scanner via MacPrices.net

13″ MacBook Pros on sale for up to $120 off M...
B&H Photo has 2017 13″ MacBook Pros in stock today and on sale for up to $120 off MSRP, each including free shipping plus NY & NJ sales tax only: – 13-inch 2.3GHz/128GB Space Gray MacBook... Read more
15″ MacBook Pros on sale for up to $200 off M...
B&H Photo has 15″ MacBook Pros on sale for up to $200 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only: – 15″ 2.8GHz MacBook Pro Space Gray (MPTR2LL/A): $2249, $150... Read more
Roundup of Apple Certified Refurbished iMacs,...
Apple has a full line of Certified Refurbished 2017 21″ and 27″ iMacs available starting at $1019 and ranging up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is free... Read more
Sale! 27″ 3.8GHz 5K iMac for $2098, save $201...
Amazon has the 27″ 3.8GHz 5K iMac (MNED2LL/A) on sale today for $2098 including free shipping. Their price is $201 off MSRP, and it’s the lowest price available for this model (Apple’s $1949... Read more
Sale! 10″ Apple WiFi iPad Pros for up to $100...
B&H Photo has 10.5″ WiFi iPad Pros in stock today and on sale for $50-$100 off MSRP. Each iPad includes free shipping, and B&H charges sales tax in NY & NJ only: – 10.5″ 64GB iPad Pro: $... Read more
Apple iMacs on sale for up to $130 off MSRP w...
B&H Photo has 21-inch and 27-inch iMacs in stock and on sale for up to $130 off MSRP including free shipping. B&H charges sales tax in NY & NJ only: – 27″ 3.8GHz iMac (MNED2LL/A): $2179 $... Read more
2017 3.5GHz 6-Core Mac Pro on sale for $2799,...
B&H Photo has the 2017 3.5GHz 6-Core Mac Pro (MD878LL/A) on sale today for $2799 including free shipping plus NY & NJ sales tax only . Their price is $200 off MSRP. Read more
12″ 1.2GHz Space Gray MacBook on sale for $11...
Amazon has the 2017 12″ 1.2GHz Space Gray Retina MacBook on sale for $100 off MSRP. Shipping is free: 12″ 1.2GHz Space Gray MacBook: $1199.99 $100 off MSRP Read more
Bare Bones Software Releases macOS High Sierr...
Bare Bones Software has announced the release and immediate availability of BBEdit 12.0, a significant upgrade to its professional strength text and code editor. BBEdit 12 introduces a new foundation... Read more
Yale Announces Availability of Apple HomeKit-...
Yale Locks & Hardware has announced that Apple HomeKit support for its Assure Lock family is available this month. The new Yale iM1 Network Module, which provides support for the Apple Home app... Read more

Jobs Board

*Apple* News Product Marketing Mgr., Publish...
Job Summary The Apple News Product Marketing Manager will work closely with a cross-functional group to assist in defining and marketing new features and services. Read more
Fraud Analyst, *Apple* Advertising Platform...
Job Summary Apple Ad Platforms has an opportunity to redefine advertising on mobile devices. Apple reaches hundreds of millions of iPhone, iPod touch, and iPad Read more
*Apple* Information Security - Security Data...
Job Summary This role is responsible for helping to strengthen Apple 's information security posture through the identification and curation of security event data. Read more
Lead *Apple* Solution Consultant - Apple In...
…develop a team of diverse partner employees focusing on excellence to deliver the Apple story. Even when you're not present, you will maintain a consistent influence Read more
watchOS Frameworks Engineering Manager, *App...
Job Summary Join the team that is shaping the future of software development for Apple Watch! Apple is looking for an exceptional software engineering leader to Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.