TweetFollow Us on Twitter

Jun 97 - Newton Q and A

Volume Number: 13 (1997)
Issue Number: 6
Column Tag: develop

Newton Q&A: Ask the Llama

by Apple Developer Technical Support Group

Q: I'm probably missing something obvious, but when I try to use an asynchronous output call in some situations, I get an exception, while synchronous calls seem to work fine. For instance, this code fails consistently with bus errors:

endpoint:output(headerCache,
   nil,
   {async: true,
   form: 'string,
   completionScript: func(ep, options, result)
      self:SendData(endpoint, qfCursor)});

On the other hand, this code works fine:

endpoint:output(headerCache, nil, nil);
self:SendData(endpoint, qfCursor);

I'd really prefer to use asynchronous calls, but I keep running into problems. Do you have any suggestions?

A: The key thing you're missing is that self (that is, the receiver) is not what you expect in your asynchronous callback. In your first example, you pass a completion frame as the third argument of the Output message. It's this frame that will be self (that is, that will be the context of the completionScript). This means that you send the sendData message to that completion frame.

What you probably want is to send the message to the ep argument passed to the completionScript. This will be the endpoint to which you sent the Output message. In general, you will have set this endpoint to have a _parent slot that points to your application. Assuming that the sendData method is in either the endpoint or your application, you would modify the body of the completionScript to be

ep:sendData(endpoint, qfCursor);

The same restrictions apply for Input and Option calls as well.


Q: I have a pop-up view that has an icon with some text, and I'd like the user to be able to edit the icon. I call MakeShape on the icon and draw it into a bitmap. I then have an interface for the user to modify the icon. The problem occurs when I try to display the modified icon in the pop-up. It either doesn't show up, has incorrect bounds, or throws an exception. Before I modify the icon, it looks like something that would be returned by GetPictAsBits:

{data: <bits, Length 42>, bounds: {0,0,15,15}, }

Once I call MakeShape on the icon, it looks like this:

{class: bitmap, bounds: <boundsRect, Length 8>,
   data: <pixels, Length 54>, }

The pop-up chokes on this when I try to display it. First it threw an exception because it was expecting a frame instead of a binary object in the bounds frame. So I called SetBounds to set the bounds frame to {0,0,15,15}. This enabled the pop-up to open, but the icon wasn't in the right place. Fiddling with the bounds frame didn't seem to help. So I'm guessing that the next problem is that I have pixels instead of bits in the data slot. I tried calling SetClass on the slot to change it from pixels to bits. That actually didn't throw an exception, but the length is still different and it didn't look right. How can I get my shape or bitmap back into a form that the pop-up will be happy with?

A: The basic problem is that the binary object used by MakeShape to represent the picture (that is, <pixels, Length 54>) is not the same as that used in the bitmap structure (<bits, Length 42>). You have a couple of choices. Since the formats are documented, you can write some code to convert the object returned by MakeShape into a NewtonScript bitmap object. The other option, which seems more complex but is probably easier to implement, is to use the MakeShape representation only for your icon editor. Let the user modify the MakeShape representation, but keep track of the changes and use them to modify the bitmap. So, while the user is editing the icon, there will be two data objects: the original icon representation using the bitmap data structure and the MakeShape representation that the user sees and modifies. As the user changes the MakeShape object, your code is also modifying the bitmap object.

As a related side note, you can use DrawIntoBitmap to get the bits that represent the shape.


Q: In an application I'm building, I want to keep a serial communication session open with a GPS unit 24 hours a day, unattended by the user. Both the MessagePad and the GPS unit are powered by the car. The GPS unit sends out data approximately every two seconds. I'm using the "Basic Serial" Newton DTS sample code as the starting point. The communications code in the application works fine except that occasionally I get a -18003 exception, which results in a kMessage_BufferOverrun message. I've tried turning on useSoftFlowControl and useHardFlowControl in the kCMOInputFlowControlParms parameter frame inside the MBuildConfigOptions method, but that doesn't seem to help.

Can you explain when/why this exception is raised? Can I safely ignore the exception by revising the MNotifyError method? What can I do to prevent the occurrence of the exception in the first place?

A: A -18003 error can indicate several things, including bad parity or a framing error. Usually it indicates that the Newton's UART (SCC chip) buffer has overrun. You can just ignore this error, repost the input specification, and go on your merry way.

To repost the input specification, call the endpoint's SetInputSpec with the relevant input specification. Before reposting the input specification, you may also want to flush the communication tools buffers using the serial discard data option (kCMOSerialDiscard) and flush the NewtonScript buffer with FlushInput. Regardless of whether you flush, you will have lost some data in the process, although for most GPS applications that should be fine. You may also want to try increasing the size of the serial input buffer; this might give you just enough time to process all the data.

A better solution would be to have the GPS receiver support some type of flow control, though this will depend on the manufacturer of the unit.


Q: I have a view with a protoKeyboard button. The input lines within the view all take numeric input, and when the user double-taps, the numeric keypad pops up. But the keyboard button brings up the full QWERTY keyboard instead. How can I make the button open the numeric keypad?

A: The keyboard button is behaving correctly. If you don't specify which keyboard to open, it will always open the global alphanumeric keyboard. There are two ways you can get the behavior you want:

  • Override the 'defaultKeyboard slot in your protoKeyboardButton. This slot contains the keyboard that you want to use. In this case you want the symbol 'numericKeyboard, which specifies the default numeric keyboard.
  • Override the buttonClickScript in the protoKeyboardButton. You can use the OpenKeypadFor function and specify your input line as the view. This will usually do the right thing since calling OpenKeypadFor has just about the same effect as the user's double-tapping in an input line.

Q: I noticed that the NTK project preferences dialog lets you compress your application. How much slower will the application run if I do this?

A: Unfortunately, there's no simple answer to this question. The speed of execution depends on a number of factors, including how many times the system has to uncompress pages from your application into a cache and how full the system heap is.

The best way to find out is to try your application with the three different compression options: none, compressed, or faster compression. Make sure that you perform your tests a number of times and under different memory-loading conditions. If your application will be doing communications, that's a good thing to test. You can also use HeapShow (which comes with NTK) to fill the system and NewtonScript heaps to simulate low-memory conditions.

 
AAPL
$105.22
Apple Inc.
+0.39
MSFT
$46.13
Microsoft Corpora
+1.11
GOOG
$539.78
Google Inc.
-4.20

MacTech Search:
Community Search:

Software Updates via MacUpdate

Tonality Pro 1.1.2 - Professional-grade...
Tonality Pro gives you the power to create stunning and dramatic black & white images. This is a complete monochrome image editor with more than 150 one-click style presets, totally unique... Read more
VueScan 9.4.49 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
OS X Server 4.0 - For OS X 10.10 Yosemit...
Designed for OS X and iOS devices, OS X Server makes it easy to share files, schedule meetings, synchronize contacts, develop software, host your own website, publish wikis, configure Mac, iPhone,... Read more
TotalFinder 1.6.12 - Adds tabs, hotkeys,...
TotalFinder is a universally acclaimed navigational companion for your Mac. Enhance your Mac's Finder with features so smart and convenient, you won't believe you ever lived without them. Tab-based... Read more
BusyCal 2.6.3 - Powerful calendar app wi...
BusyCal is an award-winning desktop calendar that combines personal productivity features for individuals with powerful calendar sharing capabilities for families and workgroups. BusyCal's unique... Read more
calibre 2.7 - Complete e-library managem...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital... Read more
Skitch 2.7.3 - Take screenshots, annotat...
With Skitch, taking, annotating, and sharing screenshots or images is as fun as it is simple.Communicate and collaborate with images using Skitch and its intuitive, engaging drawing and annotating... Read more
Delicious Library 3.3.2 - Import, browse...
Delicious Library allows you to import, browse, and share all your books, movies, music, and video games with Delicious Library. Run your very own library from your home or office using our... Read more
Art Text 2.4.8 - Create high quality hea...
Art Text is an OS X application for creating high quality textual graphics, headings, logos, icons, Web site elements, and buttons. Thanks to multi-layer support, creating complex graphics is no... Read more
Live Interior 3D Pro 2.9.6 - Powerful an...
Live Interior 3D Pro is a powerful yet very intuitive interior designing application. View Video Tutorials It has every feature of Live Interior 3D Standard, plus some exclusive ones: Create multi... Read more

Latest Forum Discussions

See All

Rami Ismail Opens Up distribute​() for D...
Rami Ismail Opens Up distribute​() for Developers Posted by Jessica Fisher on October 24th, 2014 [ permalink ] Rami Ismail, Chief Executive of Business and Development at indie game studio | Read more »
Great Hitman GO Goes on Sale and Gets Ne...
Great Hitman GO Goes on Sale and Gets New Update – Say That Three Times Fast Posted by Jessica Fisher on October 24th, 2014 [ permalink ] | Read more »
Rival Stars Basketball Review
Rival Stars Basketball Review By Jennifer Allen on October 24th, 2014 Our Rating: :: RESTRICTIVE BUT FUNUniversal App - Designed for iPhone and iPad Rival Stars Basketball is a fun mixture of basketball and card collecting but its... | Read more »
Rubicon Development Makes Over a Dozen o...
Rubicon Development Makes Over a Dozen of Their Games Free For This Weekend Only Posted by Jessica Fisher on October 24th, 2014 [ permalink ] | Read more »
I Am Dolphin Review
I Am Dolphin Review By Jennifer Allen on October 24th, 2014 Our Rating: :: NEARLY FIN-TASTICUniversal App - Designed for iPhone and iPad Swim around and eat nearly everything that moves in I Am Dolphin, a fun Ecco-ish kind of game... | Read more »
nPlayer looks to be the ultimate choice...
Developed by Newin Inc, nPlayer may seem like your standard video player – but is aiming to be the best in its field by providing high quality video play performance and support for a huge number of video formats and codecs. User reviews include... | Read more »
Fighting Fantasy: Caverns of the Snow Wi...
Fighting Fantasy: Caverns of the Snow Witch Review By Jennifer Allen on October 24th, 2014 Our Rating: :: CLASSY STORYTELLINGUniversal App - Designed for iPhone and iPad Fighting Fantasy: Caverns of the Snow Witch is a sterling... | Read more »
A Few Days Left (Games)
A Few Days Left 1.01 Device: iOS Universal Category: Games Price: $3.99, Version: 1.01 (iTunes) Description: Screenshots are in compliance to App Store's 4+ age rating! Please see App Preview for real game play! **Important: Make... | Read more »
Toca Boo (Education)
Toca Boo 1.0.2 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0.2 (iTunes) Description: BOO! Did I scare you!? My name is Bonnie and my family loves to spook! Do you want to scare them back? Follow me and I'll... | Read more »
Intuon (Games)
Intuon 1.1 Device: iOS Universal Category: Games Price: $.99, Version: 1.1 (iTunes) Description: Join the battle with your intuition in a new hardcore game Intuon! How well do you trust your intuition? Can you find a needle in a... | Read more »

Price Scanner via MacPrices.net

Weekend sale: 13-inch 128GB MacBook Air for $...
Best Buy has the 2014 13-inch 1.4GHz 128GB MacBook Air on sale for $849.99, or $150 off MSRP, on their online store. Choose free home shipping or free local store pickup (if available). Price valid... Read more
Nimbus Note Cross=Platform Notes Utility
Nimbus Note will make sure you never forget or lose your valuable data again. Create and edit notes, save web pages, screenshots and any other type of data – and share it all with your friends and... Read more
NewerTech’s Snuglet Makes MagSafe 2 Power Con...
NewerTech has introduced the Snuglet, a precision-manufactured ring designed to sit inside your MagSafe 2 connector port, providing a more snug fit to prevent your power cable from unintentional... Read more
Apple Planning To Sacrifice Gross Margins To...
Digitimes Research’s Jim Hsiao says its analysts believe Apple is planning to sacrifice its gross margins to save its tablet business, which has recently fallen into decline. They project that Apple’... Read more
Who’s On Now? – First Instant-Connect Search...
It’s nighttime and your car has broken down on the side of the highway. You need a tow truck right away, so you open an app on your iPhone, search for the closest tow truck and send an instant... Read more
13-inch 2.5GHz MacBook Pro on sale for $949,...
Best Buy has the 13″ 2.5GHz MacBook Pro available for $949.99 on their online store. Choose free shipping or free instant local store pickup (if available). Their price is $150 off MSRP. Price is... Read more
Save up to $125 on Retina MacBook Pros
B&H Photo has the new 2014 13″ and 15″ Retina MacBook Pros on sale for up to $125 off MSRP. Shipping is free, and B&H charges NY sales tax only. They’ll also include free copies of Parallels... Read more
Apple refurbished Time Capsules available sta...
The Apple Store has certified refurbished Time Capsules available for up to $60 off MSRP. Apple’s one-year warranty is included with each Time Capsule, and shipping is free: - 2TB Time Capsule: $255... Read more
Textilus New Word, Notes and PDF Processor fo...
Textilus is new word-crunching, notes, and PDF processor designed exclusively for the iPad. I haven’t had time to thoroughly check it out yet, but it looks great and early reviews are positive.... Read more
WD My Passport Pro Bus-Powered Thunderbolt RA...
WD’s My Passport Pro RAID solution is powered by an integrated Thunderbolt cable for true portability and speeds as high as 233 MB/s. HighlightsOverviewSpecifications Transfer, Back Up And Edit In... Read more

Jobs Board

*Apple* Solutions Consultant - Apple Inc. (U...
…important role that the ASC serves is that of providing an excellent Apple Customer Experience. Responsibilities include: * Promoting Apple products and solutions Read more
Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, 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
Project Manager / Business Analyst, WW *Appl...
…a senior project manager / business analyst to work within our Worldwide Apple Fulfillment Operations and the Business Process Re-engineering team. This role will work Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.