TweetFollow Us on Twitter

Winter 92 - APPLE II Q & A

APPLE II Q & A

APPLE II Developer Technical Support

Q What's the best way to do text-only printing to a character device through GS/OS? 

A If you want to print text to a GS/OS character device, here's how you do it:

  1. Look at all the on-line devices to find which are character devices. You can tell when a device is a character device by examining bit 7 of the "characteristics" word returned by DInfo--the bit is set for block devices and clear for character devices. You don't have to hard-code a list of character device IDs.
  2. Present the user with a list of device names followed by their location and generic type in parentheses. You can adjust the names of device types to reflect your use. For example, ".RPM (AppleTalk printer, port 1)," ".DEV2 (serial modem, port 2)," or ".DEV3 (generic character device, slot 5)." You can use bit 3 of the slot returned by DInfo to know whether to return "slot" or "port," too.
  3. When the user selects a printing device, call Open on the device name (such as .RPM for an AppleTalk printer). Use Write to write the information, just as you would to a file; then call Close (you can call Flush if you like, but it shouldn't be necessary). That's all you need to do.

Remember not to embed ImageWriter or any other printer-specific codes in the output stream. With the exception of choosing a device and creating a file, this same code could be used to print to any  text printer or to another device such as a disk or modem. You might give users a "text printing preferences" dialog where they can enter some codes if they like, and you might have built-in sets for ImageWriters and other common printers, but don't make it too complicated. These instructions are very generic and will work well on any setup, not just an ImageWriter II connected through the serial port.

Q On a ROM 03 Apple II GS, I save and restore the mouse mode by getting it from ReadMouse, setting the mode to what I need, and restoring the value (with SetMouse) when done. This sometimes kills the mouse--I don't get any mouse movement until my program quits. Help! By the way, this isn't a problem on ROM 01 machines.  

A The ROM 03 mouse firmware doesn't behave as documented in two respects. First, it sometimes returns an illegal mouse mode value from ReadMouse. Specifically, there's garbage in the high nibble of the mouse mode byte. Second, SetMouse returns an error and takes no action when passed an invalid mode, even though the Apple IIGS Toolbox Reference  says it returns no errors. When you try to restore the invalid mode, nothing happens and the mouse stays in whatever mode you had it in--if it's not what the system needs, the mouse will appear "hung" until someone sets the mode to what the system does need.

You can work around this problem by masking off the high nibble of the mode result from ReadMouse (AND #$000F in 65816 assembly) before passing it to SetMouse. This problem is fixed in Apple IIGS system software version 6.0-- ReadMouse always returns a valid mode under 6.0.

Q When I call SFMultiGet2, I randomly get error $1705 (bad pathname descriptor in the reply record) even though that error doesn't mean anything for that call. Any ideas? 

A All versions of SFMultiGet2 before Apple II GS System 6.0 incorrectly look at two of the words in the reply record (offsets $0008 and $000E) to make sure they don't contain the value $0002. That value would be illegal in those positions--in any of the other  new Standard File calls. SFMultiGet2 doesn't use the same reply record, but pre-6.0 versions of Standard File accidentally check those fields anyway. Make sure the values in bytes that are past the beginning of the 6-byte reply record are not $0002. This is fixed in System 6.0.

Q Although my application fully supports GS/OS, the Finder uses slashes instead of colons in the pathnames in message #1. This means my application can't open any files that have slashes in the filename. 

A The Finder and its message-passing conventions were originally released before GS/OS was written. Applications depend on the slash (/) as the separator character to be able to parse these pathnames (for example, to find the filename to use in a document window title). If the separator character were to change, many older applications would break.

Finder version 6.0 may support an additional message containing a list of fully expanded GS/OS pathnames. These pathnames use colons as separators and aren't limited to 255 characters. See the Finder 6.0 documentation for details on using this message.

Q I've written a program that hangs inside Standard File under Apple II GS System 5.0.4, but works fine under development versions of 6.0. I'm not using any 6.0-specific features. What could be the problem? 

A Standard File before System 6.0 does not behave gracefully if called with both prefix 0 and prefix 8 empty. Try setting one of these prefixes to an existing directory and see if your problem vanishes.

Q I can't find the ProDOS partition on Volume IX or later of the Developer CD Series discs. What's happened? 

A Apple II information was duplicated on all Developer CDs from Volume III through Volume VIII because without the ProDOS partition, Apple II users couldn't see the information, and without the Apple II folder on the HFS partition, the information couldn't be shared on an AppleShare file server (or Macintosh System 7 File Sharing). Apple II GS System 6.0 includes an HFS (Macintosh) file system translator, which means that Apple II GS developers can access the information on the HFS partition, making the ProDOS partition unnecessary.

The Apple II information can be found on the HFS partition with the pathname Dev.CD Vol. IX:Development Platforms (Moof!):Apple II. Note that this means the Apple II folder can only be accessed from ProDOS 8 using AppleShare with long naming on--the path to the Apple II folder is not a legal ProDOS 8 pathname.

Q Apple II Applesoft's floating-point routine results are sometimes accurate to only two places. For example, the answer returned for PRINT 55555.099-55555.09 is 9.01031494 E-03. How can we get more accurate results? 

A The accuracy loss you're experiencing with the Applesoft floating-point routines is normal. If you convert a number such as 55555.099 to a base 2 floating-point number, you won't get an exact representation using Applesoft's floating-point routines or even 96-bit precision IEEE numerics. Because 9.01031494 E-03 is 0.0090103, you can see that you have accuracy out to three and a half decimal places. The solution is to determine the accuracy that you want and massage the result to give you that accuracy. Here's a sample program that shows common Applesoft rounding techniques:

1 REM Round to 3 decimal places of accuracy example
10 Input a
20 Input b
30 If a-b>1000 then 100: REM no 3-digit rounding of numbers >1000
40 Print "Standard Applesoft Non-accurate result:";a-b
50 Print "Truncated result:";
   INT((a-b)*1000)/1000 60 Print "Rounded result:";
   INT(((a-b)+.0001)*1000)/1000
70 Goto 10
100 Print "Result has 3 decimal accuracy already:";a-b
110 Goto 10

This is the only way that you can get Applesoft to clip the numbers, apart from using a separate floating-point engine. Alternatively, you can do your own conversion from Applesoft internal numeric format to a string in assembly language and have it simulate the above operation when converting the number.


Kudos to our readers who care enough to ask us terrific and well thought-out questions. The answers are supplied by our teams of technical gurus; our thanks to all. Special thanks to Matt Deatherage, Jim Luther, Dave Lyons, Jim Mensch, and Tim Swihart for the material in this Q & A column. *



Have more questions? Need more answers? Take a look at the Dev Tech Answers library on AppleLink (updated weekly) or at the Q & A stack on the Developer CD Series  disc.*

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

The beginner's guide to Warbits
Warbits is a turn-based strategy that's clearly inspired by Nintendo's Advance Wars series. Since turn-based strategy games can be kind of tricky to dive into, see below for a few tips to help you in the beginning. Positioning is crucial [Read... | Read more »
How to upgrade your character in Spellsp...
So you’ve mastered the basics of Spellspire. By which I mean you’ve realised it’s all about spelling things in a spire. What next? Well you’re going to need to figure out how to toughen up your character. It’s all well and good being able to spell... | Read more »
5 slither.io mash-ups we'd love to...
If there's one thing that slither.io has proved, it's that the addictive gameplay of Agar.io can be transplanted onto basically anything and it will still be good fun. It wouldn't be surprising if we saw other developers jumping on the bandwagon,... | Read more »
How to navigate the terrain in Sky Charm...
Sky Charms is a whimsical match-'em up adventure that uses creative level design to really ramp up the difficulty. [Read more] | Read more »
Victorious Knight (Games)
Victorious Knight 1.3 Device: iOS Universal Category: Games Price: $1.99, Version: 1.3 (iTunes) Description: New challenges awaits you! Experience fresh RPG experience with a unique combat mechanic, packed with high quality 3D... | Read more »
Agent Gumball - Roguelike Spy Game (Gam...
Agent Gumball - Roguelike Spy Game 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Someone’s been spying on Gumball. What the what?! Two can play at that game! GO UNDERCOVERSneak past enemy... | Read more »
Runaway Toad (Games)
Runaway Toad 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: It ain’t easy bein’ green! Tap, hold, and swipe to help Toad hop to safety in this gorgeous new action game from the creators of... | Read more »
PsyCard (Games)
PsyCard 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: From the makers och Card City Nights, Progress To 100 and Ittle Dew PSYCARD is a minesweeper-like game set in a cozy cyberpunk... | Read more »
Sago Mini Robot Party (Education)
Sago Mini Robot Party 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: -- Children's Technology Review Editor's Choice -- | Read more »
How to get a high score in every level o...
Sky Charms is an adorable match three puzzler that provides a decent challenge thanks to its creative level design. It regularly presents something new, forcing you to think on your feet. [Read more] | Read more »

Price Scanner via MacPrices.net

Apple restocks Certified Refurbished Mac mini...
Apple has restocked Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz Mac mini: $419 $... Read more
15-inch 2.2GHz Retina MacBook Pro on sale for...
Amazon.com has the 15″ 2.2GHz Retina MacBook Pro on sale for $1699.99 including free shipping. Their price is $300 off MSRP, and it’s the lowest price available for this model from any reseller (and... Read more
Apple Beats Microsoft at Own Game; Amazon Pri...
First quarter seasonality combined with an overall disinterested customer base led to an annual decline of 14.7% in worldwide tablet shipments during the first quarter of 2016 (1Q16). Worldwide... Read more
Tablets Had Worst Quarter Since 2012, says St...
The global tablet market began 2016 just as 2015 left off, down. Tablet shipments fell 10% to 46.5 million units during the Q1 2016, according to the new “Preliminary Global Tablet Shipments and... Read more
Clearance 13-inch MacBook Airs, Apple refurbi...
Apple recently dropped prices on certified refurbished 2015 13″ MacBook Airs with 4GB of RAM with models now available starting at $759. An Apple one-year warranty is included with each MacBook, and... Read more
Clearance 12-inch Retina MacBooks, Apple refu...
Apple has dropped prices on Certified Refurbished 2015 12″ Retina MacBooks with models now available starting at $929. Apple will include a standard one-year warranty with each MacBook, and shipping... Read more
Aleratec Releases Mac Software Upgrade for 1...
California based Aleratec Inc., designer, developer and manufacturer of Portable Device Management (PDM) charge/sync products for mobile devices and professional-grade duplicators for hard disk... Read more
Sale! Amazon offers 27-inch iMac, 13-inch 2.9...
Amazon has the 27″ 3.2GHz 5K iMac and the 13″ 3.9GHz Retina MacBook Pro on sale for $300 off MSRP, each including free shipping, for a limited time: - 27″ 3.2GHz/1TB HD 5K iMac (model MK462LL/A): $... Read more
Apple refurbished 13-inch Retina MacBook Pros...
Apple has Certified Refurbished 13″ Retina MacBook Pros available for up to $270 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz... Read more
13-inch 2.7GHz/128GB Retina MacBook Pro on sa...
Take $200 off MSRP on the price of a new 13″ 2.7GHz/128GB Retina MacBook Pro (model MF839LL/A) at Amazon. Shipping is free: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1099.99 $200 off MSRP Act now if... Read more

Jobs Board

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* 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* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 48260200 Phoenix, Arizona, United States Posted: Apr. 22, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Solutions Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
Simply Mac *Apple* Specialist- Service Repa...
Simply Mac is the largest premier retailer of Apple products in the nation. In order to support our growing customer base, we are currently looking for a driven Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.