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.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Lyn 1.8.5 - Lightweight image browser an...
Lyn is a fast, lightweight image browser and viewer designed for photographers, graphic artists, and Web designers. Featuring an extremely versatile and aesthetically pleasing interface, it delivers... Read more
Apple iOS 10.2.1 - The latest version of...
iOS 10 is the biggest release of iOS ever. A massive update to Messages brings the power of the App Store to your conversations and makes messaging more personal than ever. Find your route with... Read more
Apple Security Update 2016-003 Supplemen...
Apple Security Update is recommended for all users and improves the security of OS X. For detailed information about the security content of this update, please visit: http://support.apple.com/kb/... Read more
Apple macOS Sierra 10.12.3 - The latest...
With Apple macOS Sierra, Siri makes its debut on Mac, with new features designed just for the desktop. Your Mac works with iCloud and your Apple devices in smart new ways, and intelligent... Read more
BetterTouchTool 1.992 - Customize Multi-...
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
Viber 6.5.5 - Send messages and make cal...
Viber lets you send free messages and make free calls to other Viber users, on any device and network, in any country! Viber syncs your contacts, messages and call history with your mobile device, so... Read more
Opera 42.0.2393.137 - High-performance W...
Opera is a fast and secure browser trusted by millions of users. With the intuitive interface, Speed Dial and visual bookmarks for organizing favorite sites, news feature with fresh, relevant content... Read more
iClock Pro 3.4.7 - Customize your menuba...
iClock Pro is a menu bar replacement clock for Apple's default clock. iClock Pro is an update, total rewrite and improvement to the popular iClock. Have the day, date and time in different fonts and... Read more
PhotoDesk 4.1.5 - Instagram client for p...
PhotoDesk lets you view, like, comment, and download Instagram pictures/videos. (NO Uploads! / Image Posting! Instagram forbids that! AND you need an existing Instagram account). But you can do so... Read more
Capo 3.5.1 - Slow down and learn to play...
Capo lets you slow down your favorite songs so you can hear the notes and learn how they are played. With Capo, you can quickly tab out your songs atop a highly-detailed OpenCL-powered spectrogram... Read more

Clash Royale gets some serious balance u...
| Read more »
Ironhide Game Studio prepares for a busy...
Kingdom Rush breathed fresh life into the tired tower defense genre way back in 2012. The game was a robust challenge that somehow managed to lift you up, rather than leaving you feeling crushed and hopeless. The rich array of unit types and... | Read more »
Collect pets and sling arrows in Arcane...
Mobile gaming is a crowded market, but regular updates are a good way to keep us attention-short players keen. The brand new content in Arcane Online is a prime example. Published by Japanese developer Gala, Arcane Online is a fantasy MMO that... | Read more »
Super Mario Run dashes onto Android in M...
Super Mario Run was one of the biggest mobile launches in 2016 before it was met with a lukewarm response by many. While the game itself plays a treat, it's pretty hard to swallow the steep price for the full game. With that said, Android users... | Read more »
WarFriends Beginner's Guide: How to...
Chillingo's new game, WarFriends, is finally available world wide, and so far it's a refreshing change from common mobile game trends. The game's a mix of tower defense, third person shooter, and collectible card game. There's a lot to unpack here... | Read more »
Super Gridland (Entertainment)
Super Gridland 1.0 Device: iOS Universal Category: Entertainment Price: $1.99, Version: 1.0 (iTunes) Description: Match. Build. Survive. "exquisitely tuned" - Rock Paper Shotgun No in-app purches, and no ads! | Read more »
Red's Kingdom (Games)
Red's Kingdom 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Mad King Mac has kidnapped your father and stolen your golden nut! Solve puzzles and battle goons as you explore and battle your... | Read more »
Turbo League Guide: How to tame the cont...
| Read more »
Fire Emblem: Heroes coming to Google Pla...
Nintendo gave us our first look at Fire Emblem: Heroes, the upcoming mobile Fire Emblem game the company hinted at last year. Revealed at the Fire Emblem Direct event held today, the game will condense the series' tactical RPG combat into bite-... | Read more »
ReSlice (Music)
ReSlice 1.0 Device: iOS Universal Category: Music Price: $9.99, Version: 1.0 (iTunes) Description: Audio Slice Machine Slice your audio samples with ReSlice and create flexible musical atoms which can be triggered by MIDI notes or... | Read more »

Price Scanner via MacPrices.net

Deal alert! 13-inch 2.0GHz MacBook Pros for $...
B&H Photo has the new 2016 13″ 2.0GHz non-Touch Bar MacBook Pros in stock today and on sale for $225 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro... Read more
Free LibreOffice Portable 5.2.4 Complete Offi...
PortableApps.com and The Document Foundation have announce the release of LibreOffice Portable 5.2.4. LibreOffice Portable is an Open Source full-featured office suite — including a word processor,... Read more
Apple Planning Three New Tablets For 2017 – D...
Digitimes’ Rebecca Kuo and Joseph Tsai say that unnamed insider sources report Apple having three new tablets in the pipeline for 2017 release: a 9.7-inch model with a friendly price range, a new mid... Read more
Roundup of 15-inch Touch Bar MacBook Pro sale...
B&H Photo has the new 2016 15″ Apple Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.7GHz Touch Bar... Read more
Apple refurbished iPad Pros available for up...
Apple has Certified Refurbished 9″ and 12″ Apple iPad Pros available for up to $160 off the cost of new iPads. An Apple one-year warranty is included with each model, and shipping is free: - 32GB 9″... Read more
16GB iPad Air 2, Apple refurbished, available...
Apple has Certified Refurbished 16GB iPad Air 2s available for $319 including free shipping. A standard Apple one-year is included. Their price is $60 off original MSRP for this model. Read more
Apple iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ and 27″ Apple iMacs on sale for up to $120 off MSRP, each including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2199 $100 off MSRP - 27″ 3.2GHz/1TB Fusion iMac... Read more
Apple refurbished Apple TVs available for up...
Apple has Certified Refurbished 32GB and 64GB Apple TVs available for up to $30 off the cost of new models. Apple’s standard one-year warranty is included with each model, and shipping is free: -... Read more
Save up to $350 with Apple Certified Refurbis...
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
2015 12-inch Retina MacBooks, Apple refurbish...
Apple has Certified Refurbished 2015 12″ Retina MacBooks available for up to $410 off original MSRP. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The... Read more

Jobs Board

*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Manhattan, NY Introduction: We have immediate job openings for several Desktop Support Technicians with one of our most Read more
*Apple* & PC Desktop Support Technician...
Apple & PC Desktop Support Technician job in Stamford, CT We have immediate job openings for several Desktop Support Technicians with one of our most well-known Read more
*Apple* Retail - Multiple Positions - Apple,...
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* Site Security Manager - Apple (Unite...
# Apple Site Security Manager Job Number: 54692472 Culver City, California, United States Posted: Jan. 19, 2017 Weekly Hours: 40.00 **Job Summary** The Apple Read more
*Apple* macOS Systems Integration Administra...
…most exceptional support available in the industry. SCI is seeking an Junior Apple macOS systems integration administrator that will be responsible for providing Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.