# theoraenc

Opaque data structure.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstVideoEncoder
                        ╰──theoraenc

## Implemented interfaces

    GstPreset

## Factory details

Authors: – Wim Taymans <wim@fluendo.com></wim@fluendo.com>

Classification: – `Codec/Encoder/Video`

Rank – primary

Plugin – theora

Package – GStreamer Base Plug-ins

## Pad Templates

### `sink`

    video/x-raw:
             format: { I420, Y42B, Y444 }
          framerate: [ 1/2147483647, 2147483647/1 ]
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]

Presence – always

Direction – sink

Object type – GstPad

### `src`

    video/x-theora:
          framerate: [ 1/2147483647, 2147483647/1 ]
              width: [ 1, 2147483647 ]
             height: [ 1, 2147483647 ]

Presence – always

Direction – src

Object type – GstPad

## Properties

### bitrate

    “bitrate” gint

Compressed video bitrate (kbps)

Flags : Read / Write

Default value : 0

### cap-overflow

    “cap-overflow” gboolean

Enable capping of bit reservoir overflows

Flags : Read / Write

Default value : true

### cap-underflow

    “cap-underflow” gboolean

Enable capping of bit reservoir underflows

Flags : Read / Write

Default value : false

### drop-frames

    “drop-frames” gboolean

Allow or disallow frame dropping

Flags : Read / Write

Default value : true

### keyframe-auto

    “keyframe-auto” gboolean

Automatic keyframe detection

Flags : Read / Write

Default value : true

### keyframe-force

    “keyframe-force” gint

Force keyframe every N frames

Flags : Read / Write

Default value : 64

### keyframe-freq

    “keyframe-freq” gint

Keyframe frequency

Flags : Read / Write

Default value : 64

### multipass-cache-file

    “multipass-cache-file” gchararray

Multipass cache file

Flags : Read / Write

Default value : NULL

### multipass-mode

    “multipass-mode” Theora-enc-multipass-mode *

Single pass or first/second pass

Flags : Read / Write

Default value : single-pass (0)

### quality

    “quality” gint

Video quality

Flags : Read / Write

Default value : 48

### rate-buffer

    “rate-buffer” gint

Sets the size of the rate control buffer, in units of frames. The default value of 0 instructs the encoder to automatically select an appropriate value

Flags : Read / Write

Default value : 0

### speed-level

    “speed-level” gint

Controls the amount of motion vector searching done while encoding

Flags : Read / Write

Default value : 1

### vp3-compatible

    “vp3-compatible” gboolean

Disables non-VP3 compatible features

Flags : Read / Write

Default value : false

## Named constants

### Theora-enc-multipass-mode

#### Members

`single-pass` (0) – Single pass
`first-pass` (1) – First pass
`second-pass` (2) – Second pass

The results of the search are