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

jAlbum 15.0 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results - Simply drag and drop photos into groups, choose a design... Read more
Duet 1.6.9.3 - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a $14.99 iOS companion app. Version 1.6.9.3:... Read more
Duet 1.6.9.3 - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a $14.99 iOS companion app. Version 1.6.9.3:... Read more
iExplorer 4.1.10 - View and transfer fil...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
iExplorer 4.1.10 - View and transfer fil...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
Adobe InCopy CC 2018 13.0.1.207 - Create...
InCopy CC 2018 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous InCopy customer). Adobe InCopy CC 2018, ideal for large team projects... Read more
Microsoft Office 2016 15.40 - Popular pr...
Microsoft Office 2016 - Unmistakably Office, designed for Mac. The new versions of Word, Excel, PowerPoint, Outlook and OneNote provide the best of both worlds for Mac users - the familiar Office... Read more
Adobe InDesign CC 2018 13.0.1.207 - Prof...
InDesign CC 2018 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous InDesign customer). Adobe InDesign CC 2018 is part of Creative Cloud.... Read more
Apple iOS 11.1.2 - The latest version of...
iOS 11 sets a new standard for what is already the world’s most advanced mobile operating system. It makes iPhone better than before. It makes iPad more capable than ever. And now it opens up both to... Read more
Slack 2.9.0 - Collaborative communicatio...
Slack is a collaborative communication app that simplifies real-time messaging, archiving, and search for modern working teams. Version 2.9.0: Slack now officially, and fully, supports Japanese.... Read more

Latest Forum Discussions

See All

Mighty Battles guide - how to build a so...
Mighty Battles, the latest title from Hothead Games, is set to take the App Store by storm. The game puts a welcome twist on lane battlers, adding FPS elements to spice things up a bit. You'll collect cards to put your own military unit to gether,... | Read more »
Rules of Survival guide - how to be the...
The PUBG craze makes its way to mobile, with more and more battle royale games debuting on iOS and Android. Rules of Survival joins the ranks of mobile PUBG-likes, offering a classic battle royale experiences that doesn't vary too much from its... | Read more »
The best new games we played this week -...
The weekend is upon us friends, and it's time to take a look back and reflect on all of the wonderful games we've played over the past few days. This week was jam packed with new releases. There were some big, long awaited launches, some fun... | Read more »
Lineage II: Revolution guide - tips and...
At long last, Lineage II: Revolution has now come to western shores, bring Netmarble's sweeping MMORPG to mobile devices. It's an addictive, epic experience, but some of the systems in the game can be a bit overwhelming. Here are a few tips to help... | Read more »
A Boy and His Blob (Games)
A Boy and His Blob 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »
Fight terrible monsters and collect epic...
Released on Western markets early last month, Dragon Project, created by Japanese developer COLOPL, brings epic monster hunting action to mobile for the very first time. Collect a huge array of weapons and armor, and join up with friends to fight... | Read more »
I Am The Hero (Games)
I Am The Hero 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: I Am The Hero is a pixel art, beat 'em up, fighting game that tells the story of a "Hero" with a glorious but mysterious past.... | Read more »
Kauldron (Music)
Kauldron 1.0 Device: iOS Universal Category: Music Price: $3.99, Version: 1.0 (iTunes) Description: Kauldron is our warmest sounding, punchiest synth yet! A completely new modeling technology, combined with carefully designed... | Read more »
Lineage II: Revolution is mobile’s bigge...
NCSoft’s hit fantasy MMORPG series has just made the leap to mobile with the help of Netmarble in Lineage II: Revolution. With over 1.5 million players having already pre-registered ahead of the game’s launch, Revolution hit the app stores... | Read more »
Swing skilfully in new physics-based pla...
Sometimes it’s the most difficult of obstacles that can be the most rewarding. One game hoping to prove this is OCMO, the new tough but fair platformer from developers Team Ocmo. Primed to set every speedrunner’s pulse racing, as an otherworldly... | Read more »

Price Scanner via MacPrices.net

Black Friday pricing on Macs and iPads now av...
B&H Photo has lowered prices on many Macs, iPads, and iPad Pros as part of their Black Friday week sale. Save up to $200 on MacBooks and iMacs and up to $150 on iPads. B&H charges sales tax... Read more
Best Apple iPad deals this weekend, up to $80...
Apple resellers are offering 9.7″ iPads and 10.5″ iPad Pros for up to $80 off MSRP this weekend as part of their early Holiday and Black Friday sales: Adorama is offering new 2017 9.7″ 32GB WiFi... Read more
Early Black Friday sale: Apple iMacs for up t...
B&H Photo has 27-inch iMacs in stock and on sale for up $130-$150 off MSRP including free shipping. B&H charges sales tax in NY & NJ only: – 27″ 3.8GHz iMac (MNED2LL/A): $2149 $150 off... Read more
Apple restocks refurbished Mac minis starting...
Apple has restocked Certified Refurbished Mac minis starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: – 1.4GHz Mac mini: $419 $80 off MSRP – 2.6GHz Mac... Read more
Save on 12″ MacBooks, Apple refurbished model...
Apple has Certified Refurbished 2017 12″ Retina MacBooks available for $200-$240 off the cost of new models. Apple will include a standard one-year warranty with each MacBook, and shipping is free.... Read more
Early Holiday sale: 12″ iPad Pros for up to $...
B&H Photo has 12″ iPad Pros on sale today for up to $130 off MSRP. Shipping is free, and B&H collects no sales tax outside NY & NJ: – 12″ 64GB WiFi iPad Pro: $749, save $50 – 12″ 256GB... Read more
Holiday sale prices on Apple 13″ MacBook Pros...
B&H Photo has 2017 13″ MacBook Pros in stock today and on sale for $100-$150 off MSRP, each including free shipping plus NY & NJ sales tax only: – 13-inch 2.3GHz/128GB Space Gray MacBook Pro... Read more
Sale: 13″ MacBook Airs starting at $899, $100...
B&H Photo has 2017 13″ MacBook Airs on sale today for $100 off MSRP including free shipping. B&H charges NY & NJ sales tax only: – 13″ 1.8GHz/128GB MacBook Air (MQD32LL/A): $899, $100 off... Read more
Week’s Best Deal on 13″ MacBook Pros: Apple r...
Apple has a full line of Apple Certified Refurbished 2017 13″ MacBook Pros available for $200-$300 off MSRP. A standard Apple one-year warranty is included with each MacBook, and shipping is free.... Read more
Deal: 15″ 2.6GHz MacBook Pro for $1799 w/free...
B&H Photo has clearance 2016 15″ 2.6GHz Touch Bar MacBook Pros in stock today and available for $600 off original MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: – 15″ 2.... Read more

Jobs Board

Product Manager - *Apple* Pay on the *Appl...
Job Summary Apple is looking for a talented product manager to drive the expansion of Apple Pay on the Apple Online Store. This position includes a unique Read more
*Apple* Pro/Consumer Apps Support Engineer -...
…exemplify AppleCare's expert technical support paired with exceptional customer service for Apple 's software apps. This person is a problem solver, who understands Read more
Partner Marketing Manager, *Apple* Pay - Ap...
Job Summary The Apple Pay partner marketing team is looking for a Marketing Manager to develop and drive US programs. The right candidate will be passionate about Read more
*Apple* Solution Consultant - Apple (United...
# Apple Solution Consultant - Rochester, MN Job Number: 113037950 Rochester, MN, Minnesota, United States Posted: 19-Sep-2017 Weekly Hours: 40.00 **Job Summary** Are Read more
Sr. Experience Producer, Today at *Apple* -...
# Sr. Experience Producer, Today at Apple Job Number: 56495251 Santa Clara Valley, California, United States Posted: 23-Jun-2017 Weekly Hours: 40.00 **Job Summary** Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.