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

Apple Pro Video Formats 2.0.2 - Updates...
Apple Pro Video Formats brings updates to Apple's professional-level codes for Final Cut Pro X, Motion 5, and Compressor 4. Version 2.0.2: Includes support for the following professional video codecs... Read more
Apple Final Cut Pro X 10.2.2 - Professio...
Apple Final Cut Pro X is a professional video editing solution.Completely redesigned from the ground up, Final Cut Pro adds extraordinary speed, quality, and flexibility to every part of the post-... Read more
Apple Compressor 4.2.1 - Adds power and...
Compressor adds power and flexibility to Final Cut Pro X export. Customize output settings, work faster with distributed encoding, and tap into a comprehensive set of delivery features. Powerful... Read more
Apple Motion 5.2.2 - Create and customiz...
Apple Motion is designed for video editors, Motion 5 lets you customize Final Cut Pro titles, transitions, and effects. Or create your own dazzling animations in 2D or 3D space, with real-time... Read more
A Better Finder Rename 10.00b1 - File, p...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
CrossOver 14.1.6 - Run Windows apps on y...
CrossOver can get your Windows productivity applications and PC games up and running on your Mac quickly and easily. CrossOver runs the Windows software that you need on Mac at home, in the office,... Read more
Printopia 2.1.14 - Share Mac printers wi...
Run Printopia on your Mac to share its printers to any capable iPhone, iPad or iPod Touch. Printopia will also add virtual printers, allowing you to save print-outs to your Mac and send to apps.... Read more
Google Drive 1.24 - File backup and shar...
Google Drive is a place where you can create, share, collaborate, and keep all of your stuff. Whether you're working with a friend on a joint research project, planning a wedding with your fiancé, or... Read more
Chromium 45.0.2454.85 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 45.0.2454.85: Note: Does not contain the "... Read more
OmniFocus 2.2.5 - GTD task manager with...
OmniFocus helps you manage your tasks the way that you want, freeing you to focus your attention on the things that matter to you most. Capturing tasks and ideas is always a keyboard shortcut away in... Read more

Zen Brush 2 (Entertainment)
Zen Brush 2 1.0 Device: iOS Universal Category: Entertainment Price: $2.99, Version: 1.0 (iTunes) Description: Zen Brush 2 is a drawing app focused on the strong yet beautiful feel of the East Asian ink brush. | Read more »
NetNewsWire (News)
NetNewsWire 4.0.0 Device: iOS iPhone Category: News Price: $3.99, Version: 4.0.0 (iTunes) Description: Follow the Web NetNewsWire 4, completely written from the ground up for iPhone. NetNewsWire is the best way to keep up with the... | Read more »
Huzzah! Farming Simulator 16 Supports Cl...
As though it weren't difficult enough to resist the siren call of Farming Simulator 16, now it's been updated with cloud saves - so you can jump between devices without missing any of that precious crop-harvesting time. [Read more] | Read more »
Don't Starve: Pocket Edition Finall...
I've made no effort to hide my enjoyment of Don't Starve: Pocket Edition, but I will admit I was a tiny bit disappointed that it was only available for the iPad. Well nuts to that, because Klei Entertainment has made it universal! [Read more] | Read more »
Goat Simulator Wasn't Enough? Then...
If you just didn't get enough goat in Goat Simulator - or if you've been wanting to play a simulated MMO as a microwave - then you're in luck! Goat Simulator MMO Simulator is out now, and it's a game about simulated goats in simulated MMOs. Plus... | Read more »
You Can Play Madfinger Games' Unkil...
Madfinger Games - probably best known for the Dead Trigger series - has officially launched their newest zombie shooter (that isn't called Dead Trigger), named Unkilled. [Read more] | Read more »
KORG iELECTRIBE for iPhone (Music)
KORG iELECTRIBE for iPhone 1.0.1 Device: iOS iPhone Category: Music Price: $9.99, Version: 1.0.1 (iTunes) Description: ** 50% OFF Special Launch Sale - For a Limited Time **The ELECTRIBE reborn in an even smaller form A full-fledged... | Read more »
Toca Life: City Just Got a Bunch of New...
Toca Life: City is Toca Boca's most popular app (number 1 in 47 different countries, apparently), and it's just had an update that adds a bunch of new content. [Read more] | Read more »
My Country 3D is More About Cities than...
My Country 3D is an upcoming city builder from Game Insight that looks pretty decent - although the name seems a tad out of whack for a city builder. Ah well, it is what it is. [Read more] | Read more »
I am Bread (Games)
I am Bread 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: ‘I am Bread’ is the latest quirky adventure from the creators of 'Surgeon Simulator', Bossa Studios. This isn't the best thing... | Read more »

Price Scanner via MacPrices.net

Near-Office Input Functionality Virtually Any...
Today Logitech introduced the Logitech K380 Multi-Device Bluetooth Keyboard and the Logitech M535 Bluetooth Mouse, giving users the freedom to work on any device, most anywhere. According to... Read more
College Student Deals: Additional $100 off Ma...
Take an additional $100 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through September 4, 2015. Anyone with a valid .EDU email address can take... Read more
2.8GHz Mac mini available for $988, includes...
Adorama has the 2.8GHz Mac mini available for $988, $11 off MSRP, including a free copy of Apple’s 3-Year AppleCare Protection Plan. Shipping is free, and Adorama charges sales tax in NY & NJ... Read more
Will You Buy An iPad Pro? – The ‘Book Mystiqu...
It looks like we may not have to wait much longer to see what finally materializes as a new, larger-panel iPad (Pro/Plus?) Usually reliable Apple product prognosticator KGI Securities analyst Ming-... Read more
eFileCabinet Announces SMB Document Managemen...
Electronic document management (EDM) eFileCabinet, Inc., a hosted solutions provider for small to medium businesses, has announced that its SecureDrawer and eFileCabinet Online services will be... Read more
WaterField Designs Unveils American-Made, All...
San Francisco’s WaterField Designs today unveiled their all-leather Cozmo 2.0 — an elegant attach laptop bag with carefully-designed features to suit any business environment. The Cozmo 2.0 is... Read more
Apple’s 2015 Back to School promotion: Free B...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
128GB MacBook Airs on sale for $100 off MSRP,...
B&H Photo has 11″ & 13″ MacBook Airs with 128GB SSDs on sale for $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 11″ 1.6GHz/128GB MacBook Air: $799.99, $100 off MSRP... Read more
13-inch 2.5GHz MacBook Pro (refurbished) avai...
The Apple Store has Apple Certified Refurbished 13″ 2.5GHz MacBook Pros available for $829, or $270 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.... Read more
27-inch 3.2GHz iMac on sale for $1679, save $...
B&H Photo has the 27″ 3.2GHz iMac on sale for $1679.99 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Content Partner Engineer - *Apple* TV - App...
**Job Summary** The Apple TV team is looking for an experienced engineer with a passion for delivering first in class home entertainment solutions. The candidate will Read more
*Apple* Desktop Analyst - KDS Staffing (Unit...
…field and consistent professional recruiting achievement. Job Description: Title: Apple Desktop AnalystPosition Type: Full-time PermanentLocation: White Plains, NYHot Read more
*Apple* Retail - Multiple Customer Support P...
Job Description: Customer Support Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the Read more
*Apple* Desktop Analyst - KDS Staffing (Unit...
…field and consistent professional recruiting achievement. Job Description: Title: Apple Desktop AnalystPosition Type: Full-time PermanentLocation: White Plains, NYHot Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.