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
$519.01
Apple Inc.
+1.05
MSFT
$40.40
Microsoft Corpora
+0.65
GOOG
$556.54
Google Inc.
+20.10

MacTech Search:
Community Search:

Software Updates via MacUpdate

PDFpenPro 6.2 - Advanced PDF toolkit for...
PDFpenPro allows users to edit PDF's easily. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Create... Read more
PDFpen 6.2 - Edit and annotate PDFs with...
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 correct text and edit graphics! Features... Read more
Monolingual 1.5.9 - 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. It requires a 64-bit capable Intel-based Mac and at least... 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
Starcraft II: Wings of Liberty 1.1.1.180...
Download the patch by launching the Starcraft II game and downloading it through the Battle.net connection within the app. Starcraft II: Wings of Liberty is a strategy game played in real-time. You... Read more
Sibelius 7.5.0 - Music notation solution...
Sibelius is the world's best-selling music notation software for Mac. It is as intuitive to use as a pen, yet so powerful that it does most things in less than the blink of an eye. The demo includes... Read more
Typinator 5.9 - Speedy and reliable text...
Typinator turbo-charges your typing productivity. Type a little. Typinator does the rest. We've all faced projects that require repetitive typing tasks. With Typinator, you can store commonly used... Read more
MYStuff Pro 2.0.16 - Create inventories...
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more
TurboTax 2013.r17.002 - Manage your 2013...
TurboTax guides you through your tax return step by step, does all the calculations, and checks your return for errors and overlooked deductions. It lets you file your return electronically to get... Read more
TrailRunner 3.8.769 - Route planning for...
Note: While the software is classified as freeware, it is actually donationware. Please consider making a donation to help support development. TrailRunner is the perfect companion for runners,... Read more

Latest Forum Discussions

See All

Unpossible (Games)
Unpossible 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: **Important** Requires at least iPad 2, iPhone 4S, iPod Touch (5th gen), or newer. | Read more »
Hitman GO (Games)
Hitman GO 1.2 Device: iOS Universal Category: Games Price: $4.99, Version: 1.2 (iTunes) Description: Get your daily fix of Agent 47 with this elegant, strategy-based Hitman game! | Read more »
The Seventh Sign: Hodappy Bird Released...
The Seventh Sign: Hodappy Bird Released on the App Store Posted by Jeff Scott on April 16th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Rogue Heroes (Games)
Rogue Heroes 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Rogue Heroes is awesome fast-paced 2D action-platforming roguelike game with RPG elements. - explore the depth of procedurally... | Read more »
Fourcast Review
Fourcast Review By Jennifer Allen on April 16th, 2014 Our Rating: :: VIDEO POTENTIALiPhone App - Designed for the iPhone, compatible with the iPad Fourcast is a great idea for combining video clips, but it does lack a number of... | Read more »
Hearthstone: Heroes of Warcraft is Avail...
Hearthstone: Heroes of Warcraft is Available on the U.S. App Store Right Now – Gogogogo! Posted by Rob Rich on April 16th, 2014 [ permalink ] | Read more »
Grammar Pop HD Review
Grammar Pop HD Review By Jennifer Allen on April 16th, 2014 Our Rating: :: FUN LEARNINGiPad Only App - Designed for the iPad Learning the different parts of speech isn’t always fun, but Grammar Pop HD makes it much more... | Read more »
Groundskeeper2 Review
Groundskeeper2 Review By Nadia Oxford on April 16th, 2014 Our Rating: :: SLICE THOSE ALIEN SLIMEUniversal App - Designed for iPhone and iPad Putting aside some minor control issues, Groundskeeper2 is a fun and furious action/... | Read more »
Pinnacle Studio for iPhone (Photography...
Pinnacle Studio for iPhone 5.0 Device: iOS iPhone Category: Photography Price: $9.99, Version: 5.0 (iTunes) Description: | Read more »
Season 3 of Zombies, Run! Starts Right N...
Season 3 of Zombies, Run! | Read more »

Price Scanner via MacPrices.net

Microsoft Blinks – Drops Microsoft Office 365...
Microsoft has dropped the annual subscription fee for Microsoft Office 365 Personal – which is needed in order to create and edit documents in Microsoft Office for iPad. However, Apple’s iOS and OS X... Read more
New AVG Vault Apps for iOS and Android Help K...
AVG Technologies N.V. an online security company for 177 million active users, has announced the launch of its latest mobile application, AVG Vault. The free app introduces an innovative user... Read more
Free Local Carrot iPhone App Helps Find Fresh...
I love fresh vegetables. I’m not a vegan, although I was for several years in the 1980s, but fresh vegetables and other whole foods are still my dietary mainstays as a matter of taste rather than... Read more
Apple refurbished iPad Airs available startin...
Apple is now offering Certified Refurbished iPad Airs for up to $140 off MSRP. Apple’s one-year warranty is included with each model, and shipping is free. The following Airs are available today: -... Read more
21-inch 2.7GHz iMac on sale for $1179, save $...
B&H Photo has the 21″ 2.7GHz iMac on sale for $1179 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Add an iMac to your shopping cart, and B&H will offer an... Read more
Download our app, iTracx, for iOS and Android
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more
Education discounts shave up to $300 off the...
Purchase a new Mac 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, and all... Read more
Save $50 on Mac mini Server
B&H Photo has the 2012 Mac mini Server on sale for $949 including free shipping plus NY sales tax only. Their price is $50 off MSRP. Read more
PhatWare’s “Ultimate Writing App For iOS” Ren...
PhatWare Corp. has announced it has renamed its new WritePro word processing app for iPhone and iPad: WritePad Pro. The decision to change the app’s name to leverages the strong brand awareness and... Read more
Full Resolution Photo Editor Tint Mint 1.0 Re...
California based independent developer, Jeffrey Sun, creator of the iOS app Modern Editor, has released Tint Mint, a new photography app for editing enthusiasts. The app costs a dollar, and it packs... Read more

Jobs Board

*Apple* Retail - Manager - Holyoke - Apple I...
Job Summary Keeping an Apple Store thriving requires a diverse set of leadership skills, and as a Manager, you’re a master of them all. In the store’s fast-paced, Read more
*Apple* Retail - Manager - Apple (United Sta...
Job SummaryKeeping an Apple Store thriving requires a diverse set of leadership skills, and as a Manager, you're a master of them all. In the store's fast-paced, dynamic 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
*Apple* Retail - Market Leader - Cincinnati...
…challenges of developing individuals, building teams, and affecting growth across Apple Stores. You demonstrate successful leadership ability - focusing on excellence Read more
*Apple* Retail - Manager - SoHo - Apple (Uni...
Job SummaryKeeping an Apple Store thriving requires a diverse set of leadership skills, and as a Manager, you're a master of them all. In the store's fast-paced, dynamic Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.