Top | ![]() |
![]() |
![]() |
![]() |
gint | bitrate | Read / Write |
GstTheoraEncBorderMode | border | Read / Write |
gboolean | center | Read / Write |
gboolean | keyframe-auto | Read / Write |
gint | keyframe-force | Read / Write |
gint | keyframe-freq | Read / Write |
gint | keyframe-mindistance | Read / Write |
gint | keyframe-threshold | Read / Write |
gint | noise-sensitivity | Read / Write |
gint | quality | Read / Write |
gboolean | quick | Read / Write |
gint | sharpness | Read / Write |
gint | speed-level | Read / Write / Construct |
gboolean | cap-overflow | Read / Write |
gboolean | cap-underflow | Read / Write |
gboolean | drop-frames | Read / Write |
gint | rate-buffer | Read / Write |
gboolean | vp3-compatible | Read / Write |
gchar * | multipass-cache-file | Read / Write |
GstTheoraEncMultipassMode | multipass-mode | Read / Write |
This element encodes raw video into a Theora stream.
Theora is a royalty-freevideo codec maintained by the Xiph.org Foundation, based on the VP3 codec.
The theora codec internally only supports encoding of images that are a multiple of 16 pixels in both X and Y direction. It is however perfectly possible to encode images with other dimensions because an arbitrary rectangular cropping region can be set up. This element will automatically set up a correct cropping region if the dimensions are not multiples of 16 pixels.
To control the quality of the encoding, the “bitrate” and “quality” properties can be used. These two properties are mutualy exclusive. Setting the bitrate property will produce a constant bitrate (CBR) stream while setting the quality property will produce a variable bitrate (VBR) stream.
1 |
gst-launch -v videotestsrc num-buffers=1000 ! theoraenc ! oggmux ! filesink location=videotestsrc.ogg |
Last reviewed on 2006-03-01 (0.10.4)
“bitrate”
property “bitrate” gint
Compressed video bitrate (kbps).
Flags: Read / Write
Allowed values: [0,16777215]
Default value: 0
“border”
property“border” GstTheoraEncBorderMode
ignored and kept for API compat only.
Flags: Read / Write
Default value: Black Border
“center”
property “center” gboolean
ignored and kept for API compat only.
Flags: Read / Write
Default value: TRUE
“keyframe-auto”
property “keyframe-auto” gboolean
Automatic keyframe detection.
Flags: Read / Write
Default value: TRUE
“keyframe-force”
property “keyframe-force” gint
Force keyframe every N frames.
Flags: Read / Write
Allowed values: [1,32768]
Default value: 64
“keyframe-freq”
property “keyframe-freq” gint
Keyframe frequency.
Flags: Read / Write
Allowed values: [1,32768]
Default value: 64
“keyframe-mindistance”
property “keyframe-mindistance” gint
ignored and kept for API compat only.
Flags: Read / Write
Allowed values: [1,32768]
Default value: 8
“keyframe-threshold”
property “keyframe-threshold” gint
ignored and kept for API compat only.
Flags: Read / Write
Allowed values: [0,32768]
Default value: 80
“noise-sensitivity”
property “noise-sensitivity” gint
ignored and kept for API compat only.
Flags: Read / Write
Allowed values: [0,32768]
Default value: 1
“quality”
property “quality” gint
Video quality.
Flags: Read / Write
Allowed values: [0,63]
Default value: 48
“quick”
property “quick” gboolean
ignored and kept for API compat only.
Flags: Read / Write
Default value: TRUE
“sharpness”
property “sharpness” gint
ignored and kept for API compat only.
Flags: Read / Write
Allowed values: [0,2]
Default value: 0
“speed-level”
property “speed-level” gint
Controls the amount of analysis performed when encoding. Higher values trade compression quality for speed. This property requires libtheora version >= 1.0, and the maximum value may vary based on encoder version.
Flags: Read / Write / Construct
Allowed values: [0,2]
Default value: 1
“cap-overflow”
property “cap-overflow” gboolean
Enable capping of bit reservoir overflows.
Flags: Read / Write
Default value: TRUE
“cap-underflow”
property “cap-underflow” gboolean
Enable capping of bit reservoir underflows.
Flags: Read / Write
Default value: FALSE
“drop-frames”
property “drop-frames” gboolean
Allow or disallow frame dropping.
Flags: Read / Write
Default value: TRUE
“rate-buffer”
property “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
Allowed values: [0,1000]
Default value: 0
“vp3-compatible”
property “vp3-compatible” gboolean
Disables non-VP3 compatible features.
Flags: Read / Write
Default value: FALSE
“multipass-cache-file”
property “multipass-cache-file” gchar *
Multipass cache file.
Flags: Read / Write
Default value: NULL