pcjs/disks/README.md
2017-09-21 15:40:15 -07:00

48 lines
1.7 KiB
Markdown

---
layout: page
title: Disk Libraries
menu_title: Disks
menu_order: 5
permalink: /disks/
---
Disk Libraries
--------------
Browse the following PCjs Disk Libraries.
* [IBM PC](pcx86/)
* [Challenger 1P](c1p/)
* [DEC](dec/)
Additional software is available in the [Application Archives](/apps/).
---
PCx86 Disk Image Formats
------------------------
PCx86 works best with disk images in a **JSON** format, so that's the only disk format you'll
find in the [PCjs Project](https://github.com/jeffpar/pcjs).
There are several ways you can convert a PCjs **JSON** disk image back into a binary **IMG** file:
- Load the disk into a PCjs machine and click the **Save** button
- Use the [DiskDump API](/api/v1/dump) (available only with the
[PCjs Node Web Server](https://github.com/jeffpar/pcjs/blob/master/server.js))
Note that whenever you **Save** a disk inside a PCjs machine, it is saved exactly as it exists
at that point in time. So, if you made any changes to the disk, those changes will be preserved
in your saved copy. Otherwise, the disk image should be an exact copy of the original PCjs disk.
When using the [DiskDump API](/api/v1/dump), set the *format* parameter set to `img` instead of `json`.
For example:
{{ site.url }}/api/v1/dump?disk=/disks/pcx86/dos/ibm/2.00/PCDOS200-DISK1.json&format=img
The [HTMLOut Component](https://github.com/jeffpar/pcjs/blob/master/modules/htmlout/lib/htmlout.js)
of the PCjs Node Web Server also generates "onclick" handlers for links to **JSON** disk
images that automatically invoke the API for you.
See [Creating PCx86-Compatible Disk Images](/docs/pcx86/#creating-pcx86-compatible-disk-images)
in the [PCx86 Documentation](/docs/pcx86/) for more information about supported disks and formats.