![]() |
![]() |
![]() |
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 GstTheoraEnc::border and GstTheoraEnc::center properties control how this cropping region will be set up.
To control the quality of the encoding, the GstTheoraEnc::bitrate and GstTheoraEnc::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.ogg
Last reviewed on 2006-03-01 (0.10.4)
bitrate
" property"bitrate" gint : Read / Write
Compressed video bitrate (kbps).
Allowed values: [0,16777215]
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