TweetFollow Us on Twitter

Jul 97 - Newton Q and A

Volume Number: 13 (1997)
Issue Number: 7
Column Tag: develop

Jul 97 - Newton Q&A: Ask the Llama

by Apple Developer Technical Support Group

Q: I want to put my own custom icons in the picker that comes up when a user taps the action button. I have a slot in my base view called myTestIcon that contains the icon I want to use. But I can't figure out how to use that icon in the array of action frames in the routeScripts slot in my application. I started with the following routing item frame based on a simple "duplicate" action:

{title: "Test Action",
icon: ROM_routeDuplicateIcon,
routeScript: func(target, targetView)
begin
	// my function here
end,},

This worked fine. Then I replaced the icon specification with this code:

icon: GetRoot().(kAppSymbol).myTestIcon,

But this won't even compile. Any ideas?

A: The problem is that you're using the GetRoot function call in your array of routing action frames. Since the array of frames is in an evaluate slot (that is, the routeScripts slot), it will be evaluated at compile time in the Newton Toolkit environment. In other words, you're asking the Newton OS to look in the root view for your application's base view frame. This assumes that your application has been installed on a Newton device. But the code is executed at compile time, so there is no Newton device, no root view, and no base application frame.

The easiest way to solve your problem is to define a constant for the icon in a text file and then use that constant in the appropriate slot that defines the action.

Let's assume that you already have a resource file with the appropriate PICT resource, and that you have a text file as part of your project (if not, just create one from the NTK File menu and add it to your project). In the text file, add a line that looks something like this:

DefineGlobalConstant('kMyIcon, GetPictAsBits("MyIcon", nil));
// Note: Earlier versions of the platform file may use DefConst instead
// of DefineGlobalConstant.

This will give you a constant named kMyIcon. (Obviously you would replace kMyIcon with your own meaningful constant name and the string "MyIcon" with the name of the appropriate PICT resource.) Do this for each of the action menu icons that you want. Note that even though the action menu calls them "icons," you get the data by reading a Macintosh PICT resource, not a Macintosh ICON resource.

In your application's routeScripts slot where you create the array of extra action button actions, use the constant names you've created:

{title: "Test Action",
icon: kMyIcon,
routeScript: func(target, targetView)
begin
	// my function here
end,},

The other way you can solve your problem is by specifying the array of action frames at run time. Instead of specifying a routeScripts slot with your array of action frames, you can provide a GetRouteScripts method. Since this method lets you construct your array of action frames at run time in the Newton environment, the root view will exist and your application will be found.


Q: I'm using a protoLabelInputLine, which I've used many times before. In this case no user input happens in the input line. The entryFlags slot looks fine. It's set to vVisible, vClickable, vStrokesAllowed, vGesturesAllowed, and vAnythingAllowed. But strokes, gestures, and recognition do not occur. I tried adding a viewClickScript, viewStrokeScript, and viewGestureScript. The viewClickScript does get called, but none of the others do. When I remove the viewClickScript, there's still nothing. What's going on?

A: You've fallen prey to a rare gotcha that's hard to find unless you know what you're looking for. The clue is in the behavior with and without the viewClickScript. Without it, the line takes no input, so it appears as if the view is ignoring clicks. With it, you see something occurring. The key is that the viewClickScript of a clickable view will be searched for in both the proto and the parent chain. So you must have a viewClickScript defined in a parent of the protoLabelInputLine. When the user puts the pen down in the input line, the inherited script is found and executed in the context of the input line. This inherited script probably turns off the ink and then does some processing. You've seen the result.

The solution is to add a viewClickScript to your protoLabelInputLine that returns the value 'skip. This will let the protoLabelInputLine grab the stroke and allow recognition to happen. Note that simply returning true or nil would not solve the problem.


Q: The documentation for StuffLong says it "writes four bytes at the specified offset using the 30-bit signed value you pass it as a third parameter and sign-extends it to 32 bytes." Ignoring the obvious error ("32 bytes" should read "32 bits"), why does it take only 30 bits? I realize the language defines an integer as a 30-bit representation, plus a sign bit, but what's bit 31 for? More specifically, how can I use StuffLong to result in the value 0x20000000?

A: First off, the representation is not 30 bits plus a sign bit plus some other bit. NewtonScript uses a 30-bit two's complement signed representation. The other two bits are used by the OS for other purposes. So StuffLong takes integers as 30 bits because that's how NewtonScript represents integers. In the binary object, the other two bits will be the sign extension of the number you pass in. That is, they'll have the same value as the sign bit: 0 for positive, 1 for negative.

As you can probably see, it isn't possible to use StuffLong to put your long word into a binary object. The two high-order bits must be the same as the sign of the number. In your case, you have a 1 bit in the sign, but you want a 0 for both bits of the sign extension.

To stuff the data you want, you'll have to use some combination of StuffWord and/or StuffByte.


Q: I have some compile-time functions that generate frame data and some other functions that do sanity checking. Is it possible to abort the compile and give an error message once NTK has started compiling?

A: Yes. NTK implements a subset of the Newton environment. This includes the ability to throw exceptions. To abort a compile, throw an exception. If the exception is of the type '|evt.ex.msg|, any message you provide will be shown in a dialog by NTK. Here's a simple example:

throw('|evt.ex.msg|, "Invalid data at position " && theIndex);

Assuming that theIndex has the value 4, this statement will abort the current compile and display a dialog containing "Invalid data at position 4."

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Cyberduck 4.7.1 - FTP and SFTP browser....
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
PDFpen 7.2 - Edit and annotate PDFs with...
We're also offering PDFpenPro for 30% off! PDFpen allows users to easily edit PDF's. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even... Read more
Skype 7.9.746 - Voice-over-internet phon...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
Apple GarageBand 10.1 - Complete recordi...
The new GarageBand is a whole music creation studio right inside your Mac -- complete with keyboard, synths, orchestral and percussion instruments, presets for guitar and voice, an entirely... Read more
Duplicate Annihilator 5.7.7 - 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
OS X Server 4.1.3 - For OS X 10.10 Yosem...
Designed for OS X and iOS devices, OS X Server makes it easy to share files, schedule meetings, synchronize contacts, develop software, host your own website, publish wikis, configure Mac, iPhone,... Read more
Firefox 39.0 - Fast, safe Web browser. (...
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more
pwSafe 4.1 - Secure password management...
pwSafe provides simple and secure password management across devices and computers. pwSafe uses iCloud to keep your password databases backed-up and synced between Macs and iOS devices. It is... Read more
Kodi 15.0.rc1 - Powerful media center to...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
Coda 2.5.11 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more

This Week at 148Apps: June 29-July 3, 20...
Into July With 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out above the... | Read more »
Sonic Runners Guide
Despite its flaws, Sonic Runners' platforming action is actually quite fun. Though it can be a little more complicated than old-school Sonic games. Here's how to make sure you're up to speed when jumping in. [Read more] | Read more »
Rage of Bahamut is Giving Almost All of...
The App Store isn't what it used to be back in 2012, so it's not unexpected to see some games changing their structures with the times. Now we can add Rage of Bahamut to that list with the recent announcement that the game is severely cutting back... | Read more »
Adventures of Pip (Games)
Adventures of Pip 1.0 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: ** ONE WEEK ONLY — 66% OFF! *** “Adventures of Pip is a delightful little platformer full of charm, challenge and impeccable... | Read more »
Divide By Sheep - Tips, Tricks, and Stre...
Who would have thought splitting up sheep could be so involved? Anyone who’s played Divide by Sheep, that’s who! While we’re not about to give you complete solutions to everything (because that’s just cheating), we will happily give you some... | Read more »
NaturalMotion and Zynga Have Started Tea...
An official sequel to 2012's CSR Racing is officially on the way, with Zynga and NaturalMotion releasing a short teaser trailer to get everyone excited. Well, as excited as one can get from a trailer with no gameplay footage, anyway. [Read more] | Read more »
Grab a Friend and Pick up Overkill 3, Be...
Overkill 3 is a pretty enjoyable third-person shooter that was sort of begging for some online multiplayer. Fortunately the begging can stop, because its newest update has added an online co-op mode. [Read more] | Read more »
Scanner Pro's Newest Update Adds Au...
Scanner Pro is one of the most popular document scanning apps on iOS, thanks in no small part to its near-constant updates, I'm sure. Now we're up to update number six, and it adds some pretty handy new features. [Read more] | Read more »
Heroki (Games)
Heroki 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: CLEAR THE SKIES FOR A NEW HERO!The peaceful sky village of Levantia is in danger! The dastardly Dr. N. Forchin and his accomplice,... | Read more »
Wars of the Roses (Games)
Wars of the Roses 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »

Price Scanner via MacPrices.net

Apple refurbished Mac minis available startin...
The Apple Store has Apple Certified Refurbished 2014 Mac minis available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz Mac mini: $419 $80 off... Read more
College Student Deals: Additional $100 off Ma...
Take an additional $100 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through August 8, 2015. Anyone with a valid .EDU email address can take... Read more
Sky Atlas Star Walk 2 App For iPhone And iPa...
Vito Technology, developer of educational apps for Android and iOS, is for a limited time offering free of charge their Star Walk 2, the next generation of the company’s best-selling stargazing guide... Read more
13-inch 1.6GHz MacBook Air on sale for $849,...
Amazon has the 2015 13″ 1.6GHz/128GB MacBook Air on sale for $849.99 including free shipping. Their price is $150 off MSRP, and it’s the lowest price available for this model. Read more
13-inch 2.5GHz MacBook Pro on sale for $999,...
Adorama has the 13-inch 2.5GHz MacBook Pro on sale for $999 including free shipping plus NY & NJ sales tax only. Their price is $100 off MSRP. Read more
Updated Mac Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has new 2015 15″ Retina MacBook Pros on sale for up to $225 off MSRP including free shipping plus NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1819 $180 off - 15″ 2.5GHz Retina... Read more
RamDisk4Mac App Helps Run Your Mac Faster And...
Ever use a RAM disk? If you’ve come to the Mac in the OS X era, likely not. The Classic Mac OS had a RAM disk function built-in, but that was dropped in the conversion to OS X. What is a RAM disk?... Read more
13-inch 1.6GHz MacBook Air on sale for $849,...
Best Buy has the 2015 13″ 1.6GHz/128GB MacBook Air on sale for $849.99 on their online store this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders... Read more
Apple Refurbished iMacs available for up to $...
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $1949 $... 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
Senior Payments Security Manager - *Apple*...
**Job Summary** Apple , Inc. is looking for a highly motivated, innovative and hands-on senior payments security manager to join the Apple Pay security team. You will 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
Sr. Payment Program Manager, *Apple* Pay -...
**Job Summary** Apple Pay is an exciting environment and a…devices in a simple, private and secure way. The Apple Pay Team is looking for an experienced Senior Read more
Project Manager - *Apple* Pay Security - Ap...
**Job Summary** The Apple Pay Security team is seeking a highly organized, results-driven Project Manager to drive the development of Apple Pay Security. If you are Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.