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

Grab it now: Game Craft’s Legend of War...
The real time strategy game is now available for you to sink your teeth into, through the App Store and Google Play. Combining elements of skill, strategy and empire building, Legend of War is a real gamers’ game. [Read more] | Read more »
Skateboard Party 3 ft. Greg Lutzka (Gam...
Skateboard Party 3 ft. Greg Lutzka 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Skateboard Party is back! This third edition of the popular sports franchise features professional skater... | Read more »
Cubious (Games)
Cubious 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: Cubious – How smart are you? How high is your IQube? Solve the impossible puzzles to find out, and help a lost little cube find his... | Read more »
Goat Simulator Waste of Space (Games)
Goat Simulator Waste of Space 1.1 Device: iOS Universal Category: Games Price: $4.99, Version: 1.1 (iTunes) Description: ** IMPORTANT - SUPPORTED DEVICESiPhone 4S, iPad 2, iPod Touch 5 or better.** | Read more »
Wildfulness - Unwind in nature and calm...
Wildfulness - Unwind in nature and calm your mind with nature sounds and illustrations 1.0 Device: iOS Universal Category: Healthcare & Fitness Price: $1.99, Version: 1.0 (iTunes) Description: Spending time in nature helps you to... | Read more »
Dr. Panda Racers (Education)
Dr. Panda Racers 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: STEP ON THE GAS, RACE AND WIN!Fasten your seat belts and get ready to race! Speed your way to the finish line while doing... | Read more »
ROMANCING SAGA 2 (Games)
ROMANCING SAGA 2 1.0.0 Device: iOS Universal Category: Games Price: $17.99, Version: 1.0.0 (iTunes) Description: Romancing SaGa 2, originally released only in Japan in 1993, has been completely remastered and now receives its first... | Read more »
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 »

Price Scanner via MacPrices.net

Goal Zero and OtterBox Partner to Expand iPh...
Goal Zero, specialists in portable power, have announced a partnership with OtterBox, brand smartphone case protection, to offer the Slide and Slide Plus Batteries as modules compatible with the new... Read more
15-inch Retina MacBook Pros on sale for up to...
B&H Photo has 15″ Retina MacBook Pros on sale for up to $210 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off MSRP - 15″ 2.5GHz Retina... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $799... 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
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.99 $120 off MSRP - 21″ 2.8GHz iMac: $1189 $110 off MSRP - 21″ 1... Read more
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

Jobs Board

Editor, *Apple* News - APPLE (United States...
Job Summary The Apple News team is looking for a passionate and knowledgeable editor with experience covering entertainment/pop culture and experience running social Read more
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.