Home
Name Modified Size InfoDownloads / Week
dircbm binaries 2023-09-04
readme.txt 2023-09-04 12.2 kB
Totals: 2 Items   12.2 kB 20
DIRCBM.WCX V0.13
================
(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)
-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.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 idea regarding the 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)
-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.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 Anregung mit der 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 2023-09-04