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

WRIO Keyboard (Utilities)
WRIO Keyboard 1.0 Device: iOS iPhone Category: Utilities Price: $2.99, Version: 1.0 (iTunes) Description: 40% OFF DURING LIMITED INTRODUCTORY OFFER | Read more »
Hatoful Boyfriend (Games)
Hatoful Boyfriend 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: The hit PC game that everybirdie loves has now migrated to your mobile device! Now you are free to explore the wonders of St... | Read more »
Warp Shift (Games)
Warp Shift 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: [ CHECK YOUR HARDWARE: Warp Shift does NOT run on iPhone 4, iPad 1 and iPod touch 4G or older devices! It requires at least iOS8... | Read more »
Lifeline: Whiteout (Games)
Lifeline: Whiteout 1.0.2 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.2 (iTunes) Description: Alone in a frozen wasteland with no memory of how he got there, a lost adventurer’s only hope is his last line of... | Read more »
Castles of Mad King Ludwig (Games)
Castles of Mad King Ludwig 1.0.1 Device: iOS Universal Category: Games Price: $6.99, Version: 1.0.1 (iTunes) Description: | Read more »
How to command and conquer in Raid HQ
Raid HQ is a satisfyingly deep base building game with over-the-top macho action and explosions. This little free to play bundle gives you a lot to do from managing a squad to building the most powerful base you possibly can. [Read more] | Read more »
How to build a successful civilisation i...
GodFinger 2 grants you godlike powers, leaving you to raise a civilization of followers. In the spirit of games like Black & White, the GodFinger games will see you building bigger and better villages, developing more advanced technology and... | Read more »
How to get all the crabs in Mr Crab 2
Mr. Crab 2 may look like a cutesy platformer for kids, but if you're the kind of person who likes to complete a game 100%, you'll soon realise that it's a tougher than a crustacean's shell. [Read more] | Read more »
How to be a star in Britney Spears: Amer...
If you've ever wanted to be a star, baby, then you've probably already checked out Britney Spears: American Dream and are happily making your way up the charts. But fame doesn't come easy, and everyone needs a helping hand sometimes. So we've got... | Read more »
AppSpy is hiring a part time Staff Write...
| Read more »

Price Scanner via MacPrices.net

Kanex Introduces GoPower USB-C Rechargeable B...
Kanex has announced its GoPower USB-C portable battery for the USB-C MacBook, featuring the new industry standard connector and cable used for connectivity and power. Providing users with a new... Read more
Convertible and Detachable Devices Winning Ov...
According to the latest figures published by International Data Corporation (IDC), Western European shipments of ultraslim convertibles and detachables posted positive growth (44.7%) to account for... Read more
New MacBook Pros And Will MacBook Air Be Upgr...
With my mid-2013 13-inch MacBook Air closing on its third anniversary come November, I’m in system upgrade mode. Actually the Haswell CPU equipped Air is still doing a fine job, but my good wife is... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free, and... Read more
13-inch 2.5GHz MacBook Pro on sale for $999,...
B&H Photo has the 13″ 2.5GHz MacBook Pro on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more
Textkraft Professional Becomes A Mobile Produ...
The new update 4.1 of Textkraft Professional for the iPad comes with many new and updated features that will be particularly of interest to self-publishers of e-books. Highlights include import and... Read more
SnipNotes 2.0 – Intelligent note-taking for i...
Indie software developer Felix Lisczyk has announced the release and immediate availability of SnipNotes 2.0, the next major version of his productivity app for iOS devices and Apple Watch.... Read more
Pitch Clock – The Entrepreneur’s Wingman Laun...
Grand Rapids, Michigan based Skunk Tank has announced the release and immediate availability of Pitch Clock – The Entrepreneur’s Wingman 1.1, the company’s new business app available exclusively on... Read more
13-inch 2.9GHz Retina MacBook Pro on sale for...
B&H Photo has the 13″ 2.9GHz Retina MacBook Pro (model #MF841LL/A) on sale for $1599 including free shipping plus NY tax only. Their price is $200 off MSRP. Amazon also has the 13″ 3.9GHz Retina... Read more

Jobs Board

*Apple* Nissan Service Technicians - Apple A...
Apple Automotive is one of the fastest growing dealer...and it shows. Consider making the switch to the Apple Automotive Group today! At Apple Automotive , Read more
ISCS *Apple* ID Site Support Engineer - APP...
…position, we are looking for an individual who has experience supporting customers with Apple ID issues and enjoys this area of support. This person should be Read more
Automotive Sales Consultant - Apple Ford Linc...
…you. The best candidates are smart, technologically savvy and are customer focused. Apple Ford Lincoln Apple Valley is different, because: $30,000 annual salary Read more
*Apple* Support Technician II - Worldventure...
…global, fast growing member based travel company, is currently sourcing for an Apple Support Technician II to be based in our Plano headquarters. WorldVentures is Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.