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 :
- There's a slot named lineHeight that contains the height of each line in pixels.
- 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).
- 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. *
