Repository files navigation

tssi2 is a header-only library for parsing MPEG-2 and DVB Transport Streams in the domain of multimedia processing applications.

The entire implementation is provided inline in the headers under the include directory. A reference documentation is stored under docs. A modern C++ compiler (C++ 14 / C++ 17) is necessary.

While the main headerinclude/tsparser.hpp provides access to the whole library, it is also possible to break out required parts. This comes in handy if you already have a PSI or PES assembler and need some additional tables or descriptors - in this case just includeinclude/specifications.hpp.

Dependencies:

• C++ Guideline Support Library (header-only, included; mostly needed forgsl::span<const T>, a type just waiting for replacement bystd::array_view<T> orstd::basic_string_view<T>)

The GNU General Public License v3 applies to this project.

If you need another (e.g. commercial) license,contact me.

📌 Fast

SeeBenchmark

📌 Modern and leak-freeby default

C++ 14 / C++ 17 / GSL

📌 Under active development

If there has not been an push for a while the next one will happen nevertheless.

📌 Lightweight

The library is a few kb in size and header-only.

📌 Cross-platform

Windows, Linux, Mac,... should be supported

📌 No-throw

Transport Streams are prone to data corruptions. tssi2 is designed to handle data errors and not to throw. This is not a no-throw guarantee! Some functions might throw (see the docs).

📌 Multi-threading support

Reentrant with shared mutual exclusion

📌 (To some extent) class-less

Processing of MPEG and DVB objects by stateless functions. No class overhead.

📌 Modular

Custom data processors can replaced provided processors on any level. Custom allocators are supported as well.

tssi1 offers some nice features like ISO 13818-6 handling and will remain available on GitHub.

tssi2 is compared against the simple memory read operationread.

voidread(span<constchar> data) {for (auto v : data) {}}

Only the time spent in tssi2 orreadis measured. Disc to memory transfers are omitted. Data is processed in 1MB chunks.

All tests were conducted on a HP Spectre x360 with Intel Core i7-7500U. The source code is available underexamples/benchmark.

We want to detect the transmission time of a Transport Stream. Let us suppose you already have included the stream and vector files from C++ and introduced the namespacestd (a source file is available, see examples).

First of all, we load a Transport Stream into a buffer variable.

auto f = ifstream{"examples/data/ard.ts", ifstream::binary };auto b = vector<char>(4000000 );f.read(b.data(), b.size());

Keep in mind to check for errors in real programs. We skip this part to illustrate the API itself.

We now create aTSParser providing 188-byte TS packets for aPSIHeap that will process and store program-specific information for common usage (for this reason a shared pointer is used to share its ownership).

auto ts = tssi::TSParser<>();auto heap = make_shared<PSIHeap<>>();

The time and date information is stored on packets with PID0x14. We tell the parser what packets we are interested in and where to send them.

ts.pid_parser({0x14 }, heap);

Thiscould also be a lambda

auto pid_parser = make_shared < LambdaNode >([&](auto data) { });ts.pid_parser({0x100,0x200,0x300 }, pid_parser);

or aPESAssembler if you are interested in packetized elementary streams.

With the buffer and parser set up, we can process the data.

ts(b);

The PSI table_ids we are looking for are0x70 and0x73, but first we retrieve a data reference from the heap.

auto& psi_data = heap->psi_heap();for (auto& v : psi_data)// v.first: section_identifier tuple//   (table_id, table_id_ext, section_number)// v.second: PSISectionif ((get<0>(v.first) ==0x70) || (get<0>(v.first) ==0x73)) {

Direct access to the section's data is available viav.second.psi_data().

auto data = v.second.psi_data();

The functions to analyze sections and descriptors are organized in namespaces. Utilize theusing statement if appropriate.

usingnamespacetssi::etsi300468::time_date_section;auto time = UTC_time(data);        cout << ctime(&time) << endl;break;    }

The program might now result in an output like:

  Fri Oct 28 23:06:06 2005

Download or clone the repository to access the HTML documentation located underdocs. For a full definition of all values have a look at the mentioned specifications.

Advertise by utilize:

• Data: 272MB Transport Stream sample (approx. 1min DVB satellite capture), test file for the following examples.
• Minimal: The quick start guide's source code.
• Benchmark: Basic chronometry.
• PSI Data: Parsing of Program-specific information to HTML.
• Audio/Video Parser: Extraction of elementary stream (audio and video in this case) to disc.
• Multi-threading: A demo on reading fromPSIHeap whileTSParser tries to fill it with new information.
• Video player: A video player using ffmpeg and SDL2.

Should you want to build the docs for yourself, makerobodoc available and usedoc.shordoc.bat. Modify the style either in the respective file or inrobodoc.rc.