Documentation for XTOMYDEV 0.1

totapdec

totapdec takes an uncompressed 44.1kHz mono AIFF file recorded directly from the Tutor (prerecorded cassettes are not supported yet) and emits a bitstream that one of the bitstream readers can work with. The audio can be passed on standard input or provided as a filename argument. The output is sent to standard output.

Large numbers of errors generally indicate the file was either not recorded correctly, or is in the wrong format.

Options you can pass on the command line:

-plot, -plotv

Display a graphical waveform (lots of data!). If you use -plotv, then the raw sample value read from the file is also displayed.

-verbose

Display additional debugging information, mostly spammy unless you understand how it hunts for pulses. If this is passed with -plot, -plot becomes -plotv.

-clamp=[value]

Sets the clamp level to the provided sample value, which should be a signed 16-bit integer. Defaults to -16384. The clamp level is used as the reference low when the tool is hunting for pulses.

totapenc takes a bitstream and emits an uncompressed 44.1kHz mono AU file which can be played back to a Data Recorder and from there read back to the Tutor. The bitstream can be passed on standard input or provided as a filename argument. The output is sent to standard output.

tobasdec

tobasdec takes a bitstream and emits the BASIC text, assuming the bitstream is a BASIC program. The bitstream can be passed on standard input or provided as a filename argument. The output is sent to standard output.

Options you can pass on the command line:

-verbose

Display additional debugging information.

topicdec takes a bitstream, extracts the bitmap and colour portions and emits them as a TARGA-format image, assuming the bitstream is a GRAPHIC save. It does not include the sprites. The bitstream can be passed on standard input or provided as a filename argument. The output is sent to standard output.

togradec

togradec takes a bitstream and displays a dump of the GRAPHIC contents, assuming the bitstream is a GRAPHIC save. It is intended for debugging; the output is mostly for educational purposes and cannot be re-encoded. There are certain byte-level variations from how GRAPHIC mode is stored in 9918 VDP memory. Of note, the filename partially overlaps the first set of octets and they are stored after the GBASIC area, and certain registers like the background colour are shadowed in the interstitial area.

Eventually this or a future related tool will be able to list GBASIC programs.

tobitenc

tobitenc takes a Portable Greymap "P5" file, such as one generated by the netpbm or pbmplus toolkits, ImageMagick or a tool such as djpeg -gray -pnm, reads the first 256x192 bytes and encodes it into a 1-bit VDP-format bitmap, emitting a bitstream that can act as a GRAPHIC load file. The input data can be passed on standard input or provided as a filename argument. The output is sent to standard output.

The filename encoded in the bitstream is BITM; so, in the MONitor, you should LOAD the filename BITM.

This utility will use a random dither to convert from grey to 1-bit, which works acceptably on continuous tone images but may cause line art to be fuzzy. If this is displeasing or undesirable, quantize the image beforehand so that the pixels are either 0 or 255 (fully black or fully white) with your desired tool.