TweetFollow Us on Twitter

March 97 - Newton Q & A

Newton Q & A: Ask the Llama

Q I recently saw the announcement of two new Newton devices -- the MessagePad 2000 and the eMate 300 -- and I have a few questions. First, will my application run fine?

A If your application was written correctly for Newton OS 2.0, for the most part it will work fine on Newton OS 2.1, which is what the new devices use. "Correctly" here means that you call only documented functions, including platform file functions where appropriate. It also means that your application works with different screen sizes by using GetAppParams in combination with minimum and maximum sizes.

Q What are the most important things to check in my application to ensure that it's completely compatible with the new devices?

A There are four broad areas to check: speed, screen size, views, and PC cards.

Speed. The new units are faster than the current ones. In the case of the MessagePad 2000, the difference is quite large. Unfortunately, it's possible for some things to be too fast. The new OS takes care of several speed issues for you -- scrolling, for example -- but there are still some areas you should check.

Check those places where you're doing repeated actions from a viewClickScript. A typical usage would be a button that will continually perform an action as long as the user presses it. If you use a loop in a viewClickScript to do the repetition, you may find that there are too many repetitions or that the repetitive action occurs too quickly. The same problem can occur if you don't use the scrolling API provided by the system, as scrolling is one area that has deliberately been slowed down on the MessagePad 2000.

Loops can also cause problems when they're used for timing. In general, you shouldn't use loops for this purpose; use Ticks instead. If you must use a loop, set the counter for that loop based on a known reference like Ticks or TimeInSeconds.

Operations that used to be long enough to require user feedback may now happen fast enough that no feedback is required. This can happen in two places:

  • You may have been deliberately turning on the busy box. The result can be a busy box that flashes very briefly, which can be distracting.
  • You may have implemented progress bars using DoProgress, protoStatus, or even a protoGauge. Try removing the progress indicator and checking whether the operation is now fast enough. Note that most of the progress indicators take time to draw and update -- in some cases significantly longer than the time to do the operation for which the progress is being displayed.
Screen size. Be sure your application works properly in both portrait and landscape orientation, with the button bar on both the left and the right. In addition to the size of your overall application on the screen, check areas where you use complex justification or dynamic allocation of view children. Check that the children are correctly aligned -- and that there are the correct number of children.

Also, be sure your borders don't go outside the application area. Note that borders are drawn outside the view. You can find your global bounds with the borders by calling GlobalOuterBox.

Views. The most likely problem related to views is assuming that the top left of the application area is always at (0, 0) in global coordinates. This is no longer the case since the button bar, which is 46 pixels wide, can be on the left side of the screen. A typical place for this problem to occur is in a viewClickScript where you do something with a point that's actually 46 pixels out from where you expect it to be. Rotate to landscape orientation and put the button bar on the left; then try tapping on the right side of your application. One sure way to cause problems is to forget to send SyncView to your base application view after a ReorientToScreen message has been sent.

Another possible view problem is that any view can be the keyView. Don't assume that the keyView can accept text input; in particular, don't use calls like SetValue to jam the text slot (which may not be there). You may want to check the class of the keyView.

PC cards. You should check that your application works when two PC card slots are being used for storage. Search for the following pieces of bad code:

GetStores()[1];   // BAD -- 0 is the only number documented to work

Length(GetStores());      // doesn't tell you the number of PC cards
If you have code like this, you'll have to change it. The first case -- assuming there's a store at the second position in the array -- is not a good idea. Even if there's a store at that position, it may not be the same store that was there the last time you checked. Also note that the positions in the array do not correspond to physical PC card slot positions. The second case can fail for similar reasons. That is, checking the length of the array returned by GetStores doesn't tell you how many PC cards are currently installed.

Along the same lines, if you're still using the action (routing) picker to move items to the card, you should change to using the filing interface. Also, make sure that you use the FileThis method to move items to different stores, and that you look at the arguments provided by FileThis; some application code seems to assume that there are only two stores. For adding soup entries, remember to call AddToDefaulStoreXmit instead of using the store directly.

You might also encounter a problem with endpoints that could use PC card modems. To set up your modem endpoint, call MakeModemOption, which will construct the correct options based on the user modem preferences and available PC card modems.

Q Are there any features that are important to support in the new devices?

A The most important thing is to make sure your application works. After that, there are some important updates you can make to support features in the new devices.

First, make sure your application can be dragged, assuming of course that it's not full-screen in all orientations. You can do this by changing your base view to a protoDragger with either some sort of status bar (preferably newtStatusBar) or a protoLargeCloseBox. Remember to make sure the borders of the protoDragger will be contained in the application area; you can use GlobalOuterBox to check this. And while you're at it, you can check that your application will handle any screen size.

You may also want to see whether you can improve your use of screen space. Note that your major layouts (for example, detail and overview) don't have to be the same size. The Names application is a good example of this.

Another important feature to support is the use of the keyboard. Add the required keyboard commands to your application. As of this writing you can find this information in the "User Interface Guidelines for Newton OS 2.1 Keyboard Enhancements" document. If your application is based on NewtApp, most of this work is done for you; otherwise you'll have to add almost all the keyboard commands yourself. Once you've supported the required set, add other commands that make sense for your application. Don't forget keyboard navigation in your overview.

A related feature that's good to support on both Newton OS 2.0 and 2.1 devices is conditional display of embedded keyboards. You can use the KeyboardConnected global function to check whether a keyboard is connected; if it is, don't display embedded keyboards unless they're highly specialized.

If you're using the infrared (IR) communications tool, you should use IrDA if possible. This will give you a faster transfer rate and a much more robust protocol. If your application might be communicating with older units, be sure to give your users a choice of IR connection types, since older units can only use the ASK protocol. Newton OS 2.1 still supports all the IR options from 2.0. Note that using the action menu to beam information will do the right thing.

You should also take advantage of the grayscale feature, by using the new RGB-based gray shades (that is, kRGB_Gray1 through 15) instead of the dithered gray patterns. Dithered patterns are usually specified as vfGray, vfLightGray, and so on. You can also change your own patterns to use grayscale. Although the dithered patterns still work, the true gray RGB shades look a lot better. You'll want to wrap the specification in a check to make sure that grayscale is available. Naturally you'll want to update important parts of your application to use grayscale -- for example, your splash screen and Extras icon.

Finally, if you're targeting the eMate and the education market, you should update your application for multiuser mode. This could be an extensive change, since you'll have to modify your interface and the names of all soups that you save.


The llama is the unofficial mascot of the Developer Technical Support group in Apple's Newton Systems Group. Send your Newton-related questions to dr.llama@newton.apple.com. The first time we use a question from you, we'll send you a T-shirt.*

Thanks to jXopher Bell, Bob Ebert, David Fedor, Ryan Robertson, Jim Schram, Maurice Sharp, and Bruce Thompson for these answers.*

If you need more answers, take a look at the Newton developer Web page, at http://www.devworld.apple.com/dev/newtondev.shtml.*

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Spotify 1.0.36.124. - Stream music, crea...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
Firefox 48.0.2 - 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
BBEdit 11.6.1 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
OmniGraffle Pro 6.6.1 - Create diagrams,...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
OmniGraffle 6.6.1 - Create diagrams, flo...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Dropbox 8.4.21 - Cloud backup and synchr...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
BetterTouchTool 1.84 - Customize Multi-T...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
ScreenFlow 6.1 - Create screen recording...
ScreenFlow is powerful, easy-to-use screencasting software for the Mac. With ScreenFlow you can record the contents of your entire monitor while also capturing your video camera, microphone and your... Read more
f.lux 37.7 - Adjusts the color of your d...
f.lux makes the color of your computer's display adapt to the time of day, warm at night and like sunlight during the day. Ever notice how people texting at night have that eerie blue glow? Or wake... Read more
BetterTouchTool 1.84 - Customize Multi-T...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more

Become the King of Avalon in FunPlus’ la...
King Arthur is dead. Considering the legend dates back to the 5th century, it would be surprising if he wasn’t. But in the context of real-time MMO game King of Avalon: Dragon Warfare, Arthur’s death plunges the kingdom into chaos. Evil sorceress... | Read more »
Nightgate (Games)
Nightgate 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: *** Launch Sale: 25% OFF for a limited time! *** In the year 2398, after a great war, a network of intelligent computers known as... | Read more »
3 best fantasy football apps to get you...
Last season didn't go the way you wanted it to in fantasy football. You were super happy following your drafts or auctions, convinced you had outsmarted everyone. You were all set to hustle on the waiver wire, work out some sweet trades, and make... | Read more »
Pokemon GO update: Take me to your leade...
The Team Leaders in Pokemon GO have had it pretty easy up until now. They show up when players reach level 5, make their cases for joining their respective teams, and that's pretty much it. Light work, as Floyd Mayweather might say. [Read more] | Read more »
Ruismaker FM (Music)
Ruismaker FM 1.0 Device: iOS Universal Category: Music Price: $4.99, Version: 1.0 (iTunes) Description: Following up on the success of Ruismaker, here's her crazy twin-sister, designed for people who want to design their own... | Read more »
Space Marshals 2 (Games)
Space Marshals 2 1.0.15 Device: iOS iPhone Category: Games Price: $5.99, Version: 1.0.15 (iTunes) Description: The sci-fi wild west adventure in outer space continues with Space Marshals 2. This tactical top-down shooter puts you in... | Read more »
Dungeon Warfare (Games)
Dungeon Warfare 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: Dungeon Warfare is a challenging tower defense game where you become a dungeon lord to defend your dungeon against greedy... | Read more »
Solitairica (Games)
Solitairica 1.0.7 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.7 (iTunes) Description: Solitairica takes RPG combat and challenging rogue-like progression to a fresh new place—the world of solitaire! | Read more »
Bowmasters tips, tricks and hints
At least for this writer, archery was one of the more pleasant surprises of the 2016 Rio Olympics. As opposed to target shooting with guns, which was dreadfully boring, watching people shoot arrows at targets was pretty darn cool. [Read more] | Read more »
Best apps for watching live TV
The Olympics have come and gone, leaving nearly everyone in a temporary state of "What the heck am I going to watch on TV right now?" Besides old reruns of Golden Girls, but that goes without saying. [Read more] | Read more »

Price Scanner via MacPrices.net

27-inch iMacs on sale for up to $220 off MSRP
B&H Photo has 27″ Apple iMacs on sale for up to $200 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2099 $200 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1899 $100... Read more
Apple refurbished 13-inch MacBook Airs availa...
Apple has Certified Refurbished 2016 and 2015 13″ MacBook Airs now available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 2016 13″ 1.6GHz/8GB/... Read more
Apple refurbished iPad mini 2s available for...
Apple is offering Certified Refurbished iPad mini 2s for up to $80 off the cost of new minis. An Apple one-year warranty is included with each model, and shipping is free: - 16GB iPad mini 2 WiFi: $... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more
Mac Pros on sale for $200 off MSRP
B&H Photo has Mac Pros on sale for $200 off MSRP. Shipping is free, and B&H charges sales tax in NY only: - 3.7GHz 4-core Mac Pro: $2799, $200 off MSRP - 3.5GHz 6-core Mac Pro: $3799, $200... Read more
Will We See A 10.5″ iPad Pro in 2017? – The ‘...
A MacRumors report, cites a research note from KGI Securities analyst Ming-Chi Kuo, saying a new size iPad model is in the works. According to the highly respected Cho, who has a strong track record... Read more
IOGEAR USB-C Docking Station Transforms Lapto...
IOGEAR has announced the launch of its innovative USB-C Docking Station with Power Delivery which turns USB-C enabled laptops into desktop workstations. The new IOGEAR USB-C Docking Station features... Read more
12-inch Retina MacBooks on sale for up to $10...
Amazon has 2016 12″ Apple Retina MacBooks on sale for $100 off MSRP. Shipping is free: - 12″ 1.1GHz Space Gray Retina MacBook: $1199 $100 off MSRP - 12″ 1.1GHz Silver Retina MacBook: $1224.99 $75 off... Read more
13-inch 2.5GHz MacBook Pro (Apple refurbished...
Apple has Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros... Read more
21-inch iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ iMacs on sale for up to $120 off MSRP including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1379 $120 off MSRP - 21″ 2.8GHz iMac: $1199.99 $100 off MSRP - 21″ 1... Read more

Jobs Board

*Apple* Mobile Master - Best Buy (United Sta...
What does a Best Buy Apple Mobile Master do? At Best Buy, our mission is to leverage the unique talents and passions of our employees to inspire, delight, and enrich Read more
*Apple* Retail - Multiple Positions Akron, O...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Simply Mac *Apple* Specialist- Repair Techn...
…The Technician is a master at working with our customers to diagnose and repair Apple devices in a manner that exceeds the expectations set forth by Apple Read more
*Apple* Retail - Multiple Positions Germanto...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Professional Learning Specialist - A...
# Apple Professional Learning Specialist Job Number: 51234379 Portland, Maine, Maine, United States Posted: Aug. 18, 2016 Weekly Hours: 40.00 **Job Summary** The Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.