Documentation for XTOMYDEV 0.3

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 of a BASIC save 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.

togbadec takes a bitstream of a GRAPHIC save and emits the GBASIC text, assuming the bitstream is a GRAPHIC save and there is text to be displayed. 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.

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.

For best results, pre-scale your image to 256x192 using a high-quality downscaler or Photoshop.

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

Options you can pass on the command line:

-random

By default this utility now uses Floyd-Steinberg dithering, which is very high quality and suitable for most images. Previous versions used 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. The older dither can be enabled with this option for those images that looked better with it.

tog64enc takes a Portable Anymap "P6" file, such as one generated by the netpbm or pbmplus toolkits, ImageMagick or a tool such as djpeg -pnm, reads the first 256x192 bytes and encodes it into a "GRAPHIC 64" colour semigraphic image, 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.

For best results, pre-scale your image to 256x192 using a high-quality downscaler or Photoshop.

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

"GRAPHIC 64" is a 64x192 synthetic semigraphics mode. This utility averages each four pixel group together so that each 4x1 "pixel" can have an independent colour. Floyd-Steinberg dithering is then applied to the final image.

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.

This utility is deprecated and will be removed in a future version once the individual components of the GRAPHIC dump can be separately analysed.