Vexatos' and asie's new Minecraft wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Cassette Tape ======

**Cassette Tapes** let you store a lot of information (from 1MB to 8MB, depending on the tape type). They also have the bonus benefit of letting you store audio in [[:dfpwm|a special format]]... and play it back!

To read from, write to and play them back, you want to craft a **Tape Drive**.

For writing/reading/playing in OpenComputers, you can use the built-in "tape" program.

===== Recording Audio =====

Audio is written in a special format called DFPWM. As of right now, there are no easy-to-use solutions to convert regular MP3s and OGGs into this format.

==== LionRay ====

LionRay is a tool by gamax92. It lets you **convert WAV files into DFPWM-format data**. Simply select the input and output filenames... and convert!

> [[https://files.vexatos.com/Computronics/dev/LionRay.jar|Download here]] - MIT license
> [[https://github.com/gamax92/LionRay/releases/|Alternative download]]
> [[https://github.com/gamax92/LionRay/|Source Code]]

==== Wabbitoe ====

**LionRay is recommended nowadays due to having a better GUI and less bugs ~ asie**

Wabbitoe is a tool which can convert .wav files into DFPWM. They must be 8- or 16-bit uncompressed PCM, and have a sane rate and channel count. It will do a nearest-neighbour resample, a simple truncation of any 16-bit audio data, and a simple mix of all the channels, so you should probably use SoX to do all the resampling for you. But it's easy to use - run the .jar, pick a .wav file to open, pick where and what to save the .dfpwm file as.

> [[https://dl.dropboxusercontent.com/u/32094129/wabbitoe.jar|Download here]] - contains public-domain source code.

==== For Developers ====

Grab [[https://github.com/asiekierka/pixmess/tree/master/scraps|these]]. These are compression and decompression software for DFPWM. aucmp takes a RAW, 8-bit signed audio stream as input and outputs DFPWM data, the reverse goes for audecmp. The rate of the stream is 32768Hz. Here's an example Linux shell script, where $1 is the input WAV file:

<code>#!/bin/sh
sox $1 -e signed-integer -b 8 -c 1 -r 32768 tmp.raw
./aucmp < tmp.raw > tmp.dfpwm
./audecmp < tmp.dfpwm > out.raw
sox -e signed-integer -b 8 -c 1 -r 32768 out.raw out.wav</code>

The script requires SoX - download [[http://sourceforge.net/projects/sox/files/sox/|here]].

===== Writing audio =====

Use write(byte) to write audio data byte by byte. Read from the .dfpwm file to get the audio data you want to write. Each byte write advances the tape position by 1 byte - after you finish writing, use seek(-length) to go back to the beginning. To read a single byte, use read(). It will also advance the tape position.

===== API =====

==== OpenComputers/ComputerCraft ====

^ Command ^ Introduced in ^ Description ^ Usage ^
| isReady() | 0.1.0 | Checks if a tape is inserted. | Returns true or false. |
| isEnd() | 0.1.0 | Checks if the tape is at most 0.25 seconds away from being over. | Returns true or false. |
| getSize() | 0.1.0 | Get the size of the tape. | Returns the tape size in bytes. |
| getLabel() | 0.1.0 | Get the tape's label. | Returns the tape's label. |
| getState() | 0.2.1 | Get the tape drive's state. | Returns "PLAYING", "REWINDING", "FORWARDING" or "STOPPED". |
| setLabel(label) | 0.1.0 | Set the tape's label. | - |
| setSpeed(speed) | 0.3.1 | Set the tape's speed. | speed is a value from 0.25 to 2.0, denoting the difference from regular tape speed, which is 1.0. |
| setVolume(volume) | ??? | Set the volume of playback. | volume is a value from 0.0 to 1.0. |
| seek(amount) | 0.1.0 | Seek through the tape. | amount is the amount to seek in bytes, returns the amount of bytes actually seeked. |
| read() | 0.1.0 | Read a single byte from the tape. | Returns a byte. |
| write(byte) | 0.1.0 | Write a single byte to the tape. | byte - value from 0 to 255. |
| play(), stop() | 0.1.0 | Controls music playback. | - |

=== OpenComputers specific ===

  * read() can take a length and return a byte array.
  * write() can take a byte array.

=== ComputerCraft specific ===

  * read() can take a length and return a string.
  * write() can take a string.

==== NedoComputers ====

^ Address ^ Read ^ Write ^
| 0x00 | Get the current state number. | Set the current state number. |
| 0x02 | Reserved | Reserved |
| 0x04 | Get the sound volume (0-127). | Set the sound volume (0-127). |
| 0x06 | Get the current tape length, in minutes (one minute is 4096*60 bytes). | - |
| 0x08 | Return the amount of bytes seeked. | Seek a number of bytes. |
| 0x0A | Read one byte. | Write one byte. |