Long Software Name:
-------------------
Not Just Another D64 Viewer 



Short Software Name:
--------------------
NJAD64V




Introduction:
-------------
A tool that will display the contents of D64 disks as real
C64 graphics using the orignal chars and colors without
having to use any emulator or a real C64. From that point 
you are able to graphically or textually export the information
stored in the directory structure of the D64 disks. 

Outputs are: PNG, TXT, CSV and PDF (purpose of label printing)




Programming and Concept Idea:
-----------------------------
Stone Oakvalley Studios - www.stone-oakvalley-studios.com
post@stone-oakvalley-studios.com



Requirements:
-------------
Microsoft Windows, any 32/64bit version will do I guess.
Some D64 files too, you know.



Reason why it exists:
----------------------
There were similar tools (D64Lister) around, but since my
way is my way, I just had to do it my way :)



What it will NOT do:
--------------------
Extract files, no editing possibilites of the data found,
or do any damage/edits to the D64 image itself.
 


Start Date/Idea Conceived:
--------------------------
24 Jul 2007




Source Code Length:
-------------------
Approx 1974 lines, Approx 56Kb



Known Bugs/Limitations:
------------------------
* If the D64 is not really a D64 file but something else...expect unpredicted results! 
* May have bugs that I haven't thought of that might appear..



Report Bugs/Feedback etc:
-------------------------
http://www.dirtcellar.net/phpBB3



ToDo:
-----
None actually.



Other information:
------------------
Real charsets graphics snooped from http://kofler.dot.at/c64






Release History:
------------------
V1.1 - 27 Oct 2010 - JUst recompiled with latest PureBasic 4.51 and PurePDF library V2.19 just to be sure its compiled with the latest developments/improvements. Added a installation setup for the entire thing. Also added a button for donation for happy users. Small counter fixes that was broken in V1.0 causing 1-3 disks not to be exported as PDF at all, just blank page. It should perform as intended now.

V1.0 - 29 Jan 2009 (uhm, I kinda forgot about, did some updates in summer 2008 and forgot about it again...but now it's released :) First release on my homepage and on our C64 forums++












INPUT#1: Standard D64 Images sizes of 174848 bytes
---------------------------------------------------
Options: Either single files or add a whole dir of files 
         into the queue (no subdirs are processed).
Notes  : The tool will display ALL entries on the D64 image,
         even deleted and scratched ones etc. This is because
         the tool is supposed to be a archive tool, and thus
         enabling to show deleted files that could be restored.
         My oh my, the treasures you'll find on your disks you
         thought were lost forever! The files will be marked in
         the filetype area with "---" to easier see them apart 
         from the rest. Then use the splendid D64Viewer by Forrest
         Mook http://almighty.c64.org and to try and rescue the
         files!
Bonus:   Sometimes text was hidden on the first segment of the
         directory structure. My tool will also show this :) 
         Max 89 bytes will be read...whatever is there....is shown.







OUTPUT#1 TXT/CSV files:
------------------------
The results can be saved as a text file (where all the funny C64
chars are removed and only human readable chars is left) Can be
used to search your collections for a filename using your favourite
text search tool later on or for importing into databases/excel or
websites.

Example: Where first line represent Column Headers and the , is 
used as separator as per CSV standards.

SizeID,NameID,ID
175,LAST NINJA2+,PRG

## Options: Either as uppercase or lowercase based on the view settings





OUTPUT#2 PNG images:
----------------------
The results of the entire C64 directory view (which goes beyond a 
real C64 screen) shown as a authentic snapshot of what the directory
structure looks like. Can be used for webpages for instance or during
own printouts projects,

## Options: Either as colors similar to a real C64 or just as white
            background with blacks chars based on view settings.






OUTPUT#3 PDF file:
-------------------
The results of the disks included in the D64 queue can be placed on 
a A4 PDF format to allow printing of the real C64 directory view on
just plain paper. Now you can cut out the labels and tape them to
5.25" diskcovers. The routine will make sure to keep the image 
contents within limits of a 5.25" disk cover. It will use the width
of a 5.25" cover as height when scaling the D64 PNG images. Thats 
means you need to place the the label in landscape format and you 
need to rotate your diskcover 90% clockwise or anti-clockwise to read
the contents if the amount of files on the D64 image was over 36 items
or something around there.
                                                            
No sticky label support was developed, this because the C64 dirview 
can vary alot and the massive amount of work involved to create something
to "fit-all-scenario" was not prioritized. 

## Options: Either C64 colors or Black/White based on view settings. 
            No 2X scale format is supported, only 1X output.




Please see the ExampleOutputs folder of what this software can export
and how it looks in standard/default mode.


Hope you will enjoy and use the NJAD64V for your collection, 
and long live the Commodore 64 forever!





