FishWings

Introduction

Using FishWings

Menu Functions

File	Edit	Apple	Tools	Help
New…	Undo	Import…	Preferences…	Content
Open…	Cut	Export As…	Export Graphic…	About…
Save	Copy	Copy Apple file
SaveAs…	Paste	Paste Apple file
Page Setup…	Clear	View Apple file
Print…	Select All	View Resource fork
Exit	Find…	Rename…
	Find Next	Properties
	Replace…	New Folder…
		Catalog
		Display Block or Sector
		Increment Block  or Sector
		Decrement Block or Sector
		Display Volume Bit Map
		Delete File…

History

Error Messages

Bugs

Miscellaneous

License


Introduction

FishWings is an Apple II disk image utility designed to run in Windows9x/ME/XP.

FishWings includes the following functions:

The ability to display the files contained on a disk image of an Apple ][ disk using a tree view similar to that used in Windows Explorer.

View ProDOS and DOS 3.3 file information on a property sheet dialog similar to that used by Windows to display properties of a Windows file.

View the contents of a file as ASCII text or hexadecimal bytes.

ProDOS and DOS 3.3 files can be exported to Windows.

Windows files can be imported into a ProDOS disk image.

ProDOS files can be renamed (including filetype, auxtype and access bits).

ProDOS files can be copied from one directory and pasted into another.

ProDOS files can be deleted from the disk image.

New folders (directories) can be created on the disk image.

You can display the volume bit map.

View any block on a ProDOS disk image or view any sector on a DOS 3.3 disk image.

New ProDOS disk images can be created.

Displayed graphics can be exported as a Windows bitmap file.


Using FishWings

Read this Warning first!

Running FishWings opens a standard Window with a menu bar.  Under the menu bar are two client windows.  On the left is the Tree View window.  The larger window on the right is the display window.

To work with any disk image you must first Open it.

Once opened a tree view of the disk image is displayed.  The root icon at the top of the tree view corresponds to the size of the image;  A 5.25” floppy of 143K bytes, 3.5” floppy of 800K bytes  or hard drive up to 32M bytes.

Left clicking on a file in the tree view highlights it (it is selected).

Once a file is selected it can be exported to Windows, copied to another folder within a ProDOS disk image or it can be viewed in the display window. It can also be deleted, renamed (including changing the file type and aux type) or show the file's properties.

Right clicking on a file brings up a floating menu that contains the functions that FishWings allows for that file.

Double-clicking on a folder will display the files it contains.

Double-clicking on a file will display its contents as the ASCII equivalent to the actual hexadecimal values.

Some file types are translated (if the appropriate preferences are set).

This allows a more useful display of the file contents.

Once a file is displayed (viewed) it can be printed or copied to the clipboard.


Menu Functions

FishWings uses the standard Windows Menu bar with pull down menus.  There are however several things to note, specifically:

The File menu functions pertain to the disk image files found in the Windows system or (in the case of the Print functions) to the text in the display window.

The Edit menu functions pertain to text in the display window.  Apple files on a disk image can't be copied using the Edit menu functions.

The Apple menu (and the associated popup menu) contain all of the functions to view and manipulate files on the disk images.

The Tools menu contains various handy functions.

The Help menu contains this help function (called Contents…) as well as any other function that doesn't seem to fit in the other menus.

In addition to the menu bar there is also a popup menu that appears if you right click on a file in the tree view.  The popup menu functions are duplicates of some of the more commonly used functions found in the Apple menu.


File

The File menu contains the standard functions used on many Windows programs.

To work with Apple files use the Apple menu.

New…

Open…

Save

SaveAs…

Page Setup…

Print…

Exit


 New...

This function creates a new disk image.  This is analogous to formatting a disk and then opening it.

When you click on "New…" in the File menu a dialog window appears that lets you enter a name for the new disk image.  The name chosen is also the volume name of the image so it must conform to ProDOS naming rules.

You can also choose from several disk sizes from 143Kb (5.25" floppy) to 32Mb (hard drive).

FishWings allows you to create 5.25" (DSK) images in either DOS order or ProDOS order.  You can also create other sizes of 2IMG images but only ProDOS ordered.

You can write protect 2IMG images only. You cannot write protect DSK images with FishWings.


Open...

This function Opens (loads) a disk image.  This is usually the first thing you will do after starting FishWings.  "Open…" presents you with a "browse" window from which you can select the image you want.

The following table gives an idea of the image files that FishWings supports:

Image	Windows			FishWings
Type	Extension	System	Order	Support
DSK	.dsk	DOS 3.3	DOS	Read Only
DSK	.dsk	ProDOS	DOS	Read/Write
DSK	.dsk	ProDOS	ProDOS	Read/Write
NIB	.nib	DOS 3.3	DOS	Read Only
Trackstore	.app	---------	---------	No
2IMG	.2mg	ProDOS	ProDOS	Read/Write
2IMG	.2mg	DOS 3.3	DOS	No
2IMG	.2mg	ProDOS	DOS	No
HDV	.hdv	ProDOS	ProDOS	Read/Write
PO	.po	ProDOS	ProDOS	Read/Write
DO	.do	ProDOS	DOS	Read/Write
DO	.do	DOS 3.3	DOS	Read Only

“Order” is the way the blocks / sectors are arranged on the image.  ProDOS order for disk images is numerical, 0, 1, 2, 3, etc.  With DOS order the blocks / sectors are skewed to allow for efficient reading of blocks or sectors on a rotating disk.

“Read Only” means that you cannot alter the disk image by importing or copying files to the image.  You also cannot rename or delete files.  You can view the files and their properties and you can export files to Windows.

If you attempt to Open a file that is not supported you will get an error message.


Save

Save the current disk image to the current location (where the image was loaded from).  There is no prompting.  If you want to save the image under another name or in a different location use the " SaveAs…" function.


SaveAs...

Saves the current disk image after prompting the user for a name for the image and a location to save it.


Exit

This is one way to quit FishWings.

You can also click on the box with an "X"

in the upper right corner of the FishWings window.


Page Setup...

Clicking on "Page Setup…" brings up a dialog window that allow you to set parameters for printing, such as, paper size, margins and orientation (portrait or landscape).  You can also set printer properties.


Print...

The "Print…" function allows you to send the contents of the display window to the printer.  It does this by first bringing up a dialog so that you can set printer properties, number of copies, and print range.  When you click "OK" the contents of the display window will be printed.

NOTE:  To print displayed graphics your printer must support the DIB (device-independent bitmap) format.  Most modern printers do support DIBs.


Edit

The Edit menu contains the typical functions used to Cut, Copy & Paste text in the display window.  Note that Edit menu functions cannot be used on Apple files in the disk images.  For Apple file manipulation you must use the functions found in the Apple menu.

Undo

Cut

Copy

Paste

Clear

Select All

Find…

Find Next

Replace


Undo

This function causes the display window to revert to its last state.  Therefore, if you accidentally "Cut" a selected string of text from the display window, Undo will put the string back.


Select

To select text in the display window, move the mouse cursor to a point just to the left of the first character you want to select.  Then press the left mouse button and hold it down while you drag the cursor right and/or down to a point just right of the last character you want to select.  Release the mouse button.

Selected text is high-lighted (the text color and background color are inverted).


Cut

Deletes the selected text from the display window and saves it to the clipboard.  From the clipboard it can be pasted to another file display or to another place in the same file display.  Since the text is in the clipboard it can also be pasted to many other text editors and word processors.

Note that cutting and pasting text does NOT change the file on the disk image, only the display.


Copy

Saves text that was selected in the display window to the clipboard.  Copy does not delete the selected text.  From the clipboard it can be pasted to another file display or to another place in the same file display.  Since the text is in the clipboard it can also be pasted to many other text editors and word processors.

Note that copying and pasting text does NOT change the file on the disk image, only the display.

Pictures in the display window cannot be copied to the clipboard.


Paste

Inserts the (text) contents of the clipboard into the display window beginning at the cursor position.


Clear

Deletes the selected text from the display window.  The text is not placed on the clipboard.

You can put the text back by clicking on the Undo function before you do any other editing or typing.


Select All

Use this function when you want to select all the text in the display window.

Select All works only with the display window, not with the tree view window.


Import...
Import

Allows you to copy a file from your MS Windows system into the current Apple ProDOS disk image.

To Import a file you first must Open a disk image.

Next select the folder (or root directory) where you want the imported file to be placed.  To select a folder move the arrow cursor to the folder and single-click with the left mouse button.  You can select a file instead of a folder if you want.  The imported file will be placed in the same folder as the selected file.

Now when you click on Import… you will see a dialog window that allows you to browse your system to find the file you want to bring into the Apple ][ world.

When you click on the "Open" button another dialog window appears that gives you the opportunity to set the name, filetype, auxtype, and access bits for the imported file.  FishWings makes an attempt to translate the file name to a legal ProDOS name.  You can edit it as well.

If the file ends in  .pic, .sdk, .shk or .bxy FishWings automatically sets the appropriate filetype and auxtype. Otherwise, FishWings defaults to a TXT filetype and a 0000 auxtype.  You may enter most of the common three letter filetype abbreviations or you can enter the hexadecimal value in the form $nn where the letter "n" represents a hexadecimal digit (0 to F).  The auxtype must be entered as hexadecimal digits with NO leading "$".

Next check the access bits you want the file to have set.  An unlocked file has the Read, Write, Rename and Destroy bits set (checked).

Last, click on the OK button (or Cancel button if you don't want to go ahead with the import).

If everything went right the imported file will appear in the tree view.

If you gave the imported file a name that was the same as another file in the folder you will get an error message and the import will be aborted.

If there is not enough room on the ProDOS volume for the imported file you will get an error message and the import will be aborted.


Apple

This menu is the heart of FishWings.  All of the File manipulation and block viewing function are found here:

Import…

Export As…

Copy Apple file

Paste Apple file

View Apple file

View Resource fork

Rename…

Properties

New Folder…

Catalog

Display Block

Increment Block

Decrement Block

Display Volume Bit Map

Delete file…

If the current image is DOS 3.3 then the Block functions are replaced by:

Display Sector…

Increment Sector

Decrement Sector


Export As...

Allows you to copy a file from the current Apple disk image to your MS Windows system.

To export a file a disk image must be Opened.

Click on the file you want to export in the treeview window.  This highlights the file for export.

Pull down the Apple menu and click on Export As… and you will be rewarded with a browse dialog to choose a location to save the file as well as the name you want it to have.

Clicking the OK buttton exports the file (you can also click on cancel if you change your mind).

You can copy a ProDOS file from one image to another by exporting a file to Windows, opening another ProDOS disk image and then importing the file into that new disk image.  One problem with this method is that you must note the filetype and auxtype of the original file so that you can reset them when you import.  Another problem is that when exporting an extended file (one with a resource fork) only the data fork is exported because Windows does not support forked files.

When exporting some types of DOS 3.3 files to Windows, FishWings allows files to be “translated” before export.  Translation removes the extra data that DOS 3.3 adds to the Applesoft BASIC, Integer BASIC, Text and Binary files.  You can set how you want the files exported in the Preferences dialog.  It is recommended that you set these files to be translated if you are going to import them to a ProDOS disk image.


Copy Apple file

After opening a disk image, this function in conjunction with Paste Apple File, allows you to copy a ProDOS file from one folder to another on that same disk image.  Copying to another disk image is supported but only if the file is not viewed before pasting.

Simply select the file you want to copy and then click on "Copy Apple file" from the Apple Menu.  The file is saved in a buffer (not the clipboard).  Copying another file overwrites the one in the buffer.

You can also copy the file by right clicking on it and then clicking on "Copy Apple file" in the popup menu that appears.

Use Paste Apple file to actually put the file where you want it.


Paste Apple file

This function is used after Copy Apple file to put the file in the folder you want.

First select the folder where you want the copied file to be placed.

Next click on Paste Apple file in the Apple menu.  That’s it. The file will appear in the tree view.

You can also paste the file by right clicking on the folder that is to accept the file and then clicking on Paste Apple file in the popup menu that appears.


View Apple file

This function lets you to view files on the disk image as text.

For most files this doesn't mean much. They will just be a seemingly random assortment of characters but for a text (TXT) file you see it as it was written.

It is important to realize that this function only views the data fork of an extended file.

Teach files contain plain text in the data fork, so they too will be displayed as plain text.  None of the fonts, styles, or formatting will be used.

You can have FishWings translate several types of files by checking the appropriate settings in the Preferences dialog.

To view a file you first open a disk image.

Next you select the file you want to view.

From the Apple menu click on View Apple file.

The file now becomes visible in the display window.

Another way to view a file is to right click on the file you want and then click on View Apple file in the popup menu that appears.

Since this function is frequently used there is a third and even easier way to view a file.  You can just left double-click on it and the file will be immediately displayed for viewing.


View Resource fork

This function lets you view an extended file's resource fork as text.

To view a file you first open a disk image.

Next you select the file you want to view.

From the Apple menu click on View Resource fork.

The file's resource fork now becomes visible (as text) in the display window.

Another way to view a file's resource fork is to right click on the file you want and then click on View Resource fork in the popup menu that appears.


Rename...
Rename…

This handy function allows you to change the name of a file, folder or volume.  It also allows you to change the file's type and aux type. And just for good measure it lets you set the file's access bits (used for locking or unlocking a file).

To rename a file you must first open a disk image and select a file.

From the Apple menu click on Rename… and a dialog window appears that contains an edit box for entering the name as well as an edit box for file type and another for aux type.  You may enter most of the common three letter filetype abbreviations or you can enter the hexadecimal value in the form $nn where the letter "n" represents a hexadecimal digit (0 to F).  The auxtype must be entered as hexadecimal digits with NO leading "$".

Finally, there are check boxes for each of the six access bits.

An unlocked file has the Read, Write, Rename and Destroy bits set (checked).

The Rename… function can also be activated by right clicking on the file and selecting Rename… from the popup menu that appears.


Properties

Displays the selected file's properties.

To display a file's properties you must, of course open a disk image and select a file.

Next you can access the properties function by either pulling down the Apple menu and clicking on Properties or you can just right click on the file and click on Properties from the popup menu that appears.

Either way you will then see a set of overlapping property sheets with tabs on top.  Each tab has a descriptive label for the properties found on that sheet.  You can select any property sheet by clicking on the tab.

The first property sheet is labeled "General" and contains the main properties you normally associate with a file such as:

icon	the icon (in the tree view) that is associated with the file
name	the name of the file
type	the file type given by its 3 letter abbreviation or by its hex byte (or both) or if the file is a DOS 3.3 file the type is given by name
aux type	the file auxiliary type given by its hex word (2 bytes) – (only applies to ProDOS )
location	the name of the folder where the file is found (only applies to ProDOS)
size	how large the file is in bytes
storage	the file's storage type (only applies to ProDOS)
creation	date & time the file was created (only applies to ProDOS)
modified	date & time the file was last modified (only applies to ProDOS)
access	the setting of each access bit (a check means the bit is set) – for DOS 3.3 the files are either locked or unlocked so in general if anything is checked the file is locked

The second property sheet is labeled "Volume" and contains the properties associated with the DOS 3.3 or ProDOS volume.  These properties include:

icon	the icon (in the tree view) that is associated with the volume
volume name	the name of the volume (not necessarily the same as the name of the image) – DOS 3.3 doesn’t support volume names, only numbers
files	the number of files (including folders) contained in the volume
size	the size of the volume in bytes & blocks (bytes, tracks & sectors for DOS 3.3)
free	the amount of free space in the volume in bytes & blocks (bytes & sectors for DOS 3.3)
creation	the volume creation date & time (only applies to ProDOS)
access	the settings of the access bits (a check means the bit is set) – for DOS 3.3 the access of a disk image (write protection) is unknown

The third property sheet is labeled "Image" and contains information about the image file including:

image name	this is a Windows file name
image type	2IMG, DSK, PO, DO or HDV
order	ProDOS or DOS
image location	actually the full pathname of the image
image creator	four letter designation meaningful in 2IMG images
version	this is only meaningful in 2IMG images
locked	yes or no

The last property sheet is labeled "Advanced" and contains information that can be used to find certain locations in the volume at the byte level.  This information applies to ProDOS images only.

File descriptor offset	This is the location  of the file descriptor relative to the beginning of the image (in decimal and hexadecimal)
File descriptor block	Number (decimal & hexadecimal) of the block containing the file descriptor.  You can use the Display Block function to view the descriptor.
First file block	The block number (decimal & hexadecimal) of the first file block (this may be a key block or data block)


New Folder...

Creates a new folder.

To create a folder you must first open a disk image and select a folder to hold the new folder. You can alternately select a file and the new folder will reside with it in the same folder.

Next pull down the Apple menu and click on New Folder… and a dialog will appear for you to enter a name for the new folder.  You can also set the access bits for the folder.

Finally, click on "Ok" and the folder will be created or click on "Cancel" if you change your mind.


Display Block...

This feature allows you to view any block on the current ProDOS volume.

To use this feature you must first open a disk image.

Next, from the Apple menu, click on Display Block… (alternately you can press the "F9" key) and a dialog window will appear asking you to enter a block number.

By default you enter the block number in decimal form.  If you want to enter the number in hexadecimal then first enter a dollar sign "$" followed by the hexadecimal digits.

Last click on "OK" and the block will be displayed in the display window.

Display format:

Hex display:

The left two thirds of the display window holds the block displayed in hexadecimal numbers.

The block is displayed as 16 columns x 32 rows of bytes (512 bytes).

The columns are labeled 00 to 0F and the rows are labeled 000 to 1F0.

All the bytes and labels are in hexadecimal.

ASCII display:

To the right of the hex display the rows of bytes are displayed as ASCII text characters. Unprintable characters (control characters, etc.) are displayed as periods.

Block number:

To the right of the ASCII display the block number is displayed in decimal and hexadecimal.

See example below:

$    00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F        ASCII        Block#

000   00 00 03 00 FE 46 49 53 48 57 49 4E 47 53 2E 44   .....FISHWINGS.D   2

010   41 54 41 00 00 00 00 00 00 00 00 00 22 C9 39 17   ATA.........".9.

020   00 00 C3 27 0D 05 00 06 00 18 01 DA 54 45 53 54   ...'........TEST   $02

030   46 4F 4C 44 45 52 00 00 00 00 00 0F 07 00 01 00   FOLDER..........

040   00 02 00 22 C9 3B 17 00 00 C3 00 00 23 BF 17 00   ...".;......#...

050   02 00 1D 44 49 53 4B 2E 43 52 45 41 54 49 4F 4E   ...DISK.CREATION

060   00 00 1A 08 00 01 00 7A 01 00 23 BF 08 00 23 00   .......z..#...#.

070   E3 73 F8 23 BF 08 00 02 00 29 53 54 59 4C 45 54   .s.#.....)STYLET

080   45 53 54 30 30 30 30 00 00 1A 0D 00 03 00 40 03   EST0000.......@.

090   00 23 BF 13 00 23 00 E3 7B 80 23 BF 13 00 02 00   .#...#..{.#.....

0A0   1D 42 41 53 49 43 2E 50 52 4F 47 52 41 4D 00 00   .BASIC.PROGRAM..

0B0   FC 0A 00 01 00 19 01 00 23 BF 2A 00 23 00 E3 01   ........#.*.#...

0C0   08 23 BF 2A 00 02 00 1D 49 4D 50 4F 52 54 45 44   .#.*....IMPORTED

0D0   2E 46 49 4C 45 00 00 04 0B 00 01 00 49 00 00 23   .FILE.......I..#

0E0   C9 02 00 00 00 C3 00 00 23 C9 25 0D 02 00 00 00   ........#.%.....

0F0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

100   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

110   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

120   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

130   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

140   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

150   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

160   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

170   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

180   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

190   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1A0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1B0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1C0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1D0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1E0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

1F0   00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................

Note that this is a display only, not an editor.  Changing the display does not effect the disk image.

The displayed block may be printed by using the Print… function in the File menu.

If a block changes while it is being displayed the view is automatically updated.

Increment / decrement Block:

You can increment the block number by pressing the "F11" key or decrement it by pressing the "F10" key.  There are also menu functions that will do the same.


Increment Block

This function displays the next block (numerically) from the one currently displayed.

Incrementing a block is only meaningful when a block is being displayed.

To use this function pull down the Apple menu and click on the "Increment Block" item.

That's all there is, the next block is now displayed.

Pressing the "F11" key will do the same.


Decrement Block

This function displays the block before (numerically) the one currently displayed.

Decrementing a block is only meaningful when a block is being displayed.

To use this function pull down the Apple menu and click on the "Decrement Block" item.

That's all there is, the next lower number block is now displayed.

Pressing the "F10" key will do the same.


Display Volume Bit Map

Once an image has been opened the volume bit map can be displayed by pulling down the Apple menu and clicking on "Display Volume Bit Map".

If the volume bit map changes while it is being viewed the display is automatically updated.

You can print the volume display by clicking on the Print… menu item in the File menu.

Display format:

The volume bit map is displayed as rows of 64 ($40) blocks divided into 4 groups of 16 columns. The rows, groups and columns are labeled as hexadecimal numbers.  You can get the block number by adding the row, group and column numbers.

Each block is represented by a "+" character if it is in use and a "-" character if it is free.

See the example below:

Volume Bit Map

        00               10               20               30

$       0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF

0000    +++++++++++++++- ---------------- ---------------- ----------------

0040    ---------------- ---------------- ---------------- ----------------

0080    ---------------- ---------------- ---------------- ----------------

00C0    ---------------- ---------------- ---------------- ----------------

0100    ---------------- --------


Delete File...

This function allows you to permanently remove a file from the disk image.

To delete a file you must first open a disk image and select a file.

Next you pull down the Apple menu, click on "Delete File…" and a prompt window will appear (unless disabled in Preferences) asking for confirmation to delete the file.

You can also delete a file by right clicking on the file and then selecting "Delete File…"" from the popup menu.


Help

The Help menu is pretty much standard except for the addition of the "Preferences…" menu item which was placed here for want of a better place.

Contents…

About…


Preferences...

You can change some of the ways FishWings works by setting your own preferences.

A "property sheet" is displayed with two tabs.

Tab 1:	General

Checking the first box causes FishWings to display a message when you attempt to quit.  The message gives you a chance to change your mind.

Checking the second box causes FishWings to display a message when you attempt to delete a file.  The message asks if you really want to delete the file and of course gives you the option to cancel.  Note that you get a prompt in any case if you attempt to delete an entire folder.

The third box is AutoSave.  Putting a check in this box causes FishWings to immediately update the disk image every time any change is made.  For instance with AutoSave checked when you delete a file from the currently displayed disk image FishWings automatically deletes the file from the image on your hard drive or floppy.  This is as you would expect.  If on the other hand AutoSave was not checked FishWings would only delete the file from the image in memory.  You would then have to use the Save function or the SaveAs… function (in the File menu) to actually and permanently delete the file.

A fourth box, Remember last directory opened, if checked causes FishWings to look in the directory used the last time a disk image was opened.

Tab 2 	Translation

Viewing files:

FishWings normally displays files as ASCII text with nonprintable characters being ignored.  For many files this isn't very helpful, so several translators have been added to improve on usefulness.

The first box is for translation of text (TXT - $04) files.  Checking the box tells FishWings to use some of the characters used to format the output (such as a carriage return).  The display then looks more as it should.

There is another box for translating teach files (GWP - $50 - aux $5445).  Teach files are extended text files with extra formatting information on the resource fork.  Checking this box causes FishWings to treat the teach file as a text file ignoring the resource fork.

Another box allows translation of source files (SRC - $B0).  These files are essentially text files and checking this box translates them in the same way.

Another box causes FishWings to do a limited translation of AppleWorks word processor files (AWP - $1A).  Most of the AppleWorks formatting is not supported.  The display output does show Bold, Underline, Subscript and Superscript styles.  Right, Center, and Left Justification works.  The tabs are hard coded, that is they always tab the same amount.  Most AppleWorks data base files (ADB - $19) will be translated for display as well.

There is a box for translating Applesoft BASIC (BAS - $FC).  If checked FishWings displays a listing similar to that seen on the Apple ][.

There are four types of graphic files that FishWings can display and each has a box that a tells FishWings to display it.

Checking the HGR box causes FishWings to display a binary file (BIN - $06) that is less than 16 kbytes long as a hires graphics picture.  Most binary files are not pictures so most of the time you will see random colored dots on the screen.

Checking the DHR box causes FishWings to display a binary file (BIN - $06) that is approximately 16 kbytes long as a double hires graphics picture.  Most binary files are not pictures so most of the time you will see random colored dots on the screen.

Checking the SHR Screen box causes FishWings to display an Apple ][GS screen file (PIC - $C1, auxtype $0000) as a super hires graphics picture.

Checking the SHR Screen (packed) box causes FishWings to display an Apple ][GS packed screen file (PNT - $C0, auxtype $0001) as a super hires graphics picture.

Checking the Icons box causes FishWings to display an the icons in an icon file (ICN - $CA).

Note:  You can force FishWings to use the default translator by holding down the shift key when double-clicking on the file or clicking on the View Apple file menu item.

There is also a box for a new default translator.  Checking this box causes FishWings to display all files (except those checked in other boxes) as both ASCII text and hexadecimal bytes.  Rows of 16 bytes are displayed.  Each row is labeled with the numerical offset from the beginning of the file.  This new default translator is slow, particularly on large files.  For instance on a 133MHz Windows95 machine a 498400 byte file (AppleWorks GS dictionary) took about 65 seconds to display.  On a 1.3GHz WindowsME machine it took about 3 seconds.

Unchecking this box causes FishWings to display the file as ASCII text with no labels.

Exporting DOS files:

DOS 3.3 adds information to some files that is not needed by ProDOS.  If you are exporting DOS 3.3 files to Windows with the intent to import them into a ProDOS disk image, FishWings can remove this information.

By checking the box marked Applesoft BASIC, FishWings will remove the first two bytes of the file and the last byte before exporting it.  If you do not check this box and you later import the file into a ProDOS disk image as an Applesoft BASIC file,  FishWings could crash when trying to view it.

By checking the box marked Integer BASIC, FishWings will remove the first two bytes of the file and the last byte before exporting it.

By checking the box marked Text, FishWings clears the high bit of each byte (character) of text.  This makes the text conform with ProDOS.

By checking the box marked Binary, FishWings will remove the first four bytes and the last byte of the file before exporting it.

Tab 3 	Display Window

This tab allows you to customize the look of the display window.

The top group box (called Font) pertains to the display window font beginning with three radio buttons:

The Standard radio button sets the font to the same font that was used in previous versions of FishWings, Courier New 9.

The Apple radio button sets the font to A2Like 12.  This is a font that mimics the Apple II 80 column text character set.  For this option to work the A2Like.ttf font must be installed in the Windows\Fonts folder.

The Other radio button activates the Choose font button just to the right.  With the Choose font button you can pick any font and font size from those installed on your Windows\Fonts folder.  Note that most fonts are proportional and do not work well with some of the FishWings functions such as Display block…and Display Volume Bit Map. Also, FishWings tries to keep the text display fixed at 80 columns to make it look more like an Apple II.  This works well with fixed width fonts like Courier and A2Like but can break down with proportional fonts.

You can also set the color that the display window uses to display text by clicking on the Font Color button.  A standard color selection dialog is displayed that lets you choose from 48 preset colors or lets you define up to 16 custom colors.  The font color takes effect the next time something is viewed in the display window unless the text is selected in which case it takes effect immediately.  Note that the font color is used for both display and printing.

The bottom group box (called Background Color) contains only one button:

Clicking on the Choose Background button allows you to set the background color of the display window by bringing up the same type of color selection dialog as with the Font Color button.  Unlike the font color, the background color is used only for the display, not for printing.  Also unlike the font color, the background color is changed immediately.

Initialization:

When you run FishWings it looks for an initialization file (fishwings.ini).  If it doesn't find one on the current folder it creates one with the default preferences.  Any time you change a preference FishWings changes the initialization file.

FishWings does not use the Windows registry.

NOTE:  If you are installing FishWings over an older version you should first delete the old fishwings.ini file.  Otherwise some of the new functions may not work correctly.


Content

This is the help screen you are now viewing.


About...

This is the dialog window that gives the copyright notice, etc.


disk image

Apple II emulator programs use disk image files to emulate actual floppies and hard disks.  They arrange the data in much the same way as disks.

FishWings supports several different formats of disk images. In the MS-DOS/Windows world these disk images have the following extensions:

DSK	Image of a 5.25" floppy, either ProDOS or DOS 3.3.  The blocks may be ProDOS ordered but are usually DOS ordered regardless of the disk operating system.

2MG	This image may be of any size up to 32 megabytes. It may be either ProDOS or DOS 3.3 and may be either ProDOS ordered or DOS ordered (FishWings does not support  DOS 3.3 or DOS ordered 2MG images). The 2MG image file (also known as 2IMG) has a header that contains information about the image and it may or may not contain other added information.

PO 	ProDOS ordered disk image of any size up to 32 megabytes.

DO	Image of a 5.25" floppy, the same as a DSK image but must be DOS ordered.

HDV	Image of a hard drive up to 32 megabytes.  Since DOS 3.3 didn't support hard drives this image format is always ProDOS.

NIB	Raw image of a 5.25" floppy complete with address and data headers and encoded as nibbles, just as it would be on a real disk.


ProDOS

ProDOS is the Disk Operating System that succeeded DOS 3.3 on the Apple ][ series of computers.

Introduced in 1984, it is faster and more flexible than DOS.  It provides a tree type system with directories (folders), allows a rudimentary memory management and has support for time/date stamping of files. ProDOS also allows 256 file types and more than 65,000 auxiliary file types.

ProDOS works with blocks of data 512 bytes long.

ProDOS files may be up to 16 Mbytes long and a ProDOS volume may be up to 32 Mbytes long.

There have been more than a dozen releases of ProDOS from version 1.0 to version 2.0.3.

With version 1.2 the name was changed to "ProDOS 8" because there was a 16 bit version for the Apple ][gs called "ProDOS 16".


DOS

The original Disk Operating System for the Apple ][ series of computers.  The most common version is DOS 3.3.

In DOS all the files reside together. There are no directories.

It allowed only 8 file types.

DOS works with sectors of data 256 bytes long.

DOS was replaced by ProDOS.


File Types

In ProDOS each file has a type number to denote its format.  The legal type numbers are 0 to 255 ($00 to $FF in hexadecimal). This file type number is not part of the file itself but is kept in a "file descriptive entry" found on the directory block.  Apple Computer maintained control of allocating file type numbers with the exception of types 241 through 248 ($F1 to $F8) which are user defined.

Many of the file types also carry an abbreviation (usually 3 characters long), for example a binary file is file type 6 ($06) and is abbreviated BIN.

Note that the file type abbreviation is not kept with the file but relies on the operating system or other software to determine what it is.

In addition to the file type each ProDOS file also has an auxiliary file type.

In DOS 3.3 there are eight file types:

Applesoft BASIC

Text

Integer BASIC

Binary

R

S

A

B


Aux Type

In addition to the file type, ProDOS also has a two byte long auxiliary file type.  As with the regular file type the aux type is kept in a "file descriptive entry" found on the directory block. Apple Computer maintained assignment of aux type numbers.


access bits

ProDOS uses eight bits (one byte) in the file descriptive entry to define how the file may be accessed.  If a bit is set (equals one) then it is enabled.  If the bit equals zero then it is disabled.

bit	access

0	read enable

1	write enable

2	invisible (used with GS/OS)

3	reserved

4	reserved

5	backup needed

6	rename enabled

7	destroy enabled

If a file is destroy, rename, read and write enabled it is considered unlocked.  If destroy, rename and write are disabled it is considered locked.

In DOS 3.3 the files are either locked or unlocked.  If FishWings displays any access boxes checked for a DOS 3.3 file it can be considered locked.

Access bits have no meaning for DOS 3.3 volumes.  FishWings cannot determine if it is write protected.


Selecting Files

Once a disk image has been opened you can select a file by moving the mouse arrow to the file you want (in the tree view window) and click on it.  The file's text will be highlighted. If the file is in a closed folder just double click on the folder and its files will be displayed in the tree.


Popup menu

When you right click on a file a "popup" or "floating" menu appears. The functions on the popup menu are a subset of the functions in the Apple menu.


ProDOS file names

ProDOS file names and volume names must be no more than 15 characters long.  The characters allowed are uppercase letters A to Z, the period (.) and digits 0 to 9.  In addition the first character must be a letter.

When entering a file or volume name in FishWings the lowercase characters are automatically converted to uppercase.


Warning!

FishWings has not been extensively tested!

Be sure to back up all your disk image files

before using FishWings.

You may also want to uncheck the AutoSave preference until you have become familiar with using FishWings.  This will keep FishWings from automatically updating the disk image on your hard drive or floppy.  Instead only the image in memory will be effected.  You can, at any time, force FishWings to update the image (on your hard drive or floppy) by clicking the Save menu item (in the Files menu).  Alternatively, you can save the image under a different name by using the SaveAs… function.


Miscellaneous

Trademarks

Windows, Windows 95, Windows NT, Windows 98, Windows 2000, Windows ME,

Windows XP, MS-DOS, and MS are registered trademarks of Microsoft Corporation.

Apple and ProDOS are registered trademarks of Apple Computer, Inc.

Technical Information

FishWings was written entirely in C using the freeware lcc-Win32 compiler & linker.  Lcc-Win32 is an excellent programming system written by Jacob Navia.  The lcc compiler was written by Chris Fraser and Dave Hanson.

Limitations

FishWings was designed to work in Windows 95, Windows ME and WindowsXP.  It will not work on MS-DOS or versions of Windows before Windows 95.  FishWings was designed to work with a screen resolution of at least 800 x 600.  If you use a lower resolution, displayed graphics files will only be partly visible (graphics can not be scrolled).

Graphic files cannot be copied to the clipboard.

DOS 3.3 DSK images are “READ ONLY”.

FishWings does not support DOS 3.3 ordered 2IMG disk images, although DOS 3.3 order is supported on DSK disk images.

Speaking of DSK disk images.  FishWings only supports standard ones that are the same size as a standard ProDOS 5.25" floppy disk.

NIB disk images are “READ ONLY” and then only if they are standard DOS 3.3, DOS ordered images.

When exporting an extended file, only the data fork is exported.

Only a few of the common file icons are used by FishWings.

The AppleWorks word processor and data base file translation is less than perfect.

FishWings does not support "Drag & Drop".

Many older Applesoft BASIC files used non-standard programming tricks.  FishWings can detect some of these “tricks” and beeps the speaker, but sometimes it cannot display the listing correctly.

The A2Like font that is included with FishWings is supposed to look like the Apple ][e 80 column text character set.  Although it is a Truetype font it scales very poorly.  It only looks good at sizes that are multiples of 12.

FishWings can become very slow if the free memory on your computer is less than the size of the disk image you are opening.


Error messages

FishWings has a limited amount of error protection.  For instance, although FishWings will not allow you to create a file that has a pathname longer than 128 characters, it will allow you to rename a folder with a longer name, thus possibly causing a file within that folder to exceed the 128 character limit.

Below is a list of error messages you may encounter.  In addition there is always the possibility of a Windows generated error message:

Usage Error messages:

"You must select a place for the imported file!"

or

"You must select a place to paste the file!"

or

"You must select a place for the new folder!"

or

"You must select a file!"

or

"No item selected!"

You have to select a file or folder in the treeview for the function to work.

"Block# must be between zero & n ($n) for this disk." (where n is any number).

You tried to display a block that doesn't exist on this disk image. "n" is the last block on the image.

"You must open a disk image first!"

You have to open a disk image for the function to work.

"Type must be 3 characters long! Hex numbers start with $"

When entering a file type in Rename... or when naming an imported file you must enter exactly 3 characters, either the 3 letter abbreviation or a dollar sign follow by two hexadecimal digits.

"Not a supported type name, use hex!"

The file type abbreviation that you entered is not supported by FishWings.  You must enter the hexadecimal equivalent.

Disk Image Error messages:

"Error! Not enough free image space available."

or

"Not enough space on the disk for the import file!"

or

"Not enough space to Paste!"

Disk is too full to accept the added file or folder.

Limitations Error messages:

"Error! Unsupported storage type."

or

"Selected file has an unsupported storage type!"

FishWings supports only volumes, directories, seedling, sapling, tree and extended files.  Any other storage type can cause an error.

"Error! Non-standard entry length."

ProDOS technically allows different file descriptive entry lengths but in practice they are $27 bytes long (the only length FishWings supports).

"DOS 3.3 disk images are not supported!"

The disk image you are trying to load is DOS 3.3.  FishWings does not support DOS 3.3 on disk images other than DSK.

"Incorrect volume directory header!"

Although, this may be a disk image it is one that is not supported by FishWings.

Memory Error messages:

"Error! Can't create buffer for the volume bit map."

FishWings can't find enough available memory on your computer to store the volume bit map.  This could happen with several file management functions.

"Edit control out of space."

The file is too large for the display window or you are trying to add too much to the existing text in the display window.

In addition to these memory error messages, many of the error messages below can at times be caused by lack of memory on your computer.

General and Internal Error messages:

"Error # n"  (where n can be any number).

Catch all error message used for obscure errors.

"Could NOT create treeview imagelist!"

or

"Could NOT create tree!"

or

“Could NOT create graphics imagelist!”

There was an internal problem when Windows tried to create the treeview.

"Edit window not created!"

There was an internal problem when Windows tried to create the display window.

"Unable to display HiRes Graphics image!"

or

"Unable to display Double HiRes Graphics image!"

or

"Unable to display Packed Super HiRes Graphics image!"

or

"Unable to display Super HiRes Graphics image!"

There was an internal problem when FishWings tried to display a picture.  This is usually due lack of memory on your computer.

"Could not get path!"

Internal treeview error.

"Can't import the file."

or

"Can't create the folder."

or

"Can't paste the file."

or

"Can't rename the file."

Internal error associated with pathname.

"Could not write file <filename>"

Windows couldn't save the exported file.

"Could not copy file <filename>"

FishWings couldn't copy the file.

"Could not Paste!"

FishWings didn't find any "copied" file to paste.

"Unable to load the Rich Edit control!"

FishWings needs to use the RICHED32.DLL file. It should be in your Windows/System folder.

"Can't create new folder."

FishWings cannot create a new folder. Usually, this is associated with a pathname problem.

"Could not launch <pathname >"

FishWings was unable to display the help file, usually because it is missing or possibly due to problems with the Windows help display routines.

"Could NOT save disk image!"

Windows could not perform the save.  Possibly there is no room on the disk or the disk is write protected.

"The file is not a true 2IMG disk image!"

FishWings does not recognize the file as a 2IMG disk image.

ProDOS Error messages:

"A ProDOS filename must have between 1 & 15 letters!"

and

"The first character of ProDOS filename must be a letter!"

and

"A ProDOS filename may only consist of letters, numbers and period!"

These error messages are caused when you try to enter an illegal ProDOS name.

"Duplicate Name!"

ProDOS doesn't allow files with the same name to reside in the same directory.

"Pathname is too long: n characters."

or

"Pathname length is: n characters. ProDOS only allows 128."

You have exceeded the pathname length allowed by ProDOS.  "n" is the number of characters entered.

"Error! ProDOS does not allow more that 51 files in the root folder."

You tried to put too many files in the root directory.

"Error! The file is too large for ProDOS"

ProDOS files can be no larger that 16 megabytes.

"Are you sure you want to create a path that is greater than 64 characters long!"

Strictly speaking this is not an error message because ProDOS allows pathnames to be 128 characters long.  Unfortunately, ProDOS only accepts commands with pathnames 64 characters long.  You must therefore set a prefix to access files with a longer than 64 character pathname.  This message gives you the option to back out or continue.

DOS Error messages:

“DOS error #n  No Buffers Available!”

Where n = 1, 2 or 3.  There isn’t enough available memory left on your computer.

“DOS error #4  File not found!”

The file you have selected can’t be found on the image.    This usually means that the track/sector list is bad.

“DOS error #5  Deleted File!”

You have clicked on a deleted file.  You should NEVER see this one.

"DOS error #10  Not a standard DOS 3.3 disk!"

Modified non-standard DOS 3.3 is not supported by FishWings.

“DOS error #11  VTOC error!”

The Volume Table of Contents is non-standard or contains more than 35 tracks.

“DOS I/O error #n”

Catch all error message.  Usually means there FishWings encountered an illegal track or sector number.

Printing Error messages:

"StartDoc Error!"

and

"StartPage Error!"

and

"Display Band Error!"

and

"EndPage Error!"

and

"EndDoc Error!"

All are printing errors associated with Windows.

"FishWings cannot print graphics on this printer."

The printer must be able to handle Device Independent Bitmaps (DIBs)

greater than 64K in size.  Most modern printers will work.

"Image Printing Error!"

An error occurred while printing a picture.

"Could not get device context!"

and

"Could not create compatible device context!"

and

"Could not create compatible bitmap!"

and

"Could not copy bitmap!"

All are errors associated with processing picture data for printing.

"Could not allocate memory for the bitmap data!"

Not enough free memory on your computer to print the picture.

---------------------------------------------------


Bugs

Alas, FishWings does have some known bugs (and I'm sure some I don't know about, yet).  Here are the known ones:

FishWings relies heavily on the disk image file format being what it is supposed to be.  FishWings makes only a few checks and then blindly assumes everything is OK.  It is therefore possible that a corrupt image file or one that has been intentionally altered will sneak past these checks and cause FishWings to crash.

When viewing an Appleworks word processor file that has a printer command character (bold, underline, etc) as the first character of the file it is ignored.  Strangely, this bug appears in Windows 95 but not in Windows ME.

There are some quirks in the DOS 3.3 export translation routines that have yet to be solved.

FishWings does not handle random access text files properly.  You may get strange results when viewing these files and the file length will be wildly inaccurate.


History

As an ex-Apple IIgs user who moved to the PC world a few years ago (In truth I still use my GS occasionally) I wanted some easy way to view files found on disk images.

I toyed with the idea of having a text-based program but the "tree view" concept used by Windows Explorer is so easy to use that I decided to mimic it with ProDOS disk images.

FishWings was born.

Of course, once I had FishWings "cataloging" the disk images and viewing files, I still had no way to show information about the files (like file type and size).  I added the properties function to alleviate the problem.  Again I borrowed from Microsoft (they do some things right) and made a "property sheet" dialog window modified to the needs of the ProDOS system.

About this time I added the copy & paste routines so that I could move the displayed text to a Windows word processor for printing.

But why not have printer routines in FishWings?  That came next.

And then it would be nice to export files to the Windows environment. Ok, did that.

I had thought about adding an import function to allow me to put files directly into a disk image.  This would be a nice feature since I move my files from the GS to the PC environment using the PC Transporter Transfer program. Unfortunately, I didn't know very much about the inner workings of ProDOS. This is a pretty big step because so far I had done nothing that effected the disk image itself.  Importing a file has the potential to destroy the disk image if it isn't done right.  Add to that the fact that I had no easy way of telling if the file had been imported correctly.

To help me examine the disk image at a lower level I added the "Display Block" function and the "Display Volume Bit Map" function.  These two functions are read only so they posed no risk to the disk image but they were a virtual necessity for me.  Besides they're pretty neat.

At this point I added a "Delete File" function.  Why delete and not the import function?  Well deleting a file is inherently easier to do than stuffing one in.

Once I got it working correctly, I added a recursive routine to delete a folder and all its files.

Now I was ready to tackle the "Import File" function.  Well, not so fast.  When a file is imported you can't assume the filename is a legal ProDOS name.  You also have to have a way to set the file type, aux. type and access bits, none of which are preserved by Windows.

So before I could start my import routines I had to write a naming dialog that had features to set the files types and access.  This is also the basis of the Rename dialog used to change the name, etc. of any file or folder in the disk image.

Ok, now finally I could add the "Import File" function.

With the import routines in place and working I began thinking that it was pretty sad that I could import a file from another environment but couldn't copy a file within the disk image itself.  I added "Copy Apple File" and "Paste Apple File" routines to handle the problem.

Next I added a folder (directory) creation function.

Next came the "New" function for creating new disk images.

I then added the "Preferences" dialog.

Finally, I improved this "Help" function that I had been writing in "bits & pieces" during the whole programming process.

I made Version 0.73 available on the internet.

I then added some “Read Only” support for DOS 3.3 DSK images.  This included viewing files, displaying their properties, exporting files to Windows and viewing track sectors.  Some extra preferences to handle the DOS 3.3 exporting were also added.

At about this time I began testing FishWings with Windows ME and found that some new bugs had surfaced.  One bad bug was causing FishWings to crash after several images had been opened (a similar bug has been reported for Windows 2000).  Another bug caused the display window to use the Windows system font instead of Courier which is hard coded for the display.  I chose Courier because it is a fixed (monospaced) font as is the original Apple II screen.  Both of these bugs have been fixed (I hope).

I made version 0.78d available on the internet and version 0.78e replaced it the next day when a bug was found (and fixed).

I decided to add the ability to customize the display screen a bit by allowing the user to choose the font, font color and background color.  I also made a font that is an Apple ][e 80 column text “look-a-like”.

I added context sensitive help to the Properties and Preferences dialogs.

I then found and hopefully fixed another bug.  This one caused some files to be invisible to the ProDOS catalog command.  Specifically, when FishWings imported or copied a file to a subdirectory and a new block was allocated (about every 14th file).  FishWings wasn’t updating the End Of File bytes in the subdirectory’s descriptive entry.  GS/OS doesn’t use these bytes and apparently ProDOS doesn’t for anything other than the catalog.

I made version 0.79 available on the internet.

A new default file display was added.  It is more useful than the original but it is so slow on big files that I allowed it to be shut off in favor of the old routine (in translation preferences).

The ability to display and print HiRes graphics was added.

This was expanded to Double HiRes and two types of Super HiRes graphics.

An option was added to have FishWings remember the last accessed directory.

I changed FishWings to allow accessing .PO disk images of any legal ProDOS size.

I made Version 0.80 available on the internet.

Next, I changed FishWings so that it can read .NIB images if they are standard DOS.  Since most .NIB images are NOT standard DOS this ability is of limited usefulness but anyway it's there.

An option was added to allow the viewing of the icons in an icon file.

Context sensitive help was added to the New, Name and New Folder dialogs.

The new default display is now five to six times faster on large files than previously.  Still it is slow compared to the original ASCII display.

Holding down the shift key while viewing a file forces the default display to be used.

Find, Find Next and Replace functions have been added for use with text in the display window.

A "Catalog" function was added to the Apple menu.  This function outputs a printable list of the image files to the display window.

When importing a file that has a .SHK or .SDK extension FishWings automatically enters the ShrinkIt filetype and auxtype into the Name dialog.  FishWings also enters the correct filetype and auxtype for .PIC and .BXY file extensions.

Several bugs have been fixed including one that caused an error message after exiting FishWings in WindowsXP.

I made version 0.83 available on the internet.

Several more bugs were fixed.  Treeview window sizing was added.  Also when you resize the window the sizes are retained for the next time.  A Tools menu was added and the preferences menuitem was moved into it.  Also, a new function Export Graphic… was added to the Tools menu.  Extended files (those with resource forks) can now be copied from one folder to another or to another disk image.  The properties dialog now shows the size of the data and resource forks of extended files.

I made version 0.85 available for download.

More bugs fixed.  You can now read and write to ProDOS HDV images.   The high bit is now stripped from the ASCII part of the “new default translation”.  This allows more text to be read.

FishWings can now display most Appleworks Data Base files.

I made version 0.86 available for download.


License

FishWings version 0.86 is a licensed, copyrighted, program that is free.  Other versions of FishWings may or may not be free.  You are licensed to use, copy and distribute this version of FishWings as long as you read and agree to the following:

I, Charlie Danemark, am the author and copyright holder of FishWings.

FishWings is distributed "AS IS".

Although, I hope you will find FishWings useful, it is not guaranteed to do anything.

FishWings is not guaranteed to be free of defects or bugs.

I cannot be held responsible for any direct or indirect damages caused by FishWings.

When distributing FishWings all the accompanying files (including this license agreement) must be included.

You may not alter FishWings without my written permission.

Using FishWings means that you agree with this license.

If you do not agree with the terms of this license you must delete all FishWings files.


Display Sector...

When a DOS 3.3 volume has been opened FishWings allows you to view individual sectors on the disk image.

To use this feature you must first open a disk image.

Next, from the Apple menu, click on Display sector… (alternately you can press the "F6" key) and a dialog window will appear asking you to enter a track number and sector number.

By default you enter the track and sector numbers in decimal form.  If you want to enter the numbers in hexadecimal then first enter a dollar sign "$" followed by the hexadecimal digits.

Last click on "OK" and the sector will be displayed in the display window.

Display format:

Hex display:

The left two thirds of the display holds the sector displayed in hexadecimal numbers.

The sector is displayed as 16 columns x 16 rows of bytes (256 bytes).

The columns are labeled 00 to 0F and the rows are labeled 00 to F0.

All the bytes and labels are in hexadecimal.

ASCII display:

To the right of the hex display the rows of bytes are displayed as ASCII text characters. Unprintable characters (control characters, etc.) are displayed as periods.

Block number:

To the right of the ASCII display the block number is displayed in decimal and hexadecimal.

See example below:

$    00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F        ASCII       Trk/Sec#

00   00 11 0E 00 00 00 00 00 00 00 00 13 0F 82 C8 C5   ..............HE   17/15

10   CC CC CF A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0   LLO

20   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 06 00 14 0F               ....  $11/$0F

30   81 C1 CE C9 CD C1 CC D3 A0 A0 A0 A0 A0 A0 A0 A0   .ANIMALS

40   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 12                  .

50   00 15 0F 80 C1 D0 D0 CC C5 A0 D0 D2 CF CD D3 A0   ....APPLE PROMS

60   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0

70   A0 A0 03 00 16 0F 81 C1 D0 D0 CC C5 D3 CF C6 D4     .....APPLESOFT

80   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0

90   A0 A0 A0 A0 A0 06 00 17 0F 81 C1 D0 D0 CC C5 D6        .....APPLEV

A0   C9 D3 C9 CF CE A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0   ISION

B0   A0 A0 A0 A0 A0 A0 A0 A0 1A 00 18 0F 81 C2 C9 CF           .....BIO

C0   D2 C8 D9 D4 C8 CD A0 A0 A0 A0 A0 A0 A0 A0 A0 A0   RHYTHM

D0   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 11 00 19 0F 84              .....

E0   C2 CF CF D4 B1 B3 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0   BOOT13

F0   A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 A0 0A 00                 ..

Note that this is a display only, not an editor.  Changing the display does not effect the disk image.

The displayed sector may be printed by using the Print… function in the File menu.

Increment / decrement Sector:

You can increment the sector number by pressing the "F8" key or decrement it by pressing the "F7" key.  There are also menu functions that will do the same.


increment sector

This function displays the next sector (numerically) from the one currently displayed.

The track is also incremented as needed.  Incrementing a sector is only meaningful when a sector is being displayed.

To use this function pull down the Apple menu and click on the "Increment Sector" item.

That's all there is, the next sector is now displayed.

Pressing the "F8" key will also increment the sector.


Decrement Sector

This function displays the sector before (numerically) the one currently displayed.

The track is also decremented as needed.  Decrementing a sector is only meaningful when a sector is being displayed.

To use this function pull down the Apple menu and click on the “Decrement Sector” item.

That's all there is, the next lower number sector is now displayed.

Pressing the "F7" key will also decrement the sector.


IDH_STDFONT
Sets the display page font to Courier New 9, the font used on old versions of FishWings.


Apple 2 Font
Sets the display page font to A2Like 12.  This is a font that looks similar to the Apple II 80 column text character set.  For this to work the A2Like.ttf must be installed in the Windows\Fonts folder.


other font selection
Activates the “Choose Font” button to allow a Windows font to be chosen.


Choose font
Displays a dialog box that allows you to choose a display window font from the Windows\Fonts folder. Note that selecting Bold or Italic have no effect.


Font color
Displays a dialog box that allows you to choose the color for the display window font.  This color will also be used for printing.


get background
Displays a dialog box that allows you to choose the background color for the display window.  This color will NOT be used for printing.


quit prompt pref
Checking this box causes a message to appear when you quit FishWings, asking you to confirm that you want to quit.


del prompt pref
Checking this box causes a message to appear when you delete an Apple II file, asking you to confirm the file deletion.


autosave pref
Checking this box causes FishWings to automatically save any changes you make.  If this box is left unchecked changes are made only on the image in memory, not to the image file.  You can save to file by using the “Save” or “Save As…” menuitems.


translate text pref
Checking this box causes FishWings to display text files without extraneous formatting characters, etc.


translate teach pref
Checking this box causes FishWings to display teach files as a plain text.


translate source pref
Checking this box causes FishWings to display source files as a plain text.


translate appleworks wp pref
Checking this box causes FishWings to translate Appleworks wordprocessor and database files so that they are readable in the display window.


translate applesoft pref
Checking this box causes FishWings to translate Applesoft BASIC program files so that listings are readable in the display window.


convert dos applesoft pref
Checking this box causes FishWings to convert DOS 3.3 Applesoft BASIC program files before exporting so they will be compatible with ProDOS.


convert dos text pref
Checking this box causes FishWings to convert DOS 3.3 text files before exporting so they will be compatible with ProDOS.


convert dos binary pref
Checking this box causes FishWings to convert DOS 3.3 binary files before exporting so they will be compatible with ProDOS.


convert dos intbasic pref
Checking this box causes FishWings to convert DOS 3.3 Integer BASIC program files before exporting so they will be compatible with ProDOS.


gen prop filetype
With ProDOS this is the file type abbreviation if one exists followed by the hexadecimal value.

For DOS 3.3 this is the file type name.


gen prop auxtype
In ProDOS this is the auxiliary file type, a four digit hexadecimal value.

 It is not used in DOS 3.3.


gen prop location
In ProDOS this is the pathname of the file’s location.

In DOS 3.3 this is the volume number where the file is located.


gen prop size
For most files this is the actual size of the file in bytes (not the size it takes up on the disk).


gen prop storetype
This is the storage type used by ProDOS.

Seedling :	a file with one data block used.

Sapling:	a file with 2 to 256 data blocks.

Tree:	a file with 257 to 32768 data blocks.

Volume:	root directory.

Folder:	subdirectory.

Extended:	a file with a resource fork.

DOS 3.3 does not use storage types.


gen prop creationdate
The date and time the file was created.

 DOS 3.3 does not support a creation date and time.


gen prop mod
The date and time the file was last modified.

DOS 3.3 does not support a modification date and time.


gen prop access
Shows how the file may be accessed.  In ProDOS individual functions may be turned on/off.

In DOS 3.3 files are either locked or unlocked.

To actually change the settings use the “Rename…” function.


gen prop read
If checked the file can be read.


gen prop write
If checked you can write to the file.


gen prop invisible
If checked the file is invisible.  This is only meaningful with GS/OS.


gen prop backupbit
If checked the file has changed since the last backup.


gen prop rename
If checked the file can be renamed.


gen prop destroy
If checked the file can be destroyed.


gen prop filename
This is the Apple ][ name for the selected file.


gen prop icon
This is the icon that FishWings uses for the selected file type.


vol prop volumename
This is the Apple ][ volume name (ProDOS) or number (DOS 3.3).


vol prop freespace
This is the amount of free space available on the volume.


vol prop numfiles
The number of files, including folders, on the volume.


image prop pcname
This is the Windows file name of the disk image.


image prop icon
This is the Windows icon for the disk image file.


image prop pclocation
This is the location of the disk image in your system.


image prop imagetype
This is the type of disk image.

DSK, 2MG or HDV.


image prop order
This is the order that the sectors or blocks are arranged on the disk image.

It can be either DOS order or ProDOS order.  Note that either order can be

used with either operating system.


image prop creator
This is the program that created the 2MG disk image.


image prop version
This is the 2MG version number.


image prop lock
Designates whether the Apple volume contained in the disk image is

locked (write protected) on not.


adv prop fileoffset
This is the number of bytes from the beginning of the ProDOS volume

to the file description entry.


adv prop headerblock
This is the block containing the file description entry.


adv prop firstblock
This is the first block of the file. This may be data or a key block.


remember last directory
Checking this box tells Fishwings to look in the last directory used when opening a disk image.


new default file translator
Checking this box tells Fishwings to display all files ( other than those checked here ) as both ASCII text and hexadecimal bytes along with the numerical  offset from the beginning of the file.   This is very slow with large files.

Unchecking this box causes the files to be displayed simply as ASCII text.  Less informative but much faster.


trans HGR
Checking this box causes binary files of the appropriate size to be displayed as HiRes graphic pictures.


trans DHR
Checking this box causes binary files of the appropriate size to be displayed as Double HiRes graphic pictures.


trans SHRC1
Checking this box causes Apple ][GS screen image files (type $C1 - auxtype $0000) to be displayed as Super HiRes graphic pictures.


trans SHRC01
Checking this box causes Apple ][GS packed screen image files (type $C0 - auxtype $0001) to be displayed as Super HiRes graphic pictures.


new 2mg
Selecting this button allows you to create a new 2IMG (.2mg) disk image.  FishWings supports only ProDOS ordered 2IMG disk images.


new dsk
Selecting this button allows you to create a new DSK (.dsk) disk image.


new prodos
Selecting this button causes the disk image to be created with ProDOS ordered sectors.  That is, the sectors are arranged so that ProDOS blocks ( 2 sectors long ) are placed on the image in numerically ascending order.


new dos order
Selecting this button causes the disk image to be created with DOS sector ordering.  This means that the sectors on the disk image are skewed in the same way that DOS 3.3 did on real floppy disks.

This option is only available with DSK (.dsk) disk images.

NOTE:  FishWings only allows the creation of ProDOS disk images but a ProDOS DSK disk image may have either ProDOS or DOS sector ordering.


new volume lock
Checking this box write-protects the disk image.  This option is only available with 2IMG (.2mg) disk images.


new po image
Selecting this button allows you to create a new PO (.po) ProDOS ordered disk image.


new name
Allows entering of a ProDOS volume name for your new disk image. ProDOS  volume names must be no more than 15 characters long.  The characters allowed are uppercase letters A to Z, the period (.) and digits 0 to 9.  In addition the first character must be a letter.


new image size
Allows you to set the size you want the new disk image to be.  FishWings allows you to create various size 2IMG and PO images.  DSK images must be 143 kilobytes.


rename editname
Edit the ProDOS file name in this box.  ProDOS  names must be no more than 15 characters long.  The characters allowed are uppercase letters A to Z, the period (.) and digits 0 to 9.  In addition the first character must be a letter.

FishWings will automatically convert lower case letters to uppercase.


rename edittype
Edit the ProDOS file type here.  You can enter the hexadecimal number of the type in the form $XX where X is a hexadecimal digit.  FishWings also allows entry of many file name abbreviations such as, BIN, TXT, SYS, BAS, etc.


rename editauxtype
Edit the ProDOS auxiliary file type here.  Enter four hexadecimal digits ( no leading $ ).


newfolder editfname
Enter the name for a new ProDOS folder in this box.  ProDOS  folder names must be no more than 15 characters long.  The characters allowed are uppercase letters A to Z, the period (.) and digits 0 to 9.  In addition the first character must be a letter.

FishWings will automatically convert lower case letters to uppercase.


display icon file
Checking this box allows you to view the icons in an icon file.


Find...

This menu item displays a dialog that allows you to enter a string of text to be found in the display window.  Alternately, you can bring up the Find dialog by typing Ctrl-F.

Checking the box on the dialog allows you match the case exactly.


Find Next

This menu item will find the next occurrence of the text string that was previously found.

You may also use the F3 key to perform the same function.

Use the Find… menu item to enter the text string.


Replace...

This menu item displays a dialog that allows you to enter one string of text to be found and another string to be used to replace it.  Alternately, you can bring up the Replace dialog by typing Ctrl-R.


Catalog

Displays a catalog (file list) in the display window.  This list is similar to what you see in the treeview but has the advantage that it is printable and you can use the Find… function to locate a particular file in the list.  To catalog the entire image the root (volume) item in the treeview should be selected.  Selecting a folder (subdirectory) displays the catalog of that folder including the folders it contains.  Selecting a file displays only that file in the catalog.  ProDOS image catalogs are displayed as an expanded tree.  DOS 3.3 image catalogs are displayed as a list similar to the way they are displayed on a real Apple ][.


Export Graphic...

This function allows you to transfer the picture in the display window to a Windows bitmap file (.bmp) file.  The picture can then be viewed or edited on various Windows drawing programs.


Tools

Preferences…

Export Graphic…