SCADM - SAM Coupé Advanced Disk Manager

Wersja 0.72 pre-alpha  (2018-04-17)

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

SCADM jest wciąż w fazie pre-alpha. Jeżeli znajdziesz jakikolwiek dysk, który
jest odczytywany niewłaściwie, proszę daj mi znać na powyższy e-mail lub w
dowolny inny sposób (np. forum speccy.pl, Facebook). Dotyczy to również
jakichkolwiek problemów i sugestii związanych z programem.

1. CO TO JEST SCADM? 

SCADM jest programem służącym do kompleksowej obsługi obrazów dyskietek 
komputera SAM Coupe. Za jego pomocą można wykonywać niemal wszystkie operacje
dyskowe tak, jakby się je robiło na rzeczywistym komputerze, a także o wiele
więcej. Jako że SAM Coupe jest następcą komputerów z serii ZX Spectrum i można
na nim otwierać i używać niektóre pliki z ZX Spectrum (np. obrazki), SCADM
potrafi też odczytywać pliki z obrazów ZX Spectrum w formatach TAP, TZX, DSK,
TRD, SCL, MGT, IMG, jednak tylko standardowe (bez zabezpieczeń przed kopiowaniem).

Dodatkowo można w pełni obsługiwać obrazy dyskietek z ZX Spectrum w formacie
DISCiPLE /+D G+DOS (obrazy MGT), jako że jest kompatybilny z systemem SAMDOS.

2. JAK UŻYWAĆ SCADM?

Główny ekran programu przypomina dwupanelowy menedżer plików typu Commander, a
jego dwa panele są na stałe przypisane do stacji dyskietek 1 i 2 komputera SAM
Coupe. Dla ułatwienia używania (i kodu programu) stacja nr 2 pracuje w trybie
"tylko do odczytu".

a) Wczytywanie obrazów dyskietek

Istnieje kilka sposobów otwierania obrazów dyskietek. Najprostszym i najbardziej
oczywistym jest wybranie z menu "Obraz" opcji "Otwórz obraz 1" lub "Otwórz obraz 2"
(dla stacji 1 lub 2). Ale są też inne możliwości:
- "Otwórz następny obraz/rekord 1" - ładuje następny (bądź poprzedni) obraz w
  tym samym katalogu co obecnie otwarty plik na dysku PC (alfabetycznie), albo
  następny (poprzedni) rekord na otwartym właśnie obrazie twardego dysku.
- "Otwórz ostatnio używany obraz 1" (lub 2) - otwiera listę poprzednio
  używanych obrazów i umożliwia wybranie jednego z nich. 
- Wklejenie ze schowka do stacji 1 przez Ctrl+v.
- Przeciągnięcie obrazu do okna programu - ładuje go do stacji 1. 
- 'Odśwież obraz/rekord 1' (lub 2) - ponownie ładuje i otwiera ten sam obraz,
  przydatne w celu pominięcia wszystkich wprowadzonych zmian.

b) Operacje na obrazie
- "Nowy obraz" - utworzenie nowego, czystego obrazu dyskietki. Do wyboru format pliku
  obrazu: MGT, SAD i DSK (tylko w standardzie EDSK), dodatkowe ścieżki na katalog
  (co umożliwia zapisanie większej ilości plików na jednej dyskietce niż 80) oraz
  możliwość wrzucenia od razu wybranej wersji DOS-u. Obraz w standardzie EDSK ma
  dodatkową możliwość ustawienia innej niż standardowa kolejności sektorów na ścieżce
  i przesunięcia względem siebie początków kolejnych ścieżek.
- "Odśwież obraz" - otwiera ponownie ten sam obraz, co ostatnio, anulując ostatnio
  wprowadzone zmiany.
- "Zapisz obraz" - zapisanie obrazu na dysku z zachowaniem nazwy pliku i jego
  formatu.
- "Zapisz obraz jako" - zapisanie obrazu pod wybraną nazwą i w wybranym formacie. 
  Uwaga: Tylko format EDSK posiada zapisane informacje o uszkodzonych lub 
  niestandardowych sektorach (np. zabezpieczenia przed kopiowaniem), natomiast format
  MGT jest dodatkowo ograniczony do standardowej wielkości dyskietki (80 ściezek na 
  stronę). 

c) Operacje na plikach

d) Przeglądarka obrazków

e) Edytor obrazków 

f) Przeglądarka plików BASICa

g) Przeglądarka binarna

h) Przeglądarka kodu maszynowego

3. CO NOWEGO?

wersja 0.76 (2021-01-19)
 + Dodane przechodzenie do pierwszego/ostatniego obrazu w folderze
   (Ctrl+Home/Ctrl+End)
 + Dodane wyszukiwanie ciągu znaków lub liczb w widoku binarnym pliku:
   Ctrl+f/F5 - znajdź, F3 - znajdź następny
 + Dodane wyszukiwanie tekstu w edytorze BASICa
 + Wolne sloty na liście plików są teraz pokazywane jako [pusty] lub
   [usunięty] aby od razu było widać, który plik może zostać przywrócony
 + Po zapisie programu z poziomu edytora BASICa automatycznie następuje 
   jego ponowny odczyt w celu pokazania jak został zinterpretowany
 * Naprawiony błąd przy zapisie do obrazu dysku twardego (hdf) powodujący
   nieodwracalne uszkodzenie tego obrazu
 * Naprawione różne błędy w edytorze BASICa
 * Naprawione kilka błędów powodujących wieszanie się programu w określonych
   sytuacjach

wersja 0.75 (2019-01-04)
 + W edytorze plików BASIC zachowane zostają znaki o kodach normalnie
   niewyświetlanych oraz obszar zmiennych bezpośrednio za programem
 + Dodany podgląd zmiennych w przeglądarce plików BASIC (tylko SAM BASIC)
 + Dodana binarna porównywarka plików
 + Dodana binarna porównywarka obrazów dyskietek
 + W imporcie obrazków dodana możliwość ustawienia wartości dla koloru 
   przeźroczystego lub koloru tła obrazków mniejszych niż rozdzielczość SAMa
 * Poprawione kilka błędów w przeglądarce/edytorze BASICa
 * Poprawiony błąd występujący przy zamianie orazów miejcami, gdy w D1 był 
   podgląd podkatalogu
 * Poprawiony błąd z nazwą pliku zapisywanego przez "Zapisz jako" 
   - rozszerzenie mogło być niezgodne z rzeczywystym typem pliku

wersja 0.74 (2018-09-26)
 + Dodana przeglądarka obrazków w trybie gigascreen z ZX Spectrum
 + Dodany eksport obrazków do PNG (było tylko BMP)
 + Dodane tworzenie nowego, pustego pliku SAM BASIC
 + Dodane dzielenie pliku typu CODE na dwie części
 * Poprawione drobne błędy w imporcie obrazków

wersja 0.73 (2018-09-07, nieoficjalna)
 + Dodany import obrazków
 + Dodany konwerter obrazów dyskietek
 + Dodane wyszykiwanie plików na obrazach dyskietek
 * Poprawiony błąd w imporcie BASICa: STR$ było dodawane jako STRS

wersja 0.72 (2018-04-17)
 + Dodana obsługa skompresowanych obrazów dyskietek. Plik może mieć 
   rozszerzenie .zip lub właściwe dla danego formatu dyskietki.
 + Dodana możliwość zmiany wielkości głównego okna - dwie wielkości do wyboru,
   zmieniane "strzałką" w prawym dolnym rogu.
 + Dodana możliwość zmiany odstępu między wierszami w listingu katalogu
   (do ustawienia w Opcjach). Umożliwia zmieszczenie większej liczby pozycji
   katalogu w oknie programu.
 + Prawy panel (D2) służy już nie tylko do kopiowania plików do D1, można 
   w nim też przeglądać pliki (np. obrazki, binarne, BASIC), jednak jedynie
   dwuklikiem myszy.
 + W przeglądarce obrazków, w oknie wyboru koloru dodany widok całej dostępnej
   palety, z możliwością wyboru koloru.
 + Dodana możliwość edycji plików BASIC bezpośrednio w przeglądarce.
 + Dodana możliwość zduplikowania pliku na dysku D1, np. w celu zrobienia
   kopii bezpieczceństwa przed edycją.
 + Przy tworzeniu czystej dyskietki dodana możliwość wyboru dwóch kolejnych
   DOS-ów: QDOS i krótszy plik SAMDOS (z wyciętymi zerami na końcu)
 + Dodane przeglądanie skompresowanych obrazków w SAVE MODE 2 MasterBasic-a
   (taki plik jest oznaczony cyfrą 2 na końcu wiersza). Kilka przykładowych
   obrazów zostało dodanych do załączonej, przykładowej dyskietki.
 + Dodany eksport obrazków SAMa do BMP z poziomu przeglądarki obrazków.
 + Widok zajętości dysku pokazuje również ułożenie sektorów na dyskietce
   (np. MasterDOS miał zmniejszone przesunięcie z 2 do 1 sektora dla kolejnych
   ścieżek w porównaniu z SAMDOS-em, przez co transfer był nieco szybszy).
   Uwaga: dane o położeniu sektorów zapisane są jedynie w standardzie edsk.
 + Przy tworzeniu dyskietki w standardzie edsk można zdefiniować niestandardowe
   ułożenie sektorów na ścieżkach.
 * Poprawione otwieranie pliku .sad dla dysków większych niż 83 ścieżki.
 * Poprawione otwieranie pliku .dsk (w standardzie edsk), gdy plik jest mniejszy
   niż przy standardowych 80 ścieżkach (np. gdy ma wycięty nieużywany obszar
   na końcu).
 * Poprawione różne drobne błędy w edytorze obrazka.

wersja 0.71 (2016-11-30)
 x W związku z przejściem do nowej wersji Lazarus'a (1.6.2) konieczne było
   poprawienie procedur związanych z operacjami na dysku PC, spowodowane zmianą
   w obsłudze standardów kodowania znaków narodowych.
 * Przy przejściu do następnego/poprzedniego obrazu z bieżącego katalogu,
   błędne i niemożliwe do otwarcia obrazy są teraz automatycznie pomijane.
 * Poprawiony błąd przy zapisie niektórych plików na obraz dyskietki - przy
   pewnych, specyficznych długościach pliku przy późniejszym odczycie pojawia 
   się błąd "End of file", ale na szczęście plik jest odczytywany prawidłowo.

wersja 0.70 (2016-10-14)
 + Dodany wybór języka interfejsu i dodany język polski.
 + Dodana obsługa podkatalogów. 
 + Dodana obsługa atrybutów plików.
 + Dodane przywracanie skasowanych plików.
 + Dodana edycja nazwy dysku.
 + Dodane szczegółowe dane o pliku.
 + Dodane informacje o dyskietce.
 + Dodana obsługa dyskietek o liczbie ścieżek na stronie większej niż 80
   (zapis na takiej dyskietce może spowodować uszkodzenie istniejących plików).
 + Dodana obsługa dyskietek zawierających uszkodzone sektory.
 + Dodana obsługa dyskietek z większym katalogiem (więcej niż 80 plików na
   dyskietce).
 + Dodana możliwość otwierania w emulatorze dyskietki będącej rekordem z
   twardego dysku (tworzony jest tymczasowy obraz dyskietki).
 + Dodana możliwość tworzenia nowej, czystej dyskietki z wybranym konkretnym
   systemem lub bez.
 + Dodane pytanie o zapisanie zmian przy wyjściu.
 + Dodane pokazywanie obrazków z plików typu ZX SNP.
 + Dodana możliwość zmiany trybu pokazywanego obrazka i przesunięcia jego
   początku w pliku (można zobaczyć obrazek, który nie zaczyna się od początku
   pliku, a jest gdzieś dalej).
 + Dodana obsługa obrazków w MODE 3 w edytorze obrazków.
 + Dodany podgląd obrazków w formacie TIMEX (multicolor i hires), testowane
   tylko dla plików zapisanych przez emulator Fuse.
 + Dodana możliwość przesunięcia całego obrazu w edytorze obrazków poprzez
   przeciągnięcie myszką.
 x Zmieniony nieco widok paneli z plikami w głównym oknie - dodane informacje o
   nazwie dysku, zajmowanych przez pliki sektorach, atrybutach i ewentualnej
   kompresji plików (przez SAVE MODE w Master BASICu).
 * Poprawione kopiowanie skompresowanych plików. 
 * Poprawione drobne błędy w przeglądarce i importerze plików BASICa.
 * Poprawiony licznik punków w MODE 1 i 2 w przeglądarce obrazków. 
