TweetFollow Us on Twitter

March 96 - Newton Q & A: Ask the Llama

Newton Q & A: Ask the Llama

Q Now that Newton 2.0 is shipping, what has changed?

A A fair question, and one that's been much on my mind. Newton 2.0 solves some of the problems previously presented in this column in much better ways. So I've gone back over old questions to see what has changed. I'll start out this time by revisiting those questions that have new answers. (Questions that dealt with subsystems whose APIs on the Newton 2.0 OS are drastically different will not be covered; most of these have to do with routing, which has undergone a significant change for the better, while some have to do with communications.)

Q How do I create my own class of binary object? (Issue 18)

A In the Newton 1.x OS you had to use SetClass on a string object to make some other binary object. In 2.0 you can just call the new function MakeBinary. So the line of code to define the canonical CharID object (see the original answer) changes to

DefConst('kDefaultCharIDOBj, MakeBinary(4, 'CharID)); 
Q I would like to add a [button|view|Llama] to [Notes|Dates|Names| etc.]. How can I do that safely? (Issue 19)

A In the Newton 1.x OS there was no supported way to add items to the built-in applications. In 2.0 there are a few ways you can do this.

For general changes, you can add new stationery to Notes, Dates, and Names. For example, you could add graph paper to Notes. You could also define new card styles or views of a person in Names.

Names and Dates also let you add whole new classes of things. For instance, you could add a Pet type of names entry that would appear in the New pop-up menu along with Person, Company, and Group.

The Dates application has an API to add new types of meetings. It also lets you add items to its Info button.

In addition, there's a general API to register buttons that can show up in the "blessed" application's status bar. It's up to each application to decide whether and how it will display registered buttons. You should no longer use the unsupported keyboardChicken hack.

Note that on the Newton 2.0 platform there's still no support for adding buttons to built-in slips. For example, if you wanted to add something to the alarm picker for a meeting, you would need to add a new type of stationery that's a superset of the alarm picker.

Q I've written my own IsASCIIAlpha, IsASCIINumeric, etc. functions. They seem to be really slow. Why is that? Here's my IsASCIIAlpha: [code not repeated here; all the functions work on strings] (Issue 20)

A Most of the comments from the original answer still hold. However, in the Newton 2.0 OS the string could be a rich string; that is, there could be an ink character inside the string. That means the compare functions have to check whether a particular character was kInkChar.

Q When I try to add an index to my soup I sometimes get an exception -48019, but not always. What's going on? (Issue 22)

A In early versions of Newton, if you added an index on a slot, and an entry in that soup had a value of nil for that slot, you would get an error. As of the Newton 2.0 OS this is no longer a problem. You can add an index even if there are entries with nil values for the slot in the soup.

Q I have an application that uses ADSP to connect to a server on the desktop. I want the server to handle multiple Newton devices connected simultaneously. Unfortunately, if a connection fails after it's opened, the server doesn't seem to be able to identify it as a new connection when the Newton device reconnects. This causes problems in the server's ability to handle multiple connections. Can you help? (Issue 23)

A In the Newton 2.0 OS this no longer occurs. The Newton device will generate a new ID for the connection.

Q Since there are changes between Newton 1.x and 2.0, what features in 2.0 can I rely on? What is the core set that defines Newton 2.0?

A At this time there is no published core set of NewtonScript-level features that you can rely on. We're confident that you can rely on the features of the NewtonScript language and major components like the view system and communication endpoint interface. However, you can't count on individual protos or even the internal applications being there. Since we license Newton technology to other companies, they could produce a Newton device that doesn't include Names, Dates, or other built-in features. They may also produce Newton devices that have features that aren't present in Apple products.

The key is to test the features you rely on. If you find that some of the features you need are missing, you can either run in a less-featured mode or just not open your application. As a simple example, suppose your application runs only in a limited set of screen sizes and aspect ratios. You can give your base application view a viewSetupFormScript that looks something like this:

myBaseView.viewSetupFormScript := func()
begin
    local screenSize := GetAppParams();
    local aspectRatio := screenSize.appAreaWidth / 
                                screenSize.appAreaHeight;

    // very simplistic test, no MINIMUM even!
    if aspectRatio > 1.0 then    // landscape
    begin
        local maxHeight := kMaxAppWidth;
        local maxWidth := kMaxAppHeight;
    end;
    else begin                      // portrait or square
        local maxHeight := kMaxAppHeight;
        local maxWidth := kMaxAppWidth;
    end;

    if screenSize.appAreaWidth <= maxWidth AND
        screenSize.appAreaHeight <= maxHeight then
    begin
        self.viewBounds := RelBounds(...);
        // other setup stuff
        ...
    end
    else begin
        // cannot operate at screen size
        :Notify(kNotifyAlert, EnsureInternal(kAppName),
            EnsureInternal(kErrorWrongScreenSize));
        AddDeferredSend(self, 'Close, nil);
    end;
end;
For global functions and variables, you can use the GlobalFnExists and GlobalVarExists utility functions. To find out whether a built-in application exists, you can check the root view with the appropriate symbol:
// check for Dates
if GetRoot().calendar then
    ...
// check for Names
if GetRoot().cardfile then
    ...
// check for Extras
if GetRoot().extrasDrawer then
    ...
For protos, you can try to access the proto and catch a frame reference exception. If the exception occurs, the proto is not present.

In general, it's a wise idea to do all your existence testing as your application is launching. Set flags in your base application so that you test for existing features only once.

Q Is there a hardware-unique ID that I can access on a Newton device?

A At this time there's no built-in hardware-unique ID, nor is there an API for accessing one if it existed. However, this doesn't rule out having such an API in future Newton devices.

Q I'm using a Newton 2.0 protoSoupOverview and I want to change the font style. How do I do that?

A This is one of those things that are obvious once you make the connection. You use the Abstract method of protoSoupOverview (and protoOverview, for that matter) to build the shape that's displayed for a particular soup entry. Notice that you're returning a shape, with all that entails. The chapter on drawing in the Newton Programmer's Guide says you can include a styles entry in a shape array, allowing you to specify things like font style. See the DTS Sample Code Checkbook on the Newton Developer CD for an example.

Q I noticed that some of the built-in applications have keyboards in their slips -- for example, the new name editor in the Names file. Is this stationery based? Is there a magic slot I can set? Is there a proto?

A Those keyboards are just views based on protoKeypad that are laid out as a child view of the slip. All you need to do is lay out your own protoKeypad and set up the definitions appropriately. There is no supported magic slot.

Q I'm trying to use a protoListPicker to display a soup structure that has nested frame entries. I can't get the listPicker to work. Am I doing something wrong?

A No. The default listPicker proto doesn't work with items that are accessed via path expressions. However, if you make the following three changes, your listPicker should work fine.

First, you have to specialize the GetObjSlot method of your pickerDef:

GetObjSlot: func(item, fieldPath)
begin
    if ClassOf(fieldPath) <> 'pathExpr then
        // if not a path expression, return the inherited value
        return inherited:GetObjSlot(item, fieldPath);

    // otherwise, if there is no item, return nil
    if not item then
        return nil;

    // there is an item, so get the real value, since the item
    // could be a NameRef or an Entry
    if IsNameRef(item) then
        local val := EntryFromObj(item);
    else
        val := item;

    // assuming we have a real thing, access the real data via the
    // path expression in fieldPath
    if val then
        val.(fieldPath);
end
Second, if you specify a validation frame in for your listPicker, the nesting of that frame must match the nesting of your soup entry.

Finally, modify your pickerDef so that the column that displays the data based on the index path uses the appropriate index path.


The llama is the unofficial mascot of the Developer Technical Support group in Apple's Newton Systems Group. Send your Newton-related questions to NewtonMail or eWorld DRLLAMA or to AppleLink DR.LLAMA. The first time we use a question from you, we'll send you a T-shirt.*

Thanks to our Newton Partners for the questions used in this column, and to jXopher Bell, Henry Cate, Bob Ebert, David Fedor, Jim Schram, Maurice Sharp, and Bruce Thompson for the answers.*

If you need more answers, check out http://dev.info.apple.com/newton on the World Wide Web or look at Newton Developer Info on AppleLink.*

 
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

Reddme for iPhone - The Reddit Client (...
Reddme for iPhone - The Reddit Client 1.0 Device: iOS iPhone Category: News Price: $.99, Version: 1.0 (iTunes) Description: Reddme for iPhone is an iOS 7-optimized Reddit client that offers a refreshing new way to experience Reddit... | Read more »
Jacob Jones and the Bigfoot Mystery : Ep...
Jacob Jones and the Bigfoot Mystery : Episode 2 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Jacob Jones is back in Episode 2 of one of Apples 'Best of 2013' games and an App Store... | Read more »
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 »

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 Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full 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* 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.