TweetFollow Us on Twitter

HyperCard 2.0
Volume Number:6
Issue Number:11
Column Tag:XCMD Corner

HyperCard 2.0

By Donald Koscheka, MacTutor Contributing Editor

The Revolution

Thomas Jefferson once stated that “Revolution is that event which allows all ordinary events to continue”. Based on this definition, I’m inclined to feel that HyperCard 2.0 is a bit revolutionary. For the past 3 years, stack developers have expended a tremendous amount of energy trying to squeeze the last bit of performance from HyperCard.

This effort almost always leads to the development of some suite of XCMDs to supercharge an existing stack. As I watched this evolution develop, I noticed that XCMDs typically fall along a specific set of tasks. These include file I/O, interfacing to external devices, print management and window management (including dialogs). From the perspective of the XCMD programmer, the HyperCard 2.0 revolution is not at all subtle: HyperCard incorporates many features found previously only in XCMDs.

HyperCard 2.0 brings more to the party than new XCMD capability but in keeping with the spirit of this column, I will focus on what’s new in the XCMD world.

What’s New and What’s Not

Whenever you need to develop for a new version of any software package, you need to evaluate the scope of the update. You can perform this evaluation very quickly by asking yourself two questions: “What changed since the last version” and “What hasn’t changed since the last version?”

Armed with these two questions, the best place to find the answers is in the interface and library files in HyperCard 2.0. My version of HyperCard 2.0 came with just 3 files: HyperXCMD.p, HyperXCMD.h and HyperXlib.o. I was immediately surprised to find that XCMDGlue was missing from the distribution disk. At first I thought this was a mistake but a quick disassembly of HyperXLib.o showed this not to be the case; XCMDGlue is no longer needed, that function is now performed directly in the Callback Library.

So the first change is that we no longer need to compile our code with a glue routine. The interface code varies incrementally beyond this point (that is, they’ve ADDED stuff but all of the old stuff is still intact). For example, XCMDs are still called with the same parameter block record as in earlier versions of HyperCard with the exception that the the fields in the block take on special meaning for external windows. External windows adds a whole new dimension to HyperCard so look for a lot of discussion about them in future installments of this column.

The parameter block is not only used for interfacing between the calling script and the XCMD but also for interfacing between the XCMD and the HyperCard callbacks. The callback engine has been increased to over 75 callbacks (I counted two callbacks that appear in the library but are not documented as of this writing). The new callbacks can be divided into groups according to the class of services they perform: Hypertalk utilities, Memory Utilities, String Utilities, String Conversions, field utilities, miscellaneous utilities, Creating and disposing windows, window utilities, text edit utilities, script editor utilities, debugging tools. The categories are Apple’s, not mine. I will use this list to set the agenda for this column for the next several months. We will look at each of these categories in detail in turn.

One of the most salient additions to XCMDs in HyperCard 2.0 is the addition of “version control” information. From now, whenever the user passes ! as the first parameter to an xcmd, you need to return the version of that XCMD. if the user types passes ? as the first parameter, you should pass usage information to the user. This is straightforward and simple enough to abide by. Funny how those darned “command lines” have a habit of appearing in the most unusual of places. With this in mind, we will start at the beginning again, introducing “Simple XCMD 2.0.c” with this new twist. This is the building block for all 2.0 XCMDs and you can use it as a sort of template. A controversy will no doubt arise over the hard coding of strings in the XCMD code resource, but without a lot of thought, I think that you can convince yourself that there isn’t a better way to do this.

An XCMD For 2.0

While we haven’t answered both questions in great detail on this pass, we have learned enough to jump right into trying our hand at an XCMD for 2.0. We learned that the interface is pretty much unchanged and that old XCMD should work fine under 2.0 although they won’t be able to take advantage of 2.0’s features. Most importantly, we learned that this isn’t a complete restart; we can easily build on existing experience as we migrate our code to 2.0. This is good -- nobody likes to spend 3 years doing anything just to discover on such and such a date that everything they know is wrong!

Listing 1 is a sample HyperCard 2.0 XCMD. It is quite straightforward since it doesn’t actually do anything. I am taking the introduction of HyperCard 2.0 as a rare opportunity to “wipe the slate clean” and start all over again with a fresh look at XCMDs. Since this is the first of many columns in which I will discuss 2.0, I have decided to start off slow and sure and build from here. Listing 1 conforms to the structure of a 2.0 XCMD without relying on the new XCMD glue. If you don’t have 2.0 yet, you can build and test this XCMD under earlier versions of HyperCard until you get version 2.0. I did this to allow those of you who want to follow along with this column to get caught up first. I will start in earnest on 2.0 next month. Until then, Happy Hacking!

/**********************************/
/* File: Sample.c*/
/* */
/* A sample XCMD for Hypercard*/
/* 2.0  */
/* */
/* Well-behaved XCMDs for HC2.0  */
/* will respond to the ! and ?*/
/* requests by returning version */
/* and usage information  */
/* respectively. */
/* */
/* ----------------------------  */
/* ©1990, Donald Koscheka */
/* All Rights Reserved    */
/**********************************/

/*
 Project:

 ANSI-A4-- standard “C” libraries assembled
 off of register A4
 
 MacTraps
 Sample2.0.c (contents of listing 1)

 Set Project Type:
 Type == XCMD | XFCN
 Name == SimpleXCMD
 id == 1000
 
 Usage
 
 SimpleXCMD “?”
 SimpleXCMD “!”
 put the result
 
 OR
 
 Put simpleXCMD( “?” )
 Put simpleXCMD( “!” )
*/

#include<SetUpA4.h>
#include<string.h>
#include<HyperXCMD.h>
 
#ifndef NIL
 #define NIL(void *)0L
#endif

Handle  strToParam( str )
 char *str;
/***************************
* Given a pointer to a string,
* copy that string into a handle
* and return the handle.
*
* The input and output strings
* are both null-terminated
*
***************************/
{
 Handle outH = NIL;
 long len = 0;
 
 len = strlen( str );
 if( len )
 if( outH = NewHandle( len ) )
 BlockMove( str, *outH, len + 1 );
 
 return( outH );
}

pascal void main( paramPtr )
 XCmdPtrparamPtr;
{
 Handle answer = NIL;
 char *str;
 long len;
 
 paramPtr->returnValue = NIL;

 /** The first thing that a well-behaved           **/
 /** HC2.0 XCMD should do is check to see    **/
 /** whether the first (and only) parameter  **/
 /** is the user request for information or  **/
 /** or usage information.  If so, just pass **/
 /** your answer back to the user, otherwise **/
 /** go ahead and perform your xcmd services **/
 
 if (paramPtr->paramCount == 1){
 if ( **(paramPtr->params[0]) == ‘!’ ){
 paramPtr->returnValue = strToParam(“Simple XCMD, version 1.0, ©Donald 
Koscheka, 1990”);
 return;
 }
 
 if ( **(paramPtr->params[0]) == ‘?’ ){
 paramPtr->returnValue = strToParam(“Simple takes no parameters and does 
nothing with them.”);
 return;
 }
 }
}

Listing 1. SimpleXCMD.c

 
AAPL
$100.96
Apple Inc.
-0.83
MSFT
$47.52
Microsoft Corpora
+0.84
GOOG
$596.08
Google Inc.
+6.81

MacTech Search:
Community Search:

Software Updates via MacUpdate

Chromium 37.0.2062.122 - 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. FreeSMUG-Free OpenSource Mac User Group build is... Read more
Attachment Tamer 3.1.14b9 - Take control...
Attachment Tamer gives you control over attachment handling in Apple Mail. It fixes the most annoying Apple Mail flaws, ensures compatibility with other email software, and allows you to set up how... Read more
Duplicate Annihilator 5.0 - Find and del...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator detects... Read more
jAlbum Pro 12.2 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more
jAlbum 12.2 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results Simply drag and drop photos into groups, choose a design... Read more
Quicken 2015 2.0.4 - 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
iMazing 1.0 - Complete iOS device manage...
iMazing (formerly 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... Read more
Xcode 6.0.1 - Integrated development env...
Apple Xcode is Apple Computer's integrated development environment (IDE) for OS X. The full Xcode package is free to ADC members and includes all the tools you need to create, debug, and optimize... Read more
Apple Safari 7.1 - Apple's Web brow...
Apple Safari in OS X Mavericks brings you all-new ways to find and enjoy the best of the web. It works with iCloud to give you a seamless browsing experience across all your devices. It looks out for... Read more
Delivery Status 6.1.2 - Check delivery s...
Delivery Status displays delivery status of packages for a variety of shipment services. Can't wait for your packages to arrive? Don't waste your time checking the site constantly, just open this all... Read more

Latest Forum Discussions

See All

Avenged Sevenfold’s Hail To The King: De...
Avenged Sevenfold’s Hail To The King: Deathbat is Coming to iOS on October 16th Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Just in time for Halloween, on October 16 Avenged Sevenfold will be launching | Read more »
Talisman Has Gone Universal – Can Now be...
Talisman Has Gone Universal – Can Now be Played on the iPhone Posted by Jessica Fisher on September 19th, 2014 [ permalink ] | Read more »
Tap Army Review
Tap Army Review By Jennifer Allen on September 19th, 2014 Our Rating: :: SHOOT EM ALLUniversal App - Designed for iPhone and iPad Mindless but fun, Tap Army is a lane-based shooter that should help you relieve some stress.   | Read more »
Monsters! Volcanoes! Loot! Epic Island f...
Monsters! Volcanoes! Loot! | Read more »
Plunder Pirates: Tips, Tricks, Strategie...
Ahoy There, Seadogs: Interested in knowing our thoughts on all this plundering and pirating? Check out our Plunder Pirates Review! Have you just downloaded the rather enjoyable pirate-em-up Plunder Pirates and are in need of some assistance? Never... | Read more »
Goat Simulator Review
Goat Simulator Review By Lee Hamlet on September 19th, 2014 Our Rating: :: THE GRUFFEST OF BILLY GOATSUniversal App - Designed for iPhone and iPad Unleash chaos as a grumpy goat in this humorous but short-lived casual game.   | Read more »
A New and Improved Wunderlist is Here fo...
A New and Improved Wunderlist is Here for iOS 8 Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Evernote Update for iOS 8 Adds Web Clipp...
Evernote Update for iOS 8 Adds Web Clipping, Quick Notes, and More Posted by Ellis Spice on September 19th, 2014 [ permalink ] | Read more »
Apple Names Ultimate Productivity Bundl...
Apple Names Ultimate Productivity Bundle by Readdle as the Essential Bundle on the App Store Posted by Jessica Fisher on September 19th, 2014 [ permalink | Read more »
SpeedyPups Review
SpeedyPups Review By Jennifer Allen on September 19th, 2014 Our Rating: :: NEAR MISSiPhone App - Designed for the iPhone, compatible with the iPad Despite the Sonic the Hegehog undertones, SpeedyPups isn’t quite a success. But it... | Read more »

Price Scanner via MacPrices.net

Mac Pros available for up to $260 off MSRP
Adorama has Mac Pros on sale for up to $260 off MSRP. Shipping is free, and Adorama charges sales tax in NY & NJ only: - 4-core Mac Pro: $2839.99, $160 off MSRP - 6-core Mac Pro: $3739.99, $260... Read more
13-inch 2.6GHz/256GB Retina MacBook Pros avai...
B&H Photo has the 13″ 2.6GHz/256GB Retina MacBook Pro on sale for $1379 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Read more
Previous-generation 15-inch 2.0GHz Retina Mac...
B&H Photo has leftover previous-generation 15″ 2.0GHz Retina MacBook Pros now available for $1599 including free shipping plus NY sales tax only. Their price is $400 off original MSRP. B&H... Read more
21″ 2.7GHz iMac available for $1179, save $12...
Adorama has 21″ 2.7GHz Hawell iMacs on sale for $1179.99 including free shipping. Their price is $120 off MSRP. NY and NJ sales tax only. Read more
iOS 8 Adoption Rate Slower than iOS 7, 6, Hit...
Apple began pushing out iOS 8 updates to eligible devices around 1pm ET on September 17, 2014. However, unlike with iOS 7, which boasted a wide variety of differences from its predecessor iOS 6, in... Read more
LIkely Final Definitive OS X 10.9.5 Mavericks...
Apple has released what will almost certainly be the last incremental version number update of OS X 10.9 Mavericks (save for futire security updates) before OS X 10.10 Yosemite is released next month... Read more
Fingerprints, Apple Pay and Identity Theft Wa...
On Sep 9th, CEO Tim Cook unveiled Apple Pay, along with the new iPhone 6 and iWatch. Apple Pay is a newly developed technology that utilizes a near field communication (NFC) to enable customer... Read more
Amazon Introduces Two All-New Kindles
Amazon on Thursday introduced the 7th generation of its Kindle dedicated e-reader device: Kindle Voyage, its top-of-the-line e-reader, and the new $79 Kindle, with a 20% faster processor, twice the... Read more
Save up to $300 on the price of a new Mac wit...
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
13-inch 2.8GHz Retina MacBook Pro available f...
B&H Photo has the new 2014 13″ 2.8GHz Retina MacBook Pro on sale for $1699.99 including free shipping plus NY sales tax only. They’ll also include free copies of Parallels Desktop and LoJack for... Read more

Jobs Board

Project Manager, *Apple* Financial Services...
**Job Summary** Apple Financial Services (AFS) offers consumers, businesses and educational institutions ways to finance Apple purchases. We work with national and 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* 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
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.