Home
Name Modified Size InfoDownloads / Week
dircbm binaries 2024-04-30
readme.txt 2024-04-30 13.5 kB
Totals: 2 Items   13.5 kB 30
DIRCBM.WCX V0.14
================
(Deutsch weiter unten)

English:
--------
Plugin for TotalCommander to extract/view/create CBM 
(Commodore Business Machines) disk images

Currently the following disk image formats are supported for reading, creating 
and writing:
-D64 (Commodore 64 1541 disk image)
  - including 40 track formats like SpeedDos and DolphinDos
  - if 40 track format is not recognizable as one of these 
    (e.g. other format or disk is full) -> image is R/O
-D71 (1571 images)
-D80 (8050 images)
-D81 (1581 images)
-D82 (8250 images)

Currently the following tape formats are supported for reading only:
-T64 (C64 tape images)

The unpacked file sizes show the actual file sizes in bytes. The packed file 
size shows the size in "blocks" (except for T64 where both sizes are in bytes).

The file sorting should be turned off (Ctrl-F7), to get the original sorting
order.

With an active setting for scratched files these will be shown as hidden files.

Functions:
----------
-read / write / extract files from/to the image
-create disk images (Alt-F5)
  - with standard or customized interleave (via config dialog)
  - with default or customized disk title, disk ID and DOS ID 
    (via config dialog)
  - with optional error information space added (via config dialog)
  - with option to write data starting from track 1 (via config dialog)
  - with option to use dir sectors for data (via config dialog)
-deleting of files (disk images only)
-replace illegal file characters with '_' ( \ / : * ? " < > | )
-special settings are in DIRCBM.INI (normally in plugin path); 
 see INI file for more details

History:
--------
V0.14:
Added:
- option in dialog to write data in track order starting from track 1 
  (track 1, 2, 3, ...)
- option in dialog to use directory sectors for data too 
  (after all "normal" blocks are used up)
  - also a checking is added if all the data and all necessary dir entries will
    fit on the disk.

Changed:
- some code cleanups

Deleted:
-

Fixed:
- bug in BAM initialization for 1581


V0.13
Added:
- disk images D64 40 track, D71, D80, D81, D82 are writeable now 
  - create image, add files, delete files
  - correct handling of interleaves for directories and files 
    (according to article from Joe Forster)
- dialog added for setting disk image attributes when creating images 
  with Alt+F5
  - interleaves (file and dir), DOS version, disk title, disk ID, adding error 
    information space
  - D64 40 track format creation
    - SpeedDos
    - DolphinDos
- ini file settings "eraseDeletedSectors" and "logLevel" 
  (see INI file for more details)
  - if "eraseDeletedSectors" is 1 then if you delete a file the sectors not 
    used any more are filled with 0x00
  - "logLevel" defines the amount of log messages sent to DebugView

Changed:
- file sizes are now reported in bytes; packed file size is reported in blocks 
  (except for T64)
- overall code improvements
- adapted to new compiler version Pelles-C 12.00.2

Deleted:
-

Fixed:
- specific wrong BAM handling for DIR track
- specific wrong sector offsets for D81
- addressed some compiler and code checker warnings


V0.12
Added:
-

Changed:
- earlier everything was converted to lower case file names - now lower and 
  upper case is handled correctly
- adapted to new compiler version Pelles-C 11.0
- logging changed to DbgView (SysInternals)
- .ini file is now created from .sample included in the zip file if not present
  in INI folder (normally where wincmd.ini is)

Deleted:
-

Fixed:
- addressed some compiler warnings

V0.11
Added:
-new switch for INI file: ignoreErrorTable (see INI file for details)
-new switch for INI file: showONLYScratchedFiles (see INI file for details)

Changed:
-MessageBoxes removed - error codes are returned to TC only
-empty image filenames will now be ignored
-adapations for CodeChecker
-better support for corrupted images

Fixed:
-fixed some memory leaks 
-locked file handles should not appear anymore in case of errors 
-fixed crash with T64 files


V0.10
-Bugfix: correction with file deleting (file names could not be resolved 
         correctly) 
-Change: Till now trailing blanks were ignored. This created some problems with 
         filenames which differ with trailing blanks only. This is corrected 
         (except for T64 images).

V0.9
-Added: support for D71 images
-Added: support for D81 images
-Added: support for debug logging (see INI file)
-Added: support to append .PRG extension always (see INI file)
-Added: support to show scratched files (see INI file)

V0.8
-Bugfix: no more file flooding of "loo*.tmp" files in TEMP path
-changed the compiler to Pelles-C (http://www.smorgasbordet.com/pellesc/index.htm)

V0.7
-Added: creation of D64 images (only 35 tracks) incl. deleting of files
-check for "cyclic block chain" added -> no endless reads
-check for sector error codes added (if available)
-bug fixes

V0.6
-Added: support for D64 40-track images

V0.5
-Added: T64 support
-Changed: better filename conversion

V0.4
-Bugfix: access violation with first use fixed

V0.3
-Change: the name of the plugin was changed to DIRCBM, because now it supports
more then the D64 format
-Added: version resource added to .wcx file
-Bugfix: data was extracted with the last byte missing

V0.2
-first official version on TotalCommander plugin page
-added: replacement of illegal characters with '_'

V0.1
-first release to Christian Ghisler
-with basic functions READ and LIST

Thanks to:
----------
- "Comos" (CZ) for the ideas regarding writing from track 1, use dir sectors 
  for data, default lower case mode, retriggering the need for more writeable 
  disk image formats, interleave and disk header discussions and testing

-Martin Hoffmann-Vetter (Berlin, Germany) for giving the idea and support
with the 8050/8052, 1571 and 1581 formats and for beta testing

-"wreg" for giving the idea of the T64 format, ini switches and beta testing

-Jürgen K. giving the idea for the  D64 40-track format

Downloads, ideas, suggestions and comments:
-------------------------------------------
http://sourceforge.net/projects/dircbm

or write e-mail to 
loo66 {at} users {dot} sourceforge {dot} net

Please change {at} to at-sign and {dot} to a dot. 

-------------------------------------------------------------------------------
Deutsch:
--------
Plugin für den TotalCommander zum Lesen/Extrahieren/Erzeugen von CBM 
(Commodore Business Machines) Diskettenimages.

Derzeit werden folgende Formate zum Lesen, Erzeugen und Schreiben unterstützt:
-D64 (Commodore 64 1541 Diskimages)
 - inklusive 40 Spur Formate wie SpeedDos und DolphinDos
 - wenn ein 40-Spur Format nicht erkannt wird (z.B. andere Formate oder die 
   Diskette ist voll) -> dann nur Lesemodus
-D71 (1571 images)
-D80 (8050 images)
-D81 (1581 images)
-D82 (8250 images)

Aktuell werden die folgenden Bandformate unterstützt (nur Lesen):
-T64 (C64 tape images)

Die ungepackte Dateigröße zeigt die echte Dateigröße in Bytes. Die gepackte 
Dateigröße zeigt die Dateigröße in Blöcken(außer bei T64, da wird beides in 
Bytes angegeben).

Die Dateisortierung sollte abgeschaltet sein (Strg-F7), um die
Originalsortierung der Dateien im Diskimage zu sehen.

Bei aktiver Anzeige von Scratched Files werden diese als versteckte Dateien 
dargestellt. 

Funktionen:
-----------
-Lesen, Schreiben und Extrahieren der Files in einem Image
-Erzeugen von Disk-Images (Alt-F5)
  - mit Standard oder individuellen Interleaves (via Konfig-Dialog)
  - mit Standard oder individuellen Disk-Titel, Disk-ID und DOS-Version 
    (via Konfig-Dialog)
  - mit optionaler Erzeugung des Datenbereichs für Fehlerinformation 
    (via Konfig-Dialog)
  - mit optionalem Schreiben beginnend mit Spur 1 (via Konfig-Dialog)
  - mit optionaler Nutzung der Verzeichnis-Spur für Daten (via Konfig-Dialog)
-Löschen von Dateien (dzt. nur für Disk-Images)
-nicht erlaubte Dateizeichen ( \ / : * ? " < > | ) werden durch '_' ersetzt
-Einstellungen über DIRCBM.INI (normalerweise im Plugin-Verzeicnis); 
 Details siehe INI Datei

History:
--------
V0.14:
Hinzugefügt:
- Option zum Schreiben ab Spur 1 und folgende 
- Option zum Nutzen der Verzeichnis-Spur auch für Daten (nachdem alle anderen 
  genutzt wurden)
  - auch eine Prüfung eingebaut ob alle Daten und Verzeichniseinträge auf die 
    Disk passen.

Geändert:
- allgemeine Code-Verbesserungen

Gelöscht:
-

Behoben:
- Fehler bei der BAM-Initialisierung für 1581


V0.13
Hinzugefügt:
- Disk-Formate D64 40-Spur, D71, D80, D81, D82 sind nun schreibbar
  - Erzeugen von Images, Dateien hinzufügen, Dateien löschen
  - korrekte Handhabung der Interleaves für Verzeichnisse und Dateien 
    (gemäß dem Artikel von Joe Forster)
- Dialog hinzugefügt um die Image Attribute beim Erzeugen von Images mit 
  Alt+F5 setzen zu können
  - interleaves (Dateien und Verzeichnisse), DOS-Version, Diskettentitel, 
    Disk-ID, opt. inkl. Fehlerinformation
  - D64 40 Spur Formaterzeugung
    - SpeedDos
    - DolphinDos
- INI Datei-Einstellungen "eraseDeletedSectors" and "logLevel" 
  (siehe INI-Datei für mehr Details)
  - wenn "eraseDeletedSectors" eins ist, dann werden beim Löschen von Dateien 
    die jeweiligen Blöcke 0x00 gesäubert
  - "logLevel" definiert die Menge an Meldungen für DebugView 

Geändert:
- Dateigrößen werden nun als Bytes an TC gemeldet; gepackte Dateigrößen in 
  Blöcken (außer T64)
- allgemeine Code-Verbesserungen
- neue Compiler Version Pelles-C 12.00.2

Gelöscht:
-

Behoben:
- manchmal falsche Behandlung der BAM für die Dir-Spur
- punktuell falsche Sektor Offsets für D81
- einige Compiler und Code-Checker Meldungen addressiert


V0.12
Added:
-

Changed:
- früher wurde alles auf Kleinbuchstaben umgesetzt - nun werden Klein- und 
  Grossbuchstaben korrekt verwendet
- auf neue Compiler Version Pelles-C 11.0 umgestellt 
- Logging nun geändert auf DbgView (SysInternals)
- Die .ini Datei wird nun aus der beiliegenden .sample Datei in der ZIP-Datei 
  erzeugt, falls im INI Dateiverzeichnis nicht vorhanden (normalerweise wo 
  wincmd.ini liegt)

Deleted:
-

Fixed:
- ein paar Compiler-Warnungen behoben


V0.11
Added:
-neuer Schalter für INI-Datei: ignoreErrorTable (Details siehe INI)
-neuer Schalter für INI-Datei: showONLYScratchedFiles (Details siehe INI)

Changed:
-MessageBoxes removed - Fehlercodes gehen jetzt immer nur an TC
-leere Filenamen werden nun nicht mehr an TC zurückgeliefert
-Adaptierungen für CodeChecker
-bessere Erkennung von ungültigen Images

Fixed:
-einige memory leaks beseitigt
-gesperrte File Handles sollten nach Fehler nicht mehr vorkommen
-Crash mit T64-Dateien behoben


V0.10
-Bugfix: Fehler beim Löschen von Dateien behoben (Namen konnten nicht richtig 
         zugeordnet werden)
-Change: Bisher wurden abschliessende Leerzeichen beim Lesen abgeschnitten. Das 
         führte zu Problemen bei Dateien, die sich nur um ein paar Blanks am 
         Ende des Namens unterscheiden. Dies wird nun berücksichtigt (außer bei
         T64-Images). 

V0.9
-Added: Unterstützung für D71 Images
-Added: Unterstützung für D81 Images
-Added: Unterstützung für Debug-Logging (siehe INI-Datei)
-Added: Unterstützung für Anhängen einer fixen Extension (.PRG), siehe INI-Datei
-Added: Unterstützung für Anzeige von gelöschten Dateien (siehe INI-Datei)

V0.8
-Korrektur bzgl. Erzeugen vieler "loo*.tmp"-Dateien im TEMP-Pfad
-Umstellung auf Pelles-C (http://www.smorgasbordet.com/pellesc/index.htm)

V0.7
-Added: Erzeugen von D64-Images (dzt. nur 35 Tracks) inkl. Löschen von Dateien
-Prüfung auf zykl. Sektorlesen eingebaut
-Prüfung auf Sektor-Fehlerbytes eingebaut (wenn vorhanden)
-Bugfixes

V0.6
-Added: Unterstützung für D64 40-Track Images

V0.5
-Added: T64-Support
-Changed: bessere Dateinamenkonvertierung

V0.4
-Bugfix: Zugriffsverletzung bei erster Anwendung behoben

V0.3
-Change: Plugin heisst jetzt DIRCBM und nicht mehr D64, da es nun mehr als das
ursprünglich vorgesehene D64-Format beherrscht.
-Added: Versionsresource hinzugefügt
-Bugfix: Daten wurden um ein Byte zu kurz extrahiert

V0.2
-erste Version auf der TotalCommander Plugin-Seite
-mit Ersetzen nichterlaubter Zeichen auf '_'

V0.1
-erste Lieferung an Christian Ghisler
-mit Grundfunktionalität Lesen und Anzeigen

Dank:
-----
- "Comos" (CZ) für die Anregungen Schreiben ab Spur 1, Nutzen der 
  Verzeichnisspur für Daten, Defaultänderung für die Gross- und Kleinschrift, 
  Anstoßen des Bedarfs für mehr schreibbare Disk-Formate, Interleave und 
  Disk-Header Diskussionen und Testen

-Martin Hoffmann-Vetter (Berlin, Germany) für die Anregung und Unterstützung
 am 8050/8052-Format, 1571- sowie 1581-Format und Beta-Testing

-"wreg" für die Anregung am T64-Format, den INI-Schaltern und Beta-Testing

-Jürgen K. für die Anregung am D64 40-Track Format

Downloads, Ideen, Wünsche, Anregungen, Kommentare, etc.:
--------------------------------------------------------
http://sourceforge.net/projects/dircbm

bzw. E-Mail an 
loo66 {at} users {dot} sourceforge {dot} net

Bitte {at} durch einen Klammeraffen und {dot} durch einen Punkt ersetzen. 

=============================================================================

Source: readme.txt, updated 2024-04-30