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."

 
AAPL
$97.67
Apple Inc.
+0.64
MSFT
$44.50
Microsoft Corpora
+0.10
GOOG
$589.02
Google Inc.
-4.33

MacTech Search:
Community Search:

Software Updates via MacUpdate

TinkerTool 5.3 - Expanded preference set...
TinkerTool is an application that gives you access to additional preference settings Apple has built into Mac OS X. This allows to activate hidden features in the operating system and in some of the... Read more
Audio Hijack Pro 2.11.0 - Record and enh...
Audio Hijack Pro drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio with Audio Hijack... Read more
Intermission 1.1.1 - Pause and rewind li...
Intermission allows you to pause and rewind live audio from any application on your Mac. Intermission will buffer up to 3 hours of audio, allowing users to skip through any assortment of audio... Read more
Autopano Giga 3.6 - Stitch multiple imag...
Autopano Giga allows you to stitch 2, 20, or 2,000 images. Version 3.0 integrates impressive new features that will definitely make you adopt Autopano Pro or Autopano Giga: Choose between 9... Read more
Airfoil 4.8.7 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
Microsoft Remote Desktop 8.0.8 - Connect...
With Microsoft Remote Desktop, you can connect to a remote PC and your work resources from almost anywhere. Experience the power of Windows with RemoteFX in a Remote Desktop client designed to help... Read more
xACT 2.30 - Audio compression toolkit. (...
xACT stands for X Aaudio Compression Toolkit, an application that encodes and decodes FLAC, SHN, Monkey’s Audio, TTA, Wavpack, and Apple Lossless files. It also can encode these formats to MP3, AAC... Read more
Firefox 31.0 - Fast, safe Web browser. (...
Firefox for Mac 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... Read more
Little Snitch 3.3.3 - Alerts you to outg...
Little Snitch gives you control over your private outgoing data. Track background activityAs soon as your computer connects to the Internet, applications often have permission to send any... Read more
Thunderbird 31.0 - Email client from Moz...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more

Latest Forum Discussions

See All

New Trailer For Outcast Odyssey, A New K...
New Trailer For Outcast Odyssey, A New Kind of Card Battler Posted by Jennifer Allen on July 25th, 2014 [ permalink ] Out this Fall is a new kind of card battle game: Outcast Odyssey. | Read more »
Garfield: Survival of the Fattest Coming...
Garfield: Survival of the Fattest Coming to iOS this Fall Posted by Jennifer Allen on July 25th, 2014 [ permalink ] Who loves lasagna? Me. Also everyone’s favorite grumpy fat cat, Garfield. | Read more »
Happy Flock Review
Happy Flock Review By Andrew Fisher on July 25th, 2014 Our Rating: :: HERD IT ALL BEFOREUniversal App - Designed for iPhone and iPad Underneath the gloss of Happy Flock’s visuals is a game of very little substance. It’s cute, but... | Read more »
Square Register Updates Adds Offline Pay...
Square Register Updates Adds Offline Payments Posted by Ellis Spice on July 25th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Looking For Group – Hearthstone’s Curse...
For the first time since its release (which has thankfully been a much shorter window for iPad players than their PC counterparts), Blizzard’s wildly successful Hearthstone: Heroes of Warcraft CCG is sporting some brand new content: the single... | Read more »
Poptile Review
Poptile Review By Jennifer Allen on July 25th, 2014 Our Rating: :: SIMPLY FUNUniversal App - Designed for iPhone and iPad Simple yet a little bit glorious, Poptile is a satisfying entertaining puzzle game with oodles of the ‘one... | Read more »
Modern Combat 5: Blackout Review
Modern Combat 5: Blackout Review By Brittany Vincent on July 25th, 2014 Our Rating: :: LESS QQ, MORE PEW PEWUniversal App - Designed for iPhone and iPad The fifth entry into the blockbuster Modern Combat series is what mobile... | Read more »
Watch and Share Mobile Gameplay Videos W...
Watch and Share Mobile Gameplay Videos With Kamcord Posted by Jennifer Allen on July 25th, 2014 [ permalink ] iPhone App - Designed for the iPhone, compatible with the iPad | Read more »
THE KING OF FIGHTERS '98 (Games)
THE KING OF FIGHTERS '98 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: Series’ masterpiece “KOF ’98” finally joins the battle on iPhone! FEATURES:■ The best game balance in the “KOF”... | Read more »
LEX Goes Free For One Day In Honor of Ne...
LEX Goes Free For One Day In Honor of New Update Posted by Jennifer Allen on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »

Price Scanner via MacPrices.net

iMacs on sale for $150 off MSRP, $250 off for...
Best Buy has iMacs on sale for up to $160 off MSRP for a limited time. Choose free home shipping or free instant local store pickup (if available). Prices are valid for online orders only, in-store... Read more
Mac minis on sale for $100 off MSRP, starting...
Best Buy has Mac minis on sale for $100 off MSRP. Choose free shipping or free instant local store pickup. Prices are for online orders only, in-store prices may vary: 2.5GHz Mac mini: $499.99 2.3GHz... Read more
Global Tablet Market Grows 11% in Q2/14 Notwi...
Worldwide tablet sales grew 11.0 percent year over year in the second quarter of 2014, with shipments reaching 49.3 million units according to preliminary data from the International Data Corporation... Read more
New iPhone 6 Models to Have Staggered Release...
Digitimes’ Cage Chao and Steve Shen report that according to unnamed sources in Apple’s upstream iPhone supply chain, the new 5.5-inch iPhone will be released several months later than the new 4.7-... Read more
New iOS App Helps People Feel Good About thei...
Mobile shoppers looking for big savings at their favorite stores can turn to the Goodshop app, a new iOS app with the latest coupons and deals at more than 5,000 online stores. In addition to being a... Read more
Save on 5th generation refurbished iPod touch...
The Apple Store has Apple Certified Refurbished 5th generation iPod touches available starting at $149. Apple’s one-year warranty is included with each model, and shipping is free. Many, but not all... Read more
What Should Apple’s Next MacBook Priority Be;...
Stabley Times’ Phil Moore says that after expanding its iMac lineup with a new low end model, Apple’s next Mac hardware decision will be how it wants to approach expanding its MacBook lineup as well... Read more
ArtRage For iPhone Painting App Free During C...
ArtRage for iPhone is currently being offered for free (regularly $1.99) during Comic-Con San Diego #SDCC, July 24-27, in celebration of the upcoming ArtRage 4.5 and other 64-bit versions of the... Read more
With The Apple/IBM Alliance, Is The iPad Now...
Almost since the iPad was rolled out in 2010, and especially after Apple made a 128 GB storage configuration available in 2012, there’s been debate over whether the iPad is a serious tool for... Read more
MacBook Airs on sale starting at $799, free s...
B&H Photo has the new 2014 MacBook Airs on sale for up to $100 off MSRP for a limited time. Shipping is free, and B&H charges NY sales tax only. They also include free copies of Parallels... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Sr. Project Manager for *Apple* Campus 2 -...
…the design and construction of one building or building components of the New Apple Campus located in Cupertino, CA. They will provide project management oversight for Read more
WW Sales Program Manager, *Apple* Online St...
**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* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.