. SHRConvert 2.1 help file     Copyright 1988 Jason Harper
. This file is not human-readable: press Apple-? in the program to display it.
. SHRConvert requires 512K and must be run from a v2.0 or higher System Disk.
. If run from the Finder, launch SHRCONV.FINDER instead of SHRCONVERT itself.

^2ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR

Invalid data in the SHRCONVERT.HELP file:

Label "^3.^0^1" not found.

^2ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR ERROR
^~~~
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.ADV-EXIT
A door opens in front of you.   You have escaped the maze alive!

.HOME
^2SuperHiRes Convert version 2.1                       Written by Jason Harper

Select the area you want to get more information about by clicking on it:

\1~How to use this program~HOWTO
\2~Load formats~LOADFMTS~Save formats~SAVEFMTS
\1~Notes on this version of SHRConvert~VERSNOTES
\1~Copyright and shareware notices~NOTICES
\1~Play a text adventure game~ADV

Close this window when you've had enough help.





                  <= Click on the Home button at any time to return here.
^~~~
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.HOWTO
-=[ How to use this program ]=-

\1~System requirements~SYSREQ
\1~Converting a picture~PICCONV
\1~Menu command summary~SUMMARY
\1~Non-menu commands~NONMENU
^~~~HOME

.SYSREQ
-=[ System Requirements ]=-

SHRConvert requires a IIgs with 512K or more memory, and must be run from a
version 2.0 or higher System Disk.

If you are running the program from Finder 1.0 on System Disk 3.1, you must
run SHRCONV.FINDER rather than SHRCONVERT itself to bypass a bug in the
toolsets from System 3.1.  If you are getting unexplainable crashes when
running the program (the main trouble spots are this Help system, loading
$C0,2 or GIF files, and saving pictures), you might want to try SHRCONV.FINDER
also.
^~~~HOWTO

.PICCONV
-=[ Converting a picture, part 1: Loading ]=-

1. Acquire a picture to convert, a demo file from a graphics program perhaps.
2. Click on the appropriate format in the 'Load Formats' dialog box.
3. Pick 'Load & convert' from the File menu, or click on the Load button.
4. Use the file selector dialog to locate the desired file, and open it.
5. The file will now be converted, please wait.
6. The picture will be displayed: if it's larger than the screen, you can use
    the arrow keys to scroll around within it.
7. Press Escape or the mouse button when you've finished looking at the file.
8. Try the Special menu's Show Page and Picture Info commands.
9. You can now load another file, quit, or save the picture (see next page)
^~~PICCONV-2~HOWTO

.PICCONV-2
-=[ Converting a picture, part 2: Saving ]=-

1. Decide which format to save the picture in, probably Apple Preferred.
2. Click on the appropriate format in the 'Save Formats' dialog box.
3. Pick 'Save conversion' from the File menu, or click on the Save button.
4. Pick a size for the saved picture from the resulting dialog box.
5. You may be asked to pick an alignment for the saved picture.  'Centered',
    'Top Left', and 'Top Center' are the most likely choices here.
6. You may now be warned that the loaded picture is incompatible with the
    selected save format.  Try another format, or another picture.
7. You should now be at a file selector dialog.  A default filename will be
    given, based on the original name and the selected save format: you can
    either accept or type over the default.
8. You can now load another file, quit, or save in a different format.
^~PICCONV~~HOWTO

.SUMMARY
-=[ Menu Command Summary ]=-

\1~APPLE menu~M1
\1~File menu~M2
\1~Edit menu~M3
\1~Windows menu~M4
\1~Special menu~M5
^~~~HOWTO

.M1
-=[ APPLE menu ]=-

\1~About SHRConvert...~M1ABOUT
\1~Help~M1HELP
\1~Menu item help~M1MHELP

Any additional items in this menu are New Desk Accessories (NDAs).
^~~M2~SUMMARY

.M2
-=[ File menu ]=-

\1~Load & convert...~M2LOAD
\1~Re-convert last file~M2RELOAD
\1~Save conversion...~M2SAVE
\1~Rename a file...~M2RENAME
\1~Delete a file...~M2DELETE
\1~Change file attributes...~M2CHANGE
\1~Format a disk...~M2FORMAT
\1~Quit~M2QUIT
^~M1~M3~SUMMARY

.M3
-=[ Edit menu ]=-

The items in this menu are only enabled when a New Desk Accessory (NDA) is the
frontmost window on the screen.  The 'Close' item will remove the NDA from the
screen: the other items do nothing unless the NDA specifies otherwise.
^~M2~M4~SUMMARY

.M4
-=[ Windows menu ]=-

\1~Load formats~M4LOAD
\1~Save formats~M4SAVE
\1~Conversion~M4CONV
\1~Full Screen~M4FULL
^~M3~M5~SUMMARY

.M5
-=[ Special menu ]=-

\1~Picture Info~M5INFO
\1~Show page~M5SHOW
\1~640 => 320 mode~M5MODE
\1~Fix Aspect Ratio...~M5ASPECT
^~M4~~SUMMARY


.M1ABOUT
APPLE menu: About SHRConvert...

Displays the program's version number, along with copyright and shareware
notices.  Click on the 'Continue' button to exit.
^~~M1HELP~M1

.M1HELP
APPLE menu: Help...
Shortcuts: Apple-? or Apple-/

Calls up the online help display that you're reading now.  An error alert is
displayed if the file SHRCONVERT.HELP cannot be found in the same subdirectory
that SHRConvert itself was run from: put the program disk in any drive and try
again.  The same alert will be shown if the SHRCONVERT.HELP file doesn't
exist, or if there is insufficient memory to load it.

Doing this command while the help window is already on the screen will bring
it in front of all other windows.

Once loaded, the help file remains in memory until you quit from SHRConvert or
the memory is needed for other purposes.
^~M1ABOUT~M1MHELP~M1

.M1MHELP
APPLE menu: Menu item help

Temporarily turns the cursor into a 'Pick menu item' cursor: pulling down a
menu and selecting an item from it (you can even select dimmed-out items)
will call up the online help display and go directly to the page corresponding
to that command.  If you decide you don't want any help after selecting this
command, just click the mouse anywhere and it will revert to normal.
^~M1HELP~M2LOAD~M1

.M2LOAD
File menu: Load & convert...
Shortcuts: Apple-L or click on Load button in the Load Formats window.

Initiates the graphics conversion process.  You must have already selected the
type of picture to convert in the Load Formats window.  All files on your disk
will be listed, but only the ones that appear to be of the chosen type (as
determined by the file's length, type, and aux_type) will be selectable.  If,
for any reason, you want to attempt a conversion on a file that isn't
selectable, you can hold down the Option (Solid Apple on an upgraded IIe) key
when giving this command: this will allow any file to be selected.  Use this
override with care, as inappropriate files will produce meaningless results and
can conceivably crash the program.
^~M1MHELP~M2RELOAD~M2

.M2RELOAD
File menu: Re-convert last file
Shortcut: Apple-R

Restarts the conversion process on the file you most recently attempted to
convert (even if the conversion failed).  If you have changed the load format,
the new conversion will be attempted in the current format (even if the file
doesn't pass the new format's file length, filetype, and aux_type checks),
so if you try the wrong format at first you can easily try a different format
without having to locate the file again.  This command is also useful for
converting PS IIgs built-in graphics (you can only grab one of the eight
graphics per conversion) and GIF (you might want to try a different graphics
mode or palette type).
^~M2LOAD~M2SAVE~M2

.M2SAVE
File menu: Save conversion...
Shortcuts: Apple-S or click on Save button in the Save Formats window.
Enabled only when a picture has been successfully converted.

Saves a converted picture to disk.  You must have already selected the type of
picture to save from the Save Formats window.
^~M2RELOAD~M2RENAME~M2

.M2RENAME
File menu: Rename a file...

Changes a file's name on disk.  First you are allowed to select a file, then
you are given a dialog asking for a new name for the file.  The dialog is set
up so that you can just type in the new filename and press Return.  However,
if you are running under ProDOS 16 version 1.2 or higher, you can also use the
mouse or arrow keys to move back into the pathname and change/add/remove
subdirectory names: this will cause the file to be moved to a different
(existing) subdirectory.  This command is unable to rename subdirectories.
^~M2SAVE~M2DELETE~M2

.M2DELETE
File menu: Delete a file...

Permanently removes a file from a disk.  You will be asked for confirmation
before the file is actually deleted.  Use this command with caution.  Will not
delete subdirectories, even if they are empty.
^~M2RENAME~M2CHANGE~M2

.M2CHANGE
File menu: Change a file's attributes...

Allows you to modify some of a file's directory information, which contains
important parameters describing the file but not actually part of it.
^C01THIS COMMAND IS POTENTIALLY DANGEROUS, AND SHOULD NOT BE USED^C00 (except for
its Lock and Unlock features) ^C01UNLESS YOU KNOW EXACTLY WHAT YOU ARE DOING!
New filetypes can be specified either by a two-digit hex number (example: $B3)
or by a standard three-character abbreviation (example: S16).  New aux_types
can be entered either in hexadecimal (preceded by a $) or decimal.  Note that
changing a file's type or aux_type does not change the data in it to conform
to the new type.  More dire warnings on next page.
^~M2DELETE~M2CHANGE-2~M2

.M2CHANGE-2
File menu: Change a file's attributes...                        Page 2

The five checkboxes correspond to the ProDOS access bits for the file.  Any
attempt to delete/rename/write to/read from a file that does not have the
associated bit turned on will generate an error.  The 'Lock' button is a quick
way to turn off the delete, rename, and write access bits, preventing the file
from being modified in any way (except for re-formatting the disk).  Likewise,
'Unlock' quickly enables all the access bits, allowing anything to happen to
the file.  This program will not allow you to turn off the read access bit,
since an unreadable file is rather useless.  The 'needs backup' bit is purely
informational and indicates that the file has been modified since the last
time a copy was made of it.  It is placed in the middle of the other access
bits because that's where it is in the file's directory entry.
^~M2CHANGE~M2FORMAT~M2

.M2FORMAT
File menu: Format a disk...

Prepares a new disk for holding files, or recycles an old disk that no longer
has any useful files on it.  You select the disk to format by stepping through
all the disk devices connected to your system until you get to the right one.
This command can do a lot of damage in a very short time: it is advisable for
you to eject all disks before giving this command.  You need to type in a
unique name (15 characters maximum) for each disk you format: having multiple
disks with the same name will confuse the system, and can lead to data loss if
you switch disks.  If you can't think of original names for each disk, at
least use serial numbers.  (/BLANK.0000, /BLANK.0001, /BLANK.0002, etc.)
^~M2CHANGE-2~M2QUIT~M2

.M2QUIT
File menu: Quit
Shortcut: Apple-Q

Exits SHRConvert and returns you to wherever you were before running the
program.  Make sure you have saved your most recent conversion if you intend
to keep it: no warning will be given if you try to quit before saving.
^~M2FORMAT~M4LOAD~M2

.M4LOAD
Windows menu: Load formats

Brings the Load Formats window to the front, allowing you to select a
different picture type to convert.
^~M2QUIT~M4SAVE~M4

.M4SAVE
Windows menu: Save formats

Brings the Save Formats window to the front, allowing you to select a format
to save pictures in.
^~M4LOAD~M4CONV~M4

.M4CONV
Windows menu: Conversion
Enabled only when a picture has been successfully converted.

Brings the Conversion window to the front, which contains a false-color
representation of the converted picture.  You can then drag the entire picture
around within the window with the cursor, which turns into a hand icon when
over this window.  The false colors allow you to see any details that may be
invisible in the picture due to lack of contrast between colors.  The title of
this window gives some information about the graphics mode used in the
picture: pay attention to this, since many IIgs graphics programs prefer or
require one mode rather than the other.
^~M4SAVE~M4FULL~M4

.M4FULL
Windows menu: Full Screen
Shortcut: Apple-F
Enabled only when a picture has been successfully converted.

Returns you to the true-color view of the converted picture.  Use the arrow
keys to scroll around within the picture if it isn't the same size as the
screen: holding down the Option key will cause larger moves, and holding down
the Apple key will cause moves to go all the way to the opposite side of the
picture.  The instructions at the top of the screen can be removed by pressing
the space bar, and recalled with ?.  Press Escape or the mouse button to exit.
^~M4CONV~M5INFO~M4

.M5INFO
Special menu: Picture Info
Shortcut: Apple-I
Enabled only when a picture has been successfully converted.

Calculates statistics on pixel and palette usage within the converted picture.
The display goes rather slow so that you can get an idea of the usage
variations from the top to the bottom of the picture: if you're impatient,
clicking the mouse in the middle of the window will speed things up.  Click on
the 'OK' button to exit: you don't have to wait for the display to finish to
do this.
^~M4FULL~M5SHOW~M5

.M5SHOW
Special menu: Show Page
Enabled only when a picture has been successfully converted.

Shows the converted picture at 50% reduction, which will allow even the
largest image that SHRConvert can handle to fit on one screen.  The curve at
the lower right represents the 65536 byte internal limit on picture size.  For
you math freaks, the curve's boundary is expressed by the equation x*y=65536.
Press any key or the mouse button to exit.
^~M5INFO~M5MODE~M5

.M5MODE
Special menu: 640 => 320 mode
Enabled only when a picture has been successfully converted, and contains one
or more scanlines that are displayed in 640 mode (4 colors).

Translates any portions of the converted picture that are 640 mode into the
closest equivalent in 320 mode.  This results in a loss of resolution, but is
necessary to use 640 mode pictures with 320-only programs such as Paintworks.
The transformation affects the color palette only, and may produce duplicate
colors in the palette.  Strange things will happen if the same palette is used
for both 320 and 640 mode areas of the picture, but I doubt that any such
pictures exist.
^~M5SHOW~M5ASPECT~M5

.M5ASPECT
Special menu: Fix Aspect Ratio...
Enabled only when a picture has been successfully converted.

Allows the converted picture to be compressed horizontally or vertically, to
make it better proportioned.  Mainly useful for GIF pictures, which may come
from machines with aspect ratios vastly different from the IIgs's.  Giving
this command produces a dialog box with the following options:
   No change
   Reduce height by 50%
   Reduce width by 50%
Other reduction percentages may be implemented in future versions.
^~M5MODE~~M5

.NONMENU
-=[ Non-menu commands: page 1 of 2 ]=-

Clicking the 'Load' button in the Load Formats window is equivalent to selecting
the 'Load & convert...' menu command.

Holding down the Option key when initiating a conversion, either by menu
command, key equivalent, or Load button, allows any file to be selected even
if it doesn't appear to be of the selected format.  Use with caution.

Clicking the 'Save' button in the Save Formats window (will only be visible if a
file has been successfully converted) is equivalent to 'Save conversion...'.

Clicking the 'Info on format' button in either the Load or Save Formats window
will call up the online help display and go directly to the page corresponding
to the currently selected load or save format.
^~~NONMENU-2~HOWTO

.NONMENU-2
-=[ Non-menu commands: page 2 of 2 ]=-

Normally, if any problem is encountered during the conversion of a file you
will receive an error alert and will not get to see any portions of the
picture that got converted.  If this happens, you can attempt to recover the
picture by holding down the Apple key and clicking in the area where the
conversion window would appear (or anywhere else in the background).  If the
picture seems to be completely unrecoverable, you'll get a beep and nothing
else.  If there is any hope, the picture will be displayed and all the menu
options for saving and modifying it will be activated.  However, there is a
slight possibility that the partial picture information in memory is not
completely self-consistant, and a crash can occur.
^~NONMENU~~HOWTO
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.LOADFMTS
-=[ Load formats ]=-

\1~Apple II family~LCA2
\1~Apple IIgs specific~LCGS
\1~Atari ST~LCST
\1~Commodore 64/128~LC64
\1~Macintosh~LCMAC
\1~Computer-independant~LCIND
^~~~HOME


.LCA2
-=[ Apple II family load formats ]=-

\1~HiRes~LFHGR
\1~Double HiRes~LFDHR
\1~PrintShop black & white graphic~LFPSGRB1
^~~LCGS~LOADFMTS

.LCGS
-=[ Apple IIgs specific load formats ]=-

\1~Type $C0 (PNT) compressed SHR~LFC1
\1~Type $C0 (PIC) non-compressed SHR~LFC0
\1~PrintShop IIgs color graphic~LFPSGRC1
\1~PrintShop IIgs built-in graphics~LFPSGRC8
^~LCA2~LCST~LOADFMTS

.LCST
-=[ Atari ST load formats ]=-

\1~Degas (.PI1, .PI2, .PI3)~LFATARI
\1~Degas Elite (.PC1, .PC2, .PC3)~LFDEGELITE
\1~Neochrome (.NEO)~LFNEO
\1~Tiny (.TNY)~LFTINY

\1~Downloading notes~LCSTNOTES
^~LCGS~LC64~LOADFMTS

.LCSTNOTES
-=[ Atari ST downloading notes ]=-

In addition to the filename endings listed, the following are also usable:

An ending of .PQ1, .PQ2, or .PQ3 indicates a .PI1-.PI3 file that has been
compressed with the standard Huffman SQ algorithm.  It can be unsqueezed on an
Apple II with a utility such as Don Elton's AUSQ or Floyd Zink's BLU.

An ending of .ARC indicates a compressed archive file that contains one or
more files which may be in a usable format.  The component files can be
extracted with Tim Swihart's DeArcGS utility.

Endings of .TN1, .TN2, or .TN3 may indicate a file that is in .TNY format: I
have seen references to these endings, but have no sample files to test.
^~~~LCST

.LC64
-=[ Commodore 64/128 load formats ]=-

\1~Doodle~LF64DOODLE
\1~Koala Illustrator~LF64KOALA
\1~PrintShop screen~LF64PS
^~LCST~LCMAC~LOADFMTS

.LCMAC
-=[ Macintosh load formats ]=-

\1~MacPaint~LFMPNT
\1~ScreenMaker (startup screen)~LFMACSM

\2~Direct file transfer~LCMACNOTES1~Downloading notes~LCMACNOTES2
^~LC64~LCIND~LOADFMTS

.LCMACNOTES1
-=[ Macintosh file transfer notes ]=-

Mac files can easily be placed on ProDOS 3.5" disks with AFE (Apple File
Exchange), which is part of the latest Mac system software.

Mac disks can be read directly on an Apple II with the MacTransGS utility, but
only if they are in the old 400K MFS format.
^~~~LCMAC

.LCMACNOTES2
-=[ Macintosh downloading notes ]=-

ALL downloaded Macintosh files (other than plain text) will be in a special
format known as MacBinary: to use such files, the 128-byte MacBinary header
must be stripped off of the file.  Assuming that the file is not much larger
than 32K, the following commands from ProDOS BASIC will accomplish this:
        bload MACPIC.BIN,tTXT,a$1000
        bsave MACPIC.BIN,tTXT,a$1080
Replace MACPIC.BIN & TXT with the file's actual name & type: do this on a copy!
In addition to MacBinary-ing, many Mac files will be in a compressed format,
either PackIt (names end in .PIT) or StuffIt (.SIT).  There is currently no
way to handle StuffIt files on a IIgs, but you can unpack PackIt files (and
un-MacBinary long files) with MACDOWN, another utility program of mine.  It
can probably be found wherever you got SHRConvert: on CompuServe, it will be
MACDWN.BNY in the Apple II Software DL of the APPTWO Forum.
^~~~LCMAC

.LCIND
-=[ Computer-independant load formats ]=-

\1~GIF (Graphics Interchange Format)~LFGIF
\1~RLE (Run Length Encoded)~LFRLE
^~LCMAC~~LOADFMTS


.LFHGR
^3Format:^1 Apple II HiRes
^3Machines:^1 all Apple II-series computers
^3Programs:^1 various, MousePaint for example
^3Resolution:^1 140 x 192 x 6 colors, or 280 x 192 in black & white
^3Recognized file lengths:^1 8184 ($1FF8) to 8448 ($2100)
^3Recognized filetypes:^1 BIN ($06) or FOT ($08)
^3Resulting picture:
        Color: 280 x 192, 320 mode, only colors 0,3,6,9,C,F are used
        B&W: 280 x 192, 320 mode, only colors 0,F are used
^~~LFDHR~LCA2

.LFDHR
^3Format:^1 Apple II Double HiRes
^3Machines:^1 Apple IIe with 128K memory, Apple IIc, Apple IIgs
^3Programs:^1 various, DazzleDraw for example
^3Resolution:^1 140 x 192 x 16 colors, or 560 x 192 in black & white
^3Recognized file lengths:^1 16376 ($3FF8) to 16640 ($4100)
^3Recognized filetypes:^1 BIN ($06) or FOT ($08)
^3Resulting picture:
        Color: 280 x 192, 320 mode, 16 colors
        B&W: 560 x 192, 640 mode non-dithered, only black & white used
^~LFHGR~LFPSGRB1~LCA2

.LFPSGRB1
^3Format:^1 Apple II PrintShop black & white graphics
^3Machines:^1 all Apple II-series computers
^3Programs:^1 Print Shop, various other programs also use this format
^3Resolution:^1 88 x 52 black & white
^3Recognized file lengths:^1 572 ($023C) to 768 ($0300)
^3Recognized filetypes:^1 BIN ($06) only
^3Resulting picture:^1 88 x 52, 320 mode, only colors 0&F (B&W) used
PrintShop graphics from other machines may be compatible, but this has not
been verified.
^~LFDHR~LFC0~LCA2

.LFC0
^3Format:^1 Type $C0 compressed SHR
^3Machines:^1 Apple IIgs
^3Programs:^1 (see aux_type info)
^3Resolution:^1 (see aux_type info)
^3Recognized file lengths:^1 1 ($0001) and up
^3Recognized filetypes:^1 $C0 only
^3Recognized aux_types:^1 0, 1, and 2 are currently defined as picture files.
        Aux_type 3, an object-oriented format, is not supported.
^3Resulting picture:^1 (see aux_type info)

\1~Aux_type 0: Paintworks Plus 1.0~LFC0x0
\1~Aux_type 1: _PackBytes format~LFC0x1
\1~Aux_type 2: Apple Preferred format~LFC0x2
^~LFPSGRB1~LFC1~LCGS

.LFC0x0
-=[ Type $C0, aux_type $00: Paintworks Plus 1.0 ]=-

^3Programs:^1 first release of Paintworks Plus
^3Resolution:^1 320 x 396 x 16 colors from a palette of 4096
^3Resulting picture:^1 320 mode, same as original (no conversion)

This format contains 514 bytes of information on the current drawing color and
patterns.  SHRConvert stores this data from the most recently loaded Paintworks
picture, and includes it with any file saved in this format.  It is therefore
highly recommended that you load at least one file of this format before saving
anything in this format: otherwise, the resulting picture will not have any
drawing patterns and will be difficult to edit in Paintworks Plus.
^~~LFC0x1~LFC0

.LFC0x1
-=[ Type $C0, aux_type $01: _PackBytes format]=-

^3Programs:^1 816/Paint compressed screen format, FantaVision IIgs
^3Resolution:^1 one full screen, all IIgs SHR graphics features are possible
^3Resulting picture:^1 same as original (no conversion)

This is referred to as the Eagle format in some documentation.

This format is no longer officially supported by Apple: these programs have no
real excuse for using it.  DO NOT use this format: it is unlikely that any
future programs will be able to display it.
^~LFC0x0~LFC0x2~LFC0

.LFC0x2
-=[ Type $C0, aux_type $02: Apple Preferred graphics format, page 1 of 2 ]=-

^3Programs:^1 hopefully all IIgs-specific graphics programs
^3Resolution:^1 virtually any size; all IIgs SHR graphics features are possible
^3Resulting picture:^1 same as original (no conversion)

This is the IIgs graphics format of choice.  It has provisions for handling
images far larger than available memory: however, all existing implementations
(including SHRConvert) place a much stricter upper limit on size.  DeluxePaint
II defines the following maximums, which are also imposed by this program:
  Maximum height: two screens (400 pixels)
  Maximum width: two screens (640 pixels in 320 mode, 1280 pixels in 640 mode)
Image size is further limited to a maximum of 65536 bytes of raw pixel data:
this is slightly more than two screenfulls in area.  This limit is illustrated
by the hyperbolic curve shown in the Show Page (under the Special menu) display.
^~LFC0x1~LFC0x2-2~LFC0

.LFC0x2-2
-=[ Apple Preferred graphics format, page 2 ]=-

Files in this format consist of a series of named segments, also referred to
as records or blocks.  Only a "MAIN" segment contains an actual picture: other
segment types contain additional information such as drawing patterns, and may
be specific to the program that created the file.  This program includes a
"SHRConvert" segment in all Apple Preferred files it produces, so that any
problems with them can be traced back to the source.  The segment will contain
two bytes of data indicating the current version of SHRConvert in standard
toolbox format, presently $0201.

When you load an Apple Preferred file, you will get a dialog box with buttons
for each segment in the file.  You specify the segment to load by clicking on
it: if it isn't a "MAIN" segment, an error message will be given.  This allows
for possible future uses of this format that include multiple images.
^~LFC0x2~~LFC0

.LFC1
^3Format:^1 Type $C1 non-compressed SHR (IIgs SuperHiRes)
^3Machines:^1 Apple IIgs
^3Programs:^1 All IIgs paint programs can read this type: most can write it.
^3Resolution:^1 320 x 200 x 16 or 640 x 200 x 4, colors taken from a palette of 4096
        Mixing of the two graphics modes is possible, but seldom implemented.
        Up to 16 independant color palettes can be (but usually aren't) used.
        640 mode has an option that allows alternate pixels to have separate
        color palettes, making 16 dithered colors possible.  You guessed it...
^3Recognized file lengths:^1 32288 ($7E20) to 33024 ($8100)
^3Recognized filetypes:^1 $C1 or BIN ($06)
^3Recognized aux_types:^1 don't care, but should be 0.
^3Resulting picture:^1 same as original, no conversion.  Always one full screen.

\1~Note on Paintworks animation files~LFC1-2
^~LFC0~LFPSGRC1~LCGS

.LFC1-2
-=[ Using Paintworks animation files ]=-

Type $C2 Paintworks Plus animation files are compatible with this format to the
extent that you can extract the first frame of the animation.  To allow files
of type $C2 to be selected, you must use the Filetype Override command: hold
down the Option key when starting the conversion, for example click on this
load format then press Option-Apple-L.
^~~~LFC1

.LFPSGRC1
^3Format:^1 PrintShop IIgs color graphics
^3Machines:^1 Apple IIgs
^3Programs:^1 PrintShop IIgs
^3Resolution:^1 88 x 52 x 8 fixed colors (BLK WHT RED ORN YEL GRN BLU PUR)
^3Recognized file lengths:^1 1716 ($06B4) to 1792 ($0700)
^3Recognized filetypes:^1 $F8 only
^3Recognized aux_types:^1 $C323 only
^3Resulting picture:^1 88 x 52, 320 mode, default palette, only 8 colors used
^~LFC1~LFPSGRC8~LCGS

.LFPSGRC8
^3Format:^1 PrintShop IIgs built-in graphics
^3Machines:^1 Apple IIgs
^3Programs:^1 PrintShop IIgs
^3Resolution:^1 Contains six named PS IIgs color graphics (see previous page)
^3Recognized file lengths:^1 13728 ($35A0) to 13888 ($3640)
^3Recognized filetypes:^1 BIN ($06) only
^3Resulting picture:^1 88 x 52, 320 mode, default palette, only 8 colors used
This load format only works with the files GRAPHIC.CGT0 thru GRAPHIC.CGT7 on
the PrintShop IIgs disk.
^~LFPSGRC1~LFATARI~LCGS

.LFATARI
^3Format:^1 Atari ST .PI1, .PI2, .PI3
^3Machines:^1 Atari 520ST and 1040ST
^3Programs:^1 Degas, Degas Elite
^3Resolution:^1 .PI1: 320 x 200 x 16 colors from a palette of 512
                      .PI2: 640 x 200 x 4 colors from a palette of 512
                      .PI3: 640 x 400 black & white
^3Recognized file lengths:^1 32034 ($7D22) to 32768 ($8000)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 .PI1: 320 x 200, 320 mode, 16 colors
                                  .PI2: 640 x 200, 640 mode non-dithered, 4 colors
                                  .PI3: 640 x 200, 640 mode non-dithered, 4-level grayscale
^~LFPSGRC8~LFDEGELITE~LCST

.LFDEGELITE
^3Format:^1 Atari ST .PC1, .PC2, .PC3
^3Machines:^1 Atari 520ST and 1040ST
^3Programs:^1 Degas Elite
^3Resolution:^1 see description of Degas .PI1,2,3 format
^3Recognized file lengths:^1 1 ($0001) to 32768 ($8000)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 see description of Degas .PI1,2,3 format
^~LFATARI~LFNEO~LCST

.LFNEO
^3Format:^1 Atari ST Neochrome (.NEO)
^3Machines:^1 Atari 520ST and 1040ST
^3Programs:^1 Neochrome
^3Resolution:^1 see description of Degas .PI1,2,3 format
^3Recognized file lengths:^1 32128 ($7D80) to 32768 ($8000)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 see description of Degas .PI1,2,3 format
All three Atari ST resolutions are representable in this format, however the
Neochrome program apparently only produces .PI1-type (lores) pictures.
^~LFDEGELITE~LFTINY~LCST

.LFTINY
^3Format:^1 Atari ST Tiny compressed (.TNY)
^3Machines:^1 Atari 520ST and 1040ST
^3Programs:^1 Interchange format only: no program uses this as default
^3Resolution:^1 see description of Degas .PC1,2,3 format
^3Recognized file lengths:^1 1 ($0001) to 32768 ($8000)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 see description of Degas .PC1,2,3 format
^~LFNEO~LF64DOODLE~LCST

.LF64DOODLE
^3Format:^1 Commodore 64 Doodle format
^3Machines:^1 Commodore 64/128
^3Programs:^1 Doodle
^3Resolution:^1 320 x 200 x 16 colors: two color choices per 8 x 8 pixel area
^3Recognized file lengths:^1 9024 ($2340) to 10000 ($2710)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 320 x 200, 320 mode, 16 colors

Doodle files always have names starting with DD.
^~LFTINY~LF64KOALA~LC64

.LF64KOALA
^3Format:^1 Commodore 64 Koala Illustrator
^3Machines:^1 Commodore 64/128
^3Programs:^1 Koala Illustrator
^3Resolution:^1 160 x 200 x 16 colors: four color choices per 4 x 8 pixel area
^3Recognized file lengths:^1 10511 ($290F) to 12000 ($2EE0)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 320 x 200, 320 mode, 16 colors
^~LF64DOODLE~LF64PS~LC64

.LF64PS
^3Format:^1 Commodore 64 Print Shop
^3Machines:^1 Commodore 64/128
^3Programs:^1 Print Shop
^3Resolution:^1 320 x 200 black & white
^3Recognized file lengths:^1 8000 ($1F40) to 11000 ($2AF8)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 320 x 200, 320 mode, only colors 0,1 used

There is a possibility of getting at least a B&W image out of other C64
picture formats by using this load type, but no guarantees can be made.
^~LF64KOALA~LFMPNT~LC64

.LFMPNT
^3Format:^1 Macintosh MacPaint
^3Machines:^1 Apple Macintosh
^3Programs:^1 MacPaint and many other Mac graphics programs
^3Resolution:^1 576 x 720 black & white
^3Recognized file lengths:^1 1000 ($03E8) to 65535 ($FFFF)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:
        => 640: 576 x 360, 640 mode non-dithered, 4-level grayscale
        => 320: 576 x 227 (truncated), 320 mode, only colors 0,F used
^~LF64PS~LFMACSM~LCMAC

.LFMACSM
^3Format:^1 Macintosh ScreenMaker (startup screen)
^3Machines:^1 Apple Macintosh
^3Programs:^1 ScreenMaker, converts MacPaint pictures to this format
^3Resolution:^1 512 x 384 black & white
^3Recognized file lengths:^1 21888 ($5580) to 22016 ($5600)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 512 x 192, 640 mode non-dithered, 4-level grayscale
This is NOT the same as the Mac II PICT 0 color startupscreen format.
^~LFMPNT~LFGIF~LCMAC

.LFGIF
^3Format:^1 GIF (CompuServe's Graphics Interchange Format)
^3Machines:^1 virtually any
^3Programs:^1 various
^3Resolution:^1 virtually unlimited; up to 256 colors from a palette of 16777216
        Images larger than 640 x 400 will be truncated without warning.
^3Recognized file lengths:^1 500 ($01F4) and up
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 virtually any size; 320 or 640 mode chosen by user
        Will not contain mixed modes, 640 mode dithering, or multiple palettes.
        Can optionally convert to the default color or grayscale palette.

\1~Downloading/usage notes~LFGIF-2
^~LFMACSM~LFRLE~LCIND

.LFGIF-2
-=[ Downloading and using GIF pictures ]=-

GIF pictures usually have filenames ending in .GIF: on CompuServe, they will
have a '/graph:GIF' flag after their name in the directory listing.

When you convert a GIF picture, you are asked to choose between the IIgs's
320 x 200 x 16 color and 640 x 200 x 4 color modes.  The default mode is
determined by the following algorithm:

        If the image width is 320 or less, 320 mode is recommended, otherwise
        If the number of colors is 8 or less, 640 mode is recommended, otherwise
        If the image height is 200 or less, 320 mode is recommended, otherwise
        640 mode is recommended.

640 x 200 GIF pictures may look better in the non-recommended mode: try it.
^~~LFGIF-3~LFGIF

.LFGIF-3
-=[ Downloading and using GIF pictures, part 2 ]=-

Since GIF images can come from a wide variety of computer systems, they may
not always look correct on the IIgs.  Be prepared to use the Fix Aspect Ratio
command (under the Special menu) if the picture comes out elongated.

Also remember the 'Reconvert last picture' (Apple-R) menu command: it is very
handy for redoing the same picture with a different choice of mode or palette.
^~LFGIF-2~~LFGIF

.LFRLE
^3Format:^1 RLE (Run Length Encoded)
^3Machines:^1 virtually any
^3Programs:^1 various
^3Resolution:^1 256 x 192 or 128 x 96, black & white
^3Recognized file lengths:^1 500 ($01F4) to 19999 ($4E1F)
^3Recognized filetypes:^1 BIN ($06) or TXT ($04)
^3Resulting picture:^1 256 x 192 or 128 x 96, 320 mode, only colors 0,F used

\1~Downloading notes~LFRLE-2
^~LFGIF~~LCIND

.LFRLE-2
-=[ RLE downloading notes ]=-

RLE pictures usually have filenames ending in .RLE: on CompuServe, they will
have a '/graph:RLE' flag after their name in the directory listing.

RLE pictures contain only 7-bit ASCII data, and do not have to begin precisely
at the start of the file: this means that you can use your telecommunication
program's capture buffer to grab RLEs, without having to worry about capturing
excess stuff before or after the actual image.  However, your program must be
capable of capturing control characters (the ESCape character, to be exact).
^~~~LFRLE
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.SAVEFMTS
-=[ Save formats ]=-

Type $C0 compressed SHR formats:
\1~Aux_type 0: Paintworks Plus 1.0~SFC0x0
\1~Aux_type 1: _PackBytes format~SFC0x1
\1~Aux_type 2: Apple Preferred format~SFC0x2

\1~Type $C1 non-compressed SHR~SFC1

\1~GIF (CompuServe's Graphics Interchange Format)~SFGIF

The 'default filename endings' listed here are purely my invention, and are in
no way defined or supported by Apple Computer.
^~~~HOME

.SFC0x0
-=[ PaintWorks Plus 1.0 'Paint' format: type $C0, aux_type $00 ]=-

Default filename ending: PNT
Programs: the first release of PaintWorks used this format rather than the
    Apple Preferred format, which wasn't defined at the time.  Some other
    programs can read this format, a few can write it.
Picture size: one screen wide, 396 pixels high, no more, no less.
File size: varies, PackBytes compression is used.
Limitations: Only the 320 pixel, 16 color graphics mode is allowed (use the
    640 => 320 menu command to allow 640 mode pictures to be saved).  Multiple
    color palettes are impossible to represent in this format.
Usage: this format will probably not be supported by future programs, so don't
    use it unless you have to.  Before saving any files in this format, you
    should load one real Paintworks picture to properly set things up.
^~SFC1~SFC0x1~SAVEFMTS

.SFC0x1
-=[ PackBytes (also known as Eagle) format: type $C0, aux_type $01 ]=-

Default filename ending: PAK
Programs: only 816/Paint seems to use this format.
Picture size: one screenfull, no more, no less.
File size: varies, PackBytes compression is used.
Limitations: like the $C1 format, all is possible but little is implemented.
Usage: this is not an officially-supported format.  Don't use it, period.
^~SFC0x0~SFC0x2~SAVEFMTS

.SFC0x2
-=[ Apple Preferred format: type $C0, aux_type $02 ]=-

Default filename ending: SHR
Programs: all IIgs graphics programs should read/write this format.
Picture size: virtually unlimited, either larger or smaller than the screen.
    All current implementations impose some size limit, which is no larger
    than two screens wide or two screens high, or 65536 bytes of raw data.
File size: varies, PackBytes compression is used.
Limitations: another case of 'all is possible but little is implemented'.
Usage: use this format if possible.  Note that you can load these files (if no
    larger than one screen) directly into Deluxe Paint II as brushes.
Format note: the files produced by this program will contain one "MAIN"
    segment and a "SHRConvert" segment giving the version number of the
    program.
^~SFC0x1~SFGIF~SAVEFMTS

.SFC1
-=[ Non-compressed screen format: type $C1, aux_type $00 ]=-

Default filename ending: SCR
Programs: all IIgs graphics programs should be able to read this format.
Picture size: one screenfull, no more, no less.
File size: always 32768 bytes (65 ProDOS blocks) long.
Limitations: all IIgs graphics features are possible, but few programs can
    handle some features such as mixed graphics modes and multiple palettes.
Usage: since this format's lack of compression makes for larger files, it
    should generally only be used in conjunction with other programs that are
    incapable of reading the standard compressed formats.
^~~SFC0x0~SAVEFMTS

.SFGIF
-=[ GIF (Graphics Interchange Format): saved as type BIN ($06) ]=-

This is a "format for the exchange of raster-based graphics information",
which was developed by CompuServe, Inc.  It allows for files containing
unlimited images of virtually unlimited size, each using up to 256 colors
chosen from a palette of up to 16777216 colors, and is designed to be easily
extensible to meet future needs.  GIF decoders and/or encoders have been
developed for a wide variety of machines: the Picture Support Forum (GO PICS)
on CompuServe is the headquarters for this effort.
Default filename ending: GIF
File size: varies, LZW compression is used.
Limitations: multiple-palette pictures can be encoded, but will not look the
    same if re-displayed on a IIgs.  Mixed 320 and 640 modes won't work.
^~SFC0x2~~SAVEFMTS
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.VERSNOTES
-=[ Notes on version 2.0 ]=-

Previous public-domain versions:  1.0  1.1  1.2B2
Previous shareware versions:  2.0

\1~Features dropped from this version~DROPPED
\1~Features added to this version~ADDED
\1~Bugs fixed in this version~FIXED
\1~Coming attractions~COMING

The program's source code currently consists of:    14446 lines APW Assembler
    809 lines APW C code    29 lines ALINK commands    1147 lines online help script
^~~~Home

.DROPPED
(none)
^~~~VERSNOTES

.ADDED
New load formats:
        Print Shop graphics (both II black & white and IIgs color).
        Atari ST: Degas Elite, Neochrome, and Tiny.
New save format:
        GIF (Graphics Interchange Format).
New 'default color' and 'grayscale' options on GIF load.
Help system is now context-sensitive.
Modified load/save format selectors to allow more formats.
New resurrect feature (Apple-click on background) to recover incompletely
  converted pictures.
^~~~VERSNOTES

.FIXED
Fixed glitch in help file that caused some text in the Atari ST downloading
  notes to be missing.
GIF load now truncates rather than rejects excessively large files.
^~~~VERSNOTES

.COMING
Printing of pictures will eventually be implemented.

Conversion of additional picture types will be added: the waiting list includes:
        Amiga IFF
        AST VisionPlus picture data files (or possibly direct digitization)
        IBM formats (there are an infinite number of them, so I can't hope to
                                get them all)

Suggestions for other new features are welcome.
^~~~VERSNOTES
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.NOTICES
This program and its accompanying help file are Copyright 1988 Jason Harper.

GIF and 'Graphics Interchange Format' are trademarks of
CompuServe, Incorporated, an H&R Block Company.

This program is shareware, meaning that you pay for it only if you decide to
continue using it.  If you don't think it is worth the price, delete the
program, or better yet give it to someone who might find it useful.  But if
you do continue to use it, send $15 to:

        Jason Harper
        1480 Michelle Ct. #A
        Colorado Springs, CO 80916

If you purchased the program from me at AppleFest/Boston '88, you are already
a registered shareware owner and are entitled to all the rights listed here.
^~~NOTICES-2~HOME

.NOTICES-2
Your money buys you the right to use this program as you see fit, as well as
any updates to it (but I cannot guarantee that any updates will be made).  You
are responsible for the costs of downloading or otherwise acquiring the program
and any updates.  I WILL NOT mail out disks: however, I may make future
arrangements for someone else to handle distribution for me.

You are allowed (and encouraged) to give away copies of this program, with the
understanding that all persons receiving it are under the same requirement to
send in the shareware fee.  You have my permission to upload the program to
other computer systems, either commercial or free, as long as the copyright
and shareware notices remain intact.
^~NOTICES~NOTICES-3~HOME

.NOTICES-3
No guarantee is made as to the functionality of this software: if it doesn't
do what you want it to do, then simply don't send any money.  Under no
circumstances will a refund be given if you become dissatisfied with it.

Please support the shareware concept.  Shareware means useful programs at a
fraction of the cost you would pay for them commercially.  You can try-before-
you-buy, and are not subjected to Copy Protection or the other atrocities
that many software vendors inflict on their customers.  Software updates can
also be distributed much faster than is possible through normal means.
^~NOTICES-2~NOTICES-4~HOME

.NOTICES-4
If you have any questions, comments, suggestions, bug reports, or gripes about
SHRConvert, you can send me mail at the address given above, or electronic mail
at one of these online addresses:
        CompuServe: 76703,4222  (preferred)
        GEnie: JR.HARPER

Hope you enjoy the program,

                                                Jason Harper
^~NOTICES-3~~HOME
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.ADV
You are in a maze of twisty little passages, all alike.

\6~North~ADV-2~South~ADV~East~ADV-0~West~ADV-0~Up~ADV~Down~ADV-0
^~~~

.ADV-2
You are in a maze of twisty little passages, all alike.

\6~North~ADV~South~ADV-0~East~ADV~West~ADV-2~Up~ADV-3~Down~ADV-0
^~~~

.ADV-3
You are in a maze of twisty little passages, all alike.

\6~North~ADV-2~South~ADV-2~East~ADV-3~West~ADV~Up~ADV-0~Down~ADV-4
^~~~

.ADV-4
You are in a maze of twisty little passages, all alike.

\6~North~ADV-2~South~ADV~East~ADV-5~West~ADV-0~Up~ADV-2~Down~ADV-4
^~~~

.ADV-5
You are in a maze of twisty little passages, all alike.

\6~North~ADV-4~South~ADV-CHOICE~East~ADV-3~West~ADV-2~Up~ADV-0~Down~ADV
^~~~
.ADV-0
You are in a maze of twisty little passages, all alike.

\6~North~ADV~South~ADV~East~ADV~West~ADV-0~Up~ADV~Down~ADV
^~~~

.ADV-CHOICE
You are in a room with no apparent exits.

A voice coming from all directions asks:
^S02"Have you sent in the $15 shareware fee yet?"


\3~Reply 'Yes'~ADV-EXIT~Reply 'No'~ADV-PIT~Don't respond~ADV-CHOICE2
^~~~

.ADV-CHOICE2
You are still in a room with no apparent exits.

An impatient voice coming from all directions asks again:
^S02"Have you sent in the $15 shareware fee yet?"


\3~Reply 'Yes'~ADV-EXIT~Reply 'No'~ADV-PIT~Don't respond~ADV-CHOICE2
^~~~

.ADV-PIT
A trap door opens beneath you, dropping you into a bottomless pit.
There's only one way out...
^~~~

{ the end */
