D64Lister

From C64-Wiki
Jump to: navigation, search
GEOS
D64Lister 1.7.2 Win10.png
Developer Lars
Company
Publisher
Release 2000
Licence Freeware
Platform Windows program (all Versions since Windows9x)
Genre Software, File-Lister
Operation
Media D64 Images
Language(s) Language:english
Information Current version: v1.7.3, Build 07.07.2018


Description[edit]

The D64Lister is a windows application for Windows 9x or higher, which shows Commodore diskimages in D64 format. The File Viewer has some extras for e.g. converting text files or shows formated BASIC program code, also GEOS file support.

Remark of the programmer

Lars: "Because I wasn't satisfied with all the available D64 lister programs in several aspects I decided to make my own one. The D64Lister is of course Freeware."


Introduction[edit]

Requirement:

  • The D64Lister used the RichEdit 2.0 DLL riched20.dll. Also is needed the DLL comctl32.dll (min. version 4.70 or higher).
  • Both DLLs are contained in the OS Windows 98 or the web browser Internet Explorer 4. By using Windows 95a it exists small problem by using the Expanded OpenDialog.
  • For looking the generated (DOS) ASCII *.TXT files with Windows, you can used e.g.: DIZzy.
  • For looking the generated output *.RTF files with 'Terminal Font', you can used e.g.: WordPad.

Feature:

  • For transfering content of C64 files (like Texte, Imageer), which are inside in a D64 images onto new OS.

Last changes:


Important Features[edit]

Lister Main Window
C64 Screen Vieiw
Extended OpenDialog
GEOS File View
BAM Viewer (Browser resized!
Basic De Tokenizer
GEOS File 1
GEOS File 2

The D64Lister is featured with the following abilities and properties, which are described more precise later on:

  • Windows based (Win9x, WinNT, Win2000, WinXP, WinVista, Windows7)
  • Multifile support
  • Extended Recursive OpenDialog with Directory selection
  • D64 Images as parameter
  • Images can be drag&dropped
  • 40 Tracks Support (SpeedDOS, DolphinDOS, PrologicDOS)
  • 99% PETSCII -> ASCII conversion
  • 99% Original C64/1541 behaviour
  • ASCII Textfile generation
  • RichTextFormat file generation
  • Appending of new Textfiles to existing ones
  • Upper/Lower -> Upper/Graphics Char switching
  • Emulated C64Screen
  • C64Screen is zoom - and scrollable
  • Comfortable OptionsDialog with *.ini File
  • GEOS File support
  • Auto Upper/Lower Char switching for GEOS Files
  • GEOS File Details
  • GeoWrite Textviewer with styles, fontsizes, formats and photoscraps
  • GEOS Font Shower
  • GeoPaint Viewer
  • PhotoScrap Viewer
  • PhotoAlbum Viewer
  • GeoPaint pictures and PhotoScraps are saveable
  • Fonts zoom - and saveable (as bitmap)
  • Zoomable display of GEOS icons
  • Export function for supported GEOS Filetypes
  • Show BAM (with diskerrors like StarCommander)
  • Show BAM entry -> filename, filename -> BAM entries
  • BlockViewer in hex or char
  • FileViewer with BASIC Command Detokenize, C64 program export and Hex View

All Options and the last loading path are saved in the D64Lister.ini *.ini file. If a file called D64Lister.ini is present in the same folder where the D64Lister.exe is, this file is used as *.ini file, so the D64Lister can be used portable. Otherwise since Windows XP the *.ini file is saved in the user Application Data folder. For Windows Versions older than Windows XP the *.ini file is saved in the Windows Folder.

Starting[edit]

The D64Lister is a full windows application and not a new DOS tool with output redirection.

An from the D64Lister unlimited amount of D64 images can be opened at once and their directory will be listed in C64/1541 format (including blocks free and filetype). Therefore, click on one of the "Load" buttons and choose the wanted images.


There are two kinds of OpenDialogs:

The normal OpenDialog: With CTRL/shift and leftmouse the images can be chosen. CTRL+A chooses all images in the actual directory. Double click chooses only one image.

The extended OpenDialog: After choosing a directory the D64 images found (with wildcard mask) are displayed in the FileList on the right. Here you can choose the wanted images or complete directories by checking the checkboxes. Additional a with leftclick dragged rectangle checks the images and a with right click dragged rectangle unchecks them again.

With "Initial Directory" you can choose ("Pick" or type) where to start the next time opening the Dialog. Here the following special locations are valid:

  • DESKTOP  : Desktop
  • DRIVES  : My Computer
  • NETWORK  : Network Neighborhood
  • NETHOOD  : My Network Places
  • PERSONAL : My Documents

The FileList Window can be resized on the right border. This setting becomes valid the next time opening the dialog.

A click on the "OK" Button lists the images.

A new loading will clear the list on the mainform.

The "List" button lists the last loaded D64 image again.

It is possible to open the D64Lister with D64 images as parameter. So you can include the D64Lister as your default D64 Lister in Windows. No ASCII file will be created automatically.

You can also open images by drag&dropping directories or files on the mainform.

ASCII Files[edit]

The directory can be viewed in the mainform and/or an ASCII file with nearly full PETSCII -> ASCII conversion (codepage 850) can be generated. Therefore the checkbox "Generate ASCII File" on the mainform has to be checked.

The ASCII file can be viewed or printed in textmode (DOS prompt) with for example "edit.com". In Windows for example "DIZzy", "UltraEdit32" or "VEdit32 Plus" can be used to display the ASCII file correctly. Also any text editor should work, where the "Terminal" Font from Windows, which should emulate the textmode, can be selected. Some recommended tools are "Jane", "Angel Writer" or "Kool Padding". Here you can set the "Terminal" font as default (Fontsize 6 or 12) and can also open RTF files (not with "Jane"). For a collection of editors refer to for example http://www.heise.de/software/download/o0g0s3l11k17 .

The generated ASCII or RTF files can also be viewed in the D64Lister with File->Import.

A click on the "Save" button let you choose between Textfile or RTF file. The RTF file uses the "Terminal" Font from Windows. You can also copy (CTRL+C) the text from the mainform. The "ASCII Textfile" is the same as the "Generate ASCII File" file. Choosing "ANSI Textfile" does some conversion to chars Windows cannot display correctly.

The PETSCII -> ASCII conversion uses a slightly modified conversion table from Joe Forster/STA (StarCommander).

The name of the ASCII file can be chosen in the OptionsDialog:

  • use the name of the image (default name)
  • use your own name (insert name)

If the file already exists, you can choose between the following options:

  • Append
  • Overwrite
  • Insert new name
  • Cancel

The directory, where the ASCII file should be saved, can be chosen in the same way in the OptionsDialog:

  • Use the directory where the image was (default path)
  • Select a different directory or create a new one (select path)

If more than one image is opened the name of the directory (default name) or an earlier inserted name (insert name) will be used for the ASCII file (multifile name).

The resulting savename can be displayed after successful saving.

Additional a header (check "Generate Header" in the OptionsDialog) can be added before every listed image in the ASCII file, which includes the name of the image and some good visible separating lines.

C64 Screen[edit]

For control or only to have a quick look into an image the C64Screen was implemented (click on "C64Screen"). This screen uses the original char from the C64 (CharROM), so it displays the directory like the original C64. The screen is zoom- and scrollable. With "Options | Images in C64Screen" the number of displayed images can be limited, because drawing the graphics in the C64Screen needs some time.

The following keys are valid:

  • - "+", "-" and "*" = Zoom


Upper/Lower → Upper/Graphics Charset[edit]

The C64 have two Charset modes: the Upper/Graphics and the Upper/Lower mode. Filenames can be saved in these different modes, too.

The D64Lister supports these two modes. You can switch between them manually, or use the automatic recognition (Options | Auto GEOS conversion):

  • BASIC files are displayed in Upper/Graphics
  • GEOS files are displayed in the C64Screen in Upper/Lower and are saved in the ASCII file with standard ASCII (GEOS uses standard ASCII)

The graphic chars are converted as good as possible to the available ASCII graphic chars.

The Upper/Graphics or Upper/Lower buttons on the mainform are used in all PETSCII conversions of the D64Lister.


Interpret Specialchars[edit]

Special chars can be present in disk names and file names. The Option "Interpret Specialchars" enables their translation while listing.

The following Specialchars are translated:

  • 0x0D - Return
  • 0x8D - Shift Return
  • 0x12 - Reverse On
  • 0x92 - Reverse Off
  • 0x1D - Cursor Right
  • 0x9D - Cursor Left
  • 0x14 - Delete

Note that no linebreak is done for the Return chars. The other Specialchars (e.g. cursor down, home, clear, and so on) will be ignored, but their resulting behaviour (e.g. Rev Off) is simulated. Disknames are limited to 80 chars (like on the C64), Filenames are limited to 40 chars.

After Quotes Chars greater than 0x80 are interpreted as BASIC Tokens in disk names, e.g. char 0x8D will be displayed as "GOSUB" instead of "Shift Return".

With the Option "Display BASIC V2 Tokens" these interpretation can be enabled. The BASIC V2 Tokens can be displayed and edited in the token table in the FileViewer Options.

GEOS Support[edit]

If GEOS files are found while listing the directory, the file ending ($80 - DEL, $81 - SEQ, $82 - PRG, $83 - USR, $84 - REL) is replaced with GEOS filetype endings. These are:

  • BAS ($01) - BASIC
  • ASS ($02) - Assembler
  • DAT ($03) - Data file
  • SYS ($04) - System File
  • DAC ($05) - Desk Accessor
  • APP ($06) - Application
  • DOC ($07) - Application Data
  • FON ($08) - Font File
  • PRN ($09) - Printer Driver
  • INP ($0A) - Input Driver
  • DRV ($0B) - Disk Driver (or Disk Device)
  • BOO ($0C) - System Boot File
  • TMP ($0D) - Temporary
  • AUT ($0E) - Auto-Execute File

If the checkbox "Generate GEOS File Details" in the OptionsDialog is checked, the Info Block of a GEOS File inclusive icon is added to the "GEOS File Details" List.

A Rightclick on the list shows the Options PopUp menu. A Doubleclick on a GeoWrite File opens the GeoWrite Viewer where the contents of the file is displayed. A double click on GEOS Fonts, GeoPaint Pictures, PhotoScraps and PhotoAlbums open different Windows where the resulting bitmap can be saved or Options can be set. By double clicking on a not supported GEOS File its icon will be displayed in a separate window and can be saved as a bitmap (right click). The "GEOS File Details" list is independent from the "Clear" button on the main form.

In the PhotoAlbum Viewer the following keys are valid:

  • "+", "-" and "*" = Zoom
  • "PgUp" and "PgDown" = next/prev Scrap

A click on the export function in the PopUp menu will export all selected supported entries to their resulting filetypes, i.e. fonts and GeoPaint Pictures are exported as bitmap and GeoWrite files are exported as a RTF text file.

Before saving the List a choicebox will come up allowing you to select which segments of the Info Block should be saved.

If problems come up by sorting the List (the GEOS Details ListView only supports the used sorting algorithm with comctl32.dll Version 5.80 or later) an own sorting routine can be used. Therefore the following entry has to be added to the D64Lister.ini:

[GeosDetails]
OwnSort=1


GeoWrite[edit]

Over the ContextMenue from the GeoWrite Viewer the Option can be switched on to replace the used GeosFonts through its FontID over a Lookup Table with Windows Fonts. Therefore a Lookup Table must be inserted in the *.ini File. The entries must have this Format:

GeosFontID=FontName;
[FontTable]
-1=Arial;                              Default
0000=Berkelium 64;                     BSW 64
0001=Arial;                            University
0002=Helvetica;                        California
0003=Times New Roman;                  Roma
0004=Olde English;                     Dwinelle
0005=JLS Space GothicR  NC;            Cory
0006=Comic Sans MS;                    Tolman
0017=Broadway;                         Superb
0019=Microgramma D OT Medium Extend;   Ormond
0025=MacType;                          LeConte
0026=Pet Me 64;                        Commodore	
0027=Times New Roman;                  LW_Roma
0028=Helvetica;                        LW_Cal	
0030=Courier New;                      LW_Barrows
0056=Arial;                            University_GE, University LQ
0057=Helvetica;                        California_GE, California LQ
0064=Times New Roman;                  Roma_GE, Roma LQ
0065=Olde English;                     Dwinelle_GE
0066=JLS Space GothicR  NC;            Cory_GE
0088=Times New Roman;                  LW_Roma_GE
0089=Helvetica;                        LW_Cal_GE
0091=Courier New;                      Barrows_LQ, LW_Barrows_GE
0128=Berkelium 64;                     BSW 128
0129=Pet Me 64;                        Commodore_GE
;0129=Commodore;                       This is an Example to rem out an entry
0736=Comic Sans MS;                    Tolman LQ
0745=Broadway;                         Superb LQ
0980=Olde English;                     Dwinelle_GE LQ

The table ist sorted by the GeosFontID while reading. The topmost entry ist used as default if a FontID present. It is recommented to use -1 as the default entry. If you just want a different DefaultFont, just enter this. The FontName is the Name displayed in for example Word, not the Filename of the FontFile. The FontName ends with a semicolon, following Chars are ignored and ca be used as a comment. The Table isn't completed yet and can be expanded.

Please have a look at: https://www.forum64.de/index.php?thread/73537-geos-fonts-als-truetype/


BAM Viewer/Block Owner/File Viewer/Block Viewer[edit]

In the BAMViewer (click on the BAM button on the Mainform) the BAM (Block Allocation Map) of the last loaded image is shown. Disk Errors (generated with e.g. StarCommander) are shown with a red frame and the error number.

For undisturbed use of the BlockViewer with right click type 'd' in the BAMViewer to deactivate the PopUp Menu. 'a' activates the Popup again.

A click on "Show Block Owner >>" Button opens a List with the files of the actual image. A click on a filename shows its BAM entries.

A click on "Show Chain" gives the numbered BAM entries with the following meanings of the colors:

  • Red indicates an error. Double click to get a little description
  • Green indicates, that the block is used by the file. For GEOS VLIR files it’s the VLIR
  • Fuchsia indicates, that the block is used by the file and has an error
  • Blue indicates a VLIR Block. The number is !not! the original VLIR number, it's the absolute VLIR number (starting at 1).
  • Yellow shows the blocks of a VLIR block. The parent VLIR block number is shown in the right top. The block number is shown at the left bottom.
  • Pink indicates the GEOS info block.

A click on a BAM entry highlights the accompanying filename.

A right click on a file opens the FileViewer. A right click on a block opens the BlockViewer.



FileViewer[edit]

In the FileViewer the following options are available (click "Options" button or menuitem):

  • Convert to ASCII
    Converts the file to ASCII using the PETSCII -> ASCII conversion table.
  • Convert to Chars
    Converts the file to chars or show it in Hex.
  • Replace 0x0d with a newline
    In most SEQ files 0x0D is used to do a newline-
  • Detokenize
    To detokenize a BASIC File click on the Detokenize Button labelled with "TOK64". The detokenize function was implemented with help from TOK64, it's source code, PETCAT and it's source code, but for now they have nothing in common anymore. Thanks to Cris Berneburg for TOK64 and Jouko Valta for PETCAT.
Optional you can additionally choose between the following modes (Default):
If Detokenize was successful, BASIC Commands and Specialchars (for example {Up}, {Down}, {Home}) are shown in different colors adjustable in the token table. The translation of the Specialchars can be disabled in the FileViewer Options.
  • Token Table
    A click on the Button "Edit" next to the BASIC Mode Selection in the FileViewer Options opens the token table. Here the tokens for the different BASIC Modes and the Specialchars are displayed and can be edited.
The following Properties can be found in the header area:
  • Number - Durchnummerierung der Spalten
  • Name - Name des Tokensets. Steht der Name in Klammern, wird das Tokenset nicht zur Auswahl des BASIC Modus in den FileViewer Options hinzugefügt.
  • Extension Of - Nummer der Spalte des Tokensets, der erweitert wird. z.B. ist BASIC V7 eine Erweiterung von BASIC V3.5, welches wiederum eine Erweiterung von BASIC V2 ist. Wird kein Tokenset erweitert, muss hier ein "-" eingetragen werden. Die Tokensets werden von Top (Auswahl des BASIC Modus in den FileViewer Options oder Autodetect) zu Bottom (das letzte Tokenset mit "-" als "Extension Of") nach Token Übereinstimmungen inkl. Prefix durchsucht.
  • Type - Der BASIC Modus kann über die Startadresse automatisch ermittelt und/oder überprüft werden. BASIC Erweiterungen (Type 5, 6, 7) können nicht automatisch erkannt werden, werden aber überprüft. Die BASIC Startadressen können mit Klick auf "Edit" neben "Ignore Startaddress" in den FileViewer Options eingestellt werden.
  • Type 0 Startadresse wird nicht überprüft
  • Type 1 steht für Specialchars
  • Type 2 steht für BASIC V2 Startadresse
  • Type 5 steht für BASIC V2 Erweiterungen
  • Type 3 steht für BASIC V3.5 Startadresse
  • Type 6 steht für BASIC V3.5 Erweiterungen
  • Type 4 steht für BASIC V7 Startadresse
  • Type 7 steht für BASIC V7 Erweiterungen
  • Color Type Auswahl der zu benutzenden Farbe für das Syntax Highlighting.
    Die Farbe kann mit "Change" am rechten Rand des Fensters geändert werden.
  • Prefix - Einige Tokensets nutzen Präfixe zur Kennzeichnung eines Tokens.
    Dieses Präfix wird hier angegeben (für Hex Zahlen 0x benutzen). Ist kein Präfix vorhanden, muss hier ein "-" eingetragen werden.
  • Comment Token - Angabe des Tokens für einen Kommentar. In BASIC V2 ist dies 0x8F (REM). Der Kommentar Token wird mit der in Color Type 15 eingestellten Farbe dargestellt.
  • Detok Comment - Angabe, ob innerhalb eines Kommentars weiter Tokens interpretiert werden (1), oder diese als Text angezeigt werden sollen (0).
Die Tokens müssen in aufsteigender Reihenfolge angegeben werden, um ein fehlerfreies Funktionieren zu gewährleisten.
Mit "Use Custom Token Table" wird beim ersten Gebrauch (entweder Öffnen der Token Table oder Detokenize) eine eigene CSV Datei mit Tokensets geladen.
Die CSV Datei kann z.B. in "Excel" oder "CSVEd" editiert werden.
Copy/Cut/Paste wird in dem Token Table Fenster unterstützt.
Das Listen Trennzeichen wird automatisch aus der "Number" Zeile ermittelt.
Somit kann eine eigene Token Table mit weiteren BASIC Erweiterungen erstellt werden. Weitere Tokensets findet man z.B. in der mit Vice mitgelieferten cbm_basic_tokens.txt
Caution: Not everything can be checked, so fill the header area carefully for a new token set with respect to the default sets.
To use the Custom Token Table at Startup of the D64Lister (for example "Display BASIC V2 Tokens" at listing) add the entry LoadAtOnCreate=1 in the Section [TOK64] in the D64Lister.ini.
  • Save as...
    You can save the file as a "RTF File", "txt File" or "C64 Program" with and without start address.

The Upper/Graphics or Upper/Lower Buttons on the mainform are also used inthe FileViewer.


BlockViewer[edit]

The BlockViewer displays the selected block dependently from the FileViewer options.

Additional Options[edit]

In the OptionsDialog the following functions can be enabled:

  • Convert Everything
    Converts alphanumeric chars, too. Instead, only graphic and other chars are converted to ASCII.
  • Show Deleted Files
    Displays files which are signed as scratched in the directory. If their name is longer than 0 chars these files can be undeleted possibly...
  • Convert Disknames
    The diskname of the image will be converted, too. This can be useful if there are graphic chars in the name. GEOS disks will be recognized and won't be converted (GEOS uses standard ASCII).
  • Allow more than 144 Files
    Normal Images only use track 18 as directory track. This results in maximal 144 files. Some special images are using additional tracks for the directory, too. With this option checked you can fully list them, but it's limited to 288 files.


D64Lister Light[edit]

D64Lister_Light

For easy listing a directory of a disk (the D64Lister was developed for that goal) can used the program "D64Lister_Light".

You can choose a directory and list it through a click or by using the cursor keys. Both char sets must be inside in the D64Lister_Light Directory or inside the Windows Font Directory.



Greetings to[edit]

  • Bacchus/FLT
  • Joe Forster/STA
  • Robert Rottmerhusen
  • Jan Stuhler
  • Stefan Weber
  • Cris Berneburg
  • Jouko Valta
  • Robert Dunn
  • Werner Weicht
  • Arndt Dettke

TOK64:


Bugs[edit]

Bug reports or other suggestions or ideas send to: d64lister@hotmail.com



Links[edit]