home *** CD-ROM | disk | FTP | other *** search
/ Commodore Free 6 / Commodore_Free_Issue_06_2007_Commodore_Computer_Club.d64 / t.diskimagery6 < prev    next >
Text File  |  2023-02-26  |  11KB  |  372 lines
  1. u
  2.             DiskImagery64
  3.  
  4.    A drag & drop Disk Image Editor
  5.      for Commodore 64 D64 Images
  6.  
  7.    Written by Christian Vogelgsang
  8.    under the GNU Public License V2
  9.  
  10.           Official Page is:
  11.       http://www.lallafa.de/blog
  12.  
  13. DiskImagery64
  14. Introduction If you are a C64-addict
  15. then you usually like to setup own
  16. disk images with new software or with
  17. new arrangements of existing
  18. collections. I often use the great
  19. "c1541" command line tool of VICE,
  20. (www.viceteam.org) to create and
  21. modify disk images on my Mac. Working
  22. this way gets cumbersome if you
  23. arrange new images from a large
  24. collection of other images or if you
  25. want to hand-craft an image with many
  26. files from different sources. For this
  27. task I wrote DiskImagery64...
  28. DiskImagery64 is a GUI application
  29. that allows to quickly view and edit
  30. alarge set of disk images and allows
  31. to copy or move files by simple
  32. dragging them from one image to the
  33. other. Furthermore, a file browser
  34. allows access to your local file
  35. system and from there you can also
  36. drag files to an image and vice
  37. versa.
  38.  
  39. Installation DiskImagery64 is written
  40. with the portable Qt-library
  41. (www.trolltech.com) and is open source
  42. under the GNU Public License V2. You
  43. can either download the source code or
  44. a compiled binary. The source compiles
  45. on all Qt-platforms:Mac, Linux/Unix
  46. with X11, and Windows. Simply call
  47. "qmake" and "make" in the source tree
  48. to build it. Make sure to use at least
  49. Version 4.2.x of Qt.
  50.  
  51. For the low-level disk image I/O
  52. DiskImagery64 uses the "diskimage"
  53. library written by Per Olofsson. For
  54. your convenience the source code is
  55. included in this source distribution,
  56. but you can also find the source with
  57. documentation on Per's official
  58. "diskimage"-Page:
  59. http://www.paradroid.net/diskimage/
  60. diskimage - D64/D71/D81 library
  61. Copyright (c) 2003-2006, Per Olofsson
  62. All rights reserved.
  63.  
  64. Fonts For authentic reproduction of
  65. file names in disk images,
  66. DiskImagery64 uses two fonts: CBM and
  67. CBMShift for the unshifted and shifted
  68. commodore char set.In this
  69. distribution you find both of them as
  70. scalable TrueType fonts. Installthem
  71. on your system before running
  72. DiskImagery64.
  73.  
  74. Mac users simply double-click on the
  75. CBM.dfont and CBMShift.dfont files
  76. andselect "Install" in the Font
  77. Manager to install them on their
  78. systems. Windows and Linux users can
  79. use the provided CBM.ttf and
  80. CBMShift.ttf files.
  81.  
  82. The fonts were not created totally by
  83. myself. I had a scalable
  84. commodoreTrueType font lying around on
  85. on my hard disk and I used it as a
  86. starting point. The existing font told
  87. me its origins in the header: based on
  88. a font byDevin D. Cook with fixes from
  89. Chris McBride.
  90.  
  91. I loaded this font in the great free
  92. font editor
  93. FontForge(http://fontforge.sf.net/)
  94. and started fixing it again: I wanted
  95. a one-to-one petscii mapping and that
  96. was not present. Furthermore, this
  97. requires to have two fonts: one for
  98. unshifted and one for the shifted
  99. commodore char set. I created the two
  100. new fonts CBM and CBMShift with a
  101. "Unicode" TrueType mapping but with
  102. each petscii character at the correct
  103. hex position. The characters were
  104. copied from the other TrueType font
  105. and missing characters were drawn
  106. bymyself.  I hope the mapping of all
  107. petscii characters is correct now. For
  108. reference Ihave provided the editable
  109. Font Forge font (*.sfd) files in the
  110. "fonts" directory. If you find any
  111. errors then please send me your fixes!
  112.  
  113. The fonts are NOT suitable to use them
  114. as a replacement for any other
  115. unicodefont as the embedded mapping is
  116. called unicode but petscii actually.
  117. Nevertheless, they are perfectly
  118. suited to directly print petscii
  119. strings.
  120.  
  121. Usage 1. Startup There are several
  122. ways to launch DiskImagery64:
  123.  
  124.  - Double-click on the application
  125. icon
  126.  - Double-click on a *.d64 image file
  127. (on Macs)
  128.  - Drag a *.d64 image file onto the
  129. application icon
  130.  
  131. If DiskImagery64 is launched with a
  132. disk image then an Image Browser
  133. windowopens and shows the directory of
  134. the image. If no image is given then
  135. the File Browser window opens.
  136.  
  137. 2. Image Browser An Image Browser
  138. windows shows the contents of a disk
  139. images. You can open as many image
  140. browsers as you like. You can create a
  141. new disk image with the "File/New
  142. Image" menu command. A new and empty
  143. image browser is opened. The new disk
  144. image is empty and has a default disk
  145. name and id.
  146.  
  147. "File/Open Image" opens a new image
  148. browser with an already existing
  149. image.
  150.  
  151. You can change the disk name and id by
  152. formatting the image with
  153. the"Tools/Format Disk" command. Enter
  154. a new disk name and id in the dialog.
  155. This will also erase all files on the
  156. disk.
  157.  
  158. A disk image is altered by copying
  159. files from and to the directory shown
  160. inthe corresponding image browser.
  161. Simply select one or more files in one
  162. disk image and drag-and-drop them to
  163. another image. It is also possible to
  164. drag files from the File Browser to
  165. the image. Then a local file is copied
  166. onto the image.
  167.  
  168. Files on a disk image can be altered
  169. with the common "Cut", "Copy",
  170. "Paste"and "Delete" commands found in
  171. the "Edit" menu. First select one or
  172. more ofthem and issue a command.
  173.  
  174. If a disk image is modified the
  175. changes are at first only performed in
  176. memory.You need to save your image to
  177. disk to make the changes permanently.
  178. Eitherselect "File/Save" to save the
  179. image with the already given name or
  180. use"File/Save as..." to save a copy or
  181. a currently unsaved image.
  182.  
  183. "File/Close" closes the current image
  184. browser. The image is not
  185. automatically saved onto disk in this
  186. case. The applications warns you if
  187. you want to close an unsaved image. If
  188. the last browser in DiskImagery64 is
  189. closed then the application quits.
  190.  
  191. 3. File Browser The File Browser shows
  192. you a directory of your machine's file
  193. system. Thebrowser is used as a drag
  194. source or a drop target if you want to
  195. move local files to or from a disk
  196. image.
  197.  
  198. You can browse your file system by
  199. opening and closing the tree hierarchy
  200. shown in the browser. Furthermore, the
  201. root of the shown file tree can be
  202. entered in the top line edit field.
  203. Simply enter a valid path there and
  204. press enter. Additionally, a click on
  205. the directory icon lets you select the
  206. root directory in a file dialog.
  207.  
  208. Select a single or multiple files in
  209. the file browser and drag them onto
  210. adisk image to copy them there. The
  211. file names are automatically converted
  212. from Unicode to Petscii. Additionally,
  213. known extensions like ".prg", ".del",
  214. ...are automatically stripped for the
  215. Petscii name and converted into the
  216. corresponding CBM file type.
  217.  
  218. The transfer of files from a disk
  219. image to the local file system works
  220. similar: Simply select one or more
  221. files in the image browser and drag
  222. them onto a directory in the file
  223. browser. Again, the file names are
  224. converted automatically and the CBM
  225. file type is added as a file
  226. extension. Invalid characters
  227. (":","/","\") are automatically
  228. stripped from the name.
  229.  
  230. 4. Tools The Tools Menu offers some
  231. tools while working with a disk image.
  232. "Format Image" allows to completely
  233. format the virtual disk. Enter the new
  234. name and disk id.
  235.  
  236. "Add Separator" is used to add a
  237. separator special file to the current
  238. disk image. A separator file is
  239. usually empty and only used in the
  240. directory listing to separate entries
  241. or to group application files. The Add
  242. Separatorcommand has already some
  243. predefined separator styles available,
  244. but you can design your own separator
  245. (see Preferences).
  246.  
  247. 5. Emulator DiskImagery64 allows to
  248. call your favorite C64 Emulator to
  249. mount an opened image. Use the
  250. preferences to setup your emulator.
  251. The "Mount Image" command
  252. mounts/attaches the disk image to a
  253. virtual drive in your emulator and
  254. launches the program.
  255.  
  256. "Run Program" allows to run the
  257. selected disk entry inside your
  258. emulator. Make sure to have a single
  259. program selected. The emulator is run
  260. and the disk image name and file name
  261. on the disk image is passed as
  262. arguments.
  263.  
  264. 6. Networking DiskImagery64 can
  265. directly work with a real Commodore 64
  266. if its connected via ethernet. For the
  267. C64 a popular network adapter is the
  268. RR-Net, a 10 MBit NIC mounted on the
  269. Retro-Replay cartidge (available from
  270. Individual Computers http://ami.ga)
  271. which is an Action Replay clone.
  272.  
  273. To set up your network, I suggest to
  274. use a cross-cable to directly connect
  275. the C=64 to your Mac. This avoids
  276. traffic from other sources that can
  277. disturb the good old 8-bitter.
  278. Furthermore, The Final Replay ROM
  279. (short: TFR) image is required to use
  280. CodeNet or NetDrive features described
  281. below. The ROM is suitable for the
  282. Retro-Replay and available at
  283. http://www.oxyron.de/html/freplay.html
  284. . Setup the correct IP addresses for
  285. the C64 and your Mac in the ROM with
  286. the deliverd tool and flash the image
  287. on your cartidge. Finally store both
  288. IP addresses in DiskImagery64's
  289. preferences and you are ready to go!
  290. The following network services are
  291. available in DiskImagery64:
  292.  
  293. * CodeNet: Press F6 on the C64 with
  294. TFR running to enter CodeNet mode. In
  295. this  mode the C64 waits for
  296. instructions from the network. You can
  297. fill memory, download data directly to
  298. C64 memory, jump to memory or run a
  299. program. This is all implemented in
  300. DiskImagery64 but currently only used
  301. to download a PRG and run it.
  302.  
  303.   In DiskImager64 simply select a
  304. program file in a disk image or a
  305. local file and select "Network/Run
  306. Program". The file is downloaded in a
  307. second and run on the real machine.
  308. This works only for one-filers as
  309. loading other files is not supported
  310. in this mode.
  311.  
  312. * NetDrive: TFR allows to access a
  313. "virtual" IEC network drive on device
  314. id 6. So a "LOAD "$",6" on your C64
  315. will load the directory from the
  316. network drive. In DiskImagery64 you
  317. can create a network drive from every
  318. disk image or selection of files (also
  319. local ones) by selecting
  320. "Network/Share Files in NetDrive".
  321.  
  322.   The NetDrive allows to use
  323. multi-file-programs as a program can
  324. load data files from the virtual
  325. device later on. The program must only
  326. use the kernal load routines (no
  327. fastloader, custom load routines...)
  328. as the NetDrive works on kernal level
  329. and is bypassed by custom routines.
  330. Kernal loading is often  required
  331. nowadays (e.g. on IDE64, Dreamload on
  332. MMC64,...), so many multi-file progs
  333. are already available in patched
  334. versions.
  335.  
  336. * WarpCopy64 support
  337. (http://www.oxyron.de/html/wc64.html).
  338.  WC64 is a server  program running on
  339. the C64 and a client on a host
  340. (PC/Mac). Now you can  control your
  341. C64-attached real disk drives (e.g.
  342. 1541) directly via network  from your
  343. Mac. You can format a disk, verify a
  344. disk, send direct DOS commands to the
  345. drive and of course copy disk images
  346. in both directions. You can then
  347. directly transfer a real disk into a
  348. disk image in DiskImagery64 or a disk
  349. image back onto a real disk. A slow
  350. (most IEC compatible) mode taking
  351. several minutes per side and a warp
  352. mode only taking tens of seconds is
  353. available.
  354.  
  355.   First of all enter CodeNet by
  356. pressing F6 in TFR.
  357. "Network/WarpCopy64/Start  WarpCopy"
  358. now transfers the WC64 server program
  359. to your C64 and launches it.  Make
  360. sure to have the correct IP adresses
  361. selected in preferences! You can pick
  362. "Network/WarpCopy64/Read Disk" to
  363. transfer a real disk into a disk image
  364. of DiskImagery64. If you have a disk
  365. image opened then the
  366. "Network/WarpCopy64/Write Disk"
  367. command is available and transfers the
  368. image  directly onto a real disk.
  369.  
  370.  
  371. ...end...
  372.  
  373.