TweetFollow Us on Twitter

CompileIt! 2.0
Volume Number:7
Issue Number:9
Column Tag:Tools of the Trade

CompileIt! 2.0!

By Dave Kelly, MacTutor Editorial Board

Most of you have seen Heizer Software’s CompileIt! 2.0 advertised. Let’s take a look at CompileIt! and what it can do for you. HyperCard is an easy going environment to work with. Because of that, HyperTalk has not been a favored language of developers. As you’ll see here, CompileIt! 2.0 overcomes nearly all of the objections to using HyperTalk as a serious development environment.

Objection #1: HyperTalk is too slow. You pay a price for convenience and ease of use. HyperTalk 1.2.x is an interpreted language. When messages are caught by a handler, the words in the handler script are turned into tokens that are interpreted by HyperCard. In HyperTalk 2.0, the handler scripts are turned into tokens and then compiled into machine language. Thus HyperCard 2.0 is faster once the handler scripts are compiled (memory permitting though since compiled handlers are purged to make room for new ones). Still, most of us don’t think that this is enough. With CompileIt! 2.0 you can boost the speed of most if not all of your handlers.

Objection #2: You can’t create a stand-alone application with HyperCard. CompileIt! doesn’t provide a solution for this problem, but there are other products appearing in the market that claim they can do this such as SuperCard which can save projects as stand-alone applications. Unless you are really short on disk space, you shouldn’t care about this that much anyway since nearly everyone has HyperCard.

Objection #3: HyperTalk doesn’t have complete access to the Macintosh ROMs. XCMDs and XFCNs provide support for virtually any ROM routine. This excuse is usually used by people that can’t or won’t program in C or Pascal. Creating externals with CompileIt! from your scripts is as easy as writing them in HyperTalk. Extensions added by CompileIt! make toolbox support much easier.

Objection #4: Protection of sensitive program code is difficult in HyperCard. Even though you can protect a stack, there are ways to break that protection. Compiled code doesn’t allow users to readily view the source code. With CompileIt! you can protect your valuable work by compiling sensitive code.

CompileIt! was designed to:

° Speed up HyperCard scripts

° translate HyperTalk scripts into 68000 machine language resulting in XCMDs and XFCNs that can be used by any HyperCard script.

° provide extensions to HyperTalk

USING CompileIt!

Although using CompileIt! comes fairly easy, it is highly recommended that you are experienced with HyperTalk scripts. You should be familiar with handlers, messages, and properties before using CompileIt!.

It’s very tempting to just paste in a script and begin compiling. The CompileIt! 2.0 program consists of a HyperCard stack that allows you to paste your script from the clipboard and then compile. It’s very interesting to note that CompileIt! 2.0 is much faster than earlier versions of CompileIt! That’s because CompileIt! 2.0 has been compiled with CompileIt! The compiling engine consists entirely of resources and only a single line of code that ties the HyperCard interface to the engine. This means that CompileIt! 2.0 can be totally customized to fit the developers needs - even going as far as creating a stand-alone application to hold it or moving it into other environments like Microphone II v3. All that is required to use the engine is a subset of the HyperCard 1.x XCMD interface.

Before using CompileIt! there are a few things that should be understood about the way CompileIt! works. The first part of CompileIt!’s 200 page manual helps you get started with a sample script. Experienced HyperTalk scripters will be able to get started quickly by going through about 7-10 pages of CompileIt! basics. Not every script can be made to run faster by compiling. Scripts that deal with HyperCard structures (that is menus, buttons, fields, cards, etc.) will not go much faster. They must still pass messages to HyperCard routines that still run the same speed. Get, Put, all forms of Repeat, Next (repeat), all forms of If-Then-Else, Abs, Add, Atan, Average, CharToNum, Cos, Delete, Divide, Exit, Exp, Exp1, Global, Length, Ln, Ln1, Log2, Min, Max, Multiply, Number(chunks), NumToChar, Offset, Param, Params, ParamCount, Pass, Random, Result, Return, Round, Sin, Sqrt, Subtract, Tan, Trunc, HyperTalk operators: Div, Mod, +, -, *, &, &&, , ¾, =, , <, >, And, Or, Not, Is Not, Is, /, ^, Constants, Ordinals, and Toolbox calls will all run faster after compiled with CompileIt!

You may need to optimize existing scripts to be sure that they don’t use too many callbacks to HyperCard. For example, the statement put x into y in the script below will make the routine run faster than if x was used throughout the script instead of y. Otherwise, the compiler would have to generate code to convert the string variable x each time it is used. Instead, the conversion from string x to local variable y is done only once. It is helpful to keep in mind that HyperTalk does a lot of conversion for you. By minimizing the amount of conversion that has to be done, the routine can run faster. Unlike HyperCard, where all variables are strings, variables can be declared at the start of a compiled handler. CompileIt! allows many more data types to be declared than are available in HyperCard. Short integers, long integers, Pointers, Handles, P-Strings (including short P-Strings), 0-terminated strings (call these HyperCard strings), OSTypes, Boolean, Character, Floating point (12-byte SANE values), and Records (default is 32 bytes but user can specify any size).

--1

-- calculate ( y)
-- by subtracting odd numbers
function squarroot x
 put x into y
 put 0 into ans
 put 1 into oddint
 repeat while y 0
 subtract oddint from y
 add 1 to ans
 add 2 to oddint
 end repeat
 return ans-1
end squarroot

Normally, Apple’s SANE routines will be used to perform all of CompileIt!’s calculations, although SANE can be turned off to force some variables to integer type. Several techniques can be used to tell CompileIt! that a particular value is floating point - putting 0.0 into a variable to initialize it, adding ^1 after the variable, or declaring it as floating point using shared variables. The manual discusses the pros and cons of using SANE vs. integer math.

Except for the routines specifically marked as “NOT IN ROM” in Inside Macintosh, all procedures and functions are included from Inside Macintosh vol. I-V. Also, selected “NOT IN ROM” routines are included such as the High-Level file manager and Print Manager (NOT IN ROM routines are included based on user demand). Many of the record structures and low-memory globals are also included. Many (but not all) of the Inside Mac VI routines and record structures are also included. CompileIt!’s Custom Symbol Edit card allows users to add additional record structures, low-memory globals, user defined constants, direct calls to other external commands (avoids a slow text callback), and other symbols on their own. Using these calls requires you to convert Inside Macintosh Pascal notation to HyperTalk/CompileIt notation. For example, a common procedure from Inside Macintosh would be: Procedure DrawString (S: Str255); the HyperTalk/CompileIt! equivalent would be: DrawString anystring. You’ll also have to setup record structures to match those in Inside Macintosh. Fortunately, CompileIt! supplies the property names for many of the common types used in Inside Macintosh. If you are not an experienced programmer, it will take some study of the CompileIt! manual sections on programming with the toolbox. Experienced programmers won’t have any trouble with it.

The process of compiling a script begins by copying your script into the clipboard. Open CompileIt! and click on the Enter New Script button. Select the destination stack where CompileIt! will put the external code. CompileIt! will use the name of the handler of the script. That is, if the script started with on mouseup then the name of the external would be mouseup and it would respond to a mouseup message. When you click on the CompileIt! button, the compile begins. It is highly recommended that users not use system messages as XCMD or XFCN names since they tend to get executed when users least expect them too. Better to use On Foo or some such. Also, the word ‘On’ results in an XCMD while the word Function results in an XFCN.

An equally great part of the CompileIt! XCMD Development System is the DebugIt! source level debugger. When you compile a script with DebugIt! turned on, debugging code is added to your external function. When you execute your compiled external, the DebugIt! window will open and execution will halt before the first line is executed. Now you can set breakpoints, view variables, and single step through the external. This gives you as much flexibility in debugging your external as you could ask for. You may find it interesting that DebugIt! is not tied to HyperCard. Externals with DebugIt! attached can be run in just about any environment that supports even a limited subset of the HyperCard 1.x XCMD interface (FoxBase, Microphone II v3, XLINK, and SuperCard are all good examples).

CompileIt! can be used to create xWindoids (external windows) for HyperCard 2.0. CompileIt! simplifies the code you need to write to support an xWindoid by treating events like system messages. HyperCard automatically tells xWindoids about various system events that apply to them such as mouseDowns, updates, menubar clicks, etc. xWindoids are a new feature of HyperCard 2.0.

CompileIt! also works with SuperCard 1.5. Since CompileIt! is shipped as HyperCard 1.2 format, SuperCard users will need to convert to SuperCard format. An appendix in the CompileIt! manual spells out what to do and what to be aware of when using SuperCard and CompileIt!

There are several reasons to go with CompileIt! The price is right at $99, and there are no fees for distribution of your compiled externals. The compile process is a snap, but you should have a good knowledge of HyperTalk. CompileIt! is a great way to speed up and protect sensitive scripts.

CompileIt! 2.0 is distributed exclusively by:

Heizer Software

P. O. Box 232019

Pleasant Hill, CA. 94523

Phone: 800--888-7667 or 415-943-7667

FAX 415-943-6882

Price: $99 (working model: $10.00 compiles scripts up to 10 lines long. The Working Model includes a $10 rebate towards the purchase of CompileIt! 2.0).

Requires: Any Macintosh that can run HyperCard. Supports all versions of HyperCard, including 2.0, and SuperCard 1.5. A moderate level of programming ability is required.

Not copy protected and no runtime fees or licenses are required to distribute externals created with CompileIt!

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Air Video Server HD 2.1.0 - Stream video...
Air Video Server HD streams videos instantly from your computer on your iPhone, iPad, iPod touch or Apple TV. No need to worry about converting or transferring files. We took everything that was... Read more
Duplicate Annihilator 5.7.5 - Find and d...
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... Read more
BusyContacts 1.0.2 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Capture One Pro 8.2.0.82 - RAW workflow...
Capture One Pro 8 is a professional RAW converter offering you ultimate image quality with accurate colors and incredible detail from more than 300 high-end cameras -- straight out of the box. It... Read more
Backblaze 4.0.0.872 - Online backup serv...
Backblaze is an online backup service designed from the ground-up for the Mac.With unlimited storage available for $5 per month, as well as a free 15-day trial, peace of mind is within reach with... Read more
Little Snitch 3.5.2 - Alerts you about o...
Little Snitch gives you control over your private outgoing data. Track background activity As soon as your computer connects to the Internet, applications often have permission to send any... Read more
Monolingual 1.6.4 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. If you use your computer in only one (human) language, you... Read more
CleanApp 5.0 - Application deinstaller a...
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
Fantastical 2.0 - Create calendar events...
Fantastical 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 details... Read more
Cocktail 8.2 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more

Pie In The Sky: A Pizza Odyssey (Games)
Pie In The Sky: A Pizza Odyssey 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A game about delivering pizza. In space. | Read more »
Android's Popular OfficeSuite Now A...
Once only available for Android devices, OfficeSuite has finally landed on the app store. The Mobile Systems app lets you view, edit, create, and share Word, Excel, and PowerPoint documents as well as convert them to/from PDFs. It's touted as being... | Read more »
Fast & Furious: Legacy's Creati...
| Read more »
N-Fusion and 505's Ember is Totally...
| Read more »
These are All the Apple Watch Apps and G...
The Apple Watch is less than a month from hitting store shelves, and once you get your hands on it you're probably going to want some apps and games to install. Fear not! We've compiled a list of all the Apple Watch apps and games we've been able to... | Read more »
Appy to Have Known You - Lee Hamlet Look...
Being at 148Apps these past 2 years has been an awesome experience that has taught me a great deal, and working with such a great team has been a privilege. Thank you to Rob Rich, and to both Rob LeFebvre and Jeff Scott before him, for helping me... | Read more »
Hands-On With Allstar Heroes - A Promisi...
Let’s get this out of the way quickly. Allstar Heroes looks a lot like a certain other recent action RPG release, but it turns out that while it’s not yet available here, Allstar Heroes has been around for much longer than that other title. Now that... | Read more »
Macho Man and Steve Austin Join the Rank...
WWE Immortals, by Warner Bros. Interactive Entertainment and WWE, has gotten a superstar update. You'll now have access to Macho Man Randy Savage and Steve Austin. Both characters have two different versions: Macho Man Randy Savage Renegade or Macho... | Read more »
Fearless Fantasy is Fantastic for the iF...
I actually had my first look at Fearless Fantasy last year at E3, but it was on a PC so there wasn't much for me to talk about. But now that I've been able to play with a pre-release version of the iOS build, there's quite a bit for me to talk... | Read more »
MLB Manager 2015 (Games)
MLB Manager 2015 5.0.14 Device: iOS Universal Category: Games Price: $4.99, Version: 5.0.14 (iTunes) Description: Guide your favorite MLB franchise to glory! MLB Manager 2015, officially licensed by MLB.com and based on the award-... | Read more »

Price Scanner via MacPrices.net

Apple offering refurbished 27-inch 5K iMacs f...
The Apple Store is offering Apple Certified Refurbished 27″ 3.5GHz 5K iMacs for $2119 including free shipping. Their price is $380 off the price of new models, and it’s the lowest price available for... Read more
16GB iPad mini on sale for $199, save $50
Walmart has 16GB iPad minis (1st generation) available for $199.99 on their online store, including free shipping. Their price is $50 off MSRP. Online orders only. Read more
New 128GB MacBook Airs on sale for $50 off MS...
 B&H Photo has 128GB 11″ and 13″ 2015 MacBook Airs on sale today for $50 off MSRP including free shipping plus NY sales tax only: - 11″ 1.6GHz/128GB MacBook Air (Model #MJVM2LL/A): $849 $50 off... Read more
13-inch 2.6GHz Retina MacBook Pro (refurbishe...
The Apple Store has Apple Certified Refurbished 13″ 2.6GHz/128GB Retina MacBook Pros available for $979 including free shipping. Original MSRP for this model was $1299. Read more
Save up to $600 with Apple refurbished Mac Pr...
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
Samsung Galaxy S 6 and Galaxy S 6 edge U.S. P...
Samsung Electronics America, Inc. has announced the Galaxy S 6 and Galaxy S 6 edge will be available in the U.S. beginning April 10, with pre-orders being accepted now. “We have completely reimagined... 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
Save up to $80 on iPad Air 2s, NY tax only, f...
 B&H Photo has iPad Air 2s on sale for $80 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $469.99 $30 off - 64GB iPad Air 2 WiFi: $549.99 $50 off - 128GB iPad... Read more
iMacs on sale for up to $205 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1019 $80 off - 21″ 2.7GHz iMac: $1189 $110 off - 21″ 2.9GHz... Read more
Färbe Technik Offers iPhone Battery Charge LI...
Färbe Technik, which manufactures and markets of mobile accessories for Apple, Blackberry and Samsung mobile devices, is offering tips on how to keep your iPhone charged while in the field: •... Read more

Jobs Board

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* 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
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
Lead *Apple* Solutions Consultant - Retail...
**Job Summary** Job Summary The Lead ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store 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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.