Esprit de Apple Corps/EDAC-2.iso/Graphics/Apps/Programs/SuperConvert/SuperConv.Help

Text File | 1990-11-27 | 80.9 KB | 1,870 lines

. SuperConvert 3.01 help file     Copyright 1991 Jason Harper
. This file is not human-readable: press Apple-? in the program to display it.

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

Invalid data in the SuperConv.Help file:

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

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

.HOME
=0
>L0,0,60,300    ;SuperConvert reduced title screen

\2~~~Version 3.01~VERSNOTES

Written by Jason Harper

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

\2~Menu command summary~SUMMARY~Other commands~NONMENU
\2~Load formats~LOADFMTS~Save formats~SAVEFMTS

Close this window when you've had enough help.







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

.LOADFMTS
-=[ Load formats ]=-

\1~Apple II family~LCA2
\1~Apple IIgs specific~LCGS
\1~Atari ST~LCST
\1~Amiga~LCAMIGA
\1~Commodore 64/128~LC64
\1~Macintosh~LCMAC
\1~IBM & compatibles~LCIBM
\1~Computer-independent~LCIND
^~~~HOME


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

\1~HiRes~LFHGR
\1~Double HiRes~LFDHR
\1~Print Shop black & white graphic~LFPSGRB1
\1~TDM text screen capture~LFTEXT
^~~LCGS~LOADFMTS

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

\1~SuperHiRes ($C0/PNT, $C1/PIC)~LFC0
\1~Uncompressed SHR screen ($C1, BIN)~LFC1
\1~Paintworks Gold 640 mode files~LFSCREWED
\1~Print Shop IIgs color graphic~LFPSGRC1
\1~Print Shop IIgs built-in graphics~LFPSGRC8
\1~Finder icon file~LFICON
\1~AST picture data file (color only)~LFAST
\1~"3200 color" pictures~LF3200
^~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~Spectrum 512~LFSPEC

\1~Other formats~LCSTNOTES
^~LCGS~LCAMIGA~LOADFMTS

.LCSTNOTES
-=[ Other Atari ST formats ]=-

You may occasionally run across an Atari ST picture with a filename ending
in .PQ1, .PQ2, or .PQ3.  These are standard .PI1-.PI3 files that have been
compressed with the standard Huffman SQ algorithm.  They can be unsqueezed
with a utility such as Shrinkit, AUSQ, or BLU.

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

.LCAMIGA
-=[ Amiga load formats ]=-

\1~IFF (FORM ILBM only)~LFIFF

The IFF format is used for many things besides graphics on the Amiga: music,
digitized sounds, and word processor documents to name a few.  Each type of
data is labelled as a specific FORM within an IFF file: ILBM for graphics,
SMUS for music, and so on.  It is possible for a FORM or other IFF structure
to contain other FORMs: for example a document FORM might contain a FORM ILBM
that specifies a picture that is included in the document.  SuperConvert
should be able to find a FORM ILBM no matter how deeply it is buried in an IFF
file's structure, however no specific file types that are likely to contain a
buried FORM ILBM are known at this time.
^~LCST~LC64~LOADFMTS

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

\1~Doodle~LF64DOODLE
\1~Koala Illustrator~LF64KOALA
\1~Print Shop screen~LF64PS
^~LCAMIGA~LCMAC~LOADFMTS

.LCMAC
-=[ Macintosh load formats ]=-

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

\2~Direct file transfer~LCMACNOTES1~Downloading notes~LCMACNOTES2
^~LC64~LCIBM~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 Mac system software.

There are also some utilities that can directly read a Mac disk on an Apple
II: MacTransGS for the old single-sided 400K (MFS) disk format, and A2FX for
800K (MFS) disks.
^~~~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,
such as PackIt (names end in .PIT) or StuffIt (.SIT).  PackIt files can be
unpacked, and MacBinary headers removed, with the utility MacDown: Stuffit
files can be unpacked with Shrinkit GS.
^~~~LCMAC

.LCIBM
-=[ IBM PC & compatible load formats ]=-

\1~PC Paintbrush (.PCX, .PCC)~LFZSOFT
\1~DeluxePaint, not Enhanced (.LBM)~LFIBMDP
\1~AutoDesk Animator frame file from FliAway~LFAATEMP
^~LCMAC~LCIND~LOADFMTS

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

\1~GIF (Graphics Interchange Format)~LFGIF
\1~RLE (Run Length Encoded)~LFRLE
\1~IPI image (.R + .G + .B)~LFIPI
\1~QuickRayTracer (QRT) raw image file~LFQRT
^~LCIBM~~LOADFMTS


.LFHGR
Format: Apple II HiRes
Machines: all Apple II-series computers
Programs: various, MousePaint for example
Identification: filetype is BIN, or occasionally FOT ($08)
Resolution: 140 x 192 x 6 colors, or 280 x 192 in black & white
Resulting picture: 280 x 192, 320 mode
^~~LFDHR~LCA2

.LFDHR
Format: Apple II Double HiRes
Machines: Apple IIe with 128K memory, Apple IIc, Apple IIgs
Programs: various, DazzleDraw for example
Identification: filetype is BIN, or occasionally FOT ($08)
Resolution: 140 x 192 x 16 colors, or 560 x 192 in black & white
Resulting picture:
        Color: 280 x 192, 320 mode
        B&W: 560 x 192, 640 mode
^~LFHGR~LFPSGRB1~LCA2

.LFPSGRB1
Format: Apple II Print Shop black & white graphics
Machines: all Apple II-series computers
Programs: Print Shop (original, not New Print Shop or Print Shop IIgs)
Resolution: 88 x 52 black & white
Resulting picture: 88 x 52, 320 mode
Print Shop uses DOS 3.3-formatted disks, so you will have to convert the files
to a ProDOS disk before SuperConvert can read them.

Print Shop graphics from other machines may be compatible, but this has not
been verified.
^~LFDHR~LFTEXT~LCA2

.LFTEXT
Format: TDM (The Desktop Manager) 40/80 column text screen captures
Machines/programs: TDM (a utility package from On Three, Inc.) runs on the
  Apple IIgs only, however this format could just as easily be generated on
  any Apple II so it is listed here instead of the IIgs-specific section.
Resulting picture:
        40 column text: 280 x 192, 320 mode
        80 column: 560 x 192, 640 mode

This conversion actually reads the IIgs's character set ROM to produce an
exact graphical representation of a text screen, even if a foreign-language
character set is selected.

\2~Compatibility warning~LFTEXT-COMPAT~Details on the format~LFTEXT-FORMAT
^~LFPSGRB1~LFC0~LCA2

.LFTEXT-COMPAT
-=[ TDM text screen captures: compatibility warning ]=-

The proprietary technique used to read the IIgs character set ROM cannot be
guaranteed to work on future revisions of the IIgs.  Also there may be
problems with future accelerator products: it works fine with the current
Transwarp GS at 7MHz, but accelerators that run faster or use a different
technique may cause this conversion to malfunction.  If this happens, you may
need to temporarily slow the accelerator down to normal IIgs speed.
^~~~LFTEXT

.LFTEXT-FORMAT
-=[ TDM text screen captures: format details ]=-

This format is simply a BIN file containing a raw image of the text screen
memory.  For example, you could save a 40-column screen from Basic with:
        BSAVE filename,A$400,L$400
80-column screen saves should store the auxiliary memory half of the screen
before the main memory half.  Files created in this manner won't contain
information on the setting of the alternate character set mode at the time the
save was made, therefore they may appear incorrectly when first converted.
When this happens, doing a Re-Convert (Apple-R) command will perform the
conversion using the opposite character set mode, making it look right.
^~~~LFTEXT

.LFC0
Format: SuperHiRes ($C0/PNT, $C1/PIC)
Machines: Apple IIgs
This load format handles all of the common IIgs-specific graphics file
formats automatically.  The individual supported formats are:

\1~Type $C0, auxtype 0: Paintworks Plus 1.0~LFC0x0
\1~Type $C0, auxtype 1: _PackBytes format~LFC0x1
\1~Type $C0, auxtype 2: Apple Preferred format~LFC0x2
\1~Type $C1, auxtype 0: uncompressed screen format~LFC1x0

If you load a file of another type (by enabling the option to load files
regardless of type), it will be interpreted as a PackBytes-format file: some
programs (usually games) use that format but give the files a different type.
^~LFTEXT~LFC1~LCGS

.LFC0x0
-=[ Type $C0, auxtype 0: Paintworks Plus 1.0 ]=-

Programs: first release of Paintworks Plus used this format only, more recent
    versions retain it as an option
Resolution: 320 x 396 x 16 colors from a palette of 4096
Resulting picture: same as original (no conversion)

This format contains 514 bytes of information on the current drawing color and
patterns.  SuperConvert 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, auxtype 1: _PackBytes format]=-

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

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

This format is almost completely unsupported by IIgs graphics programs.  Don't
use it unless you have to.
^~LFC0x0~LFC0x2~LFC0

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

Programs: hopefully all IIgs-specific graphics programs
Resolution: virtually any size; all IIgs SHR graphics features are possible
Resulting picture: 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 SuperConvert) 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 curve shown in the View Half Size (under the Screen Image 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.  When you load such a file, you'll get a dialog box
with a list of the segments in the file: those that SuperConvert can do something
with will appear as buttons, others will just be text.  A "MAIN" segment
contains an actual picture: it is almost always the first segment in the file,
and just hitting Return will cause it to be loaded.  Other supported segment
types are "SHRConvert" and "SuperConvert", which contain the version number of
the program that saved the file so that any problems with it can be traced
back to the source.  Other segments contain no usable information, but their
existence can help identify the source of the file: for example, pictures
saved from DeluxePaint will have an "EOA " segment, and Paintworks pictures will
have segments with names like "VSDV" and "VSDK".
^~LFC0x2~LFC1x0~LFC0

.LFC1x0
-=[ Type $C1, auxtype 0: uncompressed screen format ]=-
Programs: All IIgs paint programs can read this type: many can write it.
Resolution: 320 x 200 x 16 or 640 x 200 x 4, colors taken from a palette of 4096
    All IIgs graphics features are available, such as mixing the two graphics
    modes or having up to 16 independent color palettes, but few programs will
    accept or produce files containing these variations.
Resulting picture: same as original, no conversion.  Always one full screen.
^~LFC0x2~~LFC0

.LFC1
Format: Uncompressed SHR screen ($C1, BIN)
Machines: Apple IIgs
This is the same format as the type $C1, auxtype 0 uncompressed screen format
that is handled by the main SHR load format.  However, this load format doesn't
care as much about the file's exact type and auxtype, allowing you to load the
occasional file that doesn't have the right types.  In particular, many of the
pictures that were available when the IIgs first came out were incorrectly
given a filetype of BIN.

If you enable the option to load files regardless of their apparent format,
you can load a Paintworks animation file (type $C2) with this load format,
which will give you the first frame of the animation.
^~LFC0~LFSCREWED~LCGS

.LFSCREWED
Format: Paintworks Gold 640 mode files
Machines: Apple IIgs
Programs: Paintworks Gold
None of the three save formats in Paintworks Gold produces valid files when
the program is in 640 mode.  The usual symptoms when such files are loaded by
a program that properly implements the formats include incorrect colors and
half-width images.  This special load format is provided to handle these files
'properly' (actually it loads them improperly, to compensate for the defects
in the files).  Note that Paint-format files will lose their palette when
loaded this way: don't save 640 mode pictures in that format unless they use
the standard color palette.
^~LFC1~LFPSGRC1~LCGS

.LFPSGRC1
Format: Print Shop IIgs color graphics
Machines: Apple IIgs
Programs: Print Shop IIgs
Identification: filetype is $F8, auxtype is $C323
Resolution: 88 x 52 x 8 fixed colors (BLK WHT RED ORN YEL GRN BLU PUR)
Resulting picture: 88 x 52, 320 mode, default palette, only 8 colors used
^~LFSCREWED~LFPSGRC8~LCGS

.LFPSGRC8
Format: Print Shop IIgs built-in graphics
Machines: Apple IIgs
Programs: Print Shop IIgs
Identification: only works with the files GRAPHIC.CGT0 thru GRAPHIC.CGT7 found
on the Print Shop IIgs disk.
Resolution: Contains six named PS IIgs color graphics (see previous page)
Resulting picture: 88 x 52, 320 mode, default palette, only 8 colors used
^~LFPSGRC1~LFICON~LCGS

.LFICON
Format: Finder icon file
Machines: Apple IIgs
Programs: the Finder, plus various icon editors such as DIcEd
Identification: filetype is $CA
Allows selection of any icon contained in the file.  All Finder options that
can affect the appearance of the icon can be simulated: large/small icon
selection, icon coloration, and the effects of the icon being opened, offline,
or selected.  Also any background color for the icon can be selected.
Resulting picture: 640 mode, default palette, image size will be a few pixels
larger than the icon in all directions to make the background color visible
^~LFPSGRC8~LFAST~LCGS

.LFAST
Format: AST picture data file (color only)
Machines: Apple IIgs
Programs: VisionEffects, the software supplied with the AST VisionPlus video
digitizer card.  Files must be saved as picture data files from 320 mode, full
color.  Also compatible with the Allison digitizing application.
Resulting picture: 320 x 200 true color image
This load format is intended to provide a way to generate digitized screen
images of much higher quality than the VisionEffects software is capable of.
^~LFICON~LF3200~LCGS

.LF3200
Format: "3200 color" pictures           Page 1 of 2
Machines: Apple IIgs
Programs: various, including the software for the Visionary video digitizer card
Resulting picture: 320 x 200 true color image
These pictures are intended for use with special display programs that change
the color palette for each row of pixels, making it possible to display 3200
(200 lines times 16 colors per line) colors at once, although in no case
(other than a simple test pattern) would there be anywhere near 3200 distinct
colors visible.  The results can be excellent, but unfortunately the critical
timing requirements of this technique make it necessary for such display
programs to completely shut down interrupts, a normal IIgs function  [more]
^~LFAST~LF3200-2~LCGS

.LF3200-2
Format: "3200 color" pictures           Page 2 of 2

that is used by things such as AppleTalk, various desk accessories such as
alarm clocks and screen blankers, and other ordinary operations.  This
inherent incompatibility with normal IIgs functioning makes the 3200 color
format completely useless, in my opinion.  This load format is provided so
that you can convert any 3200 color pictures you have into normal formats that
might not look quite as good, but don't disrupt normal operation of the
computer.
^~LF3200~LFATARI~LCGS

.LFATARI
Format: Atari ST .PI1, .PI2, .PI3
Machines: Atari ST
Programs: Degas, Degas Elite
Resolution: .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
Resulting picture: .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
^~LF3200~LFDEGELITE~LCST

.LFDEGELITE
Format: Atari ST .PC1, .PC2, .PC3
Machines: Atari ST
Programs: Degas Elite
Resolution and resulting picture: see description of Degas .PI1,2,3 format
^~LFATARI~LFNEO~LCST

.LFNEO
Format: Atari ST Neochrome (.NEO)
Machines: Atari ST
Programs: Neochrome
Resolution and resulting picture: 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
Format: Atari ST Tiny compressed (.TNY)
Machines: Atari ST
Programs: interchange format only: no program uses this as default
Resolution and resulting picture: see description of Degas .PI1,2,3 format
^~LFNEO~LFSPEC~LCST

.LFSPEC
Format: Atari ST Spectrum 512 (uncompressed: .SPU, compressed .SPC)
Machines: Atari ST
Programs: UniSpec, DigiSpec, etc.
Resolution: 320 x 199 x 512 colors (actually it's 320 x 200, but the top line
is always solid black due to limitations of the format).  There are at most 15
colors available for any one pixel, but the available colors are changed three
times per row of pixel making it possible to have all 512 colors on the screen.
Resulting picture: 320 x 200 true color image
There is a third Spectrum 512 format, having a filename ending of .SPS, but
details of this format have not been made public.
^~LFTINY~LFIFF~LCST

.LFIFF
Format: Amiga IFF
Machines: Amiga, variations also used on other machines such as IBM
Programs: virtually all Amiga graphics programs
Resolution: arbitrary size, 2-32 arbitrary colors or 64 or 4096 limited colors
Resulting picture: true color image, same size as original
This load format handles FORM ILBM structures in any IFF file (including FORM
ILBMs buried inside other structures) that describe a normal Amiga display
mode, including EHB (Extra HalfBrite) and HAM (Hold-And-Modify).  Synthetic
and non-displayable modes (SHAM, Dynamic HAM, Dynamic HiRes, HAM-E, RGBN,
RGB8, etc.) are not currently supported.
^~LFSPEC~LF64DOODLE~LCAMIGA

.LF64DOODLE
Format: Commodore 64 Doodle format
Machines: Commodore 64/128
Programs: Doodle
Resolution: 320 x 200 x 16 colors: two color choices per 8 x 8 pixel area
Resulting picture: 320 x 200, 320 mode

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

.LF64KOALA
Format: Commodore 64 Koala Illustrator
Machines: Commodore 64/128
Programs: Koala Illustrator
Resolution: 160 x 200 x 16 colors: four color choices per 4 x 8 pixel area
Resulting picture: 320 x 200, 320 mode
^~LF64DOODLE~LF64PS~LC64

.LF64PS
Format: Commodore 64 Print Shop
Machines: Commodore 64/128
Programs: Print Shop
Resolution: 320 x 200 black & white
Resulting picture: 320 x 200, 320 mode

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
Format: Macintosh MacPaint
Machines: Apple Macintosh
Programs: MacPaint and many other Mac graphics programs
Resolution: 576 x 720 black & white
Resulting picture:
        640 mode option: 576 x 360, 640 mode non-dithered, 4-level grayscale
        320 mode option: 576 x 227, 320 mode (bottom 70% of image is lost due
                                                to screen image size limits)

Note: the default save format for MacPaint II is NOT this format, although the
old MacPaint format is available as an option.
^~LF64PS~LFMACSM~LCMAC

.LFMACSM
Format: Macintosh ScreenMaker (startup screen)
Machines: Apple Macintosh
Programs: ScreenMaker, converts MacPaint pictures to this format
Resolution: 512 x 384 black & white
Resulting picture: 512 x 192, 640 mode non-dithered, 4-level grayscale
Note: this is the startup screen format for older Macintoshes only, the Mac SE
and Mac II series use a different format which SuperConvert doesn't support yet.
^~LFMPNT~LFZSOFT~LCMAC

.LFZSOFT
Format: PC Paintbrush (full screen: .PCX, clipping: .PCC)
Machines: IBM & compatibles
Resolution: arbitrary size, 2-256 colors, but only 2-16 color files are
currently supported
Resulting picture: true color image, same size as original image
Note: each IBM program that supports this format seems to do it differently
from the others, and to do it slightly differently for each of the types
of IBM display cards (well over a dozen) that they support.  This is typical
of all IBM graphics file formats, and makes it impossible to guarantee that
SuperConvert will be compatible with all files of a particular format.
^~LFMACSM~LFIBMDP~LCIBM

.LFIBMDP
Format: Deluxe Paint II, not Enhanced (.LBM)
Machines: IBM & compatibles
Resolution: arbitrary size, 2-256 colors
Resulting picture: true color image, same size as original
The original DeluxePaint II for the IBM used a format identical with the Amiga
IFF format for graphics (FORM ILBM), with the single exception that it
supports 256 color images which aren't possible on the Amiga.  Unfortunately
DeluxePaint II Enhanced uses an incompatible variation on the format: details
on the variation haven't been found yet, so SuperConvert doesn't support those
files yet.  There is no way to tell whether a particular file is in the old or
new format other than trying to load it.
\1~Jump to description of Amiga IFF load format~LFIFF
^~LFZSOFT~LFAATEMP~LCIBM

.LFAATEMP
Format: Autodesk Animator frame file
Machines: IBM & compatibles with VGA or MCGA graphics capability
Programs: only compatible with the individual frame files created by the
accompanying FliAway utility out of .FLI animations from Autodesk Animator
Resolution: 320 x 200, 256 colors out of a palette of 262144
Resulting picture: 320 x 200 true color image
^~LFIBMDP~LFGIF~LCIBM

.LFGIF
Format: GIF (Graphics Interchange Format)
Machines: almost all
Resolution: arbitrary size, up to 256 colors out of a palette of 16777216
Resulting picture: true color image, same size as original image
Compatibility: the original version (87a) of the GIF specification is fully
supported.  Files that use features from later revisions of the specification
will convert, but portions of the picture may be missing or distorted.
Programs that produce GIF files can be found on most computer systems with
graphics capability.  If you need to convert pictures from another machine's
format that SuperConvert doesn't support, there is a good chance that a utility
will be available for that machine to convert the files to GIF.

The Graphics Interchange Format is a copyright, and "GIF" is a service mark of
CompuServe Incorporated.
^~LFAATEMP~LFRLE~LCIND

.LFRLE
Format: RLE (Run Length Encoded)
Machines: almost all
Resolution: 256 x 192 or 128 x 96, black & white
Resulting picture: 320 mode, 256 x 192 or 128 x 96

\1~Downloading notes~LFRLE-2
^~LFGIF~LFIPI~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 (especially the ESCape character).
^~~~LFRLE

.LFIPI
Format: IPI full color image (.R + .G + .B)
Resolution: 256 x 256 or 512 x 512, 16777216 possible colors
Resulting picture: true color image, same size as original
Identification: this format is rather different from the others that
SuperConvert supports, in that each image is composed of three separate files
containing the red, green, and blue portions of the image.  Select any of the
three for loading: the other two will be loaded automatically.  For this to
work, all three files must have identical names except for the endings, which
must be ".R", ".G", and ".B".  If the files are named differently, they must
be renamed before they can be loaded.
This file format was used at the Image Processing Institute of the University
of Southern California for early experiments in digital image processing.
^~LFRLE~LFQRT~LCIND

.LFQRT
Format: QuickRayTracer (QRT) raw image file
Resolution: arbitrary size, up to 16777216 possible colors
Resulting picture: true color image, same size as original
QRT is a program, available for several types of computers, for producing
computer-generated images from a mathematical description of a scene.  There
isn't a IIgs version of QRT at this time, but if one is ever available it will
presumably use the same file format as other versions.  You will be able to
use this load format to convert its output (or the output of other computers'
versions of QRT, after transferring the file to an Apple II-readable disk) to
a IIgs-displayable screen image.
^~LFIPI~~LCIND
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.SAVEFMTS
-=[ Save formats ]=-

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


\2~Type $C1 non-compressed SHR~SFC1~GIF (Graphics Interchange Format)~SFGIF
\2~Finder icon file~SFICON~TIFF (Tagged Image File Format)~SFTIFF
\2~Desktop background image INIT~SFDESK~~
^~~~HOME

.SFC0x0
-=[ PaintWorks Plus 1.0 'Paint' format: type $C0, auxtype $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.
Limitations: Only 320 mode graphics are allowed (there is a variation of this
    format that handles 640 mode, but it is not supported because only Paintworks
    Gold uses it, and that program can handle other 640 mode formats).  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 the drawing patterns up.
^~~SFC0x1~SAVEFMTS

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

Default filename ending: PAK
Programs: only 816/Paint and Fantavision GS seem to use this format.
Picture size: one screenfull, no more, no less.
Limitations: All IIgs graphics features are possible, but individual programs
    may impose restrictions such as a single palette or 320 mode only.
Usage: this is not an officially-supported format.  About the only legitimate
    use for it is in programs you write yourself, with no need for the pictures
    ever to be used anywhere else, since the format is a good compromise between
    minimizing file size and ease of writing code to load the picture.
^~SFC0x0~SFC0x2~SAVEFMTS

.SFC0x2
-=[ Apple Preferred format: type $C0, auxtype $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.
Limitations: All IIgs graphics features are possible to represent in this
    format, but programs that support it generally impose additional restrictions
    such as a single palette.  Some are badly written and cannot handle files
    with a width other than one screen.
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.
^~SFC0x1~SFC1~SAVEFMTS

.SFC1
-=[ Non-compressed screen format: type $C1, auxtype $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 (up to 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.
^~SFC0x2~SFICON~SAVEFMTS

.SFICON
-=[ Finder icon file ]=-                Page 1 of 4

Default filename ending: ICN
Programs: the Finder uses icon files, various other programs such as DIcEd can
    be used to create or modify them.
Limitations: each icon must be 640 mode, with the standard color palette.  Image
    size cannot exceed 160 x 50, with 80 x 25 being the largest you should normally
    make an icon.
Usage: this format appears twice in the list of save formats, once for making
    a new icon file containing one icon, and another for adding icons to an
    existing file, perhaps one you just created with the first option.  If you
    are making icons for a group of files that are likely to stay together, it
    is a good idea to put their icons together in one file: this reduces memory,
    disk space, and loading time requirements for the icon file.  [more]
^~SFC1~SFICON-2~SAVEFMTS

.SFICON-2
-=[ Finder icon file ]=-                Page 2 of 4

DO NOT use the add icon option with the icon files that came on your System
Disk, as any icons you add will be overwritten whenever you install a new
System version.

Icon files contain more than just the images of the icons: they also contain
information on what file or files each icon is to be used for.  Also, there
is a small icon associated with each full-size icon.  Therefore, when saving
an image in this format you'll get a dialog box allowing you to specify all of
this extra info.  Initially, all options will be set up to associate the icon
with the most recently loaded file, and to have the icon automatically run
SuperConvert when it is opened.  You can modify any of the selection criteria,
or turn some of them off to allow the icon to be used for a group of files.   [more]
^~SFICON~SFICON-3~SAVEFMTS

.SFICON-3
-=[ Finder icon file ]=-                Page 3 of 4

If you want the small icon associated with your full-size icon to be something
other than the generic document icon, you can draw whatever sort of image you
want using the icon editor at the upper right of the icon options dialog:

>R0,354,88,640          ;image of small-icon editor
Drawing is performed in the magnified view
area: the results appear there and in the
actual size area.  Clicking on the drawing
tool steps through the available tools:
Pencil - draws in the selected color.  Areas
    drawn with the 'NONE' color will be
    transparent.
Paint can - erases with the selected color
Hand - repositions icon image   [more]
^~SFICON-2~SFICON-4~SAVEFMTS

.SFICON-4
-=[ Finder icon file ]=-                Page 4 of 4

Clicking on the actual size box steps through the various ways the icon can
appear in the Finder due to it being open, offline, or selected.

If the mono/color box is checked, the Finder won't allow the user to change
the icon's colors.

Each of the little square boxes in the magnified view actually represents two
pixels, which together form one of the 16 possible dithered colors.  Normally,
drawing affects both pixels of each pair at once: if you need to do some very
detailed drawing (particularly in black & white), clicking on the half-pixel
box will enable/disable a mode in which the individual pixels of each pair can
be seperately drawn and (if both are black or white) displayed.
^~SFICON-3~SFDESK~SAVEFMTS

.SFDESK
-=[ Desktop background image INIT ]=-

Default filename ending: INI
Programs: the output of this save format is a program, intended to be placed in
    the SYSTEM.SETUP subdirectory of the SYSTEM directory of your boot disk.
    Putting one anywhere else has no effect.  When a disk with one of these files
    is booted, the picture contained in the file will be installed as the
    background image for all normal desktop-style programs.
Picture size: always one screenfull, with the top 13 rows of pixels being
    invisible due to the presence of the menu bar.  Larger images are chopped
    off at the bottom, smaller ones are centered on a light blue background.
Limitations: any image can be saved in this format, but it won't look right
    unless its palette matches the palette of the programs it appears it.  Use
    the Remap command to change an image to a different palette or mode.
^~SFICON~SFGIF~SAVEFMTS

.SFGIF
-=[ GIF (Graphics Interchange Format) }=-

Default filename ending: GIF
Programs: there are a few Apple II programs which can use GIF files, however this
    save format is primarily intended for moving graphics to other machines. Programs
    that can convert or use GIF files exist for virtually all computer systems that
    have graphics capability.
Limitations: pictures using mixed 320 and 640 modes cannot be saved in this format.
    Multipalette pictures and pictures using dithered colors in 640 mode can be saved
    as GIF, but they may not look quite the same on another IIgs since the information
    needed to recreate these IIgs-specific features cannot be stored in a GIF file.

Saved files conform to the original (87a) version of the GIF specification.
The Graphics Interchange Format is a copyright, and "GIF" is a service mark of
CompuServe Incorporated.
^~SFDESK~SFTIFF~SAVEFMTS

.SFTIFF
-=[ TIFF (Tagged Image File Format) ]=-         Page 1 of 2

Default filename ending: TIF
Programs: no Apple II programs are known to use TIFF files at this time.  However,
    many desktop publishing and other types of programs for the IBM, Macintosh,
    and other computer systems can load TIFF files: this save format is intended
    to allow you to move graphics from the IIgs to these other machines.
Compatibility: TIFF is an extremely flexible format, perhaps too flexible for
    its own good.  There are hundreds of legal variations of TIFF files, and
    new variations can be introduced at any time: unfortunately, most programs
    that claim TIFF compatibility only support a small fraction of these
    possibilities.  To maximize your chances of successfully using TIFF files,
    SuperConvert will display a dialog giving you various options to control
    exactly how the file is stored.  [more]
^~SFGIF~SFTIFF-2~SAVEFMTS

.SFTIFF-2
-=[ TIFF (Tagged Image File Format) ]=-         Page 2 of 2

The first time you save an image in TIFF format for use with a particular
program you should save several files using different combinations of options,
and see which ones work the best.  Unfortunately, no guarantee can be made
that the files will work at all with any particular program or program version
other than the ones we've tested, which currently include:
    PageMaker 4.0 (Macintosh): either byte ordering, must use 'increased
        compatibility' mode.
^~SFTIFF~~SAVEFMTS
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

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

\1~Program statistics~STATS
\1~New features and other changes~ADDED
\1~Coming attractions~COMING
^~~~HOME

.STATS
-=[ Program statistics ]=-

The program's source code currently consists of:
    48108 lines APW Assembler
    2763 lines APW C code
    135 lines LinkIIgs commands
    1865 lines online help script
^~~~VERSNOTES

.ADDED
-=[ New features and other changes ]=-

v3.01:
Corrected order of toolset startups, which could cause problems with NDAs.

v3.00:
The number of changes from the previous shareware version (SHRConvert 2.1) is
too large to list them all here.

^~~~VERSNOTES

.COMING
-=[ Coming attractions ]=-

The listing of a feature here should not be considered as a guarantee that
such a feature will ever actually be added to the program.

New load formats: TIFF (won't handle all files), Windows .BMP, New Print Shop
formats, maybe Thunderscan raw scan files.

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

.SUMMARY
-=[ Menu Command Summary ]=-

Menus:
\4~Apple~M1~File~M2~Edit~M3~Screen Image~M5




\4~True Color Image~M9~Windows~M4~Extras~M8~~

^~~~HOME

.M1
-=[ APPLE menu ]=-

\1~About SuperConvert...~M1ABOUT
\1~Help~M1HELP
\1~Menu item help~M1MHELP
\1~Preferences...~M1PREFS

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

.M2
-=[ File menu ]=-

\2~Load & convert...~M2LOAD~Print (normal)...~M2PRINT
\2~Re-convert last file~M2RELOAD~Print (enhanced)...~M2PRINTE
\2~Load next~M2LOADNEXT~Print alignment page...~M2ALIGN
\2~Cancel remaining files~M2CANCEL~Examine file...~M2FILEUTIL
\2~Save conversion...~M2SAVE~Quit~M2QUIT
\2~Exchange load/save paths~M2EXCHANGE~~
^~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 whatever the NDA wants them to do (often nothing).
^~M2~M5~SUMMARY

.M5
-=[ Screen Image menu ]=-

This menu is only enabled if there is an image loaded.  All these commands
operate only on the current screen image, they do not affect or use the true
color image (if present).

\2~View full screen~M4FULL~Crop to clipping area~M5CLIPS
\2~View half size~M5SHOW~Store palette~M5STORE
\2~View X4 magnified~M5MAGNIFY~Use as desktop background~M5USEDESK
\2~View interlaced on VOC~M5INTERLACE~Oscilloscope Art~M5OSCOPE
\2~Image info...~M5INFO~~
^~M3~M9~SUMMARY

.M9
-=[ True Color Image menu ]=-

This menu is only enabled if there is an image loaded.  These commands operate
on the current true color image (creating one from the current screen image if
a true color image isn't present), possibly producing a new screen image.
\1~Remap image...~M9REMAP
\1~View approximation~M9VIEWTRUE
\1~Image info...~M4TRUEINFO
\1~Rotate/flip image...~M9ROTFLIP
\1~Histogram equalization~M9EQUALIZE
\1~Discard true color image~M9PURGE
^~M5~M4~SUMMARY

.M4
.M4NORMAL
.M4LOAD
.M4SAVE
.M4CONV
-=[ Windows menu ]=-

The 'Normal positions' command returns all of the program's windows to their
starting positions and sizes.  The remaining items bring the named window in
front of all others, so that you can use it without having to move other
windows out of the way.  Not included here are the Help window, which can be
brought to the front by giving a help command again, and desk accessories,
which can be brought to the front by reselecting them from the Apple menu.
^~M9~M8~SUMMARY

.M8
-=[ Extras menu ]=-

This menu contains features that didn't fit anywhere else.  Some of them
really don't have anything to do with the purpose of SuperConvert, and may
be removed from future versions.
\1~Available font list~M8FONTLIST
\1~More available fonts~M8MOREFONTS
\1~Font key chart~M8KEYCHART
\1~Print banner~M8BANNER
\1~Revert to normal desktop~M8DEFDESK
\1~System info report...~M8SYSINFO
^~M4~~SUMMARY

.M1ABOUT
Apple menu: About SuperConvert...

Displays the program's version number.  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 help files cannot be found in the same subdirectory that
SuperConvert itself was run from, or there was insufficient memory to load
them.  Giving this command while the help window is already on the screen
will bring it in front of all other windows.

While the help window is open, the help files are occupying over 100K of memory.
After the window has been closed, this memory is available for other uses.  If
you have no more than a megabyte of memory and are going to be doing something
that requires lots of memory (such as working with a large true color image),
make sure you close the help window first.
^~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~M1PREFS~M1

.M1PREFS
Apple menu: Preferences...
Shortcuts: Apple-minus or Apple-_

Brings up a dialog box giving several options for modifying the behavior of
SuperConvert.  These options are in effect until changed or the program is
exited: they will be reset to normal the next time you run the program.  Most
of the options should be self-explanatory, and are intended to make it easier
to convert or print large batches of files by minimizing the number of times
that user intervention is required.

\1~More info on the 'Use second monitor' option~USEVOC
^~M1MHELP~M2LOAD~M1

.USEVOC
Preferences option:                     Page 1 of 2
      Use second monitor (attached to Video Overlay Card) for continious viewing

Enabled only if you have an Apple Video Overlay Card (VOC) installed in your
computer, the Video Overlay Toolset (file TOOL033) installed on your boot
disk, and the VOC has dual video capability (always true of the current
model).

If this option is enabled, any full screen display (as results automatically
when a picture is loaded, or by selecting a display command from the Screen
Image menu) will 'stick' on the monitor connected to the VOC, while normal
program operation continues on the monitor connected to the computer's video
output.  [more]
^~~USEVOC-2~M1PREFS

.USEVOC-2
Preferences option:                     Page 2 of 2
      Use second monitor (attached to Video Overlay Card) for continious viewing

This could be useful, for example, in giving a presentation: the presenter
could be loading the next picture on the computer's monitor while the
audience continues to view the previous picture on a large-screen TV
connected to the VOC.  The 'Don't automatically view' preferences option may
be useful to use in conjunction with this option.  DO NOT turn on this option
unless you have two monitors connected as described above: if you don't, you
won't be able to see what you're doing.  If this does happen, the following
series of keystrokes should get you back in control:
     Apple-minus M Return Apple-F
^~USEVOC~~M1PREFS

.M2LOAD
File menu: Load & convert...            Page 1 of 2
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 file to load in the Load Formats window.  You can select multiple
files to be loaded: hold down the Shift key when clicking on files to select a
range, the Apple key to select individual files.  The first selected file will
be immediately loaded, you load subsequent files in the list with the Load
Next command.  You can select subdirectories in addition to normal files, but
they will be ignored unless you have checked the 'Load all pictures in
selected subdirectories' box.  [more]
^~M1PREFS~M2LOAD-2~M2

.M2LOAD-2
File menu: Load & convert...            Page 2 of 2

Normally, only those files that appear to be of the chosen file format (as
determined by the file's length, filetype, and auxtype) will be selectable:
others will appear in the list but be dimmed out.  If for any reason, you want
to attempt a conversion on a file that isn't selectable, you can click on the
'Allow files to be selected regardless of type' box.  Don't do this without
good reason, as files that are inappropriate for the selected load format will
produce meaningless results and can conceivably crash the program.
^~M2LOAD~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 auxtype checks),
so if you try the wrong format at first you can easily try a different format
without having to locate the file again.
^~M2LOAD~M2LOADNEXT~M2

.M2LOADNEXT
File menu: Load next
Shortcuts: Apple-N, or click on Load Next button in Load Formats window
Enabled only if there are one or more files remaining from a multiple file
Load command.

Loads and converts the next in a series of files selected with the Shift or
Apple key in the Load command.  You can still do normal Loads while there are
files remaining: a single file load will be done immediately without affecting
the remaining files, a multiple file load will be added on to the list of
remaining files, and the next file in the list will be loaded.
^~M2RELOAD~M2CANCEL~M2

.M2CANCEL
File menu: Cancel remaining files
Enabled only if there are one or more files remaining from a multiple file
Load command.

Gets rid of the list of remaining files from a multiple file Load command.
^~M2LOADNEXT~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.
^~M2CANCEL~M2EXCHANGE~M2

.M2EXCHANGE
File menu: Exchange load/save paths

SuperConvert separately remembers the disk locations at which you have most
recently done a Load or Save operation: this makes it easy to convert a series
of files from one disk to another without having to step through the list of
online disks every time you do a load or save.  This command allows you to
swap the remembered locations for loading and saving: use it, for example, to
load a file you just saved to see if it looks right, then use it again to
switch back to the normal loading/saving disks.
^~M2SAVE~M2PRINT~M2

.M2PRINT
File menu: Print (normal)...

Prints the current screen image to any printer for which you have a standard
printer driver installed on your boot disk, and have selected in the Control
Panel NDA.  This command, as well as all other printing-related commands in
SuperConvert, will give you two consecutive dialog boxes for selecting print
options, corresponding to the Page Setup and Print commands in most other
programs.  This nonstandard behavior is necessary to insure that the printer
setup is correct for the graphics mode of the image being printed.

Multipalette images will not currently print properly.
^~M2EXCHANGE~M2PRINTE~M2

.M2PRINTE
.M7PRINTE
File menu: Print (enhanced)...
Shortcut: Apple-P

This variation on the Print command (see previous page) gives you additional
options to control the sizing and positioning of the image on the paper, and
allows you to add a one-line caption in any font.  By default, the caption is
NOT added: if you want it, you must check the 'Add caption' box.  If the
scaling options you have chosen will result in a printout more than one page
high, you will want to select 'No gaps between pages' in the first printer
options dialog to eliminate gaps in the printout at each page break.  See the
description of the Print Alignment Page command (next page) for a way to get
rid of vertical gaps in printouts that are more than one page wide.
^~M2PRINT~M2ALIGN~M2

.M2ALIGN
File menu: Print alignment page...

Prints a test page with an L-shaped mark in each corner at the absolute
farthest printable areas of the page for the current printer options.  If you
are going to print out an image at a scaling that makes it multiple pages
wide, you can use this command to help get the printer's paper feed shifted over
so that the right or left edge of the alignment marks (and therefore, the edge
of normal printing) is exactly on the side perforations of the paper
(obviously, this is only going to work with a tractor feed printer, not
something like a LaserWriter).  This will allow you to tape the sections of
the printout together without any gaps, without having to cut off the normal
margin of the page with scissors.  This command can be used again later to
help get the paper back to its proper centered position in the printer.
^~M2PRINTE~M2FILEUTIL~M2

.M2FILEUTIL
File menu: Examine file...              Page 1 of 3

This command will allow you to examine the contents of any file.  The exact
interpretation of the results depends on the format of each particular file,
and is beyond the scope of this documentation.  First, you'll get a standard
file selection dialog to allow you to choose the file (or files, using the
Shift or Apple keys to select multiple files) you want to examine.  For each
file you have up to three options for how you want to view it: the data fork
(the normal part of a file, and all that is present in most files), a
histogram (spectrum analysis) of the data fork, or the resource fork
(generally present only in recent program files).  When you are done with each
file, click on the window's close box to go on to the next file or return to
normal program operation.  [more]
^~M2ALIGN~M2FILEUTIL-2~M2

.M2FILEUTIL-2
File menu: Examine file...              Page 2 of 3

Data and resource forks are viewed in a scrolling window with side-by-side
hexadecimal and ASCII representations.  The ASCII part is color coded as
follows:
        Control characters ($00..$1F, $80..$9F): text is purple
        Printable characters ($20..$7F, $A0..$FF): text is black
        Normal ASCII characters ($00..$7F): background is white
        High ASCII characters ($80..$FF): background is green
The Delete character (normal $7F, high ASCII $FF) is shown as a triangle.
[more]
^~M2FILEUTIL~M2FILEUTIL-3~M2

.M2FILEUTIL-3
File menu: Examine file...              Page 3 of 3

The histogram display is a bargraph showing the number of times each of the
256 possible values of a byte appears in the file.  You can find out what
byte value a bar represents, its exact number of occurrences in the file, and
the percentage of the file it is, by pointing to it with the mouse.  This
feature is intended to help in identifying files of completely unknown format:
many formats have a distinct distribution of byte values, for example IBM .PCX
graphics files almost always have their highest peak at byte $C1, with the
next few sequential bytes also having relatively tall bars.
^~M2ALIGN~M2QUIT~M2

.M2QUIT
File menu: Quit
Shortcut: Apple-Q

Exits SuperConvert and returns you to the program selector you ran the program
from.  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.
^~M2FILEUTIL~M4FULL~M2

.M4FULL
Screen Image menu: View full screen
Shortcut: Apple-F

Returns you to the full-screen view of the current screen image that you saw
when it was originally loaded or otherwise generated.  If the image is larger
than the screen, it will automatically shift around to show you the full
image.  You can also use the mouse to scroll around within the full image.
Press any key or the mouse button to exit: if you press a valid Apple-key
command shortcut, the command will be executed immediately.
^~M2QUIT~M5SHOW~M5

.M5SHOW
Screen Image menu: View half size
Shortcut: Apple-H

Displays the current screen image at half actual size, which allows the
largest image SuperConvert can handle to fit entirely on the screen.  The
hyperbolic curve at the lower right of the screen represents the 64K image
size limitation: no image's lower right corner can extend into that area.
Press any key or the mouse button to exit: if you press a valid Apple-key
command shortcut, the command will be executed immediately.
^~M4FULL~M5MAGNIFY~M5

.M5MAGNIFY
Screen Image menu: View X4 magnified
Shortcut: Apple-4

Displays the current screen image magnified four times, possibly allowing you
to see details you couldn't at actual size.  Moving the mouse will scroll
around within the image.  Press any key or the mouse button to exit, valid
Apple-key command shortcuts will be executed immediately.
^~M5SHOW~M5INTERLACE~M5

.M5INTERLACE
Screen Image menu: View interlaced on VOC
Shortcut: Apple-O
Available only if you have an Apple Video Overlay Card (VOC) installed in your
computer and the Video Overlay Toolset (TOOL033) installed on your boot disk.

Uses the extended video capabilities of the Video Overlay Card to display the
current screen image in interlaced mode, giving 400 pixels of vertical
resolution instead of the normal 200.  An unavoidable side-effect of the use
of interlace mode is flickering of the image, which will be especially severe
around any thin horizontal lines.  If you also have a monitor connected to the
IIgs's built-in video port, it will display garbage during this command since
the built-in video doesn't know anything about interlace mode.

You may need to use the Remap Image command to double the vertical size of
images to be viewed this way, so that they retain their proper proportions.
^~M5MAGNIFY~M5INFO~M5

.M5INFO
Screen Image menu: Image info...
Shortcut: Apple-I

Calculates statistics on pixel and palette usage within the current screen
image.  Not to be confused with the command of the same name in the True Color
Image menu, which generates similar statistics for the current true color
image.  The results are not very meaningful for multipalette images, since
pixels with the same color number but in different palettes will be added
together regardless of whether they represent the same actual color.  To get
an accurate count of the number of colors in a multipalette image, select the
Discard True Color Image (if enabled) then the Image Info command under the
True Color Image menu.
^~M5INTERLACE~M5CLIPS~M5

.M5CLIPS
Screen Image menu: Crop to clipping area
Enabled only if a clipping area has been defined in the screen image window.

Throws away the parts of the current screen image outside of the selected
clipping area.  You don't need to do this if you just want to save the
clipping area (except for desktop background format), but if you want to print,
manipulate as a true color image, or get info on the clipping area, you must
use this command first.  There is no way to undo this command: if you think
you may need the full image again later, and can't easily reload it, save it
to disk first.
^~M5INFO~M5STORE~M5

.M5STORE
Screen Image menu: Store palette

Remembers the palette of the current screen image (palette #0 only, for
multipalette images) for later use in Remap operations.  This storing is done
to memory only, the palette will be gone the next time you run the program.
This feature allows you to convert pictures so that they use the exact same
palette as some existing picture: it could be useful with programs that
require some particular palette for proper operation other than the ones Remap
knows about (load a sample picture from that program and store its palette).
It is also useful for converting animations from other computers: the
animation will generally look smoother on the IIgs if all the frames use the
same palette.  Load a 'typical' frame (one that includes as many of the colors
used throughout the animation as possible), store its palette, and remap all
the other frames to that palette.
^~M5CLIPS~M5USEDESK~M5

.M5USEDESK
Screen Image menu: Use as desktop background            Page 1 of 2

Replaces the desktop background, normally light blue, with the current screen
image.  If it is larger than the screen the bottom is chopped off; if smaller,
it is centered on the screen and the area around it is left as light blue.
The new background will appear in most desktop-style programs, and lasts until
a new background is specified, the Revert To Normal Desktop command (under the
Extras menu) is given, or the machine is shut down.  If you want the changed
background to be in effect always, see the description of the Desktop
Background INIT save format.  [more]

\1~Jump to Desktop Background INIT save format description~SFDESK
^~M5STORE~M5USEDESK-2~M5

.M5USEDESK-2
Screen Image menu: Use as desktop background            Page 2 of 2

The background image doesn't have a palette of its own, therefore it will only
look right in programs with a palette that matches the image's original
palette: use of the Remap command is often necessary to make it look right at
all.  640 dither mode with the default color palette generally works right,
since most desktop programs use that palette: to make the background image
work with absolutely any program, remap it to 320 mode, B&W palette.
^~M5USEDESK~M5OSCOPE~M5

.M5OSCOPE
Screen Image menu: Oscilloscope Art

This command allows the viewing of graphics on a standard oscilloscope
connected to the IIgs's composite video output jack.  There is no known reason
why anyone would want to do this, but since it could be done I did it anyway.
The effective resolution of the display is 320 by 100 with 3 gray levels.
Required Control Panel display options: monochrome, border color = black.
Oscilloscope settings: DC-coupled input, TV Line sync if available, about 0.5
volts/div vertical sensitivity, about 20 msec/div horizontal sweep, adjust
trigger level for a stable image.  If you find a use for this feature let me
know!  This command operates on the current screen image, and produces a new
screen image.
^~M5USEDESK~M9REMAP~M5

.M9REMAP
True Color Image menu: Remap image...

Remapping is the process of reducing a true color image, which can contain
thousands of colors and have resolution limited only by available memory, down
to the resolution and colors that the IIgs can directly display as a screen
image.  This is done automatically when a true color image is loaded, or can
be explicitly requested by this command.  The process does not affect the true
color image, so you can remap it as many times as you need, trying different
options each time, without having to reload the original file.  If there is no
true color image in memory, one will be created from the current screen image:
by loading a normal IIgs image and remapping it with different options, you
can achieve effects such as turning a 320 mode picture into one with a
different palette, or into a 640 mode picture.
\1~Details on remap options~REMAP
^~M5OSCOPE~M9VIEWTRUE~M9

.M9VIEWTRUE
True Color Image menu: View approximation
Shortcut: Apple-A

It's generally not possible to view a true color image: the whole point of
SuperConvert's true color images is to represent pictures that can't be
directly converted to IIgs format, due to their resolution or number of colors
being potentially greater than the IIgs's capability.  However, this command
will show you an approximation of the current true color image (creating one
from the current screen image if it doesn't exist): the results are somewhat
dim, since the red, green, and blue components of the image are split onto
separate lines instead of being mixed together in each pixel, and the image is
highly magnified, but it is capable of simulating over 29000 colors.  It is
mainly useful for getting an idea of what an image looks like without taking
the time required for a full (or even quick) remap into IIgs displayable format.
^~M9REMAP~M4TRUEINFO~M9

.M4TRUEINFO
True Color Image menu: Image info...
Shortcut: Apple-T

Calculates and displays the number of colors in the current true color image
(creating one from the current screen image if necessary) and displays a line
graph of color usage.  Not to be confused with the command of the same name in
the Screen Image menu, which performs similar functions for the current screen
image.  The color count only distinguishes between colors that correspond to
different ones of the IIgs's 4096 displayable colors: internally, up to 32768
colors and 256 gray levels are stored.  Also shown is a classification of the
image as either black & white, grayscale, or full color.
^~M9VIEWTRUE~M9ROTFLIP~M9

.M9ROTFLIP
True Color Image menu: Rotate/flip image...

Allows an image to be flipped along either axis and/or rotated by any multiple
of 90 degrees.  If the image size is over 800 by 600 only flips will be
allowed due to memory limitations.  If the operation you request includes any
rotation, please allow several minutes for the operation to complete.
^~M4TRUEINFO~M9EQUALIZE~M9

.M9EQUALIZE
True Color Image menu: Histogram equalization

Adjusts color values in the current true color image so that the number of
pixels at each possible intensity level are approximately equal.  This tends
to increase the contrast of an image, and is intended to help fix up images
that appear dark or washed out.  Often the result has too much contrast, but
this is generally an easier problem to touch up in a paint program than the
original lack of contrast.  This command works on any sort of image, but works
best if the image is grayscale or is going to be remapped to a grayscale
palette.
^~M9ROTFLIP~M9PURGE~M9

.M9PURGE
True Color Image menu: Discard true color image
Enabled only if there is actually a true color image currently in memory.
Lack of a true color image doesn't mean that you can't use True Color Image
menu commands, they will simply generate a true color image from the current
screen image.

True color images take extremely large amounts of memory to store (two bytes
per pixel: for example, a 640 by 200 image takes 256,000 bytes), so this
command is provided to let you free up that memory for other uses such as
printing.  The screen image is not affected.  It will also be useful in cases
where you want to use a True Color Image menu command on the result of a
previous Remap, rather than on the original true color image: for example, to
use the Image Info command to see exactly how many colors the screen image
ended up having, rather than how many colors there were in the file.
^~M9EQUALIZE~M8FONTLIST~M9

.M8FONTLIST
Extras menu: Available font list

Generates an image, up to one page in size, containing the name and size of
every font you have installed on your boot disk, each displayed in that
particular font.  If there are more fonts than will fit on a page, the More
Available Fonts command (next page) will generate additional pages.  A
printout of this image is a handy thing to have by the computer when you are
selecting a font in a word processor, paint program, etc.  The generated
listing for fonts such as Cairo that contain symbols instead of letters will
be unreadable: to get a meaningful printout of symbol fonts, see the Font Key
Chart command (two pages down).
^~M9PURGE~M8MOREFONTS~M8

.M8MOREFONTS
Extras menu: More available fonts
Enabled only if the last Available Font List or More Available Fonts command
failed to reach the end of the installed fonts on your system.

Continues the process started by Available Font List.  Several repetitions may
be needed if you have lots of fonts installed.

Note: when printing the output of any of these font listing commands, you
should NOT use the 'Better Text' option found in the options dialog for some
printers.  The result isn't text, it's an image of some text, and 'Better
Text' may actually make it look worse.
^~M8FONTLIST~M8KEYCHART~M8

.M8KEYCHART
Extras menu: Font key chart

Allows you to select any font, size, and style combination, then generates an
image showing all characters in that font along with their hex value (mainly
of use to programmers) and key equivalent.  The result is limited to one page,
so you may need to use a font size smaller than the largest available one in
order to fit all the characters onto the page.  If you only have extremely
large sizes of a particular font, you may even need to manually enter a size
that is a fraction of an actually available size to make it all fit.  In the
key equivalents, the Option key is represented by a solid Apple symbol.  Entry
of key equivalents must be exact: if it shows an 'A', an 'a' won't work!  The
equivalents are only valid if you have the key translation set to Standard in
the Alphabet section of the Control Panel NDA.
^~M8MOREFONTS~M8BANNER~M8

.M8BANNER
Extras menu: Print banner...

Generates banners with one or two lines of text in any installed IIgs fonts,
sizes, and styles.  Printout color can be selected as black, or grey to reduce
ribbon wear.  The banner can be previewed to see how many pages it will take,
and to see how the two lines (if selected) are aligned.  You MUST select 'No
gaps between pages' on the printer options dialog you get after giving this
command, or there will be gaps in the printout.  Don't select landscape
(sideways) printing, that's automatically taken care of, and don't select
Draft quality printing.  Hint: you'll generally want to select the largest
available size of fonts for best print quality, but if your banner has two
lines you may want to choose a font of another available size, or half or
double an available size, to control the relative size of the two lines.
^~M8KEYCHART~M8DEFDESK~M8

.M8DEFDESK
Extras menu: Revert to normal desktop
Enabled only if there is a nonstandard desktop pattern specified to the
system.

Undoes the effect of a Use As Desktop Background command (under the Screen
Image menu), a desktop background INIT file saved onto your boot disk, or any
other utility which changes the desktop pattern.  This will free up to 32K of
memory for program use.
^~M8BANNER~M8SYSINFO~M8

.M8SYSINFO
Extras menu: System info report...

Generates a snapshot of your system's current state and configuration,
including memory usage, installed desk accessories/drivers/etc., Control Panel
settings, and so on.  Exact interpretation of this data is beyond the scope of
this documentation, and requires some knowledge of IIgs programming.  The
results can optionally be saved to disk as a text file or printed out.  If you
are reporting an apparent problem with SuperConvert via U.S. or electronic
mail or by fax, it would be appreciated if you include a copy of this report,
generated on your computer under conditions as close to those that were in
effect at the time of the problem as possible: this will make it far easier for
us to locate problems that are specific to a certain system setup.
^~M8DEFDESK~~M8
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

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

The two windows that are present when the program is run contain lists of all
the graphics file formats that SuperConvert currently knows how to load and
save.  The load formats window (on the left) is divided into two lists: at the
top is a list of the types of computers (plus a category for formats not
specific to any one computer) for which there are supported formats.  Selecting
a computer type produces a list at the bottom containing the actual formats
for that computer: you must make a selection in both top and bottom lists to
choose a particular load format.  The selections in the formats windows are
only relevant when you are performing a related function: it doesn't matter
what save format you have selected when loading a picture, and neither
selection has any affect on non-disk related functions (display, remap, etc.).
^~~NONMENU-2~HOME

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

Clicking the 'Load' button in the Load Formats window is equivalent to selecting
the 'Load & convert...' menu command.  If you have selected multiple files to
load, it will change to a 'Load next' button, equivalent to the File menu item
of the same name, and change color slightly to give a visual indication that
there are more files to be loaded.

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~NONMENU-3~HOME

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

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-consistent, and a crash can occur.
^~NONMENU-2~NONMENU-4~HOME

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

After a picture has been successfully loaded, a new window will appear at the
lower right of the screen containing a copy of it.  The colors generally won't
be right in this window, since there is no way that the arbitrary colors of an
arbitrary picture can be displayed on the screen simultaneously with the fixed
colors of SuperConvert's menus and windows.  You can click and drag the mouse
in this window to select a rectangular area of the image: when you save the
conversion (except in desktop background format), only the selected area will
be saved.  Printing and other screen image operations will still use the whole
picture unless you give a Crop To Clipping Area command.  You can resize the
selection rectangle without starting over by holding down the Option key when
you click in the window: only the corner closest to the cursor will be moved.
^~NONMENU-3~~HOME
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

.REMAP
-=[ Remap options ]=-


\3~Graphics mode~RMODE~~~Other options~ROTHER

\3~Palette to use~RPALETTE~~~~

\3~Rendering algorithm~RALGORITHM~Starting the remap~RBUTTONS~Scaling~RSCALING
^~~~M9REMAP

.RMODE
Remap options: Graphic mode             Page 1 of 2

Selects the IIgs graphics mode to be used by the resulting screen image.  If
the image is going to be used in another program, you must generally select
the same mode here that the other program uses: consult its documentation for
requirements on images.

320 x 200, 16 colors: compatible with general-purpose paint programs, gives
good results with many-colored images.

640 x 200, 4 colors: results are generally not the best, except for grayscale
conversions and images that didn't have any more than 4 colors.  Compatible
with DeluxePaint in 640 mode.
^~~RMODE-2~REMAP

.RMODE-2
Remap options: Graphic mode             Page 2 of 2

640 x 200 dither mode: a unique feature of the IIgs that gives alternating
columns of pixels a separate 4-color palette, allowing a wider range of colors
while still giving high resolution.  Compatible with graphics-based word
processors and page layout programs, such as AppleWorks GS, and with
HyperStudio.

Multipalette modes: uses the IIgs's ability to assign different palettes to
each row of pixels.  Up to 16 palettes can be used, making it theoretically
possible to have 256 colors on the screen, but in practice there will be some
colors duplicated between palettes reducing the total.  Compatibility of
multipalette pictures is extremely limited except with simple display programs,
but they give the absolute best results for images with far more colors than
the IIgs can normally display.
^~RMODE~~REMAP

.RPALETTE
Remap options: Palette to use           Page 1 of 3

Some programs require a specific palette for pictures that it loads.  In other
cases, you may wish to use some special palette to achieve a specific effect.
The options available here depend on the selected graphics mode.

Default color: uses the standard color palette for the selected mode.  This
is generally the option you want for use with programs that use a fixed
palette, such as HyperStudio.  Not a good choice otherwise, as the default
palette may not have any good match for some colors in the image.  Not
available in multipalette modes.

Grayscale: uses a palette consisting entirely of shades of gray.  Good if the
image is going to be printed on a non-color printer, or is known to consist
only of shades of gray.  Not available in multipalette modes.
^~~RPALETTE-2~REMAP

.RPALETTE-2
Remap options: Palette to use           Page 2 of 3

Calculated: generates a palette that best represents the colors actually used
in the image.  The program insures that black and white are at their usual
positions at each end of the palette, and sorts the other colors in increasing
order of brightness.  If you don't need a specific palette, this option will
give the best results unless the image is grayscale or black & white (this
will be indicated at the top center of the Remap options dialog after a few
seconds), in which case you should select Grayscale palette instead, and use
the Error Diffusion algorithm (described later).

Stored palette: allows remapping to any specific palette.  Just load a picture
containing the desired palette, chose Store Palette from the Screen Image
menu, then you can remap images using this option.  It will only be available
in the same graphics mode as the picture the palette was stored from.
^~RPALETTE~RPALETTE-3~REMAP

.RPALETTE-3
Remap options: Palette to use           Page 3 of 3

Picture's current: uses the palette of the most recently loaded, remapped, or
otherwise generated screen image.  Available only in the graphics mode that
was used by that image.  Useful if you are using a True Color Image menu
command to achieve some effect such as scaling or rotation of a screen image,
in which case its original palette will be a good choice for the new image.

Get other: gives a dialog box containing various specialized palettes that
may occassionally be useful.  The list is different for each graphics mode, and
your most recent choice is remembered separately for each mode so you don't
have to reselect it each time you do a Remap.  If you have selected
multipalette mode, the options here control the technique used to generate the
palettes rather than specifying a particular palette.  Some of these
techniques are still experimental and may not perform very well.
^~RPALETTE-2~~REMAP

.RALGORITHM
Remap options: Rendering algorithm              Page 1 of 3

Selects the method used to select the colors of pixels in the remapped screen
image.  These options have no effect on the compatibility of the produced
image, but they may have a great effect on quality and suitability for special
uses.  The available options depend on the selected graphics mode and palette.

Closest match: for each pixel to be produced, chooses the single color in the
palette which is visually closest to it.  This is the only option that some
conversion programs give you: the results aren't good if the original image
contains many colors, since multiple original colors will end up having the
same color on the screen and therefore be indistinguishable.  Useful if you
know that all colors will have an exact, individual match (for example, if
you just flipped or rotated an image and are using Picture's Current palette),
and in some cases with images scaled down to a very small size.
^~~RALGORITHM-2~REMAP

.RALGORITHM-2
Remap options: Rendering algorithm              Page 2 of 3

Pattern dither: for each color in the image being remapped, chooses a pattern
of colors from the selected palette which together closely approximate the
original color.  This allows far more original colors to be distinguishable
than there are colors in the palette.  The patterns are 2x2 pixels in 320
mode, 4x2 in the two 640 mode options, and various sizes in the multipalette
options.  This is generally the option to choose unless the Error Diffusion
option is also available.

Error diffusion: a special option only available if you have selected a
grayscale or B&W palette, which can simulate up to 256 levels of gray.  It works
by calculating the inaccuracy in each pixel chosen, then adjusting the pixels
around it to compensate for that inaccuracy.  [more]
^~RALGORIITHM-1~RALGORITHM-3~REMAP

.RALGORITHM-3
Remap options: Rendering algorithm              Page 3 of 3

For example, if the color chosen for a particular pixel is a little too dark
because an exact match wasn't available, the nearby pixels will be lightened
by the same amount to compensate for it.

You should almost always choose error diffusion when available, unless the
image is a frame in an animation sequence.  The technique tends to produce
slightly different results in identical areas of images, due to different
levels of errors being diffused from non-identical areas: in an animation,
these slight changes will slow things down, possibly impair quality, and
greatly increase the memory and disk space requirements of the animation.

Technical note: the actual error diffusion algorithm currently being used is
standard Floyd-Steinberg, with serpentine scan.
^~RALGORITHM-2~~REMAP

.RSCALING
Remap options: scaling

Adjusts the size of the screen image to be produced.  Scaling is separately
adjustable for the horizontal and vertical directions from a reduction of 1:16
to an enlargement of 4:1.  The scaling is adjusted with the use of two scroll
bars, and is displayed both numerically (original and scaled sizes, along with
their ratio if it can be expressed by small integers) and graphically (a green
rectangle which shows the size of the resulting image relative to the screen,
represented by a purple grid).  If the scaled image is larger than the screen
image size limit, the word 'Clipped' appears, and the green rectangle splits
into two: a thin-bordered one which shows how big the image should be, and a
thick one which shows how much of it you'll actually get.  See the 'Other
Options' section for ways to adjust the behavior of scaling and clipping.
^~~~REMAP

.ROTHER
Remap options: Other options

These check boxes affect the way that image clipping and scaling work.

Integral scaling only (default is ON): normally the scaling scroll bars will
only allow you to select scalings that correspond to simple integer ratios
(like 1:2, 5:3, etc.).  If you wish to scale an image to an exact size that
isn't such a ratio, turn this option off.

Clip Horiz. before Vert. (default is ON): if the scaled image is larger than a
screen in both directions, and is over the 64K screen image size limit, this
option controls whether the horizontal or vertical size is reduced first in
order to make it fit within the limit.  There is no effect otherwise.

Clip to one screen (default is OFF): clips the scaled image down to the size
of the screen if it is larger in either direction.
^~~~REMAP

.RBUTTONS
Remap options: Starting the remap               Page 1 of 2

There are two ways to actually perform a remap operation from the remap
options dialog: normal, or quick.  A normal remap produces a screen image from
the true color image using all of the mode, palette, scaling, and other
options you have selected here.  This can take several minutes to complete:
the progress of the remapping process is displayed, and you can generally
abort the process by pressing Apple-period.  A quick remap takes only a few
seconds, but completely ignores all option settings and is limited to a single
screenfull of graphics: it is intended to give you a preview of what an image
looks like, so you have a better idea of what options to select for a normal
remap.  See the View Approximation command under the True Color Image menu for
another way to preview images.
^~~RBUTTONS-2~REMAP

.RBUTTONS-2
Remap options: Starting the remap               Page 2 of 2

Another way out of the remap options dialog is to click on Cancel: this
returns you to normal program operation with the existing true color image and
screen image (if there was one) intact.  If there wasn't a screen image, one
will be created that contains a message telling you that there isn't a real
screen image available at the moment.
^~RBUTTONS~~REMAP
 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
(_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_)

{ the end */