Import CiderPress web site
This commit is contained in:
Andy McFadden
parent
6cff755eef
commit
1c3afcd3ca
Binary file not shown.
|
After Width: | Height: | Size: 1.8 MiB |
|
|
@ -0,0 +1,480 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Change Log</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress Change Log</h1>
|
||||
<p><a href="index.htm">Return to main page</a>.</p>
|
||||
<p>CiderPress has five distinct components:</p>
|
||||
<ol>
|
||||
<li>[app] - the main Windows application. Holds MFC user interface code and an abstraction layer that makes SHK archives, BNY
|
||||
archives, and disk images look alike.</li>
|
||||
<li>[reformat] - file converters. Reformat text and graphics into
|
||||
formats more easily accessible under Windows. (This was part of [app]
|
||||
until v2.0.)</li>
|
||||
<li>[mdc] - the Multi-Disk Catalog application. A small bit of UI code
|
||||
that drives the DiskImg library.</li>
|
||||
<li>[util] - a library of functions shared between [app] and [mdc].</li>
|
||||
<li>[diskimg] - the disk image DLL. All access to disk images goes
|
||||
through two classes exported by this library. The DiskImg class
|
||||
imitates a device driver layer, abstracting away the different image formats and
|
||||
allowing access via
|
||||
track/sector, block, or nibble track. The DiskFS class imitates a File
|
||||
System Translator (FST), abstracting
|
||||
filesystem differences away to provide ProDOS-like file access on all
|
||||
supported filesystems. This library also runs under Linux.</li>
|
||||
</ol>
|
||||
<p>In addition, CiderPress uses the NufxLib library to access NuFX (ShrinkIt)
|
||||
archives, and zlib to compress and expand ".gz" and ".zip" files.</p>
|
||||
<h2>v3.0.1 - 4-Jan-2009</h2>
|
||||
<ul>
|
||||
<li>[reformat] Added Apple /// Business Basic support (David Schmidt)</li>
|
||||
<li>[diskimg] Fixed CP/M 3.x disk recognition, and added support for
|
||||
disks that store data in the first 3 tracks.</li>
|
||||
</ul>
|
||||
<h2>v3.0.0 - 25-Mar-2007</h2>
|
||||
<ul>
|
||||
<li>[app] Removed shareware registration screens.</li>
|
||||
<li>[reformat] Added support for DreamGrafix images (thanks to Jason
|
||||
Andersen).</li>
|
||||
</ul>
|
||||
<h2>v2.4.6 - 19-Feb-2007</h2>
|
||||
<ul>
|
||||
<li>[app] Corrected handling of "AT" and "TO" keywords
|
||||
when importing Applesoft BASIC from text.</li>
|
||||
<li>[app] Added preference to enable "bad Mac" archive handling.</li>
|
||||
<li>[general] Updated to NufxLib v2.2.0.</li>
|
||||
</ul>
|
||||
<h2>v2.4.5 - 3-Dec-2006</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Fixed a bug that deferred some floppy disk writes until the
|
||||
volume was closed. The bug increased the likelihood of a floppy being
|
||||
ejected while the filesystem was in a bad state.</li>
|
||||
</ul>
|
||||
<h2>v2.4.4 - 7-Oct-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Fixed bug in Applesoft BASIC import that caused it to use the
|
||||
shortest matching keyword instead of the longest (ON ERR vs. ONERR, HGR 2 vs. HGR2).</li>
|
||||
<li>[app] Applesoft import now capitalizes characters not in DATA/REM
|
||||
statements or quoted text (e.g. variable names).</li>
|
||||
<li>[reformat] Added recognition and conversion of "formatted" Magic
|
||||
Window documents.</li>
|
||||
<li>[reformat] Tweaked Merlin assembly source reformatter to track quoted text
|
||||
in operand field. This avoids inserting spaces into string constants
|
||||
for "laundered" Merlin sources and DOS ED/ASM sources.</li>
|
||||
</ul>
|
||||
<h2>v2.4.3 - 3-Sep-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Fixed a bug that prevented ShrinkIt archives on read-only volumes,
|
||||
such as a write-protected floppy disk, from being opened.</li>
|
||||
<li>[app] Fixed a bug that prevented files from being extracted to the root
|
||||
directory of a volume, e.g. "C:\".</li>
|
||||
<li>[diskimg] Fixed a bug that prevented ShrinkIt archives with odd extensions
|
||||
(e.g. "archive.txt") from being opened.</li>
|
||||
</ul>
|
||||
<h2>v2.4.2 - 16-Jul-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Use disk geometry call added in WinXP to get accurate sizes of
|
||||
physical disks for "open volume" display.</li>
|
||||
<li>[app] Added option to allow writes to physical disk 0. Needed on
|
||||
some Windows systems.</li>
|
||||
<li>[diskimg] Added support for Parsons Engineering FocusDrive partitioning.
|
||||
(Thanks go to Ranger Harke for providing detailed information.)</li>
|
||||
</ul>
|
||||
<h2>v2.4.1 - 17-Jun-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Disable HFS types for non-HFS disk images.</li>
|
||||
<li>[app] Don't crash on zero-length text files in Merlin format detector.</li>
|
||||
<li>[diskimg] Various cleanups.</li>
|
||||
</ul>
|
||||
<h2>v2.4 - 20-Feb-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Handle HFS file type and creator type in the "Edit
|
||||
Attributes" dialog. Applies to HFS disks and ShrinkIt archives.</li>
|
||||
<li>[app] Allow creation of HFS disk images.</li>
|
||||
<li>[app] Sanitize filenames for file list. This is mainly for HFS
|
||||
filenames with "Macintosh Roman" high-ASCII characters, but it
|
||||
also helps for some sector-edited ProDOS disks.</li>
|
||||
<li>[app] Added "Tab" as keyboard accelerator for file viewer.</li>
|
||||
<li>[app] Added "Paste Special" to Edit menu.</li>
|
||||
<li>[app] Show progress/cancel dialog when scanning disks. Especially
|
||||
handy for CD-ROMs with lots of ProDOS volumes.</li>
|
||||
<li>[app] Fixed handling of unquoted text in DATA statements for Applesoft BASIC import.</li>
|
||||
<li>[app] Fixed handling of "reserved" MS-DOS filenames (CON, PRN,
|
||||
etc). In
|
||||
addition to stuff like "con" we now fix up names like
|
||||
"con.1.txt".</li>
|
||||
<li>[reformat] Added reformatting of Merlin source code (tabbing the fields
|
||||
properly). It does a reasonable job of telling the difference between
|
||||
Merlin source and other kinds of text files.</li>
|
||||
<li>[diskimg] Added support for HFS volumes up to 2GB.</li>
|
||||
<li>[diskimg] Recognize certain not-quite-standard MacPart images. </li>
|
||||
</ul>
|
||||
<h2>v2.3.2 - 10-Jan-2006</h2>
|
||||
<ul>
|
||||
<li>[app] Added "find file" in file listing, and "find
|
||||
text" in file viewer.</li>
|
||||
<li>[app] Added D13 to Disk Image Converter and Bulk Disk Image Converter
|
||||
tools.</li>
|
||||
<li>[app] Added D13 to New Disk Image.</li>
|
||||
<li>[app] Fixed "Reopen" so it works with volumes.</li>
|
||||
<li>[diskimg] Added D13 support.</li>
|
||||
<li>[reformat] Added converters for LISA tokenized assembly source code.
|
||||
Three different versions, corresponding to LISA v2.x, v3.x, and v4.x/5.x,
|
||||
are supported.</li>
|
||||
</ul>
|
||||
<h2>v2.3.1 - 11-Dec-2005</h2>
|
||||
<ul>
|
||||
<li>[app] Added Applesoft program import from text file.</li>
|
||||
<li>[app] Added "Reopen" to file menu.</li>
|
||||
<li>[app] Fixed filename handling bug in paste function.</li>
|
||||
<li>[app] Fixed "overwrite all/none" feature (file extraction).</li>
|
||||
<li>[reformat] Fixed wayward assertion in BASIC conversion.</li>
|
||||
</ul>
|
||||
<h2>v2.3.0 - 17-Oct-2005</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Don't try to create disk images >= 2GB unless they're
|
||||
unadorned ProDOS.</li>
|
||||
<li>[diskimg] Correctly identify HFS images with close to 65535 allocation
|
||||
units.</li>
|
||||
<li>[diskimg] Handle a couple of weird ProDOS cases that were causing assert
|
||||
failures on specific disks.</li>
|
||||
<li>[app] Set up the "new disk" dialog properly after a blank disk
|
||||
image is created.</li>
|
||||
<li>[app] Added "reduce error checking" option for ShrinkIt
|
||||
archives. This enables "ignore CRC" and "ignore LZW/II
|
||||
length".</li>
|
||||
<li>[app] Added AppleLink Compression Utility (.ACU) support. This was
|
||||
done by reverse-engineering the file format, so there may be some
|
||||
unsupported features. For example, the format appears to support some
|
||||
sort of checksum on the data, but the method isn't yet known.</li>
|
||||
<li>[reformat] Identify and convert PrintShop GS monochrome clip art.</li>
|
||||
<li>[general] Update to latest versions of NufxLib and zlib DLLs.</li>
|
||||
</ul>
|
||||
<h2>v2.2.0 - 5-Jun-2005</h2>
|
||||
<ul>
|
||||
<li>[app] If we're trying to add two files with the same name to a NuFX
|
||||
archive, allow the user to rename the second one. (Note this is
|
||||
different from adding a file to an archive in which the file already
|
||||
exists. The fix is for a situation that can only happen when pathnames
|
||||
or file attribute strings are stripped;
|
||||
otherwise, CiderPress just stores the full Windows pathname.)</li>
|
||||
<li>[app] Conversion between fixed-length and variable-length nibble formats
|
||||
is done by converting to and from 16-sector data. This doesn't work
|
||||
for 13-sector disks, so don't allow it in the UI.</li>
|
||||
<li>[diskimg] Added basic support for FDI "raw" disk images (these are
|
||||
Apple II disks read on a PC floppy drive). 5.25" and 3.5"
|
||||
images are supported. Currently read-only.</li>
|
||||
<li>[mdc] Show approximate volume size, in KB.</li>
|
||||
</ul>
|
||||
<h2>v2.1.4 - 21-Mar-2005</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Scan for MicroDrive and Macintosh partitioning before CFFA.
|
||||
(Otherwise a CFFA-formatted volume that is re-partitioned for MicroDrive
|
||||
could still be recognized as CFFA until the original volume directories are
|
||||
overwritten.)</li>
|
||||
<li>[diskimg] Corrected MicroDrive partition length handling.</li>
|
||||
</ul>
|
||||
<h2>v2.1.3 - 16-Feb-2005</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Added support for ///SHH Systeme's MicroDrive partitioning.</li>
|
||||
<li>[diskimg] Detect and report ProDOS volume bitmap entries that indicate
|
||||
used blocks past the end of the disk.</li>
|
||||
<li>[app] Under Win9x/ME, newly-created disk images are now explicitly zeroed
|
||||
out. (Under Win2K/XP, new files are automatically filled with zeroes.)</li>
|
||||
<li>[app] Fixed a null reference when creating "blank" (unformatted)
|
||||
disk images.</li>
|
||||
</ul>
|
||||
<h2>v2.1.2 - 23-Dec-2004</h2>
|
||||
<ul>
|
||||
<li>[app] Increased maximum expected number of programs on cassette (was set
|
||||
to 8).</li>
|
||||
<li>[app] Don't allow spaces to be typed when entering registration key.</li>
|
||||
<li>[app] Added Ctrl-W as an alias for File->Close.</li>
|
||||
</ul>
|
||||
<h2>v2.1.1 - 2-Dec-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Correctly handle ZIP archives with truncated
|
||||
post-end-of-central-dir area.</li>
|
||||
<li>[app] Tweaked cassette decoder slightly. Added new conversion mode.</li>
|
||||
<li>[app] Allow changing of filename separator character in NuFX archives.</li>
|
||||
<li>[app] Allow changing file type and aux type on DOS 3.2/3.3 disks.
|
||||
(Use at your own risk.)</li>
|
||||
<li>[app] Fixed display of file type description in "edit
|
||||
attributes" dialog for DOS and Pascal disks.</li>
|
||||
<li>[reformat] Corrected spacing on "illegal" keywords in Integer
|
||||
BASIC output.</li>
|
||||
</ul>
|
||||
<h2>v2.1 - 16-Nov-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Added support for 160K DOS.MASTER partitions embedded in 800K ProDOS
|
||||
disks.</li>
|
||||
<li>[diskimg] Binary files added or pasted to DOS disks no longer lose their
|
||||
aux type.</li>
|
||||
<li>[diskimg] Zero-length binary files are now properly created on DOS disks.</li>
|
||||
<li>[app] Added cassette tape WAV decoder.</li>
|
||||
<li>[app] Double-clicking on a file without a data fork now correctly opens the resource
|
||||
fork for viewing.</li>
|
||||
<li>[app] Fixed bug that caused cutting & pasting DOS files into a ProDOS
|
||||
directory to be named incorrectly.</li>
|
||||
<li>[reformat] Added CP/M text conversion (stops at first Ctrl-Z).</li>
|
||||
<li>[reformat] Added monitor-style machine code listing (//e and IIgs
|
||||
modes). Includes NiftyList annotation.</li>
|
||||
<li>[reformat] Added generic IIgs text file (GWP) conversion. Accented
|
||||
characters and some symbols are converted from the IIgs font to the Windows
|
||||
font.</li>
|
||||
<li>[reformat] Added Teach (GWP $5445) conversion. Found a font mapping
|
||||
that looks pretty reasonable.</li>
|
||||
<li>[reformat] Added AppleWorksGS Word Processor (GWP $8010) conversion.</li>
|
||||
<li>[reformat] Added Print Shop and Print Shop GS clip art to BMP conversion.</li>
|
||||
<li>[reformat] Fixed yet another bug related to AWP margins.</li>
|
||||
</ul>
|
||||
<h2>v2.0.1 - 18-Oct-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Improved CP/M disk image recognition.</li>
|
||||
<li>[diskimg] CP/M files with bad block lists are now displayed as
|
||||
"damaged".</li>
|
||||
<li>[diskimg] Corrected handling of CP/M files with the same name but
|
||||
different user numbers.</li>
|
||||
<li>[app] Corrected version-dependent behavior in Rich Edit control that was
|
||||
causing the file viewer "print" function to hang, particularly
|
||||
when used to print "raw" files. (Thanks go to Allan Sutton
|
||||
for some marathon e-mail ping-pong sessions while tracking this down.)</li>
|
||||
<li>[app] Don't try to copy damaged files.</li>
|
||||
<li>[app] Added OFN_HIDEREADONLY to all "save" dialogs. For
|
||||
some reason Win98 was allowing the user to set the "open as read
|
||||
only" flag, which makes no sense when saving a file.</li>
|
||||
</ul>
|
||||
<h2>v2.0.0 - 13-Oct-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Added access to logical and physical volumes under Win2K/XP and
|
||||
Win9x/ME.</li>
|
||||
<li>[diskimg] Added SPTI and ASPI interfaces for reading CD-ROM drives.</li>
|
||||
<li>[diskimg] Added CFFA-partitioned volume support for CF cards.</li>
|
||||
<li>[diskimg] Added Macintosh disk partition support for CD-ROMs and hard
|
||||
drives.</li>
|
||||
<li>[diskimg] Added HFS and MS-DOS FAT recognition.</li>
|
||||
<li>[diskimg] Added ability to delete and rename files, rename volumes, set
|
||||
file info, and create directories in ProDOS. Generalized support for adding files.</li>
|
||||
<li>[diskimg] Added add/delete/rename/set-file-info/rename-volume for DOS3.3.</li>
|
||||
<li>[diskimg] Added add/delete/rename/set-file-info/rename-volume for UCSD
|
||||
Pascal.</li>
|
||||
<li>[diskimg] Switched to 64-bit file offsets throughout, for access to images
|
||||
of 2GB+ hard drives.</li>
|
||||
<li>[diskimg] Upgraded to zlib DLL v1.2.1. Added workaround for damaged gzip
|
||||
files that zlib v1.1.4 didn't complain about.</li>
|
||||
<li>[diskimg] Upgraded to NufxLib DLL v2.0.3. Minor bug fixes and
|
||||
feature tweaking.</li>
|
||||
<li>[diskimg] Added support for single-entry ZIP archives with disk images
|
||||
inside.</li>
|
||||
<li>[diskimg] Corrected handling of ProDOS volume name capitalization flags.</li>
|
||||
<li>[diskimg] Added notes to disk image objects, so that warnings and comments
|
||||
about filesystem damage can be presented in the "archive info"
|
||||
screen. Added notation of "suspicious" files, e.g. ProDOS
|
||||
files whose blocks fall within the limits of the image file but outside the
|
||||
claimed number of blocks in the ProDOS volume header.</li>
|
||||
<li>[diskimg] Updated 2MG handling to support comments and "creator"
|
||||
chunks.</li>
|
||||
<li>[diskimg] Improved recognition of DOS 3.2/3.3 disks with short catalog
|
||||
tracks.</li>
|
||||
<li>[app] Added "open volume" command for CF cards, floppies, CD-ROM
|
||||
drives, and Apple II hard drives.</li>
|
||||
<li>[app] Added tool to copy whole disks or partitions to and from Windows volumes.</li>
|
||||
<li>[app] Added disk image creation tool (DOS33, Pascal, ProDOS, blank).</li>
|
||||
<li>[app] Added a dialog to the disk sector viewer that lets the user choose to open
|
||||
a disk image file, a Windows volume, or open the image that's currently
|
||||
being viewed by the main application.</li>
|
||||
<li>[app] Added menu interaction for adding, deleting, and renaming files to
|
||||
"disk archive" interface layer.</li>
|
||||
<li>[app] Added copy & paste between archives and disk images, with
|
||||
automatic DOS text conversion.</li>
|
||||
<li>[app] Added "archive info" feature. Displays information
|
||||
about currently open archive or disk image.</li>
|
||||
<li>[app] Added "save changes" feature. Useful for flushing
|
||||
changes to compressed disk images.</li>
|
||||
<li>[app] Make a "ding" sound after successful completion of most
|
||||
operations.</li>
|
||||
<li>[app] Moved disk image preferences to their own tab. Moved "use
|
||||
sparse allocation" and "allow lower case" from the
|
||||
file-to-disk converter to the main Preferences section, since they now apply
|
||||
to other operations (like adding files to ProDOS disks, and creating blank
|
||||
ProDOS disks).</li>
|
||||
<li>[app] Redesigned file viewer. Added buttons for
|
||||
data/resource/comment parts, and a drop list from which format options can
|
||||
be selected. Added a "print" button.</li>
|
||||
<li>[app] Fixed a long-standing bug that would occasionally prevent a graphic
|
||||
from being displayed as a bitmap.</li>
|
||||
<li>[app] Added UI for renaming volumes and creating subdirectories.</li>
|
||||
<li>[app] Added EOL conversion to Add Files dialog when adding
|
||||
files to disk images. Added a fourth option, "convert by
|
||||
type", to Add Files and Extract Files.</li>
|
||||
<li>[app] Added EOL Scanner tool.</li>
|
||||
<li>[app] Added 2MG properties edit tool.</li>
|
||||
<li>[app] Show name of registered user in title bar, or
|
||||
"(unregistered)". Subtle reminder to
|
||||
register the product.</li>
|
||||
<li>[app] Hitting DEL with no files selected no longer offers to delete all
|
||||
files.</li>
|
||||
<li>[reformat] Created [reformat] library by splitting the code out of the
|
||||
main application. Redesigned the API.</li>
|
||||
<li>[reformat] Added a formatter for Pascal code files (PCD). It just breaks
|
||||
the file into segments and dumps each individually.</li>
|
||||
<li>[reformat] Added converter for Paintworks PNT/$0000 SHR graphics.</li>
|
||||
<li>[reformat] Added color syntax highlighting to Applesoft/Integer converters
|
||||
(it used to show keywords in boldface; this is better).</li>
|
||||
<li>[reformat] AppleWorks WP embedded codes, like "insert today's date
|
||||
here", are now displayed in blue text.</li>
|
||||
<li>[reformat] AppleWorks WP left/right margin commands now work better.
|
||||
"Full justify" has been added, though you won't see it unless you
|
||||
paste the text into Microsoft Word.</li>
|
||||
</ul>
|
||||
<h2>v1.2.5 - 7-May-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Added support for TrackStar 40-track ".app" nibble
|
||||
images.</li>
|
||||
<li>[diskimg] Added workaround for slightly broken 'WOOF' 2mg files.</li>
|
||||
<li>[diskimg] Added "DOS 3.3 ignore checksum" to set of parameters
|
||||
available in the sector viewer. Useful for looking at nibble formats
|
||||
with bad (but perhaps partially recoverable) sectors with failing data
|
||||
checksums.</li>
|
||||
<li>[app] Added TrackStar to disk conversion tools. Added warning when
|
||||
converting between nibble formats with differing track lengths.</li>
|
||||
</ul>
|
||||
<h2>v1.2.4 - 10-Mar-2004</h2>
|
||||
<ul>
|
||||
<li>[diskimg] Updated creation of DiskCopy 4.2 images to match output from
|
||||
Mac. Specifics: volume name of ProDOS disk is now stored (instead of
|
||||
"not a Macintosh disk"); dummy 19K "tag" section has
|
||||
been added; UNIDOS disks are stored in DOS sector order rather than ProDOS;
|
||||
length byte on "not a Macintosh disk" string incremented.</li>
|
||||
<li>[diskimg] Fixed a problem preventing auto-detection of some RDOS
|
||||
disks. Only caused problems in non-debug builds (ugh).</li>
|
||||
<li>[app] Updated the disk conversion and bulk disk conversion tools to handle
|
||||
the above.</li>
|
||||
<li>[nufxlib] NufxLib was updated to v2.0.2. The new version handles
|
||||
poorly-constructed archives created by a very old version of ShrinkIt.</li>
|
||||
</ul>
|
||||
<h2>v1.2.3 - 16-Oct-2003</h2>
|
||||
<ul>
|
||||
<li>[app] Pascal "xdsk" files are now shown with type $01 (BAD).</li>
|
||||
<li>[nufxlib] NufxLib was updated to v2.0.1, which includes a workaround for
|
||||
bad GS/OS option lists as well as the ability to skip over junk at the start
|
||||
of the archive (e.g. vestigal MacBinary headers or HTTP messages, common on
|
||||
FTP sites).</li>
|
||||
</ul>
|
||||
<h2>v1.2.2 - 22-Jul-2003</h2>
|
||||
<ul>
|
||||
<li>[app] Added AppleWorks spreadsheet to CSV conversion.</li>
|
||||
<li>[app] Added MacPaint graphics conversion. Many of my test files seem
|
||||
to have some amount of corruption, so dealing with that gracefully is
|
||||
important.</li>
|
||||
<li>[app] Fixed a bug that prevented extraction to network volumes from working
|
||||
correctly.</li>
|
||||
<li>[diskimg] Fixed up the CP/M implementation a bit. File lengths are
|
||||
now determined more accurately, and the "read-only" flag is
|
||||
obeyed. Sparse files are handled correctly now.</li>
|
||||
</ul>
|
||||
<h2>v1.2.1 - 14-Jul-2003</h2>
|
||||
<ul>
|
||||
<li>[app] Added S-C Assembler to text conversion.</li>
|
||||
<li>[app] Added AppleWorks database to CSV conversion.</li>
|
||||
</ul>
|
||||
<h2>v1.2 - 08-Jun-2003</h2>
|
||||
<ul>
|
||||
<li>[app] Added DDD to disk conversion tool.</li>
|
||||
<li>[app] Further relaxed the "relaxed" criteria for identifying
|
||||
hi-res images on DOS disks. We no longer insist that the auxtype be
|
||||
$2000 or $4000.</li>
|
||||
<li>[app] Fixed wayward assert() during decoding of Apple Preferred Format
|
||||
3200-color images.</li>
|
||||
<li>[app] Show empty comments with a different icon, so you can immediately
|
||||
tell when a comment has something interesting in it.</li>
|
||||
<li>[app] Added "edit attributes" for NuFX archive entries.
|
||||
Uses the NuSetRecordAttr interface to change file type, auxtype, and access.</li>
|
||||
<li>[app] Fixed Apple Preferred Format graphics handling to support images up
|
||||
to 1024x1024.</li>
|
||||
<li>[app] Show folders in file list (only possible on ProDOS disk
|
||||
images). Allow them to be selected and viewed, but ignore them when
|
||||
extracting files.</li>
|
||||
<li>[app] When creating a new archive, existing files would not be overwritten
|
||||
even if you said "yes" to overwriting them. This is fixed.</li>
|
||||
<li>[app] Added conversion from disk image to file archive. Extract
|
||||
files, converting DOS text where needed, and stuff them into a new ShrinkIt
|
||||
archive.</li>
|
||||
<li>[app] Added framework for conversion of file archive to disk archive.</li>
|
||||
<li>[app] Save/restore the checkboxes for the set of threads selected in the "view"
|
||||
dialog.</li>
|
||||
<li>[app] Added file viewer converters for ProDOS directories (dump as 80-column
|
||||
"catalog" command) and resource forks (break down into individual
|
||||
resources and dump as hex).</li>
|
||||
<li>[app] Added bulk disk image conversion. This required a minor
|
||||
refactoring of the disk image converter and some additional UI and logic.</li>
|
||||
<li>[diskimg] Added RDOS support. Includes 13-sector, 16-sector, and
|
||||
"cracked" 13-to-16-sector formats.</li>
|
||||
<li>[diskimg] Added DDD support. Output is identical to DDD Pro
|
||||
v1.1. Getting it to work with DOS versions of DDD (e.g. DDD 2.1) is a
|
||||
bit of a chore because the format was poorly designed, but it works.</li>
|
||||
<li>[diskimg] Expanded disk usage map entries from 4 bits to 8. A
|
||||
hypothetical graphical disk usage display would have more interesting things
|
||||
to show.</li>
|
||||
<li>[diskimg] Reshuffled internal handling of open files.</li>
|
||||
<li>[diskimg] Added ability to format an arbitrarily-sized ProDOS volume
|
||||
(including boot blocks).</li>
|
||||
<li>[diskimg] (Big) Added limited support for adding files to a ProDOS volume.</li>
|
||||
<li>[diskimg] Create a "fake" entry for the ProDOS volume directory.</li>
|
||||
</ul>
|
||||
<h2>v1.1 - 17-Apr-2003</h2>
|
||||
<ul>
|
||||
<li>[app] Added disk conversion tool (mostly UI).</li>
|
||||
<li>[app] Added SST merge tool (UI and implementation).</li>
|
||||
<li>[app] Rewrote preferences implementation to be less annoying. Use
|
||||
"My Documents" as default folder.</li>
|
||||
<li>[app] Added preferences for three folders: open archive, add file, and
|
||||
extract file. These are now applied to the standard file dialogs, so
|
||||
the folders used most often are saved.</li>
|
||||
<li>[app] Replaced "SPARSESPARSESPARSE" block-fill message with a
|
||||
simple message that tells you the block is sparse. Much easier to read
|
||||
and understand. Did similar things for empty files on CP/M disks and
|
||||
unreadable sectors on NIB images.</li>
|
||||
<li>[app] Added nibble viewer to block/sector viewer.</li>
|
||||
<li>[app] Added sector parm selection to disk viewer. Change from DOS
|
||||
3.2 to DOS 3.3 on the fly.</li>
|
||||
<li>[app] Added "open as disk image" to "Actions" menu and
|
||||
right-click menu. This is very handy for disk images stored inside
|
||||
other disk images, e.g. a Copy ][+ $F1 image file stored inside a ShrinkIt
|
||||
archive.</li>
|
||||
<li>[diskimg] Added support for .NIB and .NB2 images. This required
|
||||
adding 6&2 and 5&3 encoders and decoders, a flexible sector
|
||||
read/write function, nibble track read/write/format, and some nibble image
|
||||
analysis tools.</li>
|
||||
<li>[diskimg] Added ability to create writeable disk images and copy data into
|
||||
them. All formats that can be opened can also be created.</li>
|
||||
<li>[diskimg] Generalized gzip wrapper handling so it works with everything
|
||||
(except NuFX, due to NufxLib limitations).</li>
|
||||
<li>[diskimg] Altered disk image recognition functions so odd-sized ProDOS
|
||||
volumes are handled.</li>
|
||||
<li>[diskimg] Allow images to be accessed by block, sector, or nibble track,
|
||||
with one or more methods disabled (e.g. no nibble access on 800K disks, and
|
||||
no block access on 13-sector nibble images).</li>
|
||||
<li>[diskimg] Due to radical interface changes, DLL renamed to
|
||||
"diskimg2".</li>
|
||||
<li>[mdc] Show the filename in the title bar. Useful if you're scanning
|
||||
a large set of images in the background because it causes the icon bar at
|
||||
the bottom of the screen to update. (Probably only necessary if the
|
||||
window is minimized, though there's currently no way to do that.)</li>
|
||||
</ul>
|
||||
<h2>v1.0 - 19-Mar-2003</h2>
|
||||
<ul>
|
||||
<li>Initial release.</li>
|
||||
</ul>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
@ -0,0 +1,214 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress FAQ</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress FAQ</h1>
|
||||
|
||||
<p>Some common questions and solutions. <a href="index.htm">Return to main
|
||||
page</a>.</p>
|
||||
<h3>Why can't I open my MicroDrive CF card?</h3>
|
||||
<p>If the CF card was previously formatted for
|
||||
Windows or a digital camera, it may still look like a valid volume,
|
||||
and Windows will assign a drive letter to it even though the card holds
|
||||
nothing but Apple II data. It may even allow you to try to open files with
|
||||
garbled names. If try to use the CiderPress Open Device or Volume Copier
|
||||
features by selecting the drive letter, you won't see your Apple II data.
|
||||
<p>All you need to do is open the card as a physical (numbered) device
|
||||
rather than a logical (lettered) device. Better yet, update the CF card
|
||||
with the newer version of the utilities, available from <a href="http://reactivecomputers.gotdns.com/MicroDrive/">Reactive
|
||||
Computers</a>; this will clear out the Windows volume data so the problem (and some others)
|
||||
don't arise.
|
||||
|
||||
<h3>How do I transfer my Apple II disks to my PC?</h3>
|
||||
<p>This isn't something that CiderPress currently helps with. There are,
|
||||
however, a number of useful utilities, as well as sites with disk images.
|
||||
Check the <a href="http://home.swbell.net/rubywand/A2FAQs1START.html">comp.sys.apple2
|
||||
FAQ</a> site for information, especially <a href="http://home.swbell.net/rubywand/Csa2T1TCOM.html">this
|
||||
section</a>. ADT is probably the most popular program, but using ShrinkIt
|
||||
to create disk images and transferring them over a null modem cable or AppleTalk
|
||||
network works too.</p>
|
||||
<p>If you have a SuperDrive or floptical drive on your Apple II, you can read
|
||||
and write 1.4MB floppy disks. To copy disk images, just create images with ShrinkIt, copy them
|
||||
to a 1.4MB ProDOS-formatted floppy, then copy the disk images off with
|
||||
CiderPress. If
|
||||
you're planning to use them with an emulator right away, copy them off with the
|
||||
"bulk" disk image converter so that they'll be in the format your
|
||||
emulator prefers.</p>
|
||||
<p>While CiderPress supports ProDOS-formatted 720KB and 1.4MB 3.5" floppy
|
||||
disks, it cannot support 800KB 3.5" disks or 140K 5.25" disks due to
|
||||
limitations of the disk drives used on PCs. (A program called "<a href="http://www.oldskool.org/disk2fdi/">disk2fdi</a>"
|
||||
provides some support for reading 5.25" and 3.5" Apple II disks on the
|
||||
PC.)</p>
|
||||
<h3>How do I transfer disk images to physical disks on a real Apple II?</h3>
|
||||
<p>You need to convert the disk image to a format accepted by software on the
|
||||
Apple II and then transfer it over. Check the links in the previous answer
|
||||
-- software that helps you copy disk images to the PC will usually help you copy
|
||||
them back. </p>
|
||||
<h3>Where can I find an Apple II emulator?</h3>
|
||||
<p>Check the <a href="http://directory.google.com/Top/Computers/Emulators/Apple/Apple_II/">Google
|
||||
directory</a> for a list of sites. AppleWin and KEGS are the most popular
|
||||
for Windows.</p>
|
||||
<h3>Why is my disk image opening in read-only mode?</h3>
|
||||
<p>Possible reasons:</p>
|
||||
<ul>
|
||||
<li>The file is marked "read only" in Windows. This is common
|
||||
for disk images copied off of CD-ROMs. Find the file in Windows
|
||||
Explorer, right click on it, select Properties, and make sure the "Read
|
||||
only" box is unchecked.</li>
|
||||
<li>When you open the disk image, make sure the "read only" checkbox
|
||||
in the file open dialog isn't checked.</li>
|
||||
<li>Disk images with damaged filesystems are opened read-only to avoid
|
||||
compounding existing problems. Open the file and hit Ctrl-I to bring
|
||||
up the Archive Info screen. If it says "damaged: yes", check
|
||||
the Notes section for an explanation.</li>
|
||||
<li>If you're opening a physical disk with "Open Volume" or the
|
||||
Volume Copier, un-check the "read only" checkbox. Read-only
|
||||
mode is enabled by default for physical disks, but you can change this from
|
||||
the "Disk Images" tab of the "Preferences" interface.</li>
|
||||
</ul>
|
||||
<h3>When I paste files, the disk fills up almost immediately!</h3>
|
||||
<p>When pasting files into a ProDOS disk image, you can choose the directory
|
||||
into which the files should go. If the disk image doesn't have any
|
||||
subdirectories, all of the files will be pasted into the volume directory, which
|
||||
only holds 51 files. You need to paste the files into a subdirectory
|
||||
("folder"), which can hold an effectively unlimited number of files.</p>
|
||||
<p>If you were copying from a set of nested subdirectories, and you want to preserve the
|
||||
original structure, disable the "Strip pathnames when pasting
|
||||
files" option in Edit->Preferences (or paste with Edit->Paste Special
|
||||
and select "keep full pathnames"). If you were copying from a
|
||||
single subdirectory, or you want all of the files to be pasted into one place,
|
||||
you will need to create a subdirectory with Actions->Create Subdirectory
|
||||
first, and then paste into that.</p>
|
||||
<p>You can see how much free space a disk has with the File->Archive Info
|
||||
feature (just hit Ctrl-I after opening the disk image).</p>
|
||||
<h3>Why isn't my disk image recognized?</h3>
|
||||
<p>CiderPress tries to correctly identify the sector ordering and filesystem of
|
||||
every disk image, but in some cases it's not possible. The most common
|
||||
reason is that the disk image isn't in a recognized format (DOS, ProDOS, Pascal,
|
||||
CP/M, or RDOS). Many games were shipped with custom disk layouts, usually for
|
||||
copy protection reasons.</p>
|
||||
<p>In some cases, disks with modified versions of standard file systems will fail to be
|
||||
recognized. This is most common with "customized" DOS 3.3 disks
|
||||
that have abbreviated catalog tracks.</p>
|
||||
<p>Disk images that can't be opened with "Open..." can usually be
|
||||
opened with the Disk Viewer in the Tools menu. If the Disk
|
||||
Viewer can't open the image, then either it's stored in a file format CiderPress doesn't
|
||||
support, or it's not a disk image at all.</p>
|
||||
|
||||
<h3>How do I open a modified or slightly damaged DOS 3.3 disk?</h3>
|
||||
|
||||
<p>The disk format auto-detection algorithms rely on finding the disk catalog
|
||||
track. If it's very short, or partially damaged, CiderPress won't
|
||||
recognize the disk. In some circumstances you can specify the format
|
||||
manually:</p>
|
||||
|
||||
<ul>
|
||||
<li>In Edit->Preferences->Disk Images, select "Confirm disk image
|
||||
format".</li>
|
||||
<li>Open the disk image with File->Open.</li>
|
||||
<li>When the disk image format dialog appears, select "DOS sector
|
||||
ordering" and "DOS 3.3". (If that doesn't work, try
|
||||
"ProDOS sector ordering".)</li>
|
||||
</ul>
|
||||
<p>This can also be used to select which half of a hybrid DOS/ProDOS image to
|
||||
use.</p>
|
||||
|
||||
<h3>Why does CiderPress say my files are "suspicious" or
|
||||
"damaged"?</h3>
|
||||
|
||||
<p>CiderPress runs an extensive set of consistency checks on disk images before
|
||||
it will allow them to be modified. Problems found might indicate damaged
|
||||
files, or might only indicate the potential for damage.</p>
|
||||
|
||||
<p>For example, if some of the sectors of a file are not marked as "in
|
||||
use", the next file you copy to the disk could overwrite parts of the
|
||||
existing file, corrupting it. CiderPress prevents you from making
|
||||
damage worse by treating such disks as "read only".</p>
|
||||
|
||||
<p>Some DOS 3.3 software shipped with "title" files in the
|
||||
catalog. These were only meant to highlight portions of the catalog, not
|
||||
hold data, so sometimes the software authors would use one sector in the catalog
|
||||
track as the "storage" for all of the titles. CiderPress will
|
||||
detect multiple files sharing the same storage, and mark them as
|
||||
"suspicious", meaning that their data might be present but that
|
||||
altering the files could have unforeseen consequences.
|
||||
"Suspicious" disks are also marked "read only".</p>
|
||||
|
||||
<h3>Why are my .hdv images opening read-only?</h3>
|
||||
|
||||
<p>Some ".hdv" files are undersized, and grow as you add files to
|
||||
them. CiderPress thinks these are damaged, because the size that the
|
||||
volume claims to be is much larger than the actual number of blocks in the
|
||||
file. You can tell what the difference is by opening the volume and
|
||||
selecting File->Archive Info (or hit Ctrl-I).</p>
|
||||
|
||||
<p>To be able to write to these disks with CiderPress, you need to expand them
|
||||
to their full size. One approach is to force your emulator to expand
|
||||
them. To do this, launch a ProDOS block editor within the emulator, and
|
||||
open the last block on the disk (e.g. 65534 on a 32MB image). Read the
|
||||
block and write it back.</p>
|
||||
|
||||
<p>Another approach is to create a new volume and copy all of the files
|
||||
over. To do this:</p>
|
||||
|
||||
<ol>
|
||||
<li>Create a new disk image with File->New Disk Image. Select ProDOS
|
||||
and 32MB.</li>
|
||||
<li>Open the old disk image. Select all files with Edit->Select All
|
||||
(or hit Ctrl-A).</li>
|
||||
<li>Open the new disk image. Select Edit->Paste Special, and choose
|
||||
"Keep full pathnames". (If you don't have "strip
|
||||
pathnames when pasting files" set in Edit->Preferences, you can just
|
||||
use Edit->Paste, or hit Ctrl-V.)</li>
|
||||
</ol>
|
||||
<p>That's it. For some emulators it will be necessary to close the file in
|
||||
CiderPress (File->Close or Ctrl-W) and then rename it from ".po" to ".hdv".</p>
|
||||
|
||||
<h3>How do I use DiskCopy 4.2 images on a Macintosh?</h3>
|
||||
|
||||
<p>Some (all?) DiskCopy utility programs on the Macintosh require the correct
|
||||
file type and creator type values to be set on disk image files. If you
|
||||
try to open a ".dsk" file with a generic file type, you'll get an
|
||||
error message claiming that the file format isn't recognized. The correct values
|
||||
are 'dImg' for the file type and 'dCpy' for the creator.</p>
|
||||
|
||||
<p>You can use ResEdit, BBEdit, or Norton Utilities to change the type and
|
||||
creator. If you're using PC Exchange on the Macintosh to copy the images
|
||||
off of Windows-formatted disks, you can configure it to set the type
|
||||
automatically for ".dsk" files. Take a look at <a href="http://www.macwindows.com/tutfiles.htm">this
|
||||
page</a> for more information.</p>
|
||||
|
||||
<h3>How do I format a floppy disk with ProDOS?</h3>
|
||||
|
||||
<p>Copy a 720KB or 1.4MB ProDOS disk image to a PC-formatted floppy disk with
|
||||
"Volume Copier" in the Tools menu. If you don't have a disk
|
||||
image handy, create one with File->New->Disk Image.</p>
|
||||
|
||||
<p>CiderPress does not perform low-level disk formatting, e.g. reformatting an
|
||||
800K disk for 720K. From Windows, open My Computer, right-click on the
|
||||
floppy drive, and select "Format".</p>
|
||||
|
||||
<h3>Can I use CiderPress on a non-Windows system?</h3>
|
||||
|
||||
<p>Sort of. It works reasonably well under Wine (<a href="http://winehq.org/">http://winehq.org/</a>),
|
||||
though you need a copy of "windows\system32\mfc42.dll" from a Windows
|
||||
system. Wine does crash occasionally, but many of the features work.</p>
|
||||
|
||||
<p>Windows emulators, such as <a href="http://www.vmware.com/">VMware</a>, work
|
||||
fully.</p>
|
||||
|
||||
<h3>Is there anything that CiderPress *doesn't* do?!</h3>
|
||||
|
||||
<p>Yes. Take a look at our <a href="requested-features.htm">feature request list</a>.</p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
@ -0,0 +1,247 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<meta name="description" content="faddenSoft Software">
|
||||
<title>CiderPress Features</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress Features</h1>
|
||||
|
||||
<p><a href="index.htm">Return to main page</a>.</p>
|
||||
|
||||
<p><b><a name="shrinkit"></a>Access to ShrinkIt Archives</b></p>
|
||||
<p>Full access to ShrinkIt archives (.shk, .sdk, .bxy, .sea, .bse) is provided,
|
||||
including:</p>
|
||||
<ul>
|
||||
<li>View files without having to extract them first. Special converters
|
||||
are provided for several popular file formats.</li>
|
||||
<li>Extract files and directories, optionally converting them. File type
|
||||
information and resource forks can be preserved in Windows, using the <a href="http://www.nulib.com/library/nulib2-preserve.htm">method</a>
|
||||
developed for use in NuLib2. It's possible to extract all files from a
|
||||
GS/OS boot disk to Windows, add them to a new disk image, and then boot that
|
||||
image in an emulator.</li>
|
||||
<li>Add files, directories, and disk images.</li>
|
||||
<li>Convert the contents of a ShrinkIt file archive directly to a ProDOS disk image, and
|
||||
vice-versa.</li>
|
||||
<li>Re-compress entries with a different algorithm. All compression
|
||||
methods defined in the NuFX specification are supported, as well as gzip
|
||||
"deflate".</li>
|
||||
<li>Rename entries.</li>
|
||||
<li>Test entries or whole archives.</li>
|
||||
<li>Delete entries.</li>
|
||||
<li>Add, update, and delete comments.</li>
|
||||
<li>Edit file type, aux type, and access permissions of archived files. </li>
|
||||
<li>Print file listings.</li>
|
||||
<li>Copy & paste files between archives and disk images.</li>
|
||||
</ul>
|
||||
<p>It's like having "ShrinkIt for Windows". Viewing and extracting files from Binary II files
|
||||
(.bny, .bqy) and AppleLink Compression Utility archives (.acu) is also
|
||||
supported. ShrinkIt archive access is provided by NufxLib, the library used by the
|
||||
<a href="http://www.nulib.com/">NuLib2</a> archive utility since early 2000.
|
||||
Archives created with NufxLib are nearly identical to those created with GS/ShrinkIt.</p>
|
||||
<p><b><a name="disks"></a>Disk Image Support</b></p>
|
||||
<p>CiderPress has the ability to identify nearly all Apple II disk image formats
|
||||
automatically. Supported file formats include:</p>
|
||||
<ul>
|
||||
<li>Universal Disk Images (.2mg, .2img)</li>
|
||||
<li>DiskCopy 4.2 (.dsk)</li>
|
||||
<li>Copy II Plus (.img)</li>
|
||||
<li>Sim //e HDV images (.hdv)</li>
|
||||
<li>TrackStar 40-track images (.app)</li>
|
||||
<li> Dalton's Disk Disintegrator (DDD v2.1+, DDD Pro v1.1+) (.ddd)</li>
|
||||
<li>Raw FDI images of 5.25" and 3.5 disks (read-only) (.fdi)</li>
|
||||
<li>Unadorned sector-format files (.po, .do, .d13, .raw, .hdv, .iso, most .dc6)</li>
|
||||
<li>Unadorned nibble-format files (.nib, .nb2)</li>
|
||||
<li>Any of the above compressed with gzip (.gz) or zip (.zip)</li>
|
||||
<li>ShrinkIt (NuFX) compressed disk images (.shk, .sdk)</li>
|
||||
</ul>
|
||||
<p>The image file format, filesystem, and sector ordering are <b>determined
|
||||
automatically</b> for most disks. The settings can be overridden if necessary.
|
||||
Images larger than floppies, such as ProDOS and HFS hard drive partition
|
||||
images, are fully supported.</p>
|
||||
<p>The
|
||||
recognized filesystem formats are:</p>
|
||||
<ul>
|
||||
<li>DOS 3.2/3.3 (13, 16, or 32 sectors, up to 50 tracks)</li>
|
||||
<li>ProDOS</li>
|
||||
<li>UCSD Pascal</li>
|
||||
<li>HFS (up to 2GB)</li>
|
||||
<li>CP/M</li>
|
||||
<li>SSI's RDOS (13-sector, 16-sector, and converted 13-to-16-sector formats)</li>
|
||||
</ul>
|
||||
<p> DOS, ProDOS, HFS, and UCSD Pascal filesystems are fully supported. You can
|
||||
view, add, extract, rename, and delete files, as well as create bootable blank
|
||||
disk images. Change disk volume names and DOS volume numbers. Create
|
||||
subdirectories and change file types on ProDOS disks. Files on CP/M and RDOS disks can be extracted and
|
||||
viewed. CiderPress also recognizes the following "meta-formats":</p>
|
||||
|
||||
<ul>
|
||||
<li>UNIDOS / AmDOS / OzDOS (two 400K DOS volumes on an 800K disk)</li>
|
||||
<li>ProSel Uni-DOS / DOS Master (one or more DOS volumes embedded in an 800K ProDOS disk)</li>
|
||||
<li>Macintosh-style disk partitioning (for hard drives, CD-ROMs, flopticals,
|
||||
etc).</li>
|
||||
<li>CFFA-style partitioning (fixed-size 32MB/1GB volumes, for Compact Flash
|
||||
cards).</li>
|
||||
<li>///SHH Systeme MicroDrive partitioning (allows up to 16 partitions on IDE hard
|
||||
drives).</li>
|
||||
<li>Parsons Engineering FocusDrive partitioning (allows up to 30 partitions).</li>
|
||||
</ul>
|
||||
|
||||
<p> <b><a name="physical"></a>Direct Access to Physical Devices</b></p>
|
||||
|
||||
<p> With CiderPress you can directly access physical devices on your PC.
|
||||
For example:</p>
|
||||
|
||||
<ul>
|
||||
<li>Read and write ProDOS-formatted 720KB and 1.4MB floppy disks. If you
|
||||
have a SuperDrive or floptical drive connected to your Apple II, you can
|
||||
transfer files around without needing to use MS-DOS utilities. [Works
|
||||
for PC-format disks. Does not work with Apple-format 800KB and 1.6MB
|
||||
disks, nor 140KB 5.25" disks.]</li>
|
||||
<li>Read and write files on every ProDOS partition of a CFFA card.
|
||||
4-part and
|
||||
8-part configurations are automatically detected.</li>
|
||||
<li>Read files from ProDOS partitions of CD-ROMs. If you have Apple II CD-ROMs
|
||||
with multiple 32MB ProDOS partitions, CiderPress will find every file on
|
||||
them.</li>
|
||||
<li>Read and write files on every partition of an Apple II hard drive. Got an external SCSI drive
|
||||
connected to your //gs? Plug it into a
|
||||
SCSI card on a PC and open it.</li>
|
||||
</ul>
|
||||
<p>With the included volume copier, you can also copy partitions or
|
||||
multi-partition volumes to and from physical media. This allows you to extract partitions
|
||||
from CFFA cards, CD-ROMs, and hard drives, and use them with an emulator.
|
||||
Back up your hard drive to a block image file in seconds, and restore the whole drive,
|
||||
a single partition, or individual files quickly and easily.</p>
|
||||
|
||||
<p>All of the above requires appropriate hardware, and some versions of Windows
|
||||
work better with certain hardware than others. See the <a href="hardware.htm">Hardware
|
||||
Compatibility</a> page for details about what you need and what you can expect.</p>
|
||||
|
||||
<p><b><a name="converter"></a>Built-in File Viewer/Converter</b></p>
|
||||
<p>The file viewer can convert several formats for easier viewing on modern
|
||||
systems:</p>
|
||||
<ul>
|
||||
<li>ProDOS text with carriage returns to Windows "CRLF" format.</li>
|
||||
<li>DOS 3.3 "high ASCII" text to Windows text.</li>
|
||||
<li>CP/M text converted to Windows format (stops at first Ctrl-Z).</li>
|
||||
<li>UCSD Pascal editor text to plain text.</li>
|
||||
<li>UCSD Pascal code to a segmented hex dump.</li>
|
||||
<li>Applesoft BASIC to text (matches output of "LIST" command), with
|
||||
or without color syntax highlighting.</li>
|
||||
<li>Integer BASIC to text (matches output of "LIST" command), with
|
||||
or without color syntax highlighting.</li>
|
||||
<li>Apple /// Business BASIC to text (matches output of "LIST" command), with
|
||||
or without color syntax highlighting.</li>
|
||||
<li>S-C Assembler source files to text.</li>
|
||||
<li>LISA tokenized assembly source to text (versions 2.x - 5.x).</li>
|
||||
<li>Merlin assembly sources to properly-spaced text.</li>
|
||||
<li>65C02/65816 code disassembly. Output matches //e and IIgs monitor
|
||||
listings, with the addition of Nifty List annotations (descriptions of F8
|
||||
ROM routines, softswitches, and ProDOS, GS/OS, and toolbox calls are shown).</li>
|
||||
<li>Magic Window / Magic Window II "formatted" documents to text.</li>
|
||||
<li>AppleWorks 3.0 documents:
|
||||
<ul>
|
||||
<li> Word processor to Rich Text Format (supports left/right
|
||||
margins, centering, bold, italic, etc).</li>
|
||||
<li> Database to CSV (suitable for import into Excel or other
|
||||
applications).</li>
|
||||
<li> Spreadsheet to CSV (for import into Excel or other
|
||||
spreadsheets; some formulas may not convert).</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>IIgs text documents:
|
||||
<ul>
|
||||
<li>Generic GWP to Rich Text Format. Converts non-ASCII characters,
|
||||
such as symbols and letters with accents, to Windows equivalents.
|
||||
Non-English text converts correctly.</li>
|
||||
<li>Teach documents to Rich Text Format (supports different fonts, font
|
||||
sizes, and style changes).</li>
|
||||
<li>AWGS Word Processor documents to Rich Text format (supports different
|
||||
fonts, font sizes, style changes, and paragraph justification).</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Hi-Res graphics to 560x384 16-color .BMP (B&W or color with half-pixel
|
||||
shifting).</li>
|
||||
<li>Double Hi-Res graphics to 560x384 16-color .BMP (B&W or color).</li>
|
||||
<li>Super Hi-Res graphics to 640x400 256-color .BMP. Supported formats
|
||||
include unpacked ($c1/0000), Paintworks ($c0/0000), packed ($c0/0001),
|
||||
DreamGrafix ($c0/8005), and Apple Preferred Format
|
||||
($c0/0002) up to 1280x1024.</li>
|
||||
<li>3200-color Super Hi-Res graphics to 640x400 24-bit .BMP. Supported
|
||||
formats include unpacked ($c1/0002 or ".3200"), packed
|
||||
(".3201"), DreamGrafix ($c0/8005), and Apple Preferred Format ($c0/0002 with "MULTIPAL").</li>
|
||||
<li>Print Shop and Print Shop GS clip art to 88x52 .BMP.</li>
|
||||
<li>MacPaint image to 576x720 B&W .BMP.</li>
|
||||
<li>Apple IIgs resource forks are split into individual resources and
|
||||
displayed as hex dumps.</li>
|
||||
</ul>
|
||||
<p>In addition, any fork of any file can be viewed in its "raw" state
|
||||
or as a hex dump.</p>
|
||||
<p>Text and graphics can be cut & pasted from the file viewer to
|
||||
other applications, or sent directly to your printer. The file converters can be applied when extracting
|
||||
files as well, allowing you to convert disks full of source code or images
|
||||
easily. It takes the same amount of effort to convert one AppleWorks
|
||||
document or one hundred.</p>
|
||||
<p>Unsupported formats with recognizable extensions, such as ".GIF"
|
||||
and ".JPG", are displayed in an external viewer when double-clicked.</p>
|
||||
|
||||
<p><b><a name="dicc"></a>Disk Image Creation and Conversion</b></p>
|
||||
|
||||
<p>The disk image creation tool allows you to create blank, bootable disk image
|
||||
for DOS 3.2/3.3, ProDOS, HFS, and Pascal disks. ProDOS volumes can have arbitrary sizes
|
||||
up to 32MB, and HFS can go up to 2GB. Resize volumes by copying & pasting between them, or use
|
||||
the one-step disk-to-file-archive and file-to-disk-archive features.</p>
|
||||
|
||||
<p>The disk image converter easily converts disk images to any other suitable
|
||||
format. Use it to add or remove 2MG headers, or convert .PO to .NIB and back
|
||||
again. Convert your 800K ShrinkIt disk images to and from DiskCopy 4.2.
|
||||
You can optionally add gzip compression for reduced storage size.</p>
|
||||
|
||||
<p>If you have a large collection of images that you want to convert to a
|
||||
different format, use the bulk image converter to migrate them all in a few easy
|
||||
steps.</p>
|
||||
|
||||
<p> <b><a name="tools"></a>Additional Tools</b></p>
|
||||
|
||||
<p>CiderPress includes some other handy tools:</p>
|
||||
|
||||
<ul>
|
||||
<li>Disk Viewer - Examine disk images as 512-byte blocks, 256-byte sectors or
|
||||
raw nibblized
|
||||
tracks. Open and follow individual files and embedded sub-volumes.
|
||||
Examine blocks on CF cards and other Windows volumes.</li>
|
||||
<li>Volume Copier - Copy data to and from Windows volumes, such as CF cards
|
||||
and floppy disks. Extract ProDOS partitions from CD-ROMs and copy them
|
||||
to a hard drive partition. Back up your Apple II hard drive directly.</li>
|
||||
<li>SST Image Merge - Combine SST-generated disk image pairs into .NIB files
|
||||
without having to run SST in an emulator. Just generate the images on
|
||||
the Apple II, transfer them to the PC, and let CiderPress do the reassembly
|
||||
for you.</li>
|
||||
<li>2MG Properties Editor - Change the "locked" flag, disk volume
|
||||
number, and edit the comment in a 2MG disk image file.</li>
|
||||
<li>EOL Scanner - Identify disk images and file archives damaged by ASCII-mode
|
||||
transfers. Figure out what OS a text file is formatted for.</li>
|
||||
<li>Cassette Import - Capture your Apple II cassette tape in a WAV file, then
|
||||
use CiderPress to extract every program it contains. Automatically
|
||||
identifies file type and length for most programs. It can even decode
|
||||
some tapes that no longer work on a real Apple II.</li>
|
||||
<li>Import BASIC from text file - Convert a text listing of an Applesoft
|
||||
program into a BAS file on a disk image. Handy for converting programs
|
||||
scanned from hardcopy.</li>
|
||||
</ul>
|
||||
|
||||
<p>Included as a separate application, Multi-Disk Catalog (MDC)
|
||||
allows you to generate <a href="mdc-out.txt"> file listings</a> from hundreds of disk images with only a
|
||||
few mouse clicks. Just select the images and the automatic format
|
||||
recognition does the rest.</p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
@ -0,0 +1,168 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Hardware Compatibility</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress Hardware Compatibility</h1>
|
||||
<p>CiderPress can access floppy disks, CD-ROMs, CF cards, hard drives, and other
|
||||
devices. Whether or not it can do so on your system depends on the
|
||||
specific set of devices you have and what version of Windows you're running.
|
||||
<a href="index.htm">Return to main page</a>.</p>
|
||||
<h3>General Rules</h3>
|
||||
<ul>
|
||||
<li>3.5" floppy disks
|
||||
<ul>
|
||||
<li>Requires a 3.5" floppy drive in your PC. Works under both
|
||||
Win98/ME and Win2K/XP.</li>
|
||||
<li>Only 720KB and 1.4MB PC-format floppy disks are supported.
|
||||
Apple-format 800KB and 1.6MB disks are not, due to hardware
|
||||
differences. Apple-format 140K 5.25" disks are not supported
|
||||
either.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>CompactFlash (CF) cards
|
||||
<ul>
|
||||
<li>Requires a CF card reader.</li>
|
||||
<li>Your ability to read CF cards in CiderPress depends upon your exact
|
||||
model of reader and which operating system you're running. Check
|
||||
the compatibility list, below.</li>
|
||||
<li>Cards can use CFFA fixed-partition format or the custom partitioning
|
||||
from SHH Systeme's MicroDrive system.</li>
|
||||
<li>CiderPress does not
|
||||
currently provide formatting or partitioning facilities. You must
|
||||
prepare the card on the Apple II.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>CD-ROMs
|
||||
<ul>
|
||||
<li>Requires a CD-ROM drive. Internal SCSI and IDE drives have been
|
||||
tested successfully under Win98/ME and Win2K/XP. External USB
|
||||
CD-ROM drives may not work.</li>
|
||||
<li>Works for Macintosh-partitioned CD-ROMs.</li>
|
||||
<li>CiderPress does not record discs.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Hard drives
|
||||
<ul>
|
||||
<li>Requires an appropriate interface to connect the hard drive, e.g. you
|
||||
need a SCSI adapter in your PC to read a SCSI hard drive.</li>
|
||||
<li>Under Win2K/XP, the device must be recognized by the BIOS (SCSI or
|
||||
IDE; FireWire might work but has not been tested).</li>
|
||||
<li>Under Win98/ME, it must be recognized by ASPI (usually SCSI
|
||||
only). See Win98/ME notes below.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>ZIP drives
|
||||
<ul>
|
||||
<li>ZIP disks have been used successfully. Make sure you partition
|
||||
the disk, e.g. with ADU or RamFAST utilities on the Apple II. If
|
||||
you insert a blank disk in a IIgs, and let the Finder format it as a
|
||||
simple ProDOS volume, the disk won't work if you eject and re-insert it.</li>
|
||||
<li>You may need drivers to use a ZIP drive on a PC. SCSI drives
|
||||
will probably work without them.</li>
|
||||
<li>Parallel-port ZIP drives do not work well with CiderPress under
|
||||
Win9x/ME. You can read from them, but writing fails.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Other devices
|
||||
<ul>
|
||||
<li>Insite SCSI "floptical" drives, made popular on the Apple II by
|
||||
Tulin, have been successfully tested under Win98 and Win2K. No
|
||||
additional drivers needed on the PC.</li>
|
||||
<li>Tape drives are not supported.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Win2K/XP
|
||||
<ul>
|
||||
<li>You need "administrator" privileges to access devices other
|
||||
than floppy disk drives. This is a general OS limitation on
|
||||
low-level access to devices.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Win98/ME
|
||||
<ul>
|
||||
<li>Access to CD-ROM drives and hard drives is limited to what your ASPI
|
||||
layer is capable of handling. "ASPI" is an acronym for
|
||||
Advanced SCSI Programming Interface, and provides a layer between
|
||||
applications and SCSI devices. It also provides an interface for
|
||||
IDE CD-ROM drives, and may work for other devices depending on which
|
||||
ASPI implementation you have.</li>
|
||||
<li>Microsoft provides a generic ASPI layer that is commonly replaced when
|
||||
CD recording software is installed. Adaptec/Roxio provides one
|
||||
implementation, Ahead's Nero provides another. All of these will
|
||||
work just fine with CD-ROM drives, but access to other devices may be
|
||||
affected by the currently installed version.</li>
|
||||
<li>Your SCSI card must be ASPI-compliant. Nearly all cards
|
||||
are. Adaptec 2940-series cards have been tested, as have some
|
||||
older Symbios/LSI Logic cards (e.g. Diamond FirePort).</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<p>As the saying goes, "your mileage may vary". The only way to
|
||||
know for certain if something will work is to try it and see.</p>
|
||||
<h3>CompactFlash Card Reader Compatibility List</h3>
|
||||
<table border="1" width="100%">
|
||||
<tr>
|
||||
<td width="33%"><b>Device</b></td>
|
||||
<td width="33%"><b>Win2K/XP</b></td>
|
||||
<td width="34%"><b>Win98/ME</b></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">Lexar Universal Card Reader (USB, model #GS-UFD-20SA-TP)</td>
|
||||
<td width="33%"><font color="#008000">Works</font>. Card size in Open
|
||||
Volume dialog is way off.</td>
|
||||
<td width="34%"><font color="#FF0000">Does not work</font>.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">SanDisk ImageMate SDDR-31</td>
|
||||
<td width="33%"><font color="#008000">Works</font>.</td>
|
||||
<td width="34%"><font color="#000080">Partially working</font>. Data
|
||||
can be read, but writes only pretend to succeed.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">ETI card reader (USB, model # unknown)</td>
|
||||
<td width="33%">(not tested)</td>
|
||||
<td width="34%"><font color="#000080">Partially working</font>. Data
|
||||
can be read, but writes fail.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">SanDisk 6-in-1 reader</td>
|
||||
<td width="33%"><font color="#008000">Works</font>.</td>
|
||||
<td width="34%">(not tested)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">IBM PCMCIA card adapter</td>
|
||||
<td width="33%"><font color="#008000">Works</font><font color="#000080">.</font></td>
|
||||
<td width="34%">(not tested)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="33%">SanDisk CompactFlash PC Card Adapter (model #SDAD-38-A10)</td>
|
||||
<td width="33%"><font color="#008000">Works</font><font color="#000080">.</font></td>
|
||||
<td width="34%">(not tested)</td>
|
||||
</tr>
|
||||
</table>
|
||||
<p>One common problem in Win98 is refusal by the CF reader driver to allow
|
||||
access to unrecognized logical volumes ("logical volumes" are lettered
|
||||
drives, like "C:"). In such cases, the card will not even show
|
||||
up in the logical volume list. Win2K and WinXP are usually better about
|
||||
this.</p>
|
||||
<p>Depending on your hardware and software configuration, you may be able to
|
||||
open your card reader by name (e.g. "SanDisk Imagemate II Direct-access
|
||||
device"), rather than drive letter. In this case
|
||||
you're actually using the ASPI layer to access the device, which is a little
|
||||
strange since CF card readers aren't SCSI and don't work like CD-ROM
|
||||
drives. This does appear to work for reading, but fails for writing.
|
||||
Depending on which ASPI implementation you have installed, writes may be
|
||||
rejected or may appear to succeed but not actually go through.</p>
|
||||
<p>Thus far, no fully-functioning CF configuration for Win98/ME has been found.</p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
|
|
@ -0,0 +1,31 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Screen Shot - AWP + Eagle</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<p><img border="0" src="awp-eagle.jpg" width="730" height="709"></p>
|
||||
<p><b>View documents and graphics</b>. The above are file viewer windows
|
||||
from two instances of CiderPress. The first is viewing a 3200-color image
|
||||
of an eagle, using the full palette of the original. The second is an
|
||||
AppleWorks 3.0 word processor document, converted for use in Windows. CiderPress supports many AWP formatting commands, including left
|
||||
and right margins, text justification, and text face changes such as bold,
|
||||
underlined, and
|
||||
superscripted text.</p>
|
||||
<p>You can extract files in their original form or in converted form. The
|
||||
eagle image extracts as a Windows BMP file, ready for use in any application
|
||||
that handles graphics. The AWP document extracts in Rich Text Format
|
||||
(.rtf), ready for use in most word processors. Both can be cut &
|
||||
pasted directly from the file viewer, or sent to a printer with the
|
||||
"Print" button. You can even change fonts.</p>
|
||||
<p><a href="../index.htm">UP</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 121 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.4 KiB |
|
|
@ -0,0 +1,28 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Screen Shot - Big Archive</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<p><img border="0" src="big-shk.jpg" width="730" height="615"></p>
|
||||
<p><b>Manage large archives</b>. This shows CiderPress viewing a large
|
||||
collection of files -- in this case, a ShrinkIt file archive of a 20MB hard drive partition
|
||||
with source code on it. For compactness, the archive was re-compressed with the gzip
|
||||
"deflate" algorithm. (Re-compressing the entire archive took 3
|
||||
mouse clicks and about 10 seconds, and cut the compressed size significantly.)</p>
|
||||
<p>ShrinkIt archives up to 2GB and multi-partition hard drives up to 8GB are
|
||||
supported.</p>
|
||||
<p>The file viewer is showing an Applesoft BASIC program, converted to text that
|
||||
exactly matches the output of the "LIST" command. The color
|
||||
syntax highlighting shown can be switched off. The file view can be
|
||||
changed to a hex dump or a raw file dump with one click.</p>
|
||||
<p><a href="../index.htm">UP</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 156 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.2 KiB |
|
|
@ -0,0 +1,25 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Screen Shot - Volume Copier</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<p><img border="0" src="vol-copy.jpg" width="816" height="604"></p>
|
||||
|
||||
<p><b>Access physical devices</b>. Open floppy disks, CF cards, and hard
|
||||
drives directly. Cut and paste files between disks and disk images.
|
||||
Copy partitions on and off with the volume copier.</p>
|
||||
|
||||
<p>All CiderPress features are fully documented in the extensive help
|
||||
files.</p>
|
||||
|
||||
<p><a href="../index.htm">UP</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 123 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.9 KiB |
|
|
@ -0,0 +1,28 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Screen Shot - Wolfenstein</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<p><b><img border="0" src="wolfenstein.jpg" width="681" height="638"></b></p>
|
||||
|
||||
<p><b>Works with 13-sector disks</b>. The above is from a nibble image of
|
||||
the original, 13-sector still-copy-protected Castle Wolfenstein. CiderPress
|
||||
automatically identifies 13- and 16-sector nibble images, and can "see through"
|
||||
some mild forms of copy protection. Files can be added, deleted, and
|
||||
renamed on DOS 3.2 disks -- even the copy-protected Wolfenstein disk image.</p>
|
||||
|
||||
<p>The hi-res image above was automatically identified and converted when
|
||||
double-clicked from the file list. Hi-res and double-hi-res images can be
|
||||
displayed in color or black & white.</p>
|
||||
|
||||
<p><a href="../index.htm">UP</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 100 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.7 KiB |
57
index.html
57
index.html
|
|
@ -1 +1,56 @@
|
|||
My Page
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress</title>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<p> <a href="images/big-shk.htm"><img border="2" src="images/big-shk_small.jpg" alt="big-shk.jpg (159852 bytes)" width="100" height="84"></a>
|
||||
<a href="images/awp-eagle.htm"><img border="2" src="images/awp-eagle_small.jpg" alt="awp-eagle.jpg (123500 bytes)" width="100" height="84"></a>
|
||||
<a href="images/vol-copy.htm"><img border="2" src="images/vol-copy_small.jpg" alt="vol-copy.jpg (126382 bytes)" width="100" height="84"></a>
|
||||
<a href="images/wolfenstein.htm"><img border="2" src="images/wolfenstein_small.jpg" alt="wolfenstein.jpg (102200 bytes)" width="100" height="84"></a></p>
|
||||
<h2>What's Ciderpress?</h2>
|
||||
<p>CiderPress provides the features that Apple II enthusiasts need to manage
|
||||
their disk and file archives. Open them, view their contents, and copy
|
||||
files between them. There are other programs that provide access to disk and
|
||||
file archives, but none have as many features or support as many formats as
|
||||
CiderPress.</p>
|
||||
<p>CiderPress, introduced in March 2003, was developed and sold as shareware by
|
||||
faddenSoft, LLC. The program was made free, and the source code released
|
||||
under the BSD license, in March 2007.</p>
|
||||
<p><b>Key features:</b></p>
|
||||
<ul>
|
||||
<li><a href="features.htm#shrinkit">Full support for ShrinkIt archives</a>.</li>
|
||||
<li><a href="features.htm#disks">Full support for all common disk image formats and Apple
|
||||
II filesystems</a>.</li>
|
||||
<li><a href="features.htm#physical">Direct access to hard drives, removable media, and CF cards</a>.</li>
|
||||
<li><a href="features.htm#converter">Converters for text and graphics files</a>.</li>
|
||||
<li><a href="features.htm#dicc">Disk image creation and conversion</a>.</li>
|
||||
<li><a href="features.htm#tools">Some handy tools</a>.</li>
|
||||
</ul>
|
||||
|
||||
<p><b><a href="http://github.com/fadden/ciderpress/">
|
||||
GitHub project page</a></b> -- download sources or a Win32 executable,
|
||||
file bug reports, etc.</p>
|
||||
|
||||
<p>A <a href="tutorial/index.htm">tutorial</a> is available, with some sample
|
||||
files. In addition, Walt Perko has created an <a href="Create-CF-Volume.gif">
|
||||
animated GIF (1.8MB)</a>
|
||||
demonstrating how to put a 32MB ProDOS volume onto a CF card for use with
|
||||
a CFFA (useful if your Apple II isn't able to format the CF card first).
|
||||
</p>
|
||||
|
||||
<p>Got questions? Check the <a href="faq.htm">FAQ</a> and <a href="hardware.htm">hardware
|
||||
compatibility</a> pages.</p>
|
||||
|
||||
<p>The old <a href="requested-features.htm">requested features</a> list has some
|
||||
ideas. You can also view the original <a href="change-log.htm">change log</a>.
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,136 @@
|
|||
MDC for Windows v2.0.0 (DiskImg library v4.0.0)
|
||||
Copyright (C) 2004 by faddenSoft, LLC. All rights reserved.
|
||||
MDC is part of CiderPress, available from http://www.faddensoft.com/.
|
||||
Linked against NufxLib v2.0.3 and zlib v1.2.1
|
||||
|
||||
Run started at Sun Oct 03 13:16:01 2004 in 'G:\disks\mdc-sample'
|
||||
|
||||
File: APPLE1.IMG
|
||||
Disk: Pascal APPLE1:
|
||||
Name Type Auxtyp Modified Format Length
|
||||
------------------------------------------------------------------------------
|
||||
SYSTEM.APPLE PDA $0000 03-Sep-85 00:00 Pascal 16384
|
||||
SYSTEM.PASCAL PCD $0000 03-Sep-85 00:00 Pascal 22528
|
||||
SYSTEM.EDITOR PCD $0000 03-Sep-85 00:00 Pascal 25600
|
||||
SYSTEM.FILER PCD $0000 03-Sep-85 00:00 Pascal 15360
|
||||
SYSTEM.LIBRARY PCD $0000 03-Sep-85 00:00 Pascal 19456
|
||||
SYSTEM.MISCINFO PDA $0000 25-Dec-83 00:00 Pascal 192
|
||||
SYSTEM.CHARSET PDA $0000 14-Jun-79 00:00 Pascal 1024
|
||||
SYSTEM.SYNTAX PTX $0000 01-Jul-85 00:00 Pascal 6144
|
||||
MORSE.TEXT PTX $0000 31-May-87 00:00 Pascal 5120
|
||||
MORSE.CODE PCD $0000 31-May-87 00:00 Pascal 3072
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
File: D3150.sdk
|
||||
Disk: [UNIDOS]
|
||||
Name Type Auxtyp Modified Format Length
|
||||
------------------------------------------------------------------------------
|
||||
*_DOS001:CANYON CLIMBER BIN $077D [No Date] DOS 33171
|
||||
_DOS001:HELLO BAS $0801 [No Date] DOS 899
|
||||
*_DOS001:FALCONS BIN $0800 [No Date] DOS 36096
|
||||
*_DOS001:SARGON II BIN $0300 [No Date] DOS 26112
|
||||
*_DOS001:HORIZON FIVE BIN $0810 [No Date] DOS 33016
|
||||
*_DOS001:SPITFIRE SIMULATOR BIN $0D00 [No Date] DOS 33024
|
||||
*_DOS001:AQUATRON BIN $07FD [No Date] DOS 36867
|
||||
_DOS001:Q-BERT BIN $4000 [No Date] DOS 20992
|
||||
_DOS001:SNAPPER BIN $07FD [No Date] DOS 28931
|
||||
_DOS001:LASER SILK BIN $07FD [No Date] DOS 31235
|
||||
_DOS001:CROSS COUNTRY RALLY BIN $0800 [No Date] DOS 31232
|
||||
*_DOS001:HOWITZER BAS $0801 [No Date] DOS 4297
|
||||
*_DOS001:PIG PEN BIN $0F00 [No Date] DOS 22528
|
||||
*_DOS001:SNOGGLE-JOYSTICK BIN $07FD [No Date] DOS 27408
|
||||
*_DOS001:CHECKERS BAS $0801 [No Date] DOS 4940
|
||||
*_DOS002:JUMPJET BIN $07FD [No Date] DOS 36116
|
||||
*_DOS002:HOUSE OF USHER BAS $0801 [No Date] DOS 25266
|
||||
*_DOS002:MAD-VENTURE BIN $0800 [No Date] DOS 30720
|
||||
*_DOS002:INVASION FORCE BIN $0800 [No Date] DOS 7318
|
||||
*_DOS002:BEZOFF BIN $08FD [No Date] DOS 37891
|
||||
*_DOS002:REAR GUARD BIN $0280 [No Date] DOS 37635
|
||||
_DOS002:STAR WARS BIN $0300 [No Date] DOS 27392
|
||||
_DOS002:HELLO BAS $0801 [No Date] DOS 917
|
||||
*_DOS002:NARNIA BIN $0800 [No Date] DOS 34816
|
||||
*_DOS002:EAGLE EGGS BIN $0800 [No Date] DOS 5889
|
||||
*_DOS002:ROAD PIZZA BIN $3500 [No Date] DOS 24832
|
||||
*_DOS002:BRAINTEASER BLVD BIN $0800 [No Date] DOS 22528
|
||||
*_DOS002:DRAW POKER BIN $1500 [No Date] DOS 11008
|
||||
*_DOS002:APPLE PANIC BIN $07FD [No Date] DOS 26640
|
||||
*_DOS002:PULSAR II BIN $1EFD [No Date] DOS 30467
|
||||
*_DOS002:TEMPEST BIN $1200 [No Date] DOS 24576
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
File: D3455.sdk
|
||||
Disk: ProDOS /D3455
|
||||
Name Type Auxtyp Modified Format Length
|
||||
------------------------------------------------------------------------------
|
||||
PRODOS SYS $0000 02-Nov-88 18:03 ProDOS 19560
|
||||
MENU.SYSTEM SYS $0000 27-Jul-88 19:26 ProDOS 2808
|
||||
STAR.AVENGER BIN $0800 01-Aug-88 19:22 ProDOS 21164
|
||||
STAR.BLAZER BIN $0800 01-Aug-88 19:22 ProDOS 26955
|
||||
STAR.CLONES BIN $0800 01-Aug-88 19:22 ProDOS 32057
|
||||
STAR.CRUISER BIN $0800 01-Aug-88 19:22 ProDOS 17020
|
||||
STAR.DANCE BIN $0800 01-Aug-88 19:22 ProDOS 23271
|
||||
STAR.MAZE BIN $0800 01-Aug-88 19:22 ProDOS 30537
|
||||
STAR.THIEF BIN $0800 01-Aug-88 19:23 ProDOS 14786
|
||||
STAR.TREK BIN $0800 01-Aug-88 19:25 ProDOS 28646
|
||||
STAR.WARS.II BIN $0300 03-Nov-85 00:00 ProDOS 27392
|
||||
STARGATE BIN $0800 01-Aug-88 19:23 ProDOS 31036
|
||||
STARMINES BIN $0800 01-Aug-88 19:23 ProDOS 15117
|
||||
STRANGE.ODYSSEY BIN $0800 01-Aug-88 19:24 ProDOS 18318
|
||||
STUNT.CYCLE BIN $1100 02-Oct-88 04:20 ProDOS 7936
|
||||
SUCCESSION BIN $0800 01-Aug-88 19:23 ProDOS 14667
|
||||
SUPER.HUEY BIN $0800 01-Aug-88 19:23 ProDOS 29716
|
||||
SUPER.PUCKMAN BIN $0800 01-Aug-88 19:24 ProDOS 29741
|
||||
SYZYGY BIN $0800 01-Aug-88 19:24 ProDOS 30823
|
||||
TAIL.GUNNER BIN $0800 13-Nov-88 16:32 ProDOS 15829
|
||||
TAXMAN BIN $0800 01-Aug-88 19:26 ProDOS 27680
|
||||
TECHNO.RACING BIN $0800 01-Aug-88 19:27 ProDOS 26435
|
||||
TERITORY BIN $0800 01-Aug-88 19:28 ProDOS 11114
|
||||
THE.BILESTOAD BIN $0800 01-Aug-88 19:27 ProDOS 30122
|
||||
THE.COUNT BIN $0800 28-May-88 21:56 ProDOS 20336
|
||||
THE.ELIMINATOR BIN $0800 01-Aug-88 19:27 ProDOS 25761
|
||||
THIEF BIN $0800 01-Aug-88 19:27 ProDOS 26349
|
||||
THUNDERBIRD.GX BIN $0800 01-Aug-88 19:27 ProDOS 10688
|
||||
THUNDERBOMBS BIN $0800 01-Aug-88 19:27 ProDOS 21474
|
||||
TIME.TUNNELS BIN $0800 01-Aug-88 19:28 ProDOS 24005
|
||||
TORAX BIN $0800 01-Aug-88 19:28 ProDOS 7255
|
||||
TRACK.ATTACK BIN $07FD 05-Dec-87 02:18 ProDOS 36356
|
||||
TRANQUILITY.BAS BIN $0800 01-Aug-88 19:29 ProDOS 22083
|
||||
TRIAD BIN $07ED 24-Feb-88 23:12 ProDOS 31511
|
||||
TROMPERS BIN $0800 01-Aug-88 19:29 ProDOS 18167
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
File: SYSTEM.MSTR.SHK
|
||||
Disk: DOS 3.3 Volume 254
|
||||
Name Type Auxtyp Modified Format Length
|
||||
------------------------------------------------------------------------------
|
||||
*HELLO BAS $0801 [No Date] DOS 1137
|
||||
*ANIMALS INT $0000 [No Date] DOS 4205
|
||||
*APPLE PROMS TXT $0000 [No Date] DOS 264
|
||||
*APPLESOFT INT $0000 [No Date] DOS 1142
|
||||
*APPLEVISION INT $0000 [No Date] DOS 6190
|
||||
*BIORHYTHM INT $0000 [No Date] DOS 4078
|
||||
*BOOT13 BIN $1700 [No Date] DOS 2288
|
||||
*BRIAN'S THEME BAS $0801 [No Date] DOS 1161
|
||||
*CHAIN BIN $0808 [No Date] DOS 456
|
||||
*COLOR DEMO INT $0000 [No Date] DOS 1921
|
||||
*COLOR DEMOSOFT BAS $0801 [No Date] DOS 1821
|
||||
*COPY INT $0000 [No Date] DOS 1834
|
||||
*COPY.OBJ0 BIN $02C0 [No Date] DOS 267
|
||||
*COPYA BAS $0801 [No Date] DOS 1844
|
||||
*EXEC DEMO BAS $0801 [No Date] DOS 2208
|
||||
*FID BIN $0803 [No Date] DOS 4686
|
||||
*FPBASIC BIN $D000 [No Date] DOS 12288
|
||||
*INTBASIC BIN $1000 [No Date] DOS 12288
|
||||
*LITTLE BRICK OUT BAS $0801 [No Date] DOS 6775
|
||||
*MAKE TEXT BAS $0801 [No Date] DOS 493
|
||||
*MASTER CREATE BIN $0800 [No Date] DOS 1791
|
||||
*MUFFIN BIN $0803 [No Date] DOS 6397
|
||||
*PHONE LIST BAS $0801 [No Date] DOS 12786
|
||||
*RANDOM BAS $0801 [No Date] DOS 2280
|
||||
*RENUMBER BAS $0801 [No Date] DOS 3046
|
||||
*RENUMBER INSTRUCTIONS BAS $0801 [No Date] DOS 9581
|
||||
*RETRIEVE TEXT BAS $0801 [No Date] DOS 331
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
|
||||
Scan completed in 1 seconds.
|
||||
|
|
@ -0,0 +1,236 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>CiderPress Requested Features</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress Requested Features List</h1>
|
||||
<p>In no particular order. <a href="index.htm">Return to main page</a>.</p>
|
||||
<p>Main application features:</p>
|
||||
<ul>
|
||||
<li>Add: "Search" feature to find text and binary strings across
|
||||
multiple disk images and file archives.</li>
|
||||
<li>Add: Copy & paste files to and from Windows Explorer windows.</li>
|
||||
<li>Add: Drag & drop files between disk images.</li>
|
||||
<li>Add: Drag disk images onto CiderPress window to open them.</li>
|
||||
<li>Add: "Move file" command (moves files between ProDOS/HFS directories).</li>
|
||||
<li>Add: Directory sorting.</li>
|
||||
<li>Add: Graphical "blocks in use" disk map.</li>
|
||||
<li>Add: Allow choice between list and tree display for file list.</li>
|
||||
<li>Add: "Undelete files" command.</li>
|
||||
<li>Add: "Revert to original" feature (mass "undo" for all
|
||||
types of files).</li>
|
||||
<li>Add: ResEdit-style resource viewer.</li>
|
||||
<li>Expand ZIP archive support.</li>
|
||||
<li>Add: File compare, a la ProSel-16.</li>
|
||||
</ul>
|
||||
|
||||
<p>Ideas for tools:</p>
|
||||
<ul>
|
||||
<li>Add: BinSCII encode/decode.</li>
|
||||
<li>Add: Decode "executioner", PAAF, etc.</li>
|
||||
<li>Add: ADT server.</li>
|
||||
<li>Add: Macintosh-style partitioned image creator (can be used as CD-ROM ".iso" image
|
||||
creator).</li>
|
||||
<li>Add: partition & format utilities for CFFA, MicroDrive, and FocusDrive.</li>
|
||||
<li>Add: bad block scan. Useful for .NIB, .APP, and .FDI images, as well
|
||||
as physical media.</li>
|
||||
<li>Add: more "bulk tools", e.g. bulk image testing.</li>
|
||||
<li>Add: a recursive extraction feature that extracts files from disks in
|
||||
archives on disks.</li>
|
||||
<li>Add: "disk zap" to zero out empty blocks (improves disk compression).</li>
|
||||
<li>Add: HDV Normalizer, which converts an "expanding" .hdv file into a
|
||||
full-sized file.</li>
|
||||
<li>Turn "disk sector viewer" into "disk sector editor".</li>
|
||||
<li>Add 6502/65816 code disassembly to sector viewer.</li>
|
||||
<li>Volume copier should allow you to have two volumes open at the same time,
|
||||
and copy partitions directly between them.</li>
|
||||
<li>Opening a file on a disk image should involve picking a name from a list
|
||||
or tree,
|
||||
not typing it in by hand.</li>
|
||||
<li>Add a tool that splits a .NIB disk image into two pieces for SST (needs to
|
||||
reconstruct sync bytes, etc).</li>
|
||||
</ul>
|
||||
|
||||
<p>Disk image support:</p>
|
||||
<ul>
|
||||
<li>Add: DDD Deluxe support [need format description or program disassembly].</li>
|
||||
<li>Add: Davex archived volume support.</li>
|
||||
<li>Add: zero out unused blocks (for better compression).</li>
|
||||
<li>Add: support for storage type 4 [embedded Pascal volumes -- need examples].</li>
|
||||
<li>Implement writing on CP/M and RDOS disks.</li>
|
||||
<li>CP/M user number needs to be visible to user (maybe in place of
|
||||
"type" column).</li>
|
||||
<li>Retain 2MG comments when converting 2MG to 2MG. Convert 2MG comments
|
||||
to NuFX comments and vice-versa.</li>
|
||||
<li>Expand DOS Master support to handle arbitrary volumes embedded in ProDOS
|
||||
hard drives.</li>
|
||||
<li>Add "delete DOS" and "copy DOS" for DOS 3.3 disks.</li>
|
||||
<li>Improve support for DOS files with oversized track/sector lists (e.g.
|
||||
"fastloader" files).</li>
|
||||
<li>"Krunch" Pascal disks.</li>
|
||||
<li>Convert TXT to PTX when adding files to Pascal disks. (Might make
|
||||
more sense to convert SRC to PTX, since PTX files were almost always source
|
||||
code.)</li>
|
||||
<li>Allow customization of nibble format, for reading sectors from
|
||||
copy-protected .NIB images.</li>
|
||||
<li>Allow nibble access to 3.5" disk images.</li>
|
||||
<li>Handle non-Macintosh hard drive formats, e.g. Corvus partitioning.</li>
|
||||
<li>Handle zip/gzip-compressed images larger than 32MB by expanding into a
|
||||
temp file.</li>
|
||||
<li>Recognize Infocom games. Show the game data portion as a file that
|
||||
can be extracted for use with Windows-based Infocom interpreters.</li>
|
||||
<li>Shared file access needs to be disabled, especially on disk images open
|
||||
read-write. Right now you can run a disk image in an emulator while
|
||||
it's open in CiderPress, which is convenient until the emulator deletes or
|
||||
adds files and CP doesn't know about it. (CP re-loads the block use
|
||||
map every time it does anything, so the most common forms of nastiness are
|
||||
prevented.)</li>
|
||||
<li>Add block-oriented write caching to improve speed on physical media (e.g. multiple-file deletes on a ProDOS
|
||||
3.5" floppy disk).</li>
|
||||
<li>Automatically expand undersized .hdv images.</li>
|
||||
<li>Add an option to force writes on a "damaged" or
|
||||
"suspicious" disk image. Not a good idea, but could come in
|
||||
handy.</li>
|
||||
<li>DOS/ProDOS "hybrid" disks (as created with Hybrid.Create on the
|
||||
"Extra K" disk) are supported, but only one part can be accessed
|
||||
at a time. This should be changed so that both parts can be accessed.</li>
|
||||
<li>Provide translation of 13-sector boot block in disk sector viewer.</li>
|
||||
<li>Add code to write FDI images (they're currently read-only).</li>
|
||||
<li>Add an option to decide whether to convert FDI images to variable-length
|
||||
tracks (which can be converted to .APP) or fixed-length tracks (which can be
|
||||
converted to .NIB). This needs to happen in the FDI code because the
|
||||
only way to do it reliably for copy-protected disks is to have access to the
|
||||
self-sync information.</li>
|
||||
<li>Add support for OS/9 format, for Stellation Mill 6809 card.</li>
|
||||
<li>If a disk image isn't recognized, add a "specify disk format"
|
||||
button to the error dialog. (Currently you have to enable the
|
||||
"specify format" dialog in Edit->Preferences.)</li>
|
||||
<li>Correctly identify newly-formatted DOS 3.1 .nib images, which don't
|
||||
have valid sector data fields.
|
||||
</ul>
|
||||
|
||||
<p>Physical devices:</p>
|
||||
<ul>
|
||||
<li>Try to detect or prevent media swaps, i.e. ejecting a floppy or CD-ROM and
|
||||
inserting a new one while CiderPress has it open.</li>
|
||||
<li>Find a less-noisy way to tell if there's a disk in the floppy drive in
|
||||
Win98.</li>
|
||||
<li>After N blocks read without errors, resume bulk reads. (Currently
|
||||
the disk copier goes to single-block copies after encountering read errors,
|
||||
and stays there, with a 5-6x loss in performance on slower devices.)</li>
|
||||
</ul>
|
||||
|
||||
<p>Application tweaks:</p>
|
||||
<ul>
|
||||
<li>Add: Quick-open last N files from list in "File" menu.</li>
|
||||
<li>Paste should behave like "add files": the filenames of files
|
||||
being pasted are guaranteed not to clash with other files being pasted, but
|
||||
any conflicts with existing files should be resolved with a
|
||||
rename/overwrite/skip dialog.</li>
|
||||
<li>Copying & pasting DOS 3.3 'B' files with "loaders" should
|
||||
work properly. (When you BRUN a file, DOS uses the embedded length to
|
||||
decide how long the file is. Some cracked games put a loader in the
|
||||
first part of the file, which then read the sectors out of the rest of the
|
||||
file. Handling this correctly requires copying all sectors without
|
||||
losing the length embedded in the original. Current workaround: change
|
||||
type to 'S'.)</li>
|
||||
<li>2MG file comments should be more prominent; perhaps in the Archive Info
|
||||
screen.</li>
|
||||
<li>More details should be available on why "damaged" and
|
||||
"suspicious" files are marked as such.</li>
|
||||
<li>Printed file list should have indication of "damaged" and
|
||||
"suspicious" files.</li>
|
||||
<li>"New -> Disk image" and "convert file to disk archive" should
|
||||
allow formats other than ProDOS-ordered ".po" and DOS-ordered
|
||||
".do" (e.g. 2MG).</li>
|
||||
<li>Make toolbar buttons configurable.</li>
|
||||
<li>Put the "..." in the middle of space-shortened file names,
|
||||
rather than at the start or end.</li>
|
||||
<li>Add hi-res/double-hi-res palette configuration, so individual colors can
|
||||
be tailored for authenticity with respect to a particular type of display
|
||||
hardware (i.e. NTSC television vs. RGB monitor).</li>
|
||||
<li>Sector viewer should have a sliding bar to select offset into disk or
|
||||
file, allowing fast access to arbitrary offsets.</li>
|
||||
<li>Allow addition of a Binary II header when creating NuFX archives.</li>
|
||||
<li>File copy & paste should copy comments found in NuFX archives.</li>
|
||||
<li>Allow text conversion when adding files to NuFX archives (actually a
|
||||
NufxLib change).</li>
|
||||
<li>Have a "convert current disk" feature, instead of having to
|
||||
re-open the currently-open disk in the disk image converter.</li>
|
||||
<li>Add audio capture to the cassette tape import feature, so that cassette
|
||||
tapes don't have to be captured with a sound editor.</li>
|
||||
<li>Cassette import should recognize arrays and shape tables automatically.</li>
|
||||
<li>Add audio export feature, converting BAS/INT/BIN to cassette tape format.</li>
|
||||
<li>Add syntax checking to BASIC import feature. Add Integer BASIC
|
||||
support.</li>
|
||||
<li>Add a new option to Paste Special: paste the contents of the clipboard
|
||||
into a newly-created text file. Useful for grabbing text data out of
|
||||
other Windows applications.</li>
|
||||
<li>Show compression stats, e.g. total size vs. total compressed size, for
|
||||
NuFX archives.</li>
|
||||
<li>Make the NufxLib error log output available.</li>
|
||||
<li>Make rVersion and rComment resources more easily visible, perhaps
|
||||
treating them in a fashion similar to NuFX comments.</li>
|
||||
</ul>
|
||||
|
||||
<p>File viewer and file converters:</p>
|
||||
<ul>
|
||||
<li>Add: Packed hi-res/DHR (ProDOS $08/4000 and $08/4001 -- never used?).</li>
|
||||
<li>Add: Packed hi-res (Beagle Graphics).</li>
|
||||
<li>Add: Dreamgrafix PNT/$8005 (and the less-common PIC/$8003).</li>
|
||||
<li>Add: AppleWriter.</li>
|
||||
<li>Add: Magic Window.</li>
|
||||
<li>Add: Finder icons.</li>
|
||||
<li>Add: Sound files.</li>
|
||||
<li>Add: Apple /// Business Basic (BA3).</li>
|
||||
<li>Add: Magic Window.</li>
|
||||
<li>Display text in an "Apple II" font. (There are some Apple
|
||||
II fonts on the web that you can install and use with the file viewer.
|
||||
CiderPress should include one.)</li>
|
||||
<li>Support TimeOut SuperFonts in AWP converter.</li>
|
||||
<li>Correctly support tabs in AWP and GWP documents.</li>
|
||||
<li>Have option to convert AWP to plain text instead of RTF. (Can get
|
||||
same effect by cut & pasting into Notepad.)</li>
|
||||
<li>Expand files compressed with HardPressed.</li>
|
||||
<li>Applesoft/Integer syntax highlighting could grey-out unreachable lines.</li>
|
||||
<li>Have alternate Integer BASIC mode that deciphers the POKEs that conceal
|
||||
BASIC listing in mixed Integer/assembly programs (fairly common in programs
|
||||
from cassettes).</li>
|
||||
<li>Add "save as" button to file viewer.</li>
|
||||
<li>Add "reverse" conversions, e.g. RTF to AppleWorks, BMP to SHR,
|
||||
etc.</li>
|
||||
<li>Add a printer page setup screen that allows configuration of
|
||||
margins. (Left/right margins are currently configured to deliver
|
||||
exactly 80 columns of 10-point Courier New, in an attempt to match Apple II
|
||||
output.)</li>
|
||||
<li>Present "select all" and copy/paste in a menu or as buttons
|
||||
(instead of expecting the user to know about Ctrl-A / Ctrl-C / Ctrl-V).</li>
|
||||
<li>Provide a way to view files on a Windows filesystem.</li>
|
||||
<li>Don't use a fixed pixel width for the initial size of the file
|
||||
viewer. On systems with DPI set to 120 the buttons get squished
|
||||
together.</li>
|
||||
<li>Make the File Viewer a file editor. Allow editing of text files and
|
||||
hex dumps.</li>
|
||||
</ul>
|
||||
|
||||
<p>MDC:</p>
|
||||
<ul>
|
||||
<li>Support multiple output modes (plain text, HTML, XML, CSV,
|
||||
"native" listing that looks like DOS catalog, ProDOS catalog,
|
||||
Pascal list, CP/M dir, etc.)</li>
|
||||
<li>Adjust widths of individual fields.</li>
|
||||
<li>Show the contents of SHK file archives.</li>
|
||||
<li>Open up SHK and ZIP multi-file archives and examine their contents for things
|
||||
that are obviously disk images.</li>
|
||||
</ul>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 20 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 41 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 29 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 4.9 KiB |
|
|
@ -0,0 +1,482 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
||||
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
|
||||
<meta name="ProgId" content="FrontPage.Editor.Document">
|
||||
<title>faddenSoft CiderPress Tutorial</title>
|
||||
</head>
|
||||
|
||||
<body bgcolor="#FFFFFF" text="#000000">
|
||||
|
||||
<h1>CiderPress Tutorial</h1>
|
||||
<p>Thank you for giving CiderPress a try! We hope you find it useful and
|
||||
easy to use. This page uses minimal formatting to be printer-friendly.</p>
|
||||
<p>This tutorial will get you started working with CiderPress. You will
|
||||
need to <a href="cp-samples.zip"> download the sample files</a> if you want to follow along.
|
||||
These are stored in a ZIP archive because historically some browsers have
|
||||
enjoyed corrupting SHK archives. ZIP archives can be unpacked with <a href="http://www.winzip.com/">WinZip</a>,
|
||||
or under WinXP just open the "Zip folder" and copy the data out. </p>
|
||||
<p>This tutorial assumes that you are already familiar with using a computer and
|
||||
with Microsoft Windows.</p>
|
||||
<h2>Basics</h2>
|
||||
<p>Start by installing CiderPress if you haven't yet. There aren't really
|
||||
any options to set, so just let it do its thing.</p>
|
||||
<p>You should create a "scratch folder" to put tutorial files in. Open
|
||||
your "My Documents" folder, and create a new folder called "cpt"
|
||||
(CiderPress Tutorial). To keep things simple, put the two
|
||||
sample files (cp.sample1.bxy and cp.sample2.sdk) in this folder. If you
|
||||
are using Windows' default "hide extensions of known types" feature,
|
||||
these files will show up as "cp.sample1" and "cp.sample2"
|
||||
after CiderPress is installed.</p>
|
||||
|
||||
<p>Launch CiderPress. The easiest way to do this is to click on Start,
|
||||
then Programs, then the CiderPress group, and finally on the CiderPress entry.</p>
|
||||
<p>Glance through the menus and toolbar buttons. As you select items from
|
||||
the menu or move the mouse over a toolbar button, a description will appear on
|
||||
the "status bar" at the bottom of the screen. Most of the items
|
||||
are grayed out, because you don't have a file open.</p>
|
||||
<p>Let's fix that. Click on the "File" menu and select
|
||||
"Open...". A standard Windows dialog appears. Change to
|
||||
the folder where the sample files are, click on "cp.sample1",
|
||||
and then click on the "Open" button. Your display will look
|
||||
something like this:</p>
|
||||
<p><img border="0" src="cp-sample1.gif" width="320" height="184"></p>
|
||||
<p>If you've used ShrinkIt on the Apple II, this display should look
|
||||
familiar. If you haven't, you're looking at ProDOS files stored in a
|
||||
ShrinkIt archive. The columns show the filename, some file type
|
||||
information, and other useful stuff. The little yellow rectangle next to
|
||||
"sample.text" means it has a comment.</p>
|
||||
<p>You can change the sort order of the files by clicking on the column headers
|
||||
(e.g. click on "Size" to sort by size). Click a second time on
|
||||
the same header to reverse the sort order. You can restore the original
|
||||
archive sort order by clicking on the "Edit" menu, then
|
||||
"Sort", and "By original order".</p>
|
||||
<p>Let's take a look at what we have in the archive. Double-click on
|
||||
"sample.text", a simple text file. This opens the File Viewer
|
||||
window:</p>
|
||||
<p><img border="0" src="cp-sampletext.gif" width="320" height="220"></p>
|
||||
<p>The title bar tells you the name of the file you're looking at, and specifies
|
||||
the format converter that was used. In this case, "[Converted Text]" means
|
||||
that the carriage returns found at the end of each line of the text file were
|
||||
converted to Windows "CRLF" format, and any "high ASCII"
|
||||
characters were stripped out.</p>
|
||||
<p>You can click on the "Comment" button on the left to view the
|
||||
comment instead of the file contents. Clicking on the "Raw"
|
||||
button changes to an un-converted view (no change will be visible under
|
||||
Win2K/XP), and clicking on the "Hex" button changes to a hex
|
||||
dump. The "Best" button switches back to Converted Text.
|
||||
You can also select modes from the pop-up menu.</p>
|
||||
<p>Click "Done" to close the file viewer. Let's try this a
|
||||
different way. Select all files in the archive by clicking on
|
||||
"Edit" and then "Select all". Right click on one of
|
||||
the highlighted file names to bring up a short menu of commands. Click on
|
||||
"View...". The File Viewer is back, but this time the "Next" button is
|
||||
enabled. Click on it to advance to the next file, and again to see the
|
||||
third file. Move back and forth. One of the files is the text file
|
||||
we looked at earlier, another is a hi-res graphic image of a "double Bessel
|
||||
function", and the third is an AppleWorks word processing document.</p>
|
||||
<p>Use the "Next" and "Prev" buttons to find the AppleWorks
|
||||
document ("SAMPLE.AWP"). Try resizing the window, and watch how
|
||||
the margins, centering, and right justification work. Now switch to the
|
||||
hi-res image. Using the pop-up menu, change the format conversion from
|
||||
"Hi-Res / Color" to "Hi-Res / B&W". Notice how the
|
||||
color fringes disappear, leaving a sharper image. Some graphics look
|
||||
better in black & white than in color.</p>
|
||||
<p>When you're done,
|
||||
press the "Done" button to close the window. (NOTE for Windows
|
||||
98 users: right-justified text may not display correctly when the window is
|
||||
resized. This appears to be a bug in Win98. You can cut & paste
|
||||
from the file viewer window into Word or WordPad and see the correct text.)</p>
|
||||
<h2>Extracting Files</h2>
|
||||
<p>Adding files to and extracting files from Apple II archives is a little more
|
||||
complicated than just moving files around. When adding files, it may be
|
||||
useful to restore the ProDOS file type information. When extracting, it
|
||||
may be necessary to convert the data into a different format for it to be useful
|
||||
under Windows.</p>
|
||||
<p>We're going to extract and add the files twice. The first time we will
|
||||
preserve the original files exactly, the second time we will convert them to a
|
||||
format useful in Windows.</p>
|
||||
<p>Let's begin by extracting the files. Click on "Actions" and
|
||||
then "Extract...". This brings up a dialog with lots of options:</p>
|
||||
<p><img border="0" src="cp-extract.gif" width="455" height="418"></p>
|
||||
<p>The first thing we need to do is choose where the files will go. The
|
||||
folder listed at the top of the screen is probably not the one we want, so lets change
|
||||
it. Click on the folder icon in the upper-right corner, next to the
|
||||
filename entry field. This brings up the "Choose folder"
|
||||
dialog. Navigate through the folders until the "cpt" folder you
|
||||
created earlier is highlighted, and click "Select". (If you
|
||||
created "cpt" under "My Documents", don't be surprised if
|
||||
the name shown starts something like "C:\Documents and
|
||||
Settings\UserName\". This is normal for Win2K and WinXP.)</p>
|
||||
<p>In the "Files to extract" box, select "Extract all
|
||||
files". Make sure both checkboxes in the "miscellaneous"
|
||||
section are unchecked. Finally, click on the large button near the bottom
|
||||
that says "Configure to preserve Apple II formats". This will
|
||||
configure the remaining options so that files extracted can be added to a new
|
||||
archive that is as close as possible to the original.</p>
|
||||
<p>Once everything is set up as described (it should match the options shown in
|
||||
the picture above), click the "Extract" button. On a
|
||||
fast machine, you'll see little more than a flash as the files are extracted.</p>
|
||||
<p>If you open the "cpt" folder in Windows Explorer (open My Documents
|
||||
from the desktop or Windows Start menu, then open "cpt"), you will see three new files:</p>
|
||||
<ul>
|
||||
<li>DBL.BESSEL.PIC#062000</li>
|
||||
<li>SAMPLE.AWP#1ac0fd</li>
|
||||
<li>sample.text#04000</li>
|
||||
</ul>
|
||||
<p>The junk starting with "#" that was added to the filename is a file
|
||||
attribute preservation sequence. The first two digits are the ProDOS file type,
|
||||
the next four are the ProDOS aux type. For DBL.BESSEL.PIC, it's $06
|
||||
("BIN") and $2000 (the typical load location of a hi-res image).
|
||||
None of the files has a filetype that Windows recognizes, which makes sense:
|
||||
none of the files is in a format Windows likes.</p>
|
||||
<p>You might think that "sample.text" is a text file, and Windows
|
||||
likes text files, but it's not that simple. Rename "sample.text#04000"
|
||||
to "sample.text#04000.txt". Now Windows recognizes it as a text
|
||||
file. Double-click on it. If you have Windows
|
||||
"Notepad" as your default text viewer, you will probably notice that
|
||||
the file doesn't look right. Instead of line breaks there are funny little
|
||||
rectangles. Because we told CiderPress to preserve the original file
|
||||
formats, the carriage returns in the original file were left
|
||||
unmodified. Double-clicking on the other files will most likely not yield
|
||||
anything useful, because they're in formats that only an Apple II can readily
|
||||
handle.</p>
|
||||
<p>We don't have to stand for that, however. Go back to CiderPress, and
|
||||
click on "Actions" and "Extract..." again. This time,
|
||||
click on the filename in the edit box, and hit the right arrow key until you're
|
||||
all the way at the right of the filename. We're going to extract into a
|
||||
sub-folder called "win", so type "win" at the end of the
|
||||
name. (It should now look something like "C:\Documents and Settings\Administrator\My
|
||||
Documents\cpt\win".) There's no need to create the folder ahead of
|
||||
time, CiderPress will create it for us.</p>
|
||||
<p>Click on the large button labeled "Configure for easy access in
|
||||
Windows". Make sure "Extract all files" is selected, and
|
||||
leave the rest untouched.</p>
|
||||
<p>Click the "Extract" button. Stuff happens, probably faster
|
||||
than you can see it. Open the
|
||||
"cpt" folder in Windows Explorer again, and then open the new "win"
|
||||
folder. Inside, you will find:</p>
|
||||
<ul>
|
||||
<li>DBL.BESSEL.PIC.bmp</li>
|
||||
<li>SAMPLE.AWP.rtf</li>
|
||||
<li>sample.text.TXT</li>
|
||||
</ul>
|
||||
<p>(Again, if you have "known extensions" hidden, you won't see any of
|
||||
the ".xxx" shown above.)</p>
|
||||
<p>Double-clicking on the first launches the default Windows bitmap editor,
|
||||
where you can view the double-Bessel function in all its glory.
|
||||
Double-clicking the second launches the default Windows Rich Text Format editor,
|
||||
usually Windows WordPad or Microsoft Word. Double-clicking on the third
|
||||
opens the text file, nicely formatted for easy viewing.</p>
|
||||
<h2>Adding Files</h2>
|
||||
<p>Now that we've extracted some files, let's try adding them back into an
|
||||
archive.</p>
|
||||
<p>Click on "File" and then "New" and move over to
|
||||
"ShrinkIt archive". Create
|
||||
a new archive called "test.shk" in the "cpt" folder.
|
||||
Creating or opening an archive causes the currently open one to be closed, so
|
||||
"cp.sample1.bxy" disappears and "test.shk" takes its place.</p>
|
||||
<p>Click on "Actions" and then "Add files...". This
|
||||
brings up the Add Files dialog.</p>
|
||||
<p><img border="0" src="cp-add.gif" width="446" height="438"></p>
|
||||
<p>Leave the "File attribute preservation" setting on "Use file
|
||||
attribute preservation tags".
|
||||
This tells CiderPress to look for the "#062000" stuff, but not to get
|
||||
excited if it's not there. The remaining fields aren't important for what
|
||||
we're doing now, so leave them alone.</p>
|
||||
<p>Select the three files with the funny "#062000" stuff in the
|
||||
names. You can either click on the first and then shift-click on the last,
|
||||
or click on the first and then control-click on the other two. When all
|
||||
three have been selected, click "Accept". (You may notice a file
|
||||
with a name like "CPtmp_12345" in the folder. This is a temporary file used
|
||||
when ShrinkIt archives are opened, and can be ignored.)</p>
|
||||
<p>The files are added in a flash. Double-click on them to verify that
|
||||
they are all intact. Note that the file types and modification dates match
|
||||
the originals.</p>
|
||||
<p>Now lets add the second, converted set. Click "Actions" then
|
||||
"Add files...". Make sure "Include subfolders" is
|
||||
checked and "Strip folder names" is not checked. Click on
|
||||
"win" once (don't double-click it, or the folder will open) and then
|
||||
click "Accept". This adds everything in the "win"
|
||||
folder to the archive.</p>
|
||||
<p>You will end up with three new files, each prefixed with
|
||||
"win:". Your archive should look something like this:</p>
|
||||
<p><img border="0" src="cp-postadd.gif" width="480" height="276"></p>
|
||||
<p>The file types of the three you just added are all "NON", and double-clicking on them in the
|
||||
CiderPress file list is
|
||||
disappointing. This is because these files have crossed over to the Dark
|
||||
Side (i.e. they're in Windows formats now), and the File Viewer is only able to display Apple II formats. Once
|
||||
you have converted files into Windows BMP or RTF files, it's more appropriate to
|
||||
store them in a ZIP archive than a ShrinkIt archive.</p>
|
||||
<h2>Preservation or Accessibility</h2>
|
||||
<p>Generally speaking, when extracting files you can either choose to preserve
|
||||
the original format or choose to put them in a format easily accessible in
|
||||
Windows. CiderPress does not
|
||||
know how to un-convert BMP or RTF documents back to hi-res or AppleWorks format,
|
||||
so you should use one approach if you're planning to add the files back into an
|
||||
archive for use on an Apple II, and the other approach if you want to include
|
||||
them in Windows documents.</p>
|
||||
<p>Let's try an experiment. In the CiderPress file listing for the "test.shk"
|
||||
we created above, click on "DBL.BESSEL.PIC". Click
|
||||
"Actions" then "Extract...", and make sure the extraction
|
||||
path is still set to the "win" sub-folder of our "cpt"
|
||||
folder. Hit "Configure for easy access in Windows" and then check the
|
||||
box labeled "Add file attribute preservation". Make sure the button
|
||||
in "Files to extract" is set to "Extract 1 selected file".</p>
|
||||
<p>Click "Extract". You might expect to end up with "DBL.BESSEL.PIC#062000.bmp",
|
||||
but instead you get a warning about overwriting "DBL.BESSEL.PIC.bmp".
|
||||
Hit "Cancel" to cancel the extraction.</p>
|
||||
<p>Why didn't a file attribute preservation sequence get added to the filename?
|
||||
Because we have file converters turned on, and those change it to Windows
|
||||
format. Once the file is converted to a BMP, it's no longer an Apple II
|
||||
file, and trying to preserve the "BIN" file type is no longer appropriate. The situation is similar for BASIC programs
|
||||
converted to text listings and AppleWorks word processor documents converted to
|
||||
RTF. If we added SAMPLE.AWP.rtf with an "AWP" file type, and
|
||||
then tried to load the file in AppleWorks, we'd be greatly disappointed.</p>
|
||||
<p>We're done with this set of files, so select all files ("Edit" then
|
||||
"Select all", or hit Ctrl-A), click on "Actions", then
|
||||
"Delete...", and hit "OK" when asked to confirm the
|
||||
deletion. Go to "File" and select
|
||||
"Close". The empty archive is automatically removed.</p>
|
||||
<p>It's worth mentioning at this point that archives are not handled the same
|
||||
way word processing documents are. You can't make a set of changes, undo
|
||||
them, do some other things, and then save the results. (Technically
|
||||
speaking, it's possible, but CiderPress doesn't work that way.) Any change you
|
||||
make immediately modifies the archive, and there is no "undo".</p>
|
||||
<h2>Opening Archives Differently</h2>
|
||||
<p>The ".BXY" extension is used for a ShrinkIt archive with a Binary
|
||||
II header. CiderPress is capable of opening both ShrinkIt and Binary II
|
||||
archives, so how does it decide which to open?</p>
|
||||
<p>CiderPress tries to guess what you want, but it's easy to make your choice
|
||||
explicit. Click "File",
|
||||
then "Open...", and look at the "Files of type"
|
||||
selector. Click on it and change the setting to "Binary
|
||||
II". Double-click on "cp.sample1", which is a .BXY file.</p>
|
||||
<p>This time, when the file opens, you see only one entry. "SAMPLE.SHK"
|
||||
is the ShrinkIt archive embedded inside the Binary II file. If you want to
|
||||
convert a .BXY to a .SHK, all you have to do is open the archive as Binary II
|
||||
and then extract the ShrinkIt archive. CiderPress does not have the
|
||||
ability to write to Binary II archives, which is why the title bar now also says
|
||||
"(read only)".</p>
|
||||
<p>ShrinkIt archives are often found on disk images or inside other ShrinkIt
|
||||
archives, so CiderPress provides a quick way of opening them.
|
||||
Double-click on SAMPLE.SHK and watch as a new copy of CiderPress is launched. A
|
||||
copy of SAMPLE.SHK was written into the system temp folder, and the new
|
||||
CiderPress window opened it automatically. The file will be deleted when
|
||||
the second window is closed, which is why the new window is also marked
|
||||
"(read only)". Go ahead and close the second window before
|
||||
continuing.</p>
|
||||
<h2>Opening Disk Images</h2>
|
||||
<p>Disk images are very different from ShrinkIt archives. They come in
|
||||
many different file formats, can be written with sectors scrambled in different
|
||||
orders, and can be in different filesystem formats (DOS, ProDOS, etc.).
|
||||
With most programs you have to know a fair bit about a disk image before you can
|
||||
access it, possibly having to convert it from one format to another, but with
|
||||
CiderPress that's not necessary.</p>
|
||||
|
||||
<p>Click "File" then "Open...", select "Disk
|
||||
Images" in the "Files of type" selector, and double-click
|
||||
cp.sample2. The disk image opens, and about 35 files are
|
||||
displayed. Notice that in the "Format" column, some files are
|
||||
listed as "ProDOS" and some as "DOS". This is because
|
||||
the disk image is of an 800K ProDOS volume with a 200K DOS 3.3 volume embedded
|
||||
in it. The title bar of the window now shows that this is a disk image of
|
||||
a ProDOS volume called "/CP.TEST".</p>
|
||||
<blockquote>
|
||||
<p>(For those interested in technical details: CiderPress passed
|
||||
"cp.sample2.sdk" to the "DiskImg" library and asked it to
|
||||
open the file. DiskImg opened the file, figured out that it was a
|
||||
compressed ShrinkIt disk archive, and unpacked it to a buffer in memory.
|
||||
The disk structure was scanned, and DiskImg determined that it was a ProDOS
|
||||
volume in ProDOS sector order. It then examined the structure of every
|
||||
file on the disk, and determined that there was an embedded volume. This
|
||||
second volume was then opened, scanned, and found to be a DOS 3.3 disk in
|
||||
ProDOS sector order. The contents of the DOS volume were scanned. Control
|
||||
then returned to the CiderPress application, which took the list of files and
|
||||
displayed them in the window. Don't try that on an empty stomach!)</p>
|
||||
</blockquote>
|
||||
<p>The files are shown in a "flat" list, though the real disk has most
|
||||
of the files in folders. For example, "Graphics:WORLD.MAP.PIC"
|
||||
is actually a file called "WORLD.MAP.PIC" in a folder called
|
||||
"Graphics". The files in the DOS 3.3 sub-volume aren't actually
|
||||
visible from ProDOS, so CiderPress prepends "_DOS001:" to make the
|
||||
separation clear.</p>
|
||||
<p>Try double-clicking on some files to view them. You should probably
|
||||
start by double-clicking on "ReadMe",. a file in TeachText format that
|
||||
describes the contents of the disk. Try some BASIC programs like
|
||||
"STARTUP" in the ProDOS area or "ANIMALS" in the DOS area.
|
||||
Use the conversion selector to turn color highlights on and off.</p>
|
||||
<p>You may notice that some of the files appear to be compressed -- the
|
||||
"Ratio" column isn't 100%. This is because the files are
|
||||
"sparse". ProDOS and DOS 3.3 have the ability to store empty
|
||||
disk blocks without using lots of disk space. The difference between
|
||||
"Size" and "Packed" represents the space saved by using
|
||||
sparse blocks.</p>
|
||||
<p>If you double-click on "TestFiles:SPARSE", you will get an error
|
||||
message from the File Viewer indicating that the file is too large. The
|
||||
file is actually 16MB, but because it's almost entirely sparse blocks it only
|
||||
occupies about 1.5KB. If you
|
||||
want, you can view this file by increasing the file viewer limit. Click on "Edit", then
|
||||
"Preferences...", then on the "File Viewer" tab. The
|
||||
"Viewer file size limit" can be set in 1K increments. There are
|
||||
a number of other configurable items in here, including settings that let you
|
||||
default hi-res and double-hi-res graphics to black and white. Click on the "Help" button or use the question mark icon
|
||||
in the window title bar to get more information about specific things.
|
||||
Click on "Cancel" to close the dialog.</p>
|
||||
<h2>Adding and Extracting Disk Images</h2>
|
||||
<p>Click on the "File" menu, then "Open...", change
|
||||
"Files of type" to "ShrinkIt
|
||||
Archives", and open "cp.sample2". You should see a
|
||||
single entry, for an 800K disk image. (If you want, double-click on the
|
||||
entry to pop open a second instance of CiderPress with the disk image contents
|
||||
in it. Close it when you're done.)</p>
|
||||
<p>Click on "Actions" and "Extract...". Set the
|
||||
extract folder to "cpt", and click "Configure for easy access in
|
||||
Windows". Note that "Extract disks as .2MG" is
|
||||
checked. Click "Extract".</p>
|
||||
<p>If you open the "cpt" folder with Windows Explorer, you will find a new file called
|
||||
"CP.TEST.2mg" (or just "CP.TEST" if extensions aren't being
|
||||
shown). Depending on how your file associations are
|
||||
configured, you should be able to double-click this file and launch the default
|
||||
2MG application (which is probably an Apple II emulator or CiderPress; file
|
||||
associations can be set from within CiderPress by clicking "Edit",
|
||||
"Preferences", and then the "Associations..." button).</p>
|
||||
<p>That was easy enough. Now let's try adding the disk image to an
|
||||
archive. Click on the "File" menu then "New -> ShrinkIt archive", and create a new archive called "mydisk.shk" in the
|
||||
"cpt" folder. Click on the "Actions" menu then
|
||||
"Add disk image...". Navigate to the "cpt" folder if
|
||||
you're not there already, click on "CP.TEST", and click
|
||||
"Open". The disk image is added.</p>
|
||||
<p>Let's try a different way. Extract the disk image you just added (still
|
||||
working in "mydisk.shk), but this time click on "Configure to preserve
|
||||
Apple II formats.". Click "Extract" to create
|
||||
"CP.TEST#000640i". (The "640" is the number of
|
||||
blocks in hexadecimal, and the "i" indicates that it's a disk
|
||||
image.) This file is a ProDOS-ordered sector image; if you check the
|
||||
"Add type extension" box before extraction, it will be given a
|
||||
".PO" extension and can be opened with the default
|
||||
".PO" viewer (usually CiderPress or an Apple II emulator).</p>
|
||||
<p>Let's add it back to the archive. We could use the "Add
|
||||
disks" menu item, but we have another option. Click on "Actions"
|
||||
and then "Add files...". Make sure the "File attribute preservation" setting is on "Use file
|
||||
attribute preservation tags",
|
||||
click on "CP.TEST#000640i", and click "Accept".
|
||||
When asked if you want to overwrite the file, click "Yes".</p>
|
||||
<p>Nothing appears to happen, but you've actually just replaced the disk image
|
||||
that was in the archive with the new one. You were able to add the disk image
|
||||
with the "Add files" dialog because of the file attribute preservation
|
||||
strings (the "#000640i" part). If you had set "File
|
||||
attribute preservation" to "Ignore file attribute preservation flags", you would
|
||||
have added a file called "CP.TEST#000640i" instead of a disk image
|
||||
called "CP.TEST".</p>
|
||||
<h2>Creating and Adding Files to Disk Images</h2>
|
||||
<p>Working with disk images is a little different than working with ShrinkIt
|
||||
archives. Filenames have limited lengths and may only contain certain
|
||||
characters, file lengths are limited, and on non-ProDOS volumes the selection of
|
||||
file types will be limited. On the plus side, disk images can be used
|
||||
directly by Apple II emulators.</p>
|
||||
<p>Let's start by creating a disk image. Click on the "File"
|
||||
menu, then "New -> Disk image...". This opens the Create Disk
|
||||
Image dialog.</p>
|
||||
<p><img border="0" src="cp-createdisk.gif" width="519" height="353"></p>
|
||||
<p>Leave the values set to the defaults and click "OK" to create a
|
||||
140K ProDOS image. When the "save" dialog comes up, type "testdisk"
|
||||
into the "file name" field. Leave the file type set to
|
||||
"DOS-ordered image (*.do)". Click "Save".</p>
|
||||
<p>Your brand-new ProDOS disk will open automatically. The disk has one
|
||||
entry for the volume directory, called ":NEW.DISK". Let's add
|
||||
some files.</p>
|
||||
<p>Click "Actions" then "Add files...". Select the
|
||||
three files with "#123456" stuff in the filenames (DBL.BESSEL.PIC#062000,
|
||||
SAMPLE.AWP#1ac0fd, and sample.text#040000.txt) by clicking on the first one and
|
||||
control-clicking on the other two. Make sure "use file attribute
|
||||
preservation tags" is set.</p>
|
||||
<p>You will notice that the "Text conversion" options are now
|
||||
available. The files we're adding are from an Apple II, so we don't want
|
||||
to mess with them. Click on "Don't convert text files".
|
||||
Now click "Accept" to add the files. You should be back in the
|
||||
CiderPress file listing, with four files on the screen (the volume directory and
|
||||
the three files you just added). Double-click on them to verify that
|
||||
they're all okay.</p>
|
||||
<p>You may notice that only "sample.awp" is in lower case.
|
||||
That's because, by default, CiderPress adds files to ProDOS disks in upper-case
|
||||
only. If you use a version of ProDOS 8 older than v1.8, you will get
|
||||
errors on disks with lower-case names. (You can change this behavior from
|
||||
the disk images preferences screen.) So why is "sample.awp" in
|
||||
lower case? Because AppleWorks files have lower-case flags in their
|
||||
"aux type" field. If CiderPress sees a file with type AWP, ADB,
|
||||
or ASP, the flags in the aux type are used.</p>
|
||||
<p>One nifty thing about ProDOS disks is that you can tuck files into
|
||||
subdirectories (usually called "folders" in Apple-speak). Let's
|
||||
create one now. You have to tell CiderPress which directory the new
|
||||
subdirectory will appear in, so start by clicking on the volume directory
|
||||
(":NEW.DISK"). Click on "Actions" then "Create
|
||||
subdirectory...". Type "My Stuff" as the name. Click
|
||||
"OK". A new subdirectory, called "MY.STUFF",
|
||||
appears. (If lower case were enabled, it would have been added as "My
|
||||
Stuff" instead.)</p>
|
||||
<p>Suppose we want to add more files. Where do they go? In the
|
||||
volume directory, or in MY.STUFF? Let's find out. Click on a blank
|
||||
area of the window so that nothing is highlighted. (You may still see a
|
||||
thin dashed line around one entry; that's okay.) Click on
|
||||
"Actions" then "Add files...". You will see a dialog
|
||||
that asks you to pick the location.</p>
|
||||
<p><img border="0" src="cp-selectloc.gif" width="336" height="478"></p>
|
||||
<p>As you can see, you are able to add files to the volume directory or the
|
||||
folder you created. As noted in the "tip" at the bottom, you can
|
||||
avoid seeing this dialog by clicking on the target subdirectory before you
|
||||
select "Add files...".</p>
|
||||
<p>We don't really want to add anything here, so click "Cancel".
|
||||
Close the disk image by selecting "Close" from the "File"
|
||||
menu. Let's create another image, this time a DOS 3.3 disk. From
|
||||
"File", select "New -> Disk image...".</p>
|
||||
<p>Click on the "DOS 3.3" button in the upper left. The ProDOS
|
||||
volume name entry field is greyed out, the DOS 3.3 options in the upper right
|
||||
corner become active, and our choice of sizes is now limited to just 140K
|
||||
disks. Leave the defaults alone and click "OK". Click on
|
||||
"testdisk.do" (the disk we recently created) and click
|
||||
"Save". When asked if you want to replace the existing file,
|
||||
click "Yes".</p>
|
||||
<p>Now we have open an empty DOS 3.3 disk image. Let's add a file.
|
||||
Click "Actions" then "Add files...". Open up the
|
||||
"win" folder inside "cpt", and select "sample.text"
|
||||
(or "sample.text.TXT"). Click "Accept".</p>
|
||||
<p>The file has been added, but something is strange. Our text file has
|
||||
type $F2. The reason this happened is because CiderPress didn't see it as
|
||||
an Apple II file, and gave it a file type of NON. However, there is no
|
||||
direct equivalent to NON for DOS 3.3. Instead, CiderPress used the DOS
|
||||
file type 'S'. There's no ProDOS equivalent to 'S', so CiderPress displays
|
||||
it as $F2. Because DOS 3.3 'S' files don't have an explicit file length,
|
||||
the length is rounded off to 512 (two DOS sectors).</p>
|
||||
<p>Yuck. Fortunately there's a simple way around this. Click
|
||||
"Actions" and "Add files..." again. This time, click
|
||||
the "Use tags and guess type from extension" button. This tells
|
||||
CiderPress that we want it to guess the type of the file from the filename
|
||||
extension. Since we're adding a text file to a DOS disk, we also want it
|
||||
to convert from Windows format (low ASCII, CRLF) to DOS 3.3 format (high ASCII,
|
||||
CR), so click on the "Convert text files by file type" button.</p>
|
||||
<p><img border="0" src="cp-dosadd.gif" width="480" height="401"></p>
|
||||
<p>Click on "sample.text" again, and click "Accept".
|
||||
When it asks you if you want to replace the previous file, say
|
||||
"Yes". You should now have a text file with a reasonable
|
||||
length. If you double-click on it and view it in hex dump mode, you'll see
|
||||
that it's in "high ASCII" with carriage returns, as all good DOS 3.3
|
||||
text files should be.</p>
|
||||
<p>Select "Close" from the "File" menu to close the disk
|
||||
image.</p>
|
||||
<h2>Wrapping Up</h2>
|
||||
<p>CiderPress is a powerful tool with lots of features. Start with the
|
||||
default settings and quick configuration buttons. The additional flexibility is there if you need
|
||||
it. Click the "Help" button on a screen for detailed help on
|
||||
that screen, or select "Help" then "Contents..." to start
|
||||
from the beginning. In many screens you can click on a question mark
|
||||
button in the title bar and then click on a button to get more information on
|
||||
that button.</p>
|
||||
|
||||
<p><a href="../index.htm">Return to CiderPress site</a></p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
Loading…
Reference in New Issue