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 (ResultSuccess with 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

sink

application/x-brotli-compressed:

Presencealways

Directionsink

Object typeGstPad


src

ANY

Presencealways

Directionsrc

Object typeGstPad


The results of the search are