brotlidecompress
Decompress data compressed by brotlicompress using the Brotli algorithm.
The decompressor uses GstAdapter to reassemble complete Brotli streams from
arbitrary-sized input chunks (e.g. from filesrc). Brotli streams are
self-delimiting, so no method property is required.
When the compressed stream carries original-caps (written by brotlicompress
with GDP), the srcpad caps are restored automatically. When absent, caps must be
provided downstream via a GDP depayloader or an explicit caps filter.
Examples
Direct pipeline (caps restored from original-caps):
... ! brotlicompress ! brotlidecompress ! ...
From file (no embedded caps; provide them downstream):
filesrc location=file.br ! brotlidecompress ! rawvideoparse ...
Note Corruption handling
Brotli has no end-to-end checksum (unlike zlib), so the outcome of data corruption depends on where in the stream the corrupted bytes land:
-
Structural corruption: detected as a hard failure (
ResultFailure), surfaced as a GStreamer flow error. The pipeline reports an error and no output is produced. -
Payload corruption that breaks stream framing: treated as an incomplete stream (
NeedsMoreInput). The decompressor waits for more data that never arrives, no output is produced and no error is signalled. -
Payload corruption that still forms a valid stream: decoded silently with garbage output (
ResultSuccesswith wrong data). No error is signalled.
For integrity guarantees, wrap the stream with GDP or use an external checksum.
See Also
brotlicompress
Hierarchy
GObject ╰──GInitiallyUnowned ╰──GstObject ╰──GstElement ╰──GstBaseTransform ╰──brotlidecompress
Factory details
Authors: – Daniel Morin
Classification: – Decoder/Generic
Rank – none
Plugin – compress
Package – gst-plugin-compress
Pad Templates
The results of the search are