## flacenc

flacenc

## Properties

guint | blocksize | Read / Write / Construct
gboolean | escape-coding | Read / Write / Construct
gboolean | exhaustive-model-search | Read / Write / Construct
gboolean | loose-mid-side-stereo | Read / Write / Construct
guint | max-lpc-order | Read / Write / Construct
guint | max-residual-partition-order | Read / Write / Construct
gboolean | mid-side-stereo | Read / Write / Construct
guint | min-residual-partition-order | Read / Write / Construct
gboolean | qlp-coeff-prec-search | Read / Write / Construct
guint | qlp-coeff-precision | Read / Write / Construct
GstFlacEncQuality | quality | Read / Write / Construct
guint | rice-parameter-search-dist | Read / Write / Construct
gboolean | streamable-subset | Read / Write / Construct
guint | padding | Read / Write / Construct
gint | seekpoints | Read / Write / Construct

## Types and Values

struct | GstFlacEnc

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GstObject
                ╰── GstElement
                    ╰── GstAudioEncoder
                        ╰── GstFlacEnc

## Implemented Interfaces

GstFlacEnc implements GstTagSetter and GstPreset.

## Description

flacenc encodes FLAC streams.

FLAC

is a Free Lossless Audio Codec. FLAC audio can directly be written into a file, or embedded into containers such as oggmux or matroskamux.

### Example launch line

    1

    gst-launch-1.0 audiotestsrc num-buffers=100 ! flacenc ! filesink location=beep.flac

Encode a short sine wave into FLAC

    1

    gst-launch-1.0 cdparanoiasrc mode=continuous ! queue ! audioconvert ! flacenc ! filesink location=cd.flac

Rip a whole audio CD into a single FLAC file, with the track table saved as a CUE sheet inside the FLAC file

    1

    gst-launch-1.0 cdparanoiasrc track=5 ! queue ! audioconvert ! flacenc ! filesink location=track5.flac

Rip track 5 of an audio CD and encode it losslessly to a FLAC file

## Synopsis

### Element Information

plugin | flac
author | Wim Taymans <wim.taymans@chello.be>
class | Codec/Encoder/Audio

### Element Pads

name | sink
direction | sink
presence | always
details | audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)1
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)2, channel-mask=(bitmask)0x0000000000000003
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)3, channel-mask=(bitmask)0x0000000000000007
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)4, channel-mask=(bitmask)0x0000000000000033
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)5, channel-mask=(bitmask)0x0000000000000037
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)6, channel-mask=(bitmask)0x000000000000003f
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)7, channel-mask=(bitmask)0x000000000000013f
| audio/x-raw, format=(string){ S8, S16LE, S24LE, S24_32LE }, layout=(string)interleaved, rate=(int)[ 1, 655350 ], channels=(int)8, channel-mask=(bitmask)0x0000000000000c3f

name | src
direction | source
presence | always
details | audio/x-flac

## Functions

## Types and Values

### struct GstFlacEnc

    struct GstFlacEnc;

## Property Details

### The `“blocksize”` property

      “blocksize”                guint

Blocksize in samples.

Flags: Read / Write / Construct

Allowed values: [16,65535]

Default value: 4608

### The `“escape-coding”` property

      “escape-coding”            gboolean

search for escape codes in the entropy coding stage for slightly better compression.

Flags: Read / Write / Construct

Default value: FALSE

### The `“exhaustive-model-search”` property

      “exhaustive-model-search”  gboolean

do exhaustive search of LP coefficient quantization (expensive!).

Flags: Read / Write / Construct

Default value: FALSE

### The `“loose-mid-side-stereo”` property

      “loose-mid-side-stereo”    gboolean

Loose mid side stereo.

Flags: Read / Write / Construct

Default value: FALSE

### The `“max-lpc-order”` property

      “max-lpc-order”            guint

Max LPC order; 0 => use only fixed predictors.

Flags: Read / Write / Construct

Allowed values: <= 32

Default value: 8

### The `“max-residual-partition-order”` property

      “max-residual-partition-order” guint

Max residual partition order (above 4 doesn't usually help much).

Flags: Read / Write / Construct

Allowed values: <= 16

Default value: 3

### The `“mid-side-stereo”` property

      “mid-side-stereo”          gboolean

Do mid side stereo (only for stereo input).

Flags: Read / Write / Construct

Default value: TRUE

### The `“min-residual-partition-order”` property

      “min-residual-partition-order” guint

Min residual partition order (above 4 doesn't usually help much).

Flags: Read / Write / Construct

Allowed values: <= 16

Default value: 3

### The `“qlp-coeff-prec-search”` property

      “qlp-coeff-prec-search”    gboolean

false = use qlp_coeff_precision, true = search around qlp_coeff_precision, take best.

Flags: Read / Write / Construct

Default value: FALSE

### The `“qlp-coeff-precision”` property

      “qlp-coeff-precision”      guint

Precision in bits of quantized linear-predictor coefficients; 0 = automatic.

Flags: Read / Write / Construct

Allowed values: <= 32

Default value: 0

### The `“quality”` property

      “quality”                  GstFlacEncQuality

Speed versus compression tradeoff.

Flags: Read / Write / Construct

Default value: 5 - Default

### The `“rice-parameter-search-dist”` property

      “rice-parameter-search-dist” guint

0 = try only calc'd parameter k; else try all [k-dist..k+dist] parameters, use best.

Flags: Read / Write / Construct

Allowed values: <= 15

Default value: 0

### The `“streamable-subset”` property

      “streamable-subset”        gboolean

true to limit encoder to generating a Subset stream, else false.

Flags: Read / Write / Construct

Default value: TRUE

### The `“padding”` property

      “padding”                  guint

Write a PADDING block with this length in bytes.

Flags: Read / Write / Construct

Default value: 0

### The `“seekpoints”` property

      “seekpoints”               gint

Add SEEKTABLE metadata (if > 0, number of entries, if < 0, interval in sec).

Flags: Read / Write / Construct

Allowed values: >= -2147483647

Default value: -10

## See Also

GstFlacDec