[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Frequently Asked Questions (FAQ) for c.s.a2 Part 3/4
- Subject: Frequently Asked Questions (FAQ) for c.s.a2 Part 3/4
- From: nathan@visi.com (Nathan Mates)
- Date: 1996/10/01
- Expires: 1 Nov 96
- Newsgroups: comp.sys.apple2
- Organization: Vector Internet Services, Inc.
This part 3 of 4 of the Frequently Asked Questions (FAQ) posting of the
comp.sys.apple2 newsgroup. Copyright (c) 1996 by Nathan Mates
(nathan@visi.com) This document can be freely copied so long as 1) it
is not sold, 2) any sections reposted elsewhere from it are credited
back to this FAQ with the FAQ's copyright info and official WWW
location left in place.
This FAQ is posted on the WWW for 24 hour a day (barring system and/or
internet malfunctions) availability from
http://www.visi.com/~nathan/a2/faq/csa2.html. As I am constantly
updating and fixing sections of this FAQ, making a link to the
document over the WWW is preferred-- that way, there aren't obsolete
versions floating around.
--- Begin part 3 of 4
Q#33 How do you download files off the net?
This is important because once you're on the internet, most of the
files are available only on 'ftp' and www sites. ('ftp' stands for
File Transfer Protocol, and www stands for the World Wide Web, but all
you need to know is where to get Apple II files from. See the section
above for a list of ftp sites.)
1. (For ProLine users) Get files to your host
1. Dial up your host and log in.
2. I'm not familiar with ProLine, so I'll be vague here. Just go
into the files section and look... Anyone wanna clue me in?
2. (for those with a Shell account) Get files to your host
1. Choose an FTP site from the FAQ
2. At your UNIX prompt, type "ftp _____" (fill in hostname)
3. At the "Login:" prompt, type "anonymous" (or "ftp" if you are
a bad speller like me ;)
4. Type in your e-mail address when prompted for a password.
5. Type "bin" unless you are only getting text files
6. Type "cd ______" (directory) to move to the right directory.
7. type "ls" to see a list of files.
8. Locate each file (more "cd ___"'s and "ls"). Also, "cd .."
will move up a directory in the tree.)
9. use "get ______" (filename) to get it
10. When you are done using FTP, type "quit"
3. From a WWW browser, most browsers are not set up to download .SHK
files in binary, which will make them impossible to unpack. There
are some solutions to this. Dan Zimmerman has made the Apple II
archive at Caltech automatically send files in binary mode; go to
http://apple2.caltech.edu/a2archive.html
If you are using Lynx, when the cursor is on the file to download,
you can hit 'd' to download the file, which for most people forces
a binary download. [Lynx has too many versions with the same
version 'number' and possible configurations to be able to list
which ones will work.]
Using most WWW browsers under unix (Netscape, Mosaic, lynx, maybe
some others) you can try editing the file '.mime.types' (no 's) in
your home directory on most unix systems. (Contact your local
sysadmin or guru for help on unix editors). Add the following
lines to the file:
application/x-Shrinkit shk SHK sdk SDK
application/x-BinaryII bny BNY bqy BQY bxy BXY
This will work for most files downloaded with lynx, netscape, and
mosaic. Non-unix browsers can do similar things, but you'll need
to read the documentation on them.
4. From email or comp.binaries.apple2, the files are pretty much
always in BINSCII format, so you do not need to worry about binary
downloading. Simply save the email or news articles to disk (most
things do have multiple parts, so be sure to get all of them), and
download that to your Apple II. You can keep the posts as separate
files, no need to paste them all together when saving or
downloading. For a multiple part binscii file, the order in which
you unpack them does not matter as long as you unpack every part.
5. Get files to your Apple II
See the next section on transfering Apple II files.
Q#34 How do you transfer Apple files to/from other personal computers?
Normally, you cannot stick a 5.25" disk in a non-Apple II machine and
have it read it. This is because the disk writing formats are
different at a hardware level, and no software exists (or will exist)
to let a PC read an Apple II 5.25" drive. However, with rarer addon
hardware, you can bridge the gap. This has been an insolvable problem
for nearly 15 years; if it could be solved in software, such a thing
would exist.
That being said, here's a list of ways that do work:
Q#35 How do I transfer DOS 3.3, Pascal, CP/M files?
Unless you have a null modem (see below) and a comm program for the OS
in question, you'll most likely have to use a real Apple II to
transfer the files to an OS that a lot more systems can read, such as
ProDOS.
The //e system software, the DOS 3.3 FST (GS/OS System 6), and Copy
][+ can all read and convert Dos 3.3 files into ProDOS (but the DOS
3.3 FST can not write to DOS 3.3 disks). This is only helpful for text
files, graphics, and some Basic programs. For translating between
ProDOS, CPM, Pascal and DOS 3.3, try the program Chameleon. You have
to use the 'force disk as ProDOS' option to use your hard drive.
ftp://apple2.archive.umich.edu/apple2/8bit/util/chameleon.bsq
Once the file is on a ProDOS disk, you generally have a lot more
transfer options available.
Q#36 How do I transfer files by [null] modem?
This is probably the most accessible option; it can be done by an
Apple and any other computer as long as both have serial ports,
cable(s) to go between them, and communications software on both
sides.
Modems allow you to transfer computer data over phone lines; a null
modem essentially yanks the middleman of a phone. Null modem cables
(which are identical to serial printer cables) are essentially a cable
which plugs into the serial port of two computers, and is wired such
that when one computer sends, the other receives, and vice versa. With
a communications program that supports file transfer on both ends, you
can send files from one side to the other.
For those who haven't picked a program to download with, here are the
better Apple II programs; for other systems, you'll have to find a
comparable program. All of the non-commercial programs are available
from FTP sites. If you don't have a comm program already, your best
bet is to have someone mail you one on a disk or buy ProTerm. (See
resources).
Program Comp Emulations Protocols Note
---------|----|---------------------------------------------------------------
ProTerm E$ PSE, VT-100 Kermit, X,Y,Z-modem From InSync
PTP E$, VT-100 X-Modem, (Y-mdm D/L) From Quality Computers
Kermit-65 E VT-100 Kermit, X-modem Hard to use,Works on ][+
Z-Link E VT-100 X-modem Good.
CommSys E none X-modem Works on ][+
TIC E$ VT-100 (+) X-modem Small, Scripting.
Agate E mono ANSI X,(Y,Z D/L only) Unpacks ZIP, Buggy
ColorTerm GS color ANSI X-modem Desktop based
MegaTerm GS color ANSI none ProDOS 8
ANSITerm GS$ color ANSI, PSE X,Y,Z-modem Editor, scrollback, etc.
SnowTerm GS VT-100 (+) none Desktop based
FreeTerm GS none X-modem Desktop based
GenComm GS none none Text, Shell Compat.
GSVT GS VT-100 none Desktop
GTerm GS color ANSI none Written in BASIC/ML
Telcom GS VT-100, PSE X, (Y D/L only) Shell compat
----------Key:---------
| Key: $ = A commercial program + = And other obscure ones
| Computer: E = works on GS and //e, GS = only works on GS
| D/L = Download from other computer
---
PTP = Point-To-Point. I don't think it's being sold anymore. Anyone
know? See the resources section for where to buy the commercial
programs.
Once you are set up with a comm program on both ends, with a modem,
here's how to send files:
1. Find out what file transfer protocols your Apple communications
package supports. (see below for a list)
2. On your local comm program, set your file transfer type to Text
(TXT) or Binary (BIN) depending on what type of file you are
downloading. If there is an option to "strip incoming linefeeds",
try turning it on.
3. Get your host to send you the file. I don't know about ProLine,
but UNIX users can use these commands:
For Z-Modem: "sz ___ ____ ____" (file names)
For X-Modem: "sx ____" (one at a time)
For Kermit: "kermit", then "put _____" (filename)
Z-Modem is by far the fastest of the three; if you are getting
random connection errors, you may need to do "sz -e ___ ____ ____"
to force a safer (but slower) xfer method.
4. If needed, tell your local communications program to Receive. You
must do this quickly, or the other host will give up trying to
send the file.
5. Write down the full pathname of the files you downloaded and where
you put them. There will be a quiz later. Pathnames look like
"/DISK/DIR/FILE.NAME"
Note: If something goes wrong, hit ESC, Ctrl-X or Ctrl-C 3 times.
If you can't get one protocol to work, try the next one down.
Z-modem is much faster than the others. You will want to find a
program that supports it.
With a null modem, it is similar. First, you need to tell both sides
that they are online. Reading the manual is strongly encouraged! This
is easy for some programs, where you can just start them or set an
option, and they're running. Other, like Windows 95's Hyperterminal,
are almost dead set on dialing a modem first. You'll also need to set
both sides to communicate at the same speed and connection parameters
(8 bits, no parity, 1 stop bit, aka '8N1' is customary). When you've
got that done successfully, you can type on either computer's keyboard
and have it appear on the other's screen.
Once the null modem connection is set up, you can transfer files. From
the receiving end, issue the command(s) to receive a file in some
protocol, such as Kermit, X-Modem, or Z-Modem. Then, from the sending
side, issue the command(s) to send a file in that same protocol. The
file should then be transferred. (As above, reading the manuals and/or
documentation for the software used is highly encouraged).
A very nice null modem is the CrossWorks product, which has been taken
over by Sequential Systems. It is a null modem cable as well as Apple
II and IBM PC software that lets you translate certain types of files
between both sides, such as Appleworks files, and keep the formatting
roughly intact. See the vendors lists below.
Q#37 How do I read/write files from other platforms with an Apple II?
As noted above, Apple II drives write differently at a hardware level
than IBM PC drives; you will not be able to write to IBM PC 5.25"
disks or 720K 3.5" disks from Apple IIs unless you have special
hardware. If you have an Apple //e, there is the Bluedisk from SHH
systems (see hardware vendors below), which lets you plug in IBM PC
3.5" and 5.25" drives to an Apple II; I'm not sure if their software
allows file transfers.
The more supported option is the AE PC Transporter card, which had PC
disk drive support for 5.25" and 3.5" drives, as well as the software
to translate between the two. You also get the ability to run a number
of IBM PC programs on your Apple!
If you have a 3.5" drive on your system capable of reading 800K or
1.44MB disks, you can read Mac (HFS) disks of the right size directly
with some pieces of software:
ftp://apple2.archive.umich.edu apple2/8bit/util/a2fx.8.bsq
ftp://apple2.archive.umich.edu/apple2/8bit/util/hfslink.b3.bsq
Null modem's also an option if your Apple II has a serial port. Such a
port is built into the //c, IIc+ and IIGS; you will need to purchase a
card such as the Super Serial Card to add such functionality to a ][,
][+ or //e.
Q#38 How do I read/write files from other platforms with an Apple IIGS?
With support for both 3.5" and 5.25" drives, the Apple IIGS is the
best all-round platform for transferring files between various setups.
First, all of the Apple II programs and methods are available to it;
see above for those.
With GS/OS System 6.0 and 6.0.1, the GS gained the ability to read and
write Macintosh 800K and 3.5" 1.44MB floppies. (1.44MB requires some
additional hardware, such as the Apple 1.44MB Superdrive and
Superdrive controller, the Bluedisk, or SCSI Floptical drives). Use
the System 6 installer (select 'Custom' install when you launch it to
see the options) to install the HFS (Macintosh) FST on your boot disk,
then copy away. It may be a bit of a squeeze to fit the HFS FST and
such on a 800K boot disk, and GS/OS System 6.0 pretty much requires 1
- 1.25MB RAM.
System 6.0.1 allowed read-only (not write) access to MS-DOS formatted
disks, though disks with Windows 95's VFAT extended names will not
have the long names displayed. The GS's normal 800K drives are not
capable of reading MS-DOS 720K or 1.44MB disks directly; you will need
to get a 1.44MB capable drive, as listed in the paragraph above. For
the ability to write to MS-DOS disks, you will need a program shell
such as that included with The Byteworks' Orca series, or Procyon's
GNO/ME, and the msdostools package.
System 6.0 also added read-only support for Dos 3.3 and Pascal 140K
disks. The Pascal FST in System 6.0.1 (and probably 6.0 also; never
checked that) will not recognize disks with (legal) punctuation in the
disk name; Nathan Mates's GUPP program fixes that. See the System 6.0
mini-FAQ in this FAQ for details on where to download GUPP.
Q#39 How do I read/write Apple II files from a Mac?
If you can read/write Apple II 3.5" disks, Macs can usually read/write
to them fine. Apart from the Apple //e emulation card (see below),
Macs never really had 140K 5.25" support. Using a null modem is almost
always an option; see above.
With Macintosh System 7, the Macintosh gained the ability to write to
ProDOS formatted disks. With System 7.5 and up, the Control Panel 'PC
Exchange' lets you mount ProDOS and MS-DOS disks on the desktop and
copy files to and from them. Before 7.5, the program 'Apple File
Exchange' (not installed by default-- look through the options in the
installer) is an application that lets you do the same. Consult the
system software disks for your Mac if you can't find these programs.
Unfortunately, if a Macintosh program (such as the program you're
using to download a file) tends to add a 'resource fork' to a file
when writing it to an Apple II disk, then programs not running under
GS/OS (such as Binscii, Shrinkit 3.4, Appleworks, etc) can not read
them, giving a 'FILE TYPE MISMATCH' error. If you are comfortable with
ResEdit or other filetype changers, you can apparently change the type
and creator to 'TEXT' and 'pdos', before copying it to the ProDOS
disk.
If this gets monotonous, or you don't know how to run ResEdit, there
is a Mac program to fix this problem, however; download, unpack and
run the following programs on any files that have had their resource
fork added. (For information on downloading and unpacking Macintosh
programs, please see the comp.sys.mac.misc FAQ, or ask a friend)
ftp://mirrors.aol.com/mir02/INFOMAC/info-mac/disk/file-stripper-utilit
ies.hqx
Also, the Apple //e emulation card (available for the LC, LC II, LC
III, some performas, and some LC XYZ models) allows you to plug in a
real Apple II 5.25 drive, and read files off of it.
Q#40 How do I read/write Apple II files from an IBM PC?
Once again, IBM PC drives operate differently from Apple II drives at
a hardware level; there is NO software to overcome that. End of story.
Deal with it.
If you have a Macintosh and access to an Apple II with 3.5" disks
(such as most GSs), you can copy the files to a ProDOS disk and let
the Mac read that disk. It can then copy them to a MS-DOS disk with
the same software that read the ProDOS disks; see above for Mac
specifics.
Null modem is probably the best method; as noted above, the Crossworks
product from Sequential Systems is a good product that lets you
transfer and translate certain Apple II and IBM PC file formats.
There's supposedly a program that reads 1.44MB ProDOS disks on a PC
(which the PC does support), but you need the ability to write such
disks from the Apple II side anyhow.
There are a few rare hardware boards that you can plug into a PC and
get it to access Apple II disks; the Trackstar Plus and Quadram boards
are reported to be usable in IBM PCs. (Quadram's Quadlink reportedly
only supports the IBM PC XT and older; the Trackstar Plus works well
in any PC with space for a very full-sized ISA board and VGA
capabilities) Neither is available new anymore, and can command a
premium now on the used market, as IBM PCers who sold off their Apple
IIs realize the follies of their ways. :)
Q#41 How do I download and unpack binscii?
[If you'd rather skip this and most of the next step, Steve Cavanaugh
(who took over this service from Chuck Orem) has a disk containing
this and Shrinkit 3.4. See the Resources section below.]
1. Binscii has many programs that can unpack it, but if you have none
of them, you will need to first get 'BINSCII.TXT', the only
binscii program that can be transferred without any of the others
or Shrinkit. After you have this binscii program and Shrinkit, you
can unpack other binscii decoders.
2. Make sure you have a method of getting files to a ProDOS disk on
your Apple. That may include downloading with a communications
program, or copying to a disk from another computer. Please note
that Apple II and IBM PC 5.25" and 3.5" disk formats are different
at a hardware level, so without (rare) addon hardware on one or
both sides, you cannot use an IBM PC to download stuff to an Apple
II disk.
Macs running system 7 can write to ProDOS 3.5" 800K disks, but
please note that the Macintosh system software has the bad habit
of adding a "resource fork" to files. This makes them UNREADABLE
from most Apple IIs, unless you run a special program on them from
the Macintosh side. Please see the section (#12) on file transfer
from Macintosh to Apple II for where to get that program.
If you do not have ProDOS, please contact your local Apple II User
Group for a copy-- they can copy it free of charge. If you do not
have a modem program, but do have a modem or null modem to another
computer, Steve Cavanaugh's disk that was mentioned above has some
simple comm programs. Alternatively, the commercial program
ProTERM 3.1 by Intrec is by far the best general Apple II
communications program, so if you have at least a 128K Enhanced
Apple //e, a //c, IIc+, or Apple IIGS, it is worth it to invest in
this program. See the sections on dealers below for Intrec's
address and phone number.
The rest of this tutorial assumes that you have read the above
sections and have a basic clue as to how to navigate the internet
and download files.
3. Download the file 'BINSCII.TXT', written by Todd Whitesel to your
Apple II. A copy is linked in at Nathan Mates's Apple II Resources
WWW pages, http://www.visi.com/~nathan/a2/binscii.txt Or, check
the major Apple II ftp sites (see above), as well as
ftp.ugcs.caltech.edu, pub/nathan/binscii.txt
This is a _text_ file. (Previous versions of it were named
'binscii.exe', which most people confused as being a MS-DOS
executable, which the program most definitely is not.) It must be
downloaded in text mode to your computer, or it will require some
work to get it working. Check the ftp and [z]modem transfer
options to make sure binary mode is off before downloading it to
your Apple II.
If you used a Macintosh to write the file to a ProDOS disk, be
warned that it'll sometimes add a 'resource fork' to the file,
rendering it unusable under ProDOS and Basic with a "FILE TYPE
MISMATCH" error on trying to access it. To avoid that, see the
section (#39) on file transfer from Macintosh to Apple II for a
Mac program to clean up after that problem.
4. See if you can unpack it. You will need to get to Applesoft Basic
under ProDOS to do this. [ProDOS identifies itself as such when
booting, and Basic is the ']' prompt available by running
'BASIC.SYSTEM' if you booted to the Finder]. From the prompt,
change to the disk/directory with the BINSCII.TXT file in it. [A
quick list of Dos 3.3 and ProDOS commands is not part of this FAQ,
but is available at
http://www.visi.com/~nathan/a2/faq/doscmds.html] Next, verify that
the file was transferred as a text file. From the prompt, type the
following:
PR#3
CATALOG
If the "PR#3" command causes your computer to crash, hang, or display
garbage, you do not have an 80-column card in the normal place.
[This is rare, and only happens on ][+s, or stock //es.] Reboot
your computer and try again without the PR#3 command. The catalog
should have a line like the following (though the date and time
will vary)
BINSCII.TXT TXT 12 20-AUG-96 20-AUG-96 3:14 5645
[If not in 80-column mode, that'll be wrapped to 2 lines.] Anyhow, the
number we wanted was the very last number, which should be 5645.
If that number is 5737, you downloaded in binary mode off an IBM
PC. That's fixable. If the number is 512, you disregarded the
warnings above about how the Macintosh will make an Apple II file
unreadable; see the section (#39) on file transfer from Macintosh
to Apple II for a Mac program to clean up after that problem.
Also, note the file type in the second column, which is 'TXT'
here. If it is already TXT, you can skip forward to step 5. Fixing
the filetype. First, note what it currently is. If it's not 'TXT',
common alternatives are 'BIN' or '$00', but almost anything is
possible. The second and fourth line of the following commands,
assume it's '$00', with file length 5645. Modify those two values
to match what you saw in the catalog listing above:
RENAME BINSCII.TXT,BINSCII.ORIG
BLOAD BINSCII.ORIG,A$2000,T$00,L5645
CREATE BINSCII.TXT,TTXT
BSAVE BINSCII.TXT,A$2000,TTXT,L5645
This first renames the old file, loads it up, creates a file of the
right length and then writes the new file.
5. Now that the file type is correct, trying to install binscii. Type
the following:
EXEC BINSCII.TXT
If you get a lot of ?SYNTAX ERRORs and beeps, then you most likely did
not download it in ascii mode. You should try again, making sure
of ascii mode, or try typing in this program. If the file size you
got from the CATALOG above is not 5645, change the 5645 in line 10
to whatever it is.
10 D$=CHR$(4): L=5645
20 PRINT D$"BLOAD BINSCII.TXT,A$2000,TTXT,L"L
30 FOR I=8192 TO 8192+L: IF PEEK(I)=10 THEN POKE I,13
40 NEXT: ONERR GOTO 60
50 PRINT D$"DELETE BINSCII2.TXT"
60 PRINT D$"CREATE BINSCII2.TXT,TTXT"
70 PRINT D$"BSAVE BINSCII2.TXT,A$2000,TTXT,L"L
Use the basic command 'RUN' (no 's) to run this program. After it is
done, you should have a better chance at being able to "EXEC
BINSCII2.TXT" and run it.
6. After all of this is done, you should have the 'BINSCII.SYSTEM'
program on the disk/directory you EXECd binscii from. To run it,
type
-BINSCII
That should start it. For now, with no files to decompress, just exit
it. Congratulations, you can now unpack BINSCII files.
7. There are fancier BINSCII decoders, but this one is the only that
can be easily transferred. If you have a GS, you might want to
consider downloading the gsciiplus program from some of the
following ftp sites:
apple2.archive.umich.edu, apple2/gs/archivers/gscii.bsc
apple2.caltech.edu pub/apple2/addons/nda/gscii231.shk
However, to unpack this, you will need a Shrinkit program
(detailed in the next section) to unpack them before you can use
them. Once unpacked, you will need to copy the 'gsciiplus' NDA to
the DESK.ACCS folder inside the SYSTEM folder on your boot GS/OS
disk.
Q#42 How do I download and unpack a Shrinkit unpacker?
Ok, getting and downloading binscii is the hard part, promise. Because
binscii takes care of the worry of filetypes, end of lines and the
like, you don't really need to worry about those problems again.
Which Shrinkit program you should download depends on which model of
Apple II you have. These programs are listed in increasing order of
features and better user interfaces, so Unshrink ][+ will run on
pretty much anything that you got binscii running on, while
GS-Shrinkit 1.1 will only run Apple IIGSs. Apple IIGS programs can
have file formats known as 'forked files' which ProDOS 8 and regular
Shrinkit cannot unpack, so if you wish to download and unpack most GS
programs, GS-Shrinkit is required. (The exceptions are demos and the
like distributed as a shrunk copy of a disk)
At least an Apple ][+ with 64K running ProDOS:
Your only option is Unshrink ][+ and Autounshrink, available
via ftp from
apple2.caltech.edu, pub/apple2/ARCHIVERS/unshk2plus.bsc
apple2.caltech.edu, pub/apple2/ARCHIVERS/autounshk.bsq
At least an Enhanced Apple //e with 128K, or //c, IIc+, IIGS:
Although you can run Unshrink ][+, Shrinkit 3.4 is far better.
Get
apple2.caltech.edu, pub/apple2/ARCHIVERS/shrinkit34.bsc
At least an Apple IIGS with at least 1.5MB Ram, running GS/OS System
5.0.4 or later, hard drive recommended:
GS-Shrinkit is the best choice, though if you spend most of
your time in ProDOS 8, you may also want to get Shrinkit 3.4 as
well as detailed above. You can get GS-Shrinkit from
apple2.caltech.edu, pub/apple2/ARCHIVERS/gshk11.bsc
Download the appropriate file(s) to your computer, and unpack them
with the binscii decoder.
IMPORTANT NOTICE: The gscii plus NDA (and related unpackers, like the
sscii command) can NOT correctly unpack the GS-Shrinkit 1.1 file. You
_MUST_ use the binscii program that was mentioned and downloaded in
stage 1, or wait for GS-Shrinkit 1.1A.
Run them Shrinkit program you just unpacked. GS-Shrinkit can be run by
double-clicking on its icon in the Finder or the equivalent for other
launchers. For the other programs, from the Basic ']' command in the
disk/directory where you unpacked the program type 'CAT' to get a list
of files. Find the filename of the program, and then '-FILENAME' to
run it. (Replace 'FILENAME' with the name you saw in the list)
Q#43 How do I unpack a generic .SHK or .BSQ file?
Now that you have all the files you want on your Apple II, you will
first need to run the binscii program on any BINSCII'd files you
downloaded, and then the Shrinkit program on the results of the
un-binsciiing and/or any .SHK/.BXY files you downloaded. Once you're
done with that, it's up to you to play around with the files you
unpacked.
After unpacking the .BSQ files, you'll notice that .SHK files are
usually produced. You do not need to keep the .BSQ files around to
unpack the .SHK files; you may delete the .BSQ file(s) at your
convenience. Similarly, once the .SHK file is unpacked, you can delete
it if you do not expect to need to unpack it again anytime soon.
Q#44 Apple Archive Format (aaf)
Apple Archive Format was invented as a standard way to post source
code to comp.sources.apple2. The C and Basic source code to aaf
unpackers are available on the various FTP sites, in aaf format.
Fortunately, files in aaf format can be turned back into source code
with a simple text editor. Just break the file up into component files
and remove the first character of each line.
ftp://apple2.archive.umich.edu /apple2/unix
_________________________________________________________________
Q#45 A quick note about ProDOS filetypes
ProDOS keeps some information about a file's type. Files can be text
(TXT), binary (BIN), executable (SYS), fonts (FON), etc. Most other
file systems do not have a place to store this information, so it may
get 'lost' when you upload the file. Similarly, when you download a
file, you may not know the file type. Most comm programs will use some
default. For NuFX archives, this is not a big deal, since you can
still unpack an archive if the filetype is wrong (and the archive
protects the filetype of the files inside the archive). For other
files, you may need to change the file's type. One utility that comes
well recommended is File Attribute Zapper II.
ftp://apple2.archive.umich.edu /apple2/8bit/util/fazz.2.3.bsq
Q#46 Net standard formats
There are several formats that are used widely on the Internet. The
most common in FTP sites are tar (.tar) and compress (.Z). From a unix
box, to undo a Tape Archive, type 'tar -xvf filename.tar', to undo a
compress, type 'uncompress filename.Z'. Since tar does not make the
file smaller, and compress can only compress 1 file, many times you
will find files that are 'tarred an feathered'. They have a '.tar.Z'
extension. Just run uncompress then un-tar the result. Other USENET
groups will use uuencode (.uu) to send binaries. From a unix box, just
type 'uudecode file.uu'. BinSCII is better than uuencode because 1) It
stores the ProDOS filetype. 2) It splits the file into manageable 12K
chunks. 3) It does a CRC checksum on each chunk.
Most of these 'Unix' standard formats are available on the Apple. See
the table below.
Format Types
+-------------------------------------------------------+
|NuFX|Bin |uuen-|com- |.ZOO|Bin |LZH/| Stuff| ARC| Other|
Program | | |SCII|code |press| |Hex |LHA | -It | | |
--------|-|----|----|-----|-----|----|----|----|------|----|------|
Binscii |e| | X | | | | | | | | |
Shrinkit|e| X | | | | | | | | | |
DeArc |e| | | | | | | | | D | |
Angel[1]|e| | | | X | X | | X | | X | .ZIP |
GShk |g| X | | | D | D | | | D | D | |
GSCII+ |g| | X | X | | | D | | | | .AAF |
sscii |x| | X | X | | | X | | | | |
PMPUnzip|x| | | | | | | | | | .ZIP |
LHext |x| | | | | | | D? | | | |
BSC |c| | E | | | | | | | | |
Nulib |c| X | | | | | | | | | |
SciiBin |c| | D | | | | | | | | |
(Key: E = Encode only, D = Decode only, X = Encode and Decode)
(Type: e = Apple //e, g = GS Only, x = GS EXE file, c = C Source code)
[1] Angel is pretty Buggy, but it's worth a try.
Where to get those programs listed above
This FAQ already lists exactly where to get Binscii and GSCII+ as well
as the Shrinkit programs, as well as the top level directories of
several major ftp sites. To save some hunting around in the directory
structures, Apple II versions of most archive programs are located at
the following places:
Caltech's Apple II Archive: apple2.caltech.edu, pub/apple2/ARCHIVERS
Ground: ftp://ground.isca.uiowa.edu/apple2/Mirrors/caltech/ARCHIVERS
_________________________________________________________________
Q#47 What do the file extensions mean?
Many times, people put filename extensions (extra characters at the
end of a filename) to denote what type of file it is. Please note that
these are just accepted standards. If a file does not indicate it's
type, you will probably have to guess. The following is a table of
some common filename extensions. (Note that upper/lower case usually
doesn't matter in extensions) See the previous section (on archivers)
for programs that will deal with these files.
Extension What is it? (What program do I use?)
--------- ---------------------------------------------------------------
Text only files:
.html [TEXT] ASCII text file with (ascii) formatting codes. Used to
format documents on the World Wide Web, some other places.
.htm [TEXT] .html, but the extension got trimmed to 3 characters
.txt [TEXT] An ASCII text file: usually English text.
Archive files:
.aaf [TEXT] Apple Archive Format for source code (aaf.unpacker)
.ACU Applelink Conversion Utility (Shrinkit)
.ARC ARC Archive (IBM ARC, GS Shrinkit, //e Angel or DeArc2E)
.CPT Compactor Pro archive (Compactor Pro on a Mac only)
.BSC [TEXT] Binscii file. (Binscii)
.BSQ [TEXT] Binscii'd NuFX file. (Binscii--then Shrinkit)
.BXY NuFX archive with a Binary II header. (Shrinkit)
.BNY BLU archive. (Shrinkit)
.BQY NuFX or Binary II with BLU header. (Shrinkit)
.BNX NuFX with BLU header. (Shrinkit)
.dsk Disk image of 140K 5.25" Apple disk. Requires Apple II with >140K
drives or Apple II and PC/Mac to unpack successfully.
.dsz Gzipped .dsk
.exe [TEXT] Executioner file. May only work in DOS 3.3. See above.
Note: .EXE generally means IBM executable program.
.gz Gzipped file.
.HQX [TEXT] Mac BinHex file. (BinHex on Mac or GSCII+ on GS)
.LZH LZH Archive (IBM/Amiga LZH program, //e Angel)
.LHA LHA Archive (IBM/Amiga LZH program, //e Angel)
.QQ BLU archive. (Shrinkit)
.SEA Self-extracting archive (Usually Mac, might be Shrinkit archive)
.SIT Mac StuffIt archive. (StuffIt on Mac (preferred) or GS ShrinkIt;
GS Shrinkit will only decode very old StuffIt files.
.SHK NuFX archive. (Shrinkit)
.SDK NuFX with a shrunk disk image. (Shrinkit)
.tar Unix Tape Archive (Unix 'tar -xvf', GS EXE tar)
.tgz Gzipped .tar file
.uu [TEXT] Unix uuencode file [TEXT] (//e uudecode, Unix uudecode)
.uue [TEXT] Unix uuencode file [TEXT] (//e uudecode, Unix uudecode)
.ZOO IBM Zoo Archive (GS Shrinkit or IBM ZOO program, //e Angel)
.ZIP IBM Zip Archive (GS EXE Unzip, IBM PKUNZIP, Unix unzip, //e Angel)
.Z Compressed file (GS Shrinkit, Unix uncompress, //e Angel)
Common graphics file extensions:
.AVI Windows Movie. No Apple II program can display this.
.BMP Windows and OS/2 Bitmap format.
.GIF Graphics Interchange Format: Compressed picture.
(IIGIF for //e, many programs for all other computers)
.JPG Newer graphics format. (GS viewers only)
.JPEG Newer graphics format. (GS viewers only)
.MOV Quicktime Movie. No Apple II program can display this.
.MPG Movie format. No Apple II program can display this.
.MPEG Movie format. No Apple II program can display this.
.TIFF Graphics format (GS SHR Convert and others)
Common sound file extensions:
.AU Sun (unix) audio format. AudioZap 2.0 can read/write.
.MOD Amiga Music file. Some GS programs can read & play these.
.WAV Windows file. AudioZap 2.0 for the GS can read/write, other
programs can guess at reading
All 'text only files' files can usually be opened directly in any word
processor, assuming they were downloaded in ascii mode. (Downloading a
text file in binary mode from a non-Apple (Apple II or Macintosh)
machine will probably be formatted incorrectly.)
All of these types, except the ones marked [TEXT] are BINARY files.
Binary files cannot be sent over e-mail, posted to the newsgroups or
FTP'd in text mode. You must FTP them in binary mode (see the section
on FTP). You can download either with kermit, X-,Y- or Z-Modem.
See the next few sections for how to use transfer text, pictures,
general graphics, and sound/music files.
Generally, anything labeled as 'Archive' above can and do contain
multiple files, and even subdirectories. Most archivers (except for
tar) also compress the files so that they take less disk space and
time needed to download them.
Sometimes you will find multiple filename extensions. Simply take the
filename extensions apart one at a time starting with the rightmost
and you should be able to reconstruct the original file. (i.e.
somefile.bsq.tar.Z would mean: uncompress, untar, unbinscii, then
unShrink to get the original file!)
_________________________________________________________________
Q#48 How do I USE stuff I have transferred to/from an IBM/Mac?
A:If you get a 'File Type Mismatch' error on when trying to read a
file you transferred via a mac, then you will need to remove the
resource fork from the file. See the section (#39) on file transfer
from Macintosh to Apple II for where to get that program.
In general, only certain types of files can be usefully transferred
back-and-forth between computers. One thing that you CANNOT do is run
programs designed for another type of computer. But often you can
transfer data files between similar programs (Spreadsheets) on
different platforms. Here are some pointers:
Q#49 How do I use text files from other computers?
One helpful hint is that all computers can read text files. Most word
processors can save your file as text and import as text. But with
text files, you will loose all your formatting (font type, centering
and so-forth). For spreadsheets, saving as DIF will make conversion a
breeze. Databases can be saved as tab-delimited records. (Note that in
AppleWorks, you have to go to Print to save in these formats). Look
for options like "Import" or "Export" (or "Save As" in the Mac world).
If you want to do better, there are several options available. A
commercial program called MacLinkPlus can do some conversions. Some
Claris programs do conversions automatically. Also, AFE can convert
between some kinds of documents (For example AppleWorks Word Processor
to MsWorks) if you have the right translator.
ftp://sumex-aim.stanford.edu/info-mac/util/afe-appleworks-msworks.hqx
For IBM folks, The CrossWorks program can convert between many Apple
and IBM formats, and even comes with a universal null modem cable.
Alternately, If you use AppleWorks a lot, you can get SuperWorks for
the IBM, a clone of AppleWorks. It can import AppleWorks files
directly. For graphics, SuperConvert can convert between all
Apple-specific graphics formats and many Mac, Amiga and IBM specific
formats. It can also save as GIF, which is a universal standard.
Q#50 How do I view picture files from other platforms?
A: There are quite a few programs available, each capable of reading
different file formats:
GIF, BMP, other lossless compressed formats:
* IIGIF is a freeware GIF converter for any Apple II (but there is a
patch needed for the Apple //c). It reads in GIF and saves as
hires or double-hires.
ftp://apple2.archive.umich.edu/apple2/8bit/graphics/iigif.bsc
ftp://apple2.archive.umich.edu/apple2/8bit/graphics/iic.patch.for.
iigif
* MACDOWN is also freeware and lets you do the same with MacPaint
pics.
* A ProDOS 8 version of The Graphics Exchange (don't know much about
it).
[The following software only work on an Apple IIGS]
* Convert 3200 is one of the best programs still being sold for
graphics conversion on the GS. A short list of file formats it
handles is: Apple Preferred Format (GS) and PaintWorks Gold
format, various 3200 color GS formats, as well as Windows-OS/2
BMP, Compuserve GIF, Amiga .IFF/ PC .LBM, Paintbrush PCX, Binary
PC and several varieties of TIFF files. It can save in a number of
those: Apple Preferred, Windows BMP, Paintbrush PCX, TIFF, Binary
PC and Print Shop GS.
For more information, please see
http://www.crl.com/~joko/convert.html.
* The Graphics Exchange converts between many formats of graphics;
not sure where it's available from.
* Prizm v1.0 Converts .GIFs, Amiga IFFs, Raw Files, and some other
types to Grayscale (very fast), 16 colors, 256 colors, and 3200
colors! Size of picture limited by availabe RAM (Not sure where
it's available from anymore either; it was commercial.)
* SuperConvert (commercial program, published by Seven Hills
Software) loads all GS formats, plus GIFS and other non-GS
specific formats and saves in all GS formats (including Finder
Icon files). It has more dithering options than most of the other
programs, but you may have to play with it to find the best one.
* SHRConvert is the earlier, shareware, predecessor to SuperConvert.
It does a pretty good job on the types of graphics it supports.
SHRConvert used to be available for download at
ftp://apple2.archive.umich.edu/apple2/gs/graphics/shrconvert.2.1.b
sq, but I think that it was pulled off ftp sites at the author's
request when SuperConvert was published.
* Platinum Paint is a commercial program that can import all GS
formats plus MacPaint. It can only save in SHR and Apple
Preferred. Version 2.0 can make Animations too! Platinum Paint was
sold by Scantron Quality Computers.
* ShowPic 6 is a shareware NDA that can display most GS formats. You
can also save the resulting graphic as a IIGS SHR painting.
ftp://apple2.archive.umich.edu/apple2/gs/gsos/nda/showpic.6.0.bsq
* Dream Grafix supports all 3200 color picture types and also 16
color and 256 color pictures. This is a very impressive commercial
paint program with its 3200 color support. Unfortunately it is
pretty much out of print.
Note: 'All GS formats' includes Superhires (type $C1 and $C0), hires,
double-hires and PrintShop/PrintShop GS.
JPEG and other lossy formats:
As far as I know, JPEG viewers are only available for the Apple IIGS,
no other Apple II machines. A number of viewers are available at
ftp://apple2.caltech.edu/pub/apple2/graphics/viewers. Check them out
if you're interested.
Q#51 How do I use Icons/Fonts/etc from other platforms?
A: For reading Mac icons and such, try "Resource Spy"
ftp://apple2.archive.umich.edu/pub/apple2/gs/util/resource.spy.bsq
Note that Mac TrueType fonts will require you to purchase the
'Pointless' program by Westcode software before you can actually use
them on a GS. Once you have that installed, you can copy Mac TrueType
fonts off a Macintosh disk and use them without any conversion through
Resource Spy. IBM Truetype fonts are in a different and unspported
file format. Conversion programs exist for the Macintosh (and possibly
IBMs as well), but no GS converters exist.
No Truetype readers exist for non-GS Apple IIs to my knowledge;
Postscript fonts are not readable by any Apple II programs to my
knowledge.
Q#52 How do I listen to sounds/music from other platforms?
For non-GS Apple IIs, the program 'IISound' is your best bet. It can
play back many sorts of sounds. You can get it from:
ftp://apple2.caltech.edu/pub/apple2/sound/iisoundbeta.shk.
With the expended sound circuitry of the GS, the number of sound
programs is dramatically increased. On the GS, the program
'MacSoundGrabber' can read Mac sounds out of Mac files, and save them
in a GS format; you can get it from
ftp://apple2.caltech.edu/pub/apple2/sound/macsoundgrab.shk.
Also, programs such as AudioZAP for the GS can read/play WAV files and
lots of other formats. With most 8-bit mono sounds, you can simply
import the file as binary and use the editor to strip off any header
and Zero (0) bytes, which cause the sound to stop prematurely on
playback due to the way the GS's Ensoniq chip handles samples. 16-bit
formats (a number of WAVs, possibly also .AUs) will sound like
garbage; only AudioZAP 2.0 (available only after paying the $20
shareware fee for AudioZAP 1.x) can deal nicely with those.
ftp://apple2.caltech.edu/pub/apple2/sound/audiozap.shk.
About the only non-Apple II music format which is readily playable is
the Amiga .MOD format. Many players exist, from fairly lousy to ones
doing a pretty good job. Recommended ones are MODZap, Beatbox,
Shellplay/Deskplay; most of those are available from
ftp://apple2.caltech.edu/pub/apple2/music/modplayers.
Q#53 How do I transfer Hypercard files?
Apple bundled a 'rMover' program with Hypercard GS that facilitated
the transfer of files that didn't require custom XCMDs. I've never
used it, but the necessary files should be available with the rest of
Hypercard at ftp.support.apple.com,
pub/apple_sw_updates/US/Apple_II/HyperCard_IIGS . These files are
unfortunately only unpackable on Macs. The .bxy files (despite the
filetype extension) are not readable on Apple IIs unless you manyally
strip off the 512 byte header
_________________________________________________________________
Email suggestions to nathan@visi.com. As always, let me know of any
mistakes, updates, corrections, additions, etc.
There are a lot more questions with answers not included directly in
this FAQ; please see http://www.visi.com/~nathan/a2/faq for more of
them.
Copyright 1996 by Nathan Mates ( Nathan Mates)
--- End Part 3 of 4
--
<*> Nathan Mates http://www.visi.com/~nathan/ <*>
# What are the facts? Again and again and again-- what are the _facts_?
# Shun wishful thinking, avoid opinion, care not what the neighbors
# think-- what are the facts, and to how many decimal places? -R.A. Heinlein