SCADM - SAM Coupé Advanced Disk Manager

Version 0.75 pre-alpha  (2019-01-04)

Author: Sir David /speccy.pl <sirdavid.samcoupe@gmail.com>

SCADM is still in pre-alpha stage. If you find any disk image red wrong, please
let me know at sirdavid.samcoupe@gmail.com or in any other way. Any
other suggestions are also welcome!

1. WHAT IS SCADM? 

SCADM is an utility to manage the images of SAM Coupe diskettes. 
You can do almost every disk operation as on the real machine and much more. 
As SAM Coupe is the succesor of ZX Spectrum series and it can use some of 
ZX Spectrum files (eg. screens), SCADM can also read different ZX Spectrum
formats, such as TAP,TZX,DSK,TRD,SCL,MGT,IMG, but only the standard ones
(without copy protection).

There is also a possiblity to fully manage ZX Spectrum disks in the DISCiPLE 
/+D G+DOS (MGT) format, as it is compatibile with SAMDOS.

2. HOW TO USE SCADM?

On the main screen there are two file panels, representing two SAM's floppy
drives. To simplify it's usage (and the program code), the second drive is
'read only'.

a) Disk image loading

Loading of disk images is possible in a different ways. The first and most
obvious is by choosing 'Open Image 1' or 'Open Image 2' (for dvide 1 and 2) in
the 'Image' menu. But there are also some other ways:
- 'Open Next Image/Record 1' (or Previous, or 2) - opens next (previous) image 
  in the same directory of the PC hard disk as currently opened image (sorted
  alphabetical), or next (previous) image (by record number) on the currently
  opened SAM hard disk image.
- 'Open Recent Image 1' (or 2) - opens the list of previously used images to
  choose the one to open.
- Paste form clipboard to drive 1 by Ctrl+v. 
- Drag and drop image to drive 1.
- 'Reopen Disk/Record 1' (or 2) - opens the same image again, useful for undo
  all changes.

b) Disk Operations
- "New Image" - creates the new, clean image. At this moment we can choose 
  the image type: MGT, SAD i DSK (only in EDSK format), additional tracks for 
  directory (to save more than 80 files on disk) and DOS version. In EDSK we
  can also change the default sector layout and the shift between two successive
  tracks.
- "Reopen Disk" - opens the same disk again, canceling last changes.
- "Save Image" - saves image to disk under the same name and format.
- "Save Image As..." - saves the image under choosen name and format.

c) File Operations

d) Image Viewer

e) Screen Editor

f) BASIC Viewer

g) Binary Viewer

h) Machine Code Viewer

3. WHAT'S NEW?

version 0.76 (2021-01-19)
 + Added moving to the first/last image in the current folder
   (Ctrl+Home/Ctrl+End)
 + Added search of strings or numbers in binary file view:
   Ctrl+f/F5 - find, F3 - find next 
 + Added search of strings in the BASIC editor
 + Free slots on the file list are now shown as [empty] or [deleted] 
   to see at sight deleted files which can be restored
 + After saving BASIC file it's automatically re-read to see how it was
   interpreted
 * Fixed bug of hdf image destruction while saving
 * Fixed various bugs in BASIC editor
 * Fixed some bugs causing program hangups

version 0.75 (2019-01-04)
 + In BASIC editor all char codes and variables area are now preserved
 + Added variables preview in BASIC viewer (only in SAM BASIC)
 + Added binary file comparsion
 + Added binary image comparsion
 + In picture importer, added possibility to set transparent color or 
   background color when imported picture is smaller than SAM's resolution
 * Fixed some bugs in BASIC viewer/editor
 * Fixed bug with replacing disks when D1 in subdirectory view
 * Fixed bug with "Save as" image when the file extension and the actual
   image type are different

version 0.74 (2018-09-26)
 + Added ZX Spectrum gigascreen pictures view
 + Added export of the screens in PNG format
 + Added creating the new and clean SAM BASIC file
 + Added splitting of CODE files
 * Fixed some minor bugs in the image importer

version 0.73 (2018-09-07, unofficial)
 + Added image (picture) import.
 + Added batch floppy image converter.
 + Added file finder on floppy images.
 * Fixed bug in BASIC import: STR$ was added as STRS.

version 0.72 (2018-04-17)
 + Added support for compressed images.
 + Added possibility to change main window's height (the arrow at the
   right-bottom)
 + Added possibility to change the line spacing in directory listing (to fit
   more files).
 + Added possiblity to show files (eg. pictures, binary, BASIC) on D2, but only
   by mouse double-click.
 + Added the whole palette view in "Edit Color" window, with possiblity to
   choose the color by mouse click.
 + BASIC viewer is now also an editor.
 + Added "Duplicate File on D1" option, eg. for backup files before editing.
 + "Disk Usage" now shows also sector layout on disk (only in edsk, for other
   formats standard 1 sector shift is shown).
 + Added possiblity to change sector layout while creating the new edsk image.
 + Added QDOS and shorter SAMDOS in "New Disk".
 + Added support for pictures saved in SAVE MODE 2 (in MasterBasic). A few
   examples are added to the attached sample disk.
 + Added export pictures to BMP in picture viewer.
 * Fixed opening of larger .sad files (more than 83 tracks)
 * Fixed opening of smaller .dsk files (in edsk standard) 
 * Fixed some bugs in Screen Editor.

version 0.71 (2016-11-30)
 x Due to transition to the new Lazarus version (1.6.2), all code connected 
   with PC disk access had to be modified.
 * Fixed loading next/pravious image from the current directory - faulty images
   are skipped.
 * Fixed error in saving SAM files with certain lengths - sectors used could
   have been set incorrectly. Fortunately these files are properly read despite
   the "End of file" message.

version 0.70 (2016-10-15)
 + Added choosing of intarface language.
 + Added support for subdirectories.
 + Added support for file attributes.
 + Added undeleting of erased files.
 + Added editing of disk name.
 + Added detailed file info.
 + Added disk info.
 + Added support for disks with more than 80 tracks a side (writing on such
   disks can corrupt existing files!)
 + Added support for disks with bad sectors.
 + Added support for disks with larger directory (more than 80 files on disk). 
 + Added possiblity to open disk in emulator when the hard disk record is
   opened (temporary disk image is created).
 + Added possiblity to create an new disk with certain operating system on it.
 + Added asking about saving changes.
 + Added showing screens in ZX SNP files.
 + Added possiblity to choose MODE and start offset of opened pictures.
 + Added support for MODE 3 in the screen editor.
 + Added possiblity to show pictures in TIMEX modes (multicolor and hires).
 + Added 'Move Screen' to the screen editor - you can move the whole screen by
   draggig it.
 x Changed file panels view - added the information of sectors used, attributes
   and compression (by SAVE MODE in Master BASIC).
 * Fixed copying of compressed files. 
 * Fixed some errors in BASIC viewer and importer.
 * Fixed pixel counter in MODE 1 and 2. 
