Author: Copyright (C) 2014 by CiderPress authors

Extracting Files

If you only want to extract a few files, select them from the file list before clicking on "Extract...". Selected subdirectories are ignored; only plain files are examined.

The extraction options dialog presents a large set of choices. If you find the range of options bewildering, you may want to walk through the tutorial on the faddenSoft web site. The Quick Configuration buttons, described later, can simplify common tasks.

Files to Extract

You may choose to extract the files selected in the file list, or all of the files in the archive or disk image. If no files have been selected, "all files" will be the only option available.

Parts to Extract

You can further refine your selection by choosing to extract only certain kinds of entries. You will almost always want to leave "data forks" and "disk images" enabled, unless you have an archive that is a mixture of the two. "Disk images" refers to ShrinkIt-archived disk images (the file type is listed as "Disk"), not disk images stored as files.

If you just want to view the contents of the files under Windows, there's usually not much value in extracting the resource forks.

Attempting to extract a ProDOS subdirectory file (type "DIR") will not work. You can examine them as raw data in the file viewer, but extracting them as raw data doesn't make much sense. Instead, folders are automatically created as they are needed.

Format Conversion

Two options are available. If you select "Convert to non-Apple II formats", then files will be converted in the same way they would when viewed with the file viewer. For example, BASIC programs will be converted to TXT or RTF files, and graphic files are extracted as Windows bitmaps (BMP). The individual converters can be turned on and off from the file viewer preferences page. Files without specific conversions are treated as text or binary data according to the rules specified in the "text conversion" options (described below).

The "Extract disks as .2MG" selects whether disk images in NuFX archives are extracted to ProDOS-order ".PO" files or Universal Disk Format 2IMG files. The latter is generally preferred for use with Apple II emulators because the format contains some useful information about the disk image.

Filenames

There are a couple of ways to tweak the filenames. Selecting "Add file attribute preservation" will extend the filename with an attribute preservation sequence, and will replace any characters not legal in Windows with "%xx" codes. This can be used to restore the file type, aux type, original filename, and whether the file holds a data fork, resource fork, or disk image. More detail can be found here. This setting is useful when you plan to add the files back into an archive.

The "Add type extension" option adds a three-letter extension to files that lack one. For example, any file of type TXT will be given a ".TXT" extension so that you can open the file with Notepad by double-clicking on it.

The filename alterations that affect the list view, such as converting filenames to lower case or replacing spaces with underscores, are also taken into account here. These are configured in the General Preferences screen.

Text Conversion

Text files on the Apple II have carriage returns (CR, ASCII code 13) at the end of each line. UNIX and its derivatives use linefeeds (LF, ASCII code 10), and Windows prefers a carriage return followed by a linefeed (CRLF). CiderPress can convert these "end-of-line markers" to CRLF so that Windows applications can read the files.

Not all files of type TXT are text files, and not all text files have type TXT, so CiderPress can try to sort things out for you. There are four settings for end-of-line conversion: off, by file type, automatic scan, and on. When it's set to "off", nothing is converted; when it's "on", everything is converted. If you select "Convert text files by file type", only files of type "TXT" or "SRC" are converted. In the "Auto-detect & convert files with text" mode, CiderPress will scan each file and convert the ones that look like text files, regardless of file type.

Apple DOS 3.3 complicates matters somewhat with "high ASCII" text files. These look garbled unless the high bit of every byte is stripped. However, stripping every text file would cause Apple IIgs documents with "smart quotes" and accented characters to appear damaged. CiderPress only strips the high bits if the end-of-line converter is also enabled, and does so only on DOS 3.3 text files or on text files that are entirely composed of characters with the high bit set. (The "strip high ASCII text files" option is dimmed when "don't convert text files" is selected.)

Archived disk images (e.g. "Disk" entries in a ShrinkIt Archive) never undergo text conversion, even when "Convert ALL files" is selected. Neither do resource forks.

Miscellaneous

Two options that you may find useful. These are not affected by the Quick Configuration buttons.

"Strip folder names" reduces the pathnames shown in the list to just their filenames. Everything you extract will end up in the same folder.

If you select "Overwrite existing files", you will not be asked to confirm overwriting of files with the same name as files being extracted.

Quick Configuration Buttons

There are two large buttons at the bottom of the dialog that allow you to choose from the two most common configurations. Pressing the buttons just changes the state of the controls in the dialog. There are no hidden options or side-effects.

"Configure to preserve Apple II formats" is useful when you want to extract files from one archive and add them to another. Resource forks are extracted, file attribute preservation is enabled, and format converters (including text conversion) are disabled. These files will most likely not be readily usable under Windows, so file extensions are not added.

Click on "Configure for easy access in Windows" when you want to extract files for viewing under Windows. File viewer and text converters are enabled, and file extensions are added where appropriate. Disks are extracted in 2MG format.

Other Notes

Extracting a file that already exists brings up a small dialog that lets you choose whether or not to overwrite the file. You can choose to overwrite it, skip it, overwrite it and all other conflicting files, skip it and all other conflicting files, rename the file being extracted, or cancel the whole thing.

"Damaged" files will not be extracted.