mirrors/gst-plugins-rs
mirrors/gst-plugins-rs
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git synced 2024-11-22 19:41:00 +00:00
Code Issues Projects Releases Wiki Activity
GStreamer plugins written in Rust. *These plugins can be used by applications written in other programming languages as well of course, they are just like any other GStreamer plugins available on the system.*
1091 commits 14 branches 100 tags 44 MiB
Rust 96%
JavaScript 1.3%
C 1.1%
Python 0.5%
Meson 0.3%
Other 0.7%
Find a file
Mathieu Duponchelle 42b4defb5c tttocea608: in-depth refactoring, support for new input format 
Up to now, tttocea608 supported text/utf8, and no interface to
control the positioning of closed captions apart from new lines
in the input text.

CEA 608 supports a larger set of features than that, such as
positioning CC precisely in its 32 x 15 grid, styling text,
switching from one mode to another, resetting the base row
in roll-up mode etc ..

A custom, JSON-based format is now supported by the element
(caps application/x-json, format=cea608), allowing users to
control those features in a pretty advanced manner.

A side effect of this is that the approach previously used
by the element to ensure frame-accurate CC display is now
untenable: where we knew before that an input buffer would
at most span 74 buffers and calculate a somewhat reasonable
latency based on that, this is no longer possible. Instead
we pick the approach most CC encoders seem to pick, and
accept a certain latency at display time: for example the
flipping of the back buffer to the display buffer for a
10-character text buffer will occur 7 frames after its
PTS. This has obvious benefits in terms of code complexity
and should generally be acceptable.

+ Removes a now irrelevant test, updates other tests

+ Extracts the Mode enum to the root of the crate, it will
  be used by another element in a follow-up commit
2021-01-20 02:29:19 +01:00
audio use cargo-c to produce cdy and static libs 2021-01-04 12:26:45 +01:00
ci Add new text/json crate 2021-01-20 02:29:19 +01:00
generic Update to rand 0.8 2021-01-09 12:34:42 +02:00
net rusoto: Port to nom 6 2021-01-09 12:34:41 +02:00
text textwrap: expose accumulate-time property 2021-01-20 02:29:19 +01:00
tutorial use cargo-c to produce cdy and static libs 2021-01-04 12:26:45 +01:00
utils fallbackswitch,togglerecord: Don't apply clipped PTS to buffer DTS 2021-01-19 19:45:14 +09:00
version-helper Update for macro renames 2020-12-20 20:43:45 +02:00
video tttocea608: in-depth refactoring, support for new input format 2021-01-20 02:29:19 +01:00
.gitignore gif: Add initial implementation of a gif encoder 2020-02-25 08:45:22 +00:00
.gitlab-ci.yml ci: install cargo-c to proper location 2021-01-04 16:04:52 +01:00
Cargo.toml Add new text/json crate 2021-01-20 02:29:19 +01:00
cargo_wrapper.py meson: install plugins pc files 2021-01-04 12:26:45 +01:00
deny.toml deny.toml: Update 2021-01-16 10:19:51 +02:00
LICENSE-APACHE Change license from LGPLv2.1+ to Apache2/MIT 2017-02-16 17:52:27 +02:00
LICENSE-LGPLv2 Add gst-plugin-togglerecord 2017-12-05 09:56:58 +02:00
LICENSE-MIT Change license from LGPLv2.1+ to Apache2/MIT 2017-02-16 17:52:27 +02:00
Makefile Clean up Makefile some more 2019-07-06 10:32:22 +03:00
meson.build Add new text/json crate 2021-01-20 02:29:19 +01:00
meson_options.txt Add csound-based filter plugin 2020-03-22 13:44:40 +02:00
README.md use cargo-c to produce cdy and static libs 2021-01-04 12:26:45 +01:00
update-version.sh Add update-version script 2020-04-15 20:39:31 +02:00

README.md

gst-plugins-rs crates.io pipeline status

Repository containing various GStreamer plugins and elements written in the Rust programming language.

The plugins build upon the GStreamer Rust bindings. Check the README.md of that repository also for details about how to set-up your development environment.

Plugins

You will find the following plugins in this repository:

  • generic

    • file: A Rust implementation of the standard filesrc and filesink elements

    • sodium: Elements to perform encryption and decryption using libsodium.

    • threadshare: Some popular threaded elements reimplemented using common thread-sharing infrastructure.

  • net

    • reqwest: An HTTP source element based on the reqwest library.

    • rusoto: A source and sink plugin to talk to the Amazon S3 object storage system using the Rusoto library.

  • audio

    • audiofx: Plugins to apply audio effects to a stream (such as adding echo/reverb, removing noise or normalization).

    • claxon: A FLAC decoder based on the Claxon library.

    • csound: A plugin to implement audio effects using the Csound library.

    • lewton: A Vorbis decoder based on the lewton library.

  • video

    • cdg: A parser and renderer for CD+G karaoke data.

    • closedcaption: Plugins to deal with several closed caption formats (MCC, SCC, EIA-608/CEA-608 and timed text).

    • dav1d: AV1 decoder based on the dav1d library.

    • flavors: FLV demuxer based on the flavors library.

    • gif: A GIF encoder based on the gif library.

    • rav1e: AV1 encoder based on the rav1e library.

  • utils

    • fallbackswitch: Aggregator element that allows falling back to a different sink pad after a timeout.

    • togglerecord: Element to enable starting and stopping multiple streams together.

Building

gst-plugins-rs relies on cargo-c to generate shared and static C libraries. It can be installed using:

$ cargo install cargo-c

Then you can easily build and test a specific plugin:

$ cargo cbuild --manifest-path video/cdg/Cargo.toml
$ GST_PLUGIN_PATH=$GST_PLUGIN_PATH:target/debug gst-inspect-1.0 cdgdec

The plugin can also be installed system-wide:

$ cargo cbuild --manifest-path video/cdg/Cargo.toml --prefix=/usr
$ cargo cinstall --manifest-path video/cdg/Cargo.toml --prefix=/usr

This will install the plugin to /usr/lib/gstreamer-1.0. You can use --libdir to pass a custom lib directory such as /usr/lib/x86_64-linux-gnu for example.

Note that you can also just use cargo directly to build Rust static libraries and shared C libraries. cargo-c is mostly useful to build static C libraries and generate pkg-config files.

LICENSE

gst-plugins-rs and all crates contained in here that are not listed below are licensed under either of

at your option.

gst-plugin-togglerecord is licensed under the Lesser General Public License (LICENSE-LGPLv2) version 2.1 or (at your option) any later version.

gst-plugin-csound is licensed under the Lesser General Public License (LICENSE-LGPLv2) version 2.1 or (at your option) any later version.

GStreamer itself is licensed under the Lesser General Public License version 2.1 or (at your option) any later version: https://www.gnu.org/licenses/lgpl-2.1.html

Contribution

Any kinds of contributions are welcome as a pull request.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in gst-plugins-rs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.