TweetFollow Us on Twitter

June 95 - Newton Q & A: Ask the Llama

Newton Q & A: Ask the Llama

Newton Developer Tecchnical Support

Q When I try to print or fax something, the Newton usually runs out of memory. I'm sending a lot of data to my print format, but it seems that the fields frame passed to SetupRoutingSlip should have only a reference to the data. What am I doing wrong?

A Unfortunately, you're missing one important step in the process of printing. The fields frame is eventually placed in the outbox soup. Thus all references are followed, which means that all the data you placed in the fields frame is duplicated. The duplication occurs in the soup:Add call.

In other words, you probably have a large data structure (or view, or proto) in your application. You put a reference to this structure in the fields frame in SetupRoutingSlip. When the user accepts the item to be printed (or faxed, beamed, or whatever), the fields frame is placed in the outbox soup, causing your structure to be duplicated.

Ideally, you should pass as little data as possible in the fields frame. As an example, assume that your data is all in a soup. You would pass information that allowed you to construct a query that returned the soup data of interest. This may be the index to search on plus the key to search for. You may even pass the query frame itself. Note that any changes made from the time the print request is made to the time the printing occurs will be reflected in the printed items. This may not be what you want. As in most cases, there are tradeoffs.

Q I'd like to have something like a viewIdleScript in my communications endpoint. The endpoint proto doesn't contain a way to do this. What's a good way to do it?

A One solution is to include your endpoint in a view object, such as a clView. You can then treat the whole clView as the communications object. You can use the view messages associated with opening a view to manage the control of your endpoint. Similar things can be done with viewQuitScript. And of course you can use a viewIdleScript.

Also note that using a view gives you a way to provide visual feedback (assuming it makes sense). Take a look at protoLlamaTalk in the LlamaTalk sample on this issue's CD for an example.

Q How do I get a text view to redraw itself with a new font?

A Simply use SetValue on the viewFont slot:

SetValue(theParaView,
	'viewFont,
	{family: 'espy, face: kFaceBold, size: 12});

Q I'm trying to use a view that has vfFillGray as the background. I've found that it looks really bad. Why is this?

A The pattern vfFillGray is an alternating on/off checkerboard pattern of pixels (that is, 50% gray). With the current state of the technology, all passive LCDs have problems displaying large areas of 50% gray (or large areas of black). The problem (called crosstalk ) is worse when you have alternating on and off pixels. Basically, the LCD freaks out. You should avoid using large areas of 50% gray where possible.Q When I try to add an index to my soup I sometimes get an exception -48019, but not always. What's going on?

A That particular exception indicates that an entry in your soup has a value of NIL in the slot you're trying to create an index for (that is, the entry contains the slot with a value of NIL). You can easily recreate this error by trying to add an index on the bday slot in the names file. Here's some code that you can type in the inspector:

call func()
begin
	local nameSoup := GetStores()[0]:GetSoup(ROM_cardfilesoupname);
	nameSoup:AddIndex(
		{structure: 'slot, path: 'bday, type: 'Int});
end with ();

In this case the error occurs because the default cardfile entry has a value of NIL for the bday slot. The solution is to make sure that there are no soup entries with a value of NIL for the slot that you want to use for the new index. This is best done in the design of your soup data.

If this isn't possible, the only solution is to make sure that all entries in the soup either have a valid value for the new index slot or do not contain the new index slot. Unfortunately, you don't know in advance if the new index will fail. In this case you can wrap the code that adds the index in a try/onexception clause. If an exception occurs that has the -48019 error number, you know that you have to iterate through the soup and fix entries.

Also note that you may want to keep a list of those "fixed" entries around since you may have to unfix them after the index has been added. In other words, it's OK for an entry to have a NIL value in an indexed slot after the index has been added to the soup.

Q I have a protoA2Z_TDS controlling a protoTextList. There are two things this combination doesn't do: (1) As the protoTextList contents are scrolled, the protoA2Z_TDS doesn't update the current letter, and (2) when the user clicks on a letter in the protoA2Z_TDS, I want to scroll the protoTextList to the appropriate place. How do I do these things?

A For those who may not know, protoA2Z_TDS is sample code provided by PIE Developer Technical Support. In answer to the first question, all you need to do is set the curIndex to the correct value, where A is 0 and Z is 25. If you use SetValue, the display will update for you. So if your protoA2Z_TDS was declared as indexer, and you wanted to change it to the letter B, you would do this:

SetValue(indexer, 'curIndex, 1);

You could also write a method of the protoA2Z_TDS that would update the display based on a character:

SetIndex := func(newChar)
begin
	local newIndex := Ord(Upcase(newChar)) - 65;
	if newIndex < 0 then newIndex := 0;
	if newIndex >= numIndices then newIndex := numIndices - 1;
		SetValue(self, 'curIndex, newIndex);
end;

Note that this function will try to do the right thing with weird input. However, if you're expecting the full range of Unicode values, you'll have to change the function to accommodate multibyte characters. Now let's tackle question number 2. You need to know about three things in the protoTextList that aren't yet documented in the Newton Programmer's Guide :

  1. There's a slot named lineHeight that contains the height of each line in pixels.
  2. The protoTextList uses SetOrigin to scroll. Therefore, the slot viewOriginY contains the number of pixels that the view is scrolled (and viewOriginY DIV lineHeight is the line number of the top displayed line).
  3. There's a method DoScrollScript(offset) that scrolls from the current position by the specified offset (in pixels).

Given these three pieces of information, here's a method for a protoTextList that will highlight a particular row and make it visible:

protoTextList.HiliteRow := func(index)
begin
	// highlight this item
	SetValue(self, 'selection, index);
	// scroll as necessary
	local topItem := viewOriginY DIV lineHeight;
	if index < topItem or (index >= topItem + viewLines) then begin
		// we need to scroll so that the index is the first item
		:DoScrollScript(-(topItem - index) * lineHeight);
	end;
end

Of course you still have to calculate what index to pass to the function. But that should be fairly straightforward. The protoA2Z_TDS will give you the first letter, which you can then find in your listItems array in the protoTextList. Note that if the listItems array is sorted, you can use a binary search to find the correct index.

Q What is the origin of the llama?

A The first evidence of llamas dates back to the llama raptor discovered by Dr. Leakey in the jungles of the Amazon. This find was dated back to the late "Jurassic Park" period. Early llamas are thought to have been both more violent and more intelligent than today's breeds. Cave paintings from the hills of Venezuela clearly depict early humans in use as pack animals for tribes of llamas.


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

Thanks to Erik York and our PIE Partners for the questions used in this column, and to Bob Ebert, J. Christopher Bell, Mike Engber, Neil Rhodes, Kent Sandvik, Jim Schram, Maurice Sharp, and Bruce Thompson for the answers. *

Have more questions? Need more answers? Take a look at PIE Developer Info on AppleLink. *

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

BusyCal 3.7.2 - Powerful calendar app wi...
BusyCal is the powerful, flexible, reliable calendar app for macOS. It's packed with time-saving features and compatible with all leading cloud services including iCloud, Google, Exchange and more.... Read more
BusyContacts 1.4.2 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
iShowU Instant 1.3.0 - Full-featured scr...
iShowU Instant gives you real-time screen recording like you've never seen before! It is the fastest, most feature-filled real-time screen capture tool from shinywhitebox yet. All of the features you... Read more
Capo 3.8 - Slow down and learn to play y...
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
Viber 11.7.0 - Send messages and make fr...
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
Drive Genius 5.3.1 - $79.00
Drive Genius features a comprehensive Malware Scan. Automate your malware protection. Protect your investment from any threat. The Malware Scan is part of the automated DrivePulse utility. DrivePulse... Read more
CorelDRAW 21.2.0.708 - Graphic design so...
CorelDRAW - professional graphic design software for vector illustration, layout, and so much more. Get started quickly and easily with a wealth of intuitive tools, built-in learning materials,... Read more
Navicat Premium Essentials 12.1.27 - Pro...
Navicat Premium Essentials is a compact version of Navicat which provides basic and necessary features you will need to perform simple administration on a database. It supports the latest features... Read more
OmniFocus 3.4.3 - GTD task manager with...
OmniFocus is an organizer app. It uses projects to organize tasks naturally, and then add tags to organize across projects. Easily enter tasks when you’re on the go, and process them when you have... Read more
Microsoft OneNote 16.30 - Free digital n...
OneNote is your very own digital notebook. With OneNote, you can capture that flash of genius, that moment of inspiration, or that list of errands that's too important to forget. Whether you're at... Read more

Latest Forum Discussions

See All

Upcoming mobile MMO TeeTINY Online’s sec...
TeeTINY Online is an upcoming anime-themed MMO which boasts striking visuals and an ambitious open world to explore. Following a successful CBT (closed beta test) on Android, developer TEENY.studio has now released a follow-up test which adds an... | Read more »
Breakout: Dark Prison is a fast-paced ac...
Breakout: Dark Prison is an action RPG from LaterSoft. Set in the aftermath of a deadly virus outbreak your daughter has been taken from you because she has an immunity to the illness in her DNA. Not being a fan of experimentation on children –... | Read more »
Apple Arcade in review
This weekend, Apple Arcade will officially be one month old. That means anyone who signed up for the free trial on day one has a decision to make: Stick with the service and shell out $5 a month, or cancel and go about your merry way. | Read more »
Alluris is a choose-your-own adventure g...
Alluris is an RPG that the developer's are calling a swipe-your-own adventure game. This is because the game incorporates a Reigns-style - swiping left or right - selection mechanic to make all the decisions you'd usually expect to make across... | Read more »
Hello Hero All Stars receives update wit...
The first Hello Hero game hit global platforms in 2013 and proved a huge success, with developer Fincon adding two more entries to this popular series of casual RPG games since. Released in June this year, Hello Hero All Stars brings many of the... | Read more »
Zombieland: Double Tapper, a cartoon idl...
Zombieland: Double Tapper is the idle RPG tie-in to the upcoming Zombieland: Double Tap. Oddly, it's one of two different Zombieland games launching today, with the other being the Switch title Zombieland: Double Tap - Road Trip. [Read more] | Read more »
Rusty Lake's The White Door launche...
Rusty Lake and Second Maze's intriguing point-and-click adventure game, The White Door, is now up for pre-order on the App Store. This one sees you playing as Robert Hill, a mental health patient who is suffering from severe memory loss. The game... | Read more »
Hellrule is an auto-runner inspired by G...
Hellrule is an upcoming auto-runner game from independent developer Pedrocorp where players will take control of a dapperly dressed gentlemen who comes equipped with a razor-sharp umbrella for slicing up his foes. The game will be available for... | Read more »
Grobo is a gravity bending puzzle platfo...
Grobo is a 2D puzzle platformer that marks the first release from developers Hot Chocolate Games. You'll find yourself manipulating gravity as you make your through this title that's available now for iOS and Android. [Read more] | Read more »
Adrenaline, Compulsive Entertainment’s h...
Compulsive Entertainment’s high-octane arcade racer, Adrenaline, has now made its way to the App Store following a successful launch on Google Play. It’s a ton of challenging, fast-paced fun, boasting easy-to-learn controls and a varied selection... | Read more »

Price Scanner via MacPrices.net

11″ WiFi iPad Pros on sale today for up to $2...
Amazon has new 2018 Apple 11″ WiFi iPad Pros in stock today and on sale for up to $250 off Apple’s MSRP. These are the same iPad Pros sold by Apple in its retail and online stores. Be sure to select... Read more
Apple offers clearance 2018 15″ 6-Core MacBoo...
Apple has clearance 2018 15″ 6-Core Touch Bar MacBook Pros, Certified Refurbished, available starting at only $1999. Each model features a new outer case, shipping is free, and an Apple 1-year... Read more
Apple continues to offer refurbished 2019 21″...
Apple has Certified Refurbished 2019 21″ & 27″ iMacs available starting at $929 and up to $350 off the cost of new models. Apple’s one-year warranty is standard, shipping is free, and each iMac... Read more
Verizon offers free iPhone 7 for customers wh...
Verizon is offering a free 32GB iPhone 7 for new or existing customers who open a new line of service, no trade-in required. Cost of the phone is credited to your account monthly for 24 months. The... Read more
13″ 2.4GHz 4-Core MacBook Pros remain availab...
Apple has a full line of Certified Refurbished 2019 13″ 2.4GHz 4-Core Touch Bar MacBook Pros available starting at $1529 and up to $300 off MSRP. Apple’s one-year warranty is included, shipping is... Read more
Lease one iPhone Xs, Xr, or X at Sprint and g...
Purchase an Apple iPhone X, Xr, Xs, or Xs Max at Sprint, and get a 64GB iPhone Xr for free. Requires 2 new lines or 1 upgrade-eligible line and 1 new line. The fine print: “iPhone Xs (64 GB) $37.50/... Read more
How to use your Apple Education discount to s...
Purchase a new MacBook Pro or MacBook Air using Apple’s Education discount, and take up to $200 off MSRP. All teachers, students, and staff of any educational institution with a .edu email address... Read more
Base 2019 13″ 1.4GHz 4-Core MacBook Pro on sa...
Amazon has the new 2019 13″ 1.4GHz/128GB 4-Core Space Gray Touch Bar MacBook Pro on sale for $100 off Apple’s MSRP. This is the same MacBook Pro sold by Apple in its retail and online stores: – 2019... Read more
Save up to $30 on Apple’s AirPods at these re...
Amazon is offering discounts on new 2019 Apple AirPods ranging up to $30 off MSRP. Shipping is free: – AirPods with Charging Case: $144 $15 off MSRP – AirPods with Wireless Charging Case: $169 $30... Read more
Save $15 on Apple Watch Series 5 models on Wa...
Walmart has new Apple Watch Series 5 models on sale for $15 off Apple’s MSRP on their online store. Choose free shipping or free local store pickup (if available). Sale prices for online orders only... Read more

Jobs Board

Best Buy *Apple* Computing Master - Best Bu...
**734688BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000297-Reston-Store **Job Description:** The Core Read more
Best Buy *Apple* Computing Master - Best Bu...
**738529BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000258-Lewisville-Store **Job Description:** **What does a Read more
*Apple* Mobility Pro - Best Buy (United Stat...
**741888BR** **Job Title:** Apple Mobility Pro **Job Category:** Store Associates **Location Number:** 000870-N Scottsdale-Store **Job Description:** At Best Buy, Read more
*Apple* Mobile App Developer - eiWorkflow So...
…eiWorkflow Solutions, LLC is currently looking for a consultant for the following role. Apple Mobile App Developer Tasks the role will be performing: ? Mobile App Read more
Essbase Developer - *Apple* - Theorem, LLC...
Job Summary Apple is seeking an experienced, detail-minded Essbase developer to join our worldwide business development and strategy team. If you are someone who Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.