aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorMatthias P. Braendli <matthias.braendli@mpb.li>2016-09-23 10:52:30 +0200
committerMatthias P. Braendli <matthias.braendli@mpb.li>2016-09-23 10:52:30 +0200
commit397343b73698597a2ab4c92e7ba039d62902fcec (patch)
treeb600c59f9247df7114d831ef3df1349a7a3cad39 /README.md
parenteecb4369a8b3ff32ae76f66c5eb40619a835a822 (diff)
downloadODR-AudioEnc-397343b73698597a2ab4c92e7ba039d62902fcec.tar.gz
ODR-AudioEnc-397343b73698597a2ab4c92e7ba039d62902fcec.tar.bz2
ODR-AudioEnc-397343b73698597a2ab4c92e7ba039d62902fcec.zip
Update README to remove mot-encoder things
Diffstat (limited to 'README.md')
-rw-r--r--README.md64
1 files changed, 4 insertions, 60 deletions
diff --git a/README.md b/README.md
index b823e63..37b93ed 100644
--- a/README.md
+++ b/README.md
@@ -22,14 +22,10 @@ The JACK input does not automatically connect to anything. The encoder runs
at the rate defined by the system clock, and therefore sound
card clock drift compensation is also used.
-*odr-audioenc* includes support for DAB MOT Slideshow and DLS, contributed by
-[CSP](http://rd.csp.it).
+*odr-audioenc* can insert Programme-Associated Data, that can be generated with
+ODR-PadEnc.
-To encode DLS and Slideshow data, the *mot-encoder* tool reads images
-from a folder and DLS text from a file, and generates the PAD data
-for the encoder.
-
-For detailed usage, see the usage screen of the different tools.
+For detailed usage, see the usage screen of the tool with the *-h* option.
More information is available on the
[Opendigitalradio wiki](http://opendigitalradio.org)
@@ -41,7 +37,6 @@ Requirements:
* A C++11 compiler
* FDK-AAC with the DAB+ patches
-* ImageMagick magickwand (optional, for MOT slideshow)
* Install ZeroMQ 4.0.4 or more recent
* If your distribution does not include it, take it from
from http://download.zeromq.org/zeromq-4.0.4.tar.gz
@@ -61,7 +56,6 @@ If you want to use ALSA, JACK and libVLC inputs, please use
./configure --enable-alsa --enable-jack --enable-vlc
* See the possible scenarios below on how to use the tools
-* use *mot-encoder* to encode images into MOT Slideshow
How to use
@@ -123,7 +117,7 @@ Read a webstream and send it to ODR-DabMux over ZMQ:
If you need to extract the ICY-Text information, e.g. for DLS, you can use the
**-w <filename>** option to write the ICY-Text into a file that can be read by
-*mot-encoder*.
+*ODR-PadEnc*.
If the webstream bitrate is slightly wrong (bad clock at the source), you can
enable drift compensation with **-D**.
@@ -185,62 +179,12 @@ odr-audioenc returns:
* 4 it the ZeroMQ send failed
* 5 if the input had a fault
-Usage of MOT Slideshow and DLS
-==============================
-
-*mot-encoder* reads images from the specified folder, and generates the PAD
-data for the encoder. This is communicated through a fifo to the encoder. It
-also reads DLS from a file, and includes this information in the PAD.
-
-If ImageMagick is available
----------------------------
-It can read all file formats supported by ImageMagick, and by default resizes
-them to 320x240 pixels, and compresses them as JPEG. If the input file is already
-a JPEG file of the correct size, and smaller than 50kB, it is sent without further
-compression. If the input file is a PNG that satisfies the same criteria, it is
-transmitted as PNG without any recompression.
-
-RAW Format
-----------
-If ImageMagick is not compiled in, or when enabled with the -R option, the images
-are not modified, and are transmitted as-is. Use this if you can guarantee that
-the generated files are smaller than 50kB and not larger than 320x240 pixels.
-
-Supported Encoders
-------------------
-*odr-audioenc* can insert the PAD data from *mot-encoder* into the bitstream.
-The mp2 encoder [Toolame-DAB](https://github.com/Opendigitalradio/toolame-dab)
-can also read *mot-encoder* data.
-
-This is an ongoing development. Make sure you use the same pad length option
-for *mot-encoder* and the audio encoder. Only some pad lengths are supported,
-please see *mot-encoder*'s help.
-
-Character Sets
---------------
-When *mot-encoder* is launched with the default character set options, it assumes
-that the DLS text in the file is encoded in UTF-8, and will convert it according to
-the DAB standard to the *Complete EBU Latin based repertoire* character set encoding.
-
-If you set the character set encoding to any other setting (except
-*Complete EBU Latin based repertoire* which needs no conversion),
-*mot-encoder* will abort, as it does not support any other conversion than from
-UTF-8 to *Complete EBU Latin based repertoire*.
-
-You can however use the -C option to transmit the untouched DLS text. In this
-case, it is your responsibility to ensure the encoding is valid. For instance,
-if your data is already encoded in *Complete EBU Latin based repertoire*, you
-must specify both --charset=0 and --raw-dls.
Known Limitations
-----------------
The gain option for libVLC enables the VLC audio compressor with default
settings. This has more impact than just changing the volume of the audio.
-*mot-encoder* encodes slides in a 10 second interval, which is not linked
-to the rate at which the encoder reads the PAD data. It also doesn't prioritise
-DLS transmission over Slides.
-
Some receivers did not decode audio anymore between v0.3.0 and v0.5.0, because of
a change implemented to get PAD to work. The change was subsequently reverted in
v0.5.1 because it was deemed essential that audio decoding works on all receivers.