GstPbutils.EncodingVideoProfile¶

Subclasses:: None

Methods¶

Inherited:: GstPbutils.EncodingProfile (31), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`new` (format, preset, restriction, presence)
	`get_pass` ()
	`get_variableframerate` ()
	`set_pass` (pass_)
	`set_variableframerate` (variableframerate)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Inherited:: GstPbutils.EncodingProfile (2)

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class GstPbutils.EncodingVideoProfile(**kwargs)¶

Bases:: GstPbutils.EncodingProfile
Abstract:: No
Structure:: GstPbutils.EncodingVideoProfileClass

Variant of GstPbutils.EncodingProfile for video streams, allows specifying the pass.

classmethod new(format, preset, restriction, presence)[source]¶

Parameters:

format (Gst.Caps) – the Gst.Caps
preset (str or None) – the preset(s) to use on the encoder, can be None
restriction (Gst.Caps or None) – the Gst.Caps used to restrict the input to the encoder, can be None. See GstPbutils.EncodingProfile.get_restriction() for more details.
presence (int) – the number of time this stream must be used. 0 means any number of times (including never)

Returns:

the newly created GstPbutils.EncodingVideoProfile.

Return type:

GstPbutils.EncodingVideoProfile

Creates a new GstPbutils.EncodingVideoProfile

All provided allocatable arguments will be internally copied, so can be safely freed/unreferenced after calling this method.

If you wish to control the pass number (in case of multi-pass scenarios), please refer to the GstPbutils.EncodingVideoProfile.set_pass() documentation.

If you wish to use/force a constant framerate please refer to the GstPbutils.EncodingVideoProfile.set_variableframerate() documentation.

get_pass()[source]¶

Returns:: The pass number. Starts at 1 for multi-pass. 0 if this is not a multi-pass profile
Return type:: int

Get the pass number if this is part of a multi-pass profile.

get_variableframerate()[source]¶

Returns:: Whether non-constant video framerate is allowed for encoding.
Return type:: bool

*NOTE*: Fixed framerate won’t be enforced when #encodebin:avoid-reencoding is set.

set_pass(pass_)[source]¶

Parameters:: pass (int) – the pass number for this profile

Sets the pass number of this video profile. The first pass profile should have this value set to 1. If this video profile isn’t part of a multi-pass profile, you may set it to 0 (the default value).

set_variableframerate(variableframerate)[source]¶

Parameters:: variableframerate (bool) – a boolean

If set to True, then the incoming stream will be allowed to have non-constant framerate. If set to False (default value), then the incoming stream will be normalized by dropping/duplicating frames in order to produce a constance framerate.