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

Apple Pro Video Formats 2.0.1 - Updates...
Apple Pro Video Formats brings updates to Apple's professional-level codes for Final Cut Pro X, Motion 5, and Compressor 4. Version 2.0.1: Support for the following professional video codecs Apple... Read more
Maya 2015 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more
EtreCheck 2.2 - For troubleshooting your...
EtreCheck is a simple little app to display the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support... Read more
OmniOutliner Pro 4.2 - Pro version of th...
OmniOutliner Pro is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
VLC Media Player 2.2.1 - Popular multime...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more
Nisus Writer Pro 2.1.1 - Multilingual wo...
Nisus Writer Pro is a powerful multilingual word processor, similar to its entry level products, but brings new features such as table of contents, indexing, bookmarks, widow and orphan control,... Read more
Tinderbox 6.2.0 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
OmniOutliner 4.2 - Organize your ideas,...
OmniOutliner is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
calibre 2.25.0 - Complete e-library mana...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
Things 2.5.4 - 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

Watch This Homerun is Batting for the Ap...
Eyes Wide Games' Watch This Homerun is purportedly the first sports game coming to the Apple Watch, where you'll be up to bat as the pitcher tries to out-manuever you with fastballs, curveballs, and changeups. Using one-touch controls you can try to... | Read more »
Field Trip Can Take You on a Guided Tour...
Field Trip, by Google’s Niantic Labs, is an exploration app that gives you details about the awesome places you can discover wherever you find yourself. The app can show you local history, delicious restraunts, the best places to shop, and places to... | Read more »
Watch Your Six - SPY_WATCH is Infiltrati...
SPY_WATCH, by Bossa Studios, is a new game designed for the Apple Watch. Runmor has it your spy agency has fallen out of favor. To save it, you'll need to train-up a spy and send them on missions to earn you a stunningly suspicious reputation and... | Read more »
Both Halo: Spartan Assault and Halo: Spa...
Halo: Spartan Assault and Halo: Spartan Strike, by Microsoft, have officially landed on the App Store. Spartan Assault pits you against the Covenant with missions geared to tell the story of the origin of Spartan Ops. In Spartan Strike you'll delve... | Read more »
The Apple Watch Could Revolutionize the...
It’s not here yet but there’s that developing sneaky feeling that the Apple Watch, despite its price tag and low battery life, might yet change quite a lot about how we conduct our lives. While I don’t think it’s going to be an overnight... | Read more »
Mad Skills Motocross 2 Version 2.0 is He...
Mad Skills Motocross 2 fans got some good news this week as Turborilla has given the game its biggest update yet. Now you'll have access to Versus mode where you can compete against your friends in timed challenges. Turborilla has implemented a... | Read more »
Kids Can Practice Healthy Living With Gr...
Bobaka is releasing a new interactive book called Green Riding Hood  in May. The app teaches kids about yoga and organic style of life through mini-games and a fun take on the classic Little Red Riding Hood fairy tale. | Read more »
Chainsaw Warrior: Lords of the Night has...
It's time to put the Darkness back in its place now that Chainsaw Warrior: Lords of the Night has officially made it to iOS. | Read more »
A World of Ice and Fire Lets You Stalk 2...
George R. R. Martin’s A World of Ice and Fire, by Random House, is a mobile guide to the epic series. The new update gives you the Journeys map feture that will let you track the movements of 25 different characters. But don't worry, you can protect... | Read more »
Gameloft Announces Battle Odyssey, a New...
Battle Odyssey, Gameloft's newest puzzle RPG, is coming to the App Store next week. Set in the world of Pondera, you will need to control the power of the elements to defend the world from evil. You'll be able to entlist over 500 allies to aid you... | Read more »

Price Scanner via MacPrices.net

Sale! 15-inch Retina MacBook Pros for up to $...
 MacMall has 15″ Retina MacBook Pros on sale for up to $255 off MSRP. Shipping is free: - 15″ 2.2GHz Retina MacBook Pro: $1794.99 save $205 - 15″ 2.5GHz Retina MacBook Pro: $2244.99 save $255 Adorama... Read more
New 2015 MacBook Airs on sale for up to $75 o...
Save up to $75 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
Clearance 13-inch Retina MacBook Pros availab...
B&H Photo has leftover 2014 13″ Retina MacBook Pros on sale for up to $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.6GHz/128GB Retina MacBook Pro: $1129... Read more
Clearance 2014 MacBook Airs available startin...
B&H Photo has clearance 2014 MacBook Airs available for up to $200 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 11″ 128GB MacBook Air: $729 $170 off original MSRP... Read more
16GB iPad mini 3 on sale for $349, save $50
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $349 including free shipping plus NY sales tax only. Their price is $50 off MSRP, and it’s the lowest price available for this model. Read more
Mac minis on sale for up to $75 off, starting...
MacMall has Mac minis on sale for up to $75 off MSRP including free shipping. Their prices are the lowest available for these models from any reseller: - 1.4GHz Mac mini: $459.99 $40 off - 2.6GHz Mac... Read more
Taichi Temple First Tai Chi Motion Sensor App...
Zhen Wu LLC has announced the official launch of Taichi Temple 1.0, the first motion sensor app for Tai Chi, offering a revolutionary new way to de-compress, relax and exercise all at the same time.... Read more
CleanExit – Erase your Hard Drive Quickly, Se...
CleanExit works on both Macs and PCs, securely and permanently deleting all files from any type of hard drive, flash-based drive or camera media card making the files permanently unrecoverable.... Read more
250 iPhone 6 Tips eBook Released for $1.99
Bournemouth, UK based iOS Guides has released 250 iPhone 6 Tips, a new eBook available in the iBookstore that reveals a wealth of tips and tutorials for iPhone 6 and iPhone 6 Plus. Priced at $1.99,... Read more
TigerText Introduces First Secure Enterprise...
TigerText, a provider of secure, real-time messaging for the enterprise, has announced the launch of TigerText for the Apple Watch. TigerText for the Apple Watch enables users to securely send and... Read more

Jobs Board

*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
DevOps Software Engineer - *Apple* Pay, iOS...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Pay - Site Reliability Engineer - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.