![]() |
![]() |
![]() |
GStreamer Base Plugins 0.10 Plugins Reference Manual | ![]() |
---|---|---|---|---|
"bitrate" gint : Read / Write "border" GstTheoraEncBorderMode : Read / Write "center" gboolean : Read / Write "keyframe-auto" gboolean : Read / Write "keyframe-force" gint : Read / Write "keyframe-freq" gint : Read / Write "keyframe-mindistance" gint : Read / Write "keyframe-threshold" gint : Read / Write "noise-sensitivity" gint : Read / Write "quality" gint : Read / Write "quick" gboolean : Read / Write "sharpness" gint : Read / Write
This element encodes raw video into a Theora stream. Theora is a royalty-free video 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. The "border" and "center" properties control how this cropping region will be set up.
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.
gst-launch -v videotestsrc num-buffers=1000 ! theoraenc ! oggmux ! filesink location=videotestsrc.oggThis example pipeline will encode a test video source to theora muxed in an ogg container. Refer to the theoradec documentation to decode the create stream.
Last reviewed on 2006-03-01 (0.10.4)
plugin | theora |
author | Wim Taymans <wim@fluendo.com> |
class | Codec/Encoder/Video |
name | src |
direction | source |
presence | always |
details | video/x-theora |
name | sink |
direction | sink |
presence | always |
details | video/x-raw-yuv, format=(fourcc)I420, framerate=(fraction)[ 0/1, 2147483647/1 ], width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ] |
bitrate
" property"bitrate" gint : Read / Write
Compressed video bitrate (kbps).
Allowed values: [0,2000]
Default value: 0
border
" property"border" GstTheoraEncBorderMode : Read / Write
Border color to add when sizes not multiple of 16.
Default value: Black Border
center
" property"center" gboolean : Read / Write
Center image when sizes not multiple of 16.
Default value: TRUE
keyframe-auto
" property"keyframe-auto" gboolean : Read / Write
Automatic keyframe detection.
Default value: TRUE
keyframe-force
" property"keyframe-force" gint : Read / Write
Force keyframe every N frames.
Allowed values: [1,32768]
Default value: 64
keyframe-freq
" property"keyframe-freq" gint : Read / Write
Keyframe frequency.
Allowed values: [1,32768]
Default value: 64
keyframe-mindistance
" property"keyframe-mindistance" gint : Read / Write
Keyframe mindistance.
Allowed values: [1,32768]
Default value: 8
keyframe-threshold
" property"keyframe-threshold" gint : Read / Write
Keyframe threshold.
Allowed values: [0,32768]
Default value: 80
noise-sensitivity
" property"noise-sensitivity" gint : Read / Write
Noise sensitivity.
Allowed values: [0,32768]
Default value: 1
quality
" property"quality" gint : Read / Write
Video quality.
Allowed values: [0,63]
Default value: 16