Enums

Details

class GstVideo.ColorBalanceType(value)

Bases: GObject.GEnum

An enumeration indicating whether an element implements color balancing operations in software or in dedicated hardware. In general, dedicated hardware implementations (such as those provided by xvimagesink) are preferred.

HARDWARE = 0

Color balance is implemented with dedicated hardware.

SOFTWARE = 1

Color balance is implemented via software processing.

class GstVideo.NavigationCommand(value)

Bases: GObject.GEnum

A set of commands that may be issued to an element providing the GstVideo.Navigation interface. The available commands can be queried via the GstVideo.Navigation.query_new_commands() query.

For convenience in handling DVD navigation, the MENU commands are aliased as: GST_NAVIGATION_COMMAND_DVD_MENU = GstVideo.NavigationCommand.MENU1 GST_NAVIGATION_COMMAND_DVD_TITLE_MENU = GstVideo.NavigationCommand.MENU2 GST_NAVIGATION_COMMAND_DVD_ROOT_MENU = GstVideo.NavigationCommand.MENU3 GST_NAVIGATION_COMMAND_DVD_SUBPICTURE_MENU = GstVideo.NavigationCommand.MENU4 GST_NAVIGATION_COMMAND_DVD_AUDIO_MENU = GstVideo.NavigationCommand.MENU5 GST_NAVIGATION_COMMAND_DVD_ANGLE_MENU = GstVideo.NavigationCommand.MENU6 GST_NAVIGATION_COMMAND_DVD_CHAPTER_MENU = GstVideo.NavigationCommand.MENU7

INVALID = 0

An invalid command entry

MENU1 = 1

Execute navigation menu command 1. For DVD, this enters the DVD root menu, or exits back to the title from the menu.

MENU2 = 2

Execute navigation menu command 2. For DVD, this jumps to the DVD title menu.

LEFT = 20

Select the next button to the left in a menu, if such a button exists.

RIGHT = 21

Select the next button to the right in a menu, if such a button exists.

UP = 22

Select the button above the current one in a menu, if such a button exists.

DOWN = 23

Select the button below the current one in a menu, if such a button exists.

ACTIVATE = 24

Activate (click) the currently selected button in a menu, if such a button exists.

MENU3 = 3

Execute navigation menu command 3. For DVD, this jumps into the DVD root menu.

PREV_ANGLE = 30

Switch to the previous angle in a multiangle feature.

NEXT_ANGLE = 31

Switch to the next angle in a multiangle feature.

MENU4 = 4

Execute navigation menu command 4. For DVD, this jumps to the Subpicture menu.

MENU5 = 5

Execute navigation menu command 5. For DVD, the jumps to the audio menu.

MENU6 = 6

Execute navigation menu command 6. For DVD, this jumps to the angles menu.

MENU7 = 7

Execute navigation menu command 7. For DVD, this jumps to the chapter menu.

class GstVideo.NavigationEventType(value)

Bases: GObject.GEnum

Enum values for the various events that an element implementing the GstVideo.Navigation interface might send up the pipeline.

INVALID = 0

Returned from GstVideo.Navigation.event_get_type() when the passed event is not a navigation event.

KEY_PRESS = 1

A key press event. Use GstVideo.Navigation.event_parse_key_event() to extract the details from the event.

KEY_RELEASE = 2

A key release event. Use GstVideo.Navigation.event_parse_key_event() to extract the details from the event.

MOUSE_BUTTON_PRESS = 3

A mouse button press event. Use GstVideo.Navigation.event_parse_mouse_button_event() to extract the details from the event.

MOUSE_BUTTON_RELEASE = 4

A mouse button release event. Use GstVideo.Navigation.event_parse_mouse_button_event() to extract the details from the event.

MOUSE_MOVE = 5

A mouse movement event. Use GstVideo.Navigation.event_parse_mouse_move_event() to extract the details from the event.

COMMAND = 6

A navigation command event. Use GstVideo.Navigation.event_parse_command() to extract the details from the event.

class GstVideo.NavigationMessageType(value)

Bases: GObject.GEnum

A set of notifications that may be received on the bus when navigation related status changes.

INVALID = 0

Returned from GstVideo.Navigation.message_get_type() when the passed message is not a navigation message.

MOUSE_OVER = 1

Sent when the mouse moves over or leaves a clickable region of the output, such as a DVD menu button.

COMMANDS_CHANGED = 2

Sent when the set of available commands changes and should re-queried by interested applications.

ANGLES_CHANGED = 3

Sent when display angles in a multi-angle feature (such as a multiangle DVD) change - either angles have appeared or disappeared.

EVENT = 4

Sent when a navigation event was not handled by any element in the pipeline

New in version 1.6.

class GstVideo.NavigationQueryType(value)

Bases: GObject.GEnum

Tyoes of navigation interface queries.

INVALID = 0

invalid query

COMMANDS = 1

command query

ANGLES = 2

viewing angle query

class GstVideo.VideoAlphaMode(value)

Bases: GObject.GEnum

Different alpha modes.

New in version 1.6.

COPY = 0

When input and output have alpha, it will be copied. When the input has no alpha, alpha will be set to GstVideo.VIDEO_CONVERTER_OPT_ALPHA_VALUE

SET = 1

set all alpha to GstVideo.VIDEO_CONVERTER_OPT_ALPHA_VALUE

MULT = 2

multiply all alpha with GstVideo.VIDEO_CONVERTER_OPT_ALPHA_VALUE. When the input format has no alpha but the output format has, the alpha value will be set to GstVideo.VIDEO_CONVERTER_OPT_ALPHA_VALUE

class GstVideo.VideoAncillaryDID(value)

Bases: GObject.GEnum

New in version 1.16.

UNDEFINED = 0
DELETION = 128
HANC_3G_AUDIO_DATA_FIRST = 160
HANC_3G_AUDIO_DATA_LAST = 167
HANC_HDTV_AUDIO_DATA_FIRST = 224
HANC_HDTV_AUDIO_DATA_LAST = 231
HANC_SDTV_AUDIO_DATA_1_FIRST = 236
HANC_SDTV_AUDIO_DATA_1_LAST = 239
CAMERA_POSITION = 240
HANC_ERROR_DETECTION = 244
HANC_SDTV_AUDIO_DATA_2_FIRST = 248
HANC_SDTV_AUDIO_DATA_2_LAST = 255
class GstVideo.VideoAncillaryDID16(value)

Bases: GObject.GEnum

Some know types of Ancillary Data identifiers.

New in version 1.16.

S2016_3_AFD_BAR = 16645

AFD/Bar Ancillary data according to SMPTE 2016-3

New in version 1.18.

S334_EIA_708 = 24833

CEA 708 Ancillary data according to SMPTE 334

S334_EIA_608 = 24834

CEA 608 Ancillary data according to SMPTE 334

class GstVideo.VideoCaptionType(value)

Bases: GObject.GEnum

The various known types of Closed Caption (CC).

New in version 1.16.

classmethod from_caps(caps)[source]
Parameters:caps (Gst.Caps) – Fixed Gst.Caps to parse
Returns:GstVideo.VideoCaptionType.
Return type:GstVideo.VideoCaptionType

Parses fixed Closed Caption Gst.Caps and returns the corresponding caption type, or GstVideo.VideoCaptionType.UNKNOWN.

New in version 1.16.

classmethod to_caps(type)[source]
Parameters:type (GstVideo.VideoCaptionType) – GstVideo.VideoCaptionType
Returns:new Gst.Caps
Return type:Gst.Caps

Creates new caps corresponding to type.

New in version 1.16.

UNKNOWN = 0

Unknown type of CC

CEA608_RAW = 1

CEA-608 as byte pairs. Note that this format is not recommended since is does not specify to which field the caption comes from and therefore assumes it comes from the first field (and that there is no information on the second field). Use GstVideo.VideoCaptionType.CEA708_RAW if you wish to store CEA-608 from two fields and prefix each byte pair with 0xFC for the first field and 0xFD for the second field.

CEA608_S334_1A = 2

CEA-608 as byte triplets as defined in SMPTE S334-1 Annex A. The second and third byte of the byte triplet is the raw CEA608 data, the first byte is a bitfield: The top/7th bit is 0 for the second field, 1 for the first field, bit 6 and 5 are 0 and bits 4 to 0 are a 5 bit unsigned integer that represents the line offset relative to the base-line of the original image format (line 9 for 525-line field 1, line 272 for 525-line field 2, line 5 for 625-line field 1 and line 318 for 625-line field 2).

CEA708_RAW = 3

CEA-708 as cc_data byte triplets. They can also contain 608-in-708 and the first byte of each triplet has to be inspected for detecting the type.

CEA708_CDP = 4

CEA-708 (and optionally CEA-608) in a CDP (Caption Distribution Packet) defined by SMPTE S-334-2. Contains the whole CDP (starting with 0x9669).

class GstVideo.VideoChromaMethod(value)

Bases: GObject.GEnum

Different subsampling and upsampling methods

NEAREST = 0

Duplicates the chroma samples when upsampling and drops when subsampling

LINEAR = 1

Uses linear interpolation to reconstruct missing chroma and averaging to subsample

class GstVideo.VideoChromaMode(value)

Bases: GObject.GEnum

Different chroma downsampling and upsampling modes

New in version 1.6.

FULL = 0

do full chroma up and down sampling

UPSAMPLE_ONLY = 1

only perform chroma upsampling

DOWNSAMPLE_ONLY = 2

only perform chroma downsampling

NONE = 3

disable chroma resampling

class GstVideo.VideoColorMatrix(value)

Bases: GObject.GEnum

The color matrix is used to convert between Y’PbPr and non-linear RGB (R’G’B’)

classmethod get_Kr_Kb(matrix)[source]
Parameters:matrix (GstVideo.VideoColorMatrix) – a GstVideo.VideoColorMatrix
Returns:True if matrix was a YUV color format and Kr and Kb contain valid values.
Kr:result red channel coefficient
Kb:result blue channel coefficient
Return type:(bool, Kr: float, Kb: float)

Get the coefficients used to convert between Y’PbPr and R’G’B’ using matrix.

When:

0.0 <= [Y',R',G',B'] <= 1.0)
(-0.5 <= [Pb,Pr] <= 0.5)

the general conversion is given by:

Y' = Kr*R' + (1-Kr-Kb)*G' + Kb*B'
Pb = (B'-Y')/(2*(1-Kb))
Pr = (R'-Y')/(2*(1-Kr))

and the other way around:

R' = Y' + Cr*2*(1-Kr)
G' = Y' - Cb*2*(1-Kb)*Kb/(1-Kr-Kb) - Cr*2*(1-Kr)*Kr/(1-Kr-Kb)
B' = Y' + Cb*2*(1-Kb)

New in version 1.6.

UNKNOWN = 0

unknown matrix

RGB = 1

identity matrix

FCC = 2

FCC color matrix

BT709 = 3

ITU-R BT.709 color matrix

BT601 = 4

ITU-R BT.601 color matrix

SMPTE240M = 5

SMPTE 240M color matrix

BT2020 = 6

ITU-R BT.2020 color matrix.

New in version 1.6.

class GstVideo.VideoColorPrimaries(value)

Bases: GObject.GEnum

The color primaries define the how to transform linear RGB values to and from the CIE XYZ colorspace.

classmethod get_info(primaries)[source]
Parameters:primaries (GstVideo.VideoColorPrimaries) – a GstVideo.VideoColorPrimaries
Returns:a GstVideo.VideoColorPrimariesInfo for primaries.
Return type:GstVideo.VideoColorPrimariesInfo

Get information about the chromaticity coordinates of primaries.

New in version 1.6.

UNKNOWN = 0

unknown color primaries

BT709 = 1

BT709 primaries

SMPTERP431 = 10

SMPTE RP 431 primaries.

New in version 1.16.

SMPTEEG432 = 11

SMPTE EG 432 primaries.

New in version 1.16.

EBU3213 = 12

EBU 3213 primaries.

New in version 1.16.

BT470M = 2

BT470M primaries

BT470BG = 3

BT470BG primaries

SMPTE170M = 4

SMPTE170M primaries

SMPTE240M = 5

SMPTE240M primaries

FILM = 6

Generic film

BT2020 = 7

BT2020 primaries.

New in version 1.6.

ADOBERGB = 8

Adobe RGB primaries.

New in version 1.8.

SMPTEST428 = 9

SMPTE ST 428 primaries.

New in version 1.16.

class GstVideo.VideoColorRange(value)

Bases: GObject.GEnum

Possible color range values. These constants are defined for 8 bit color values and can be scaled for other bit depths.

classmethod offsets(range, info)[source]
Parameters:
Returns:

offset:output offsets
scale:output scale

Return type:

(offset: [int], scale: [int])

Compute the offset and scale values for each component of info. For each component, (c[i] - offset[i]) / scale[i] will scale the component c[i] to the range [0.0 .. 1.0].

The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in info and range.

UNKNOWN = 0

unknown range

0_255 = 1
_0_255 = 1

[0..255] for 8 bit components

16_235 = 2
_16_235 = 2

[16..235] for 8 bit components. Chroma has [16..240] range.

class GstVideo.VideoDitherMethod(value)

Bases: GObject.GEnum

Different dithering methods to use.

NONE = 0

no dithering

VERTERR = 1

propagate rounding errors downwards

FLOYD_STEINBERG = 2

Dither with floyd-steinberg error diffusion

SIERRA_LITE = 3

Dither with Sierra Lite error diffusion

BAYER = 4

ordered dither using a bayer pattern

class GstVideo.VideoFieldOrder(value)

Bases: GObject.GEnum

Field order of interlaced content. This is only valid for interlace-mode=interleaved and not interlace-mode=mixed. In the case of mixed or GST_VIDEO_FIELD_ORDER_UNKOWN, the field order is signalled via buffer flags.

New in version 1.12.

classmethod from_string(order)[source]
Parameters:order (str) – a field order
Returns:the GstVideo.VideoFieldOrder of order or GstVideo.VideoFieldOrder.UNKNOWN when order is not a valid string representation for a GstVideo.VideoFieldOrder.
Return type:GstVideo.VideoFieldOrder

Convert order to a GstVideo.VideoFieldOrder

New in version 1.12.

classmethod to_string(order)[source]
Parameters:order (GstVideo.VideoFieldOrder) – a GstVideo.VideoFieldOrder
Returns:order as a string or None if order in invalid.
Return type:str

Convert order to its string representation.

New in version 1.12.

UNKNOWN = 0

unknown field order for interlaced content. The actual field order is signalled via buffer flags.

TOP_FIELD_FIRST = 1

top field is first

BOTTOM_FIELD_FIRST = 2

bottom field is first

class GstVideo.VideoFormat(value)

Bases: GObject.GEnum

Enum value describing the most common video formats.

See the GStreamer raw video format design document for details about the layout and packing of these formats in memory.

classmethod from_fourcc(fourcc)[source]
Parameters:fourcc (int) – a FOURCC value representing raw YUV video
Returns:the GstVideo.VideoFormat describing the FOURCC value
Return type:GstVideo.VideoFormat

Converts a FOURCC value into the corresponding GstVideo.VideoFormat. If the FOURCC cannot be represented by GstVideo.VideoFormat, GstVideo.VideoFormat.UNKNOWN is returned.

classmethod from_masks(depth, bpp, endianness, red_mask, green_mask, blue_mask, alpha_mask)[source]
Parameters:
  • depth (int) – the amount of bits used for a pixel
  • bpp (int) – the amount of bits used to store a pixel. This value is bigger than depth
  • endianness (int) – the endianness of the masks, GLib.LITTLE_ENDIAN or GLib.BIG_ENDIAN
  • red_mask (int) – the red mask
  • green_mask (int) – the green mask
  • blue_mask (int) – the blue mask
  • alpha_mask (int) – the alpha mask, or 0 if no alpha mask
Returns:

a GstVideo.VideoFormat or GstVideo.VideoFormat.UNKNOWN when the parameters to not specify a known format.

Return type:

GstVideo.VideoFormat

Find the GstVideo.VideoFormat for the given parameters.

classmethod from_string(format)[source]
Parameters:format (str) – a format string
Returns:the GstVideo.VideoFormat for format or GstVideo.VideoFormat.UNKNOWN when the string is not a known format.
Return type:GstVideo.VideoFormat

Convert the format string to its GstVideo.VideoFormat.

classmethod get_info(format)[source]
Parameters:format (GstVideo.VideoFormat) – a GstVideo.VideoFormat
Returns:The GstVideo.VideoFormatInfo for format.
Return type:GstVideo.VideoFormatInfo

Get the GstVideo.VideoFormatInfo for format

classmethod get_palette(format)[source]
Parameters:format (GstVideo.VideoFormat) – a GstVideo.VideoFormat
Returns:the default palette of format or None when format does not have a palette.
size:size of the palette in bytes
Return type:(object or None, size: int)

Get the default palette of format. This the palette used in the pack function for paletted formats.

New in version 1.2.

classmethod to_fourcc(format)[source]
Parameters:format (GstVideo.VideoFormat) – a GstVideo.VideoFormat video format
Returns:the FOURCC corresponding to format
Return type:int

Converts a GstVideo.VideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If format has no corresponding FOURCC value, 0 is returned.

classmethod to_string(format)[source]
Parameters:format (GstVideo.VideoFormat) – a GstVideo.VideoFormat video format
Returns:the name corresponding to format
Return type:str

Returns a string containing a descriptive name for the GstVideo.VideoFormat if there is one, or None otherwise.

UNKNOWN = 0

Unknown or unset video format id

ENCODED = 1

Encoded video format. Only ever use that in caps for special video formats in combination with non-system memory Gst.CapsFeatures where it does not make sense to specify a real video format.

XBGR = 10

sparse reverse rgb packed into 32 bit, space first

RGBA = 11

rgb with alpha channel last

BGRA = 12

reverse rgb with alpha channel last

ARGB = 13

rgb with alpha channel first

ABGR = 14

reverse rgb with alpha channel first

RGB = 15

RGB packed into 24 bits without padding (R-G-B-R-G-B)

BGR = 16

reverse RGB packed into 24 bits without padding (B-G-R-B-G-R)

Y41B = 17

planar 4:1:1 YUV

Y42B = 18

planar 4:2:2 YUV

YVYU = 19

packed 4:2:2 YUV (Y0-V0-Y1-U0 Y2-V2-Y3-U2 Y4 …)

I420 = 2

planar 4:2:0 YUV

Y444 = 20

planar 4:4:4 YUV

V210 = 21

packed 4:2:2 10-bit YUV, complex format

V216 = 22

packed 4:2:2 16-bit YUV, Y0-U0-Y1-V1 order

NV12 = 23

planar 4:2:0 YUV with interleaved UV plane

NV21 = 24

planar 4:2:0 YUV with interleaved VU plane

GRAY8 = 25

8-bit grayscale

GRAY16_BE = 26

16-bit grayscale, most significant byte first

GRAY16_LE = 27

16-bit grayscale, least significant byte first

V308 = 28

packed 4:4:4 YUV (Y-U-V …)

RGB16 = 29

rgb 5-6-5 bits per component

YV12 = 3

planar 4:2:0 YVU (like I420 but UV planes swapped)

BGR16 = 30

reverse rgb 5-6-5 bits per component

RGB15 = 31

rgb 5-5-5 bits per component

BGR15 = 32

reverse rgb 5-5-5 bits per component

UYVP = 33

packed 10-bit 4:2:2 YUV (U0-Y0-V0-Y1 U2-Y2-V2-Y3 U4 …)

A420 = 34

planar 4:4:2:0 AYUV

RGB8P = 35

8-bit paletted RGB

YUV9 = 36

planar 4:1:0 YUV

YVU9 = 37

planar 4:1:0 YUV (like YUV9 but UV planes swapped)

IYU1 = 38

packed 4:1:1 YUV (Cb-Y0-Y1-Cr-Y2-Y3 …)

ARGB64 = 39

rgb with alpha channel first, 16 bits per channel

YUY2 = 4

packed 4:2:2 YUV (Y0-U0-Y1-V0 Y2-U2-Y3-V2 Y4 …)

AYUV64 = 40

packed 4:4:4 YUV with alpha channel, 16 bits per channel (A0-Y0-U0-V0 …)

R210 = 41

packed 4:4:4 RGB, 10 bits per channel

I420_10BE = 42

planar 4:2:0 YUV, 10 bits per channel

I420_10LE = 43

planar 4:2:0 YUV, 10 bits per channel

I422_10BE = 44

planar 4:2:2 YUV, 10 bits per channel

I422_10LE = 45

planar 4:2:2 YUV, 10 bits per channel

Y444_10BE = 46

planar 4:4:4 YUV, 10 bits per channel

New in version 1.2.

Y444_10LE = 47

planar 4:4:4 YUV, 10 bits per channel

New in version 1.2.

GBR = 48

planar 4:4:4 RGB, 8 bits per channel

New in version 1.2.

GBR_10BE = 49

planar 4:4:4 RGB, 10 bits per channel

New in version 1.2.

UYVY = 5

packed 4:2:2 YUV (U0-Y0-V0-Y1 U2-Y2-V2-Y3 U4 …)

GBR_10LE = 50

planar 4:4:4 RGB, 10 bits per channel

New in version 1.2.

NV16 = 51

planar 4:2:2 YUV with interleaved UV plane

New in version 1.2.

NV24 = 52

planar 4:4:4 YUV with interleaved UV plane

New in version 1.2.

NV12_64Z32 = 53

NV12 with 64x32 tiling in zigzag pattern

New in version 1.4.

A420_10BE = 54

planar 4:4:2:0 YUV, 10 bits per channel

New in version 1.6.

A420_10LE = 55

planar 4:4:2:0 YUV, 10 bits per channel

New in version 1.6.

A422_10BE = 56

planar 4:4:2:2 YUV, 10 bits per channel

New in version 1.6.

A422_10LE = 57

planar 4:4:2:2 YUV, 10 bits per channel

New in version 1.6.

A444_10BE = 58

planar 4:4:4:4 YUV, 10 bits per channel

New in version 1.6.

A444_10LE = 59

planar 4:4:4:4 YUV, 10 bits per channel

New in version 1.6.

AYUV = 6

packed 4:4:4 YUV with alpha channel (A0-Y0-U0-V0 …)

NV61 = 60

planar 4:2:2 YUV with interleaved VU plane

New in version 1.6.

P010_10BE = 61

planar 4:2:0 YUV with interleaved UV plane, 10 bits per channel

New in version 1.10.

P010_10LE = 62

planar 4:2:0 YUV with interleaved UV plane, 10 bits per channel

New in version 1.10.

IYU2 = 63

packed 4:4:4 YUV (U-Y-V …)

New in version 1.10.

VYUY = 64

packed 4:2:2 YUV (V0-Y0-U0-Y1 V2-Y2-U2-Y3 V4 …)

GBRA = 65

planar 4:4:4:4 ARGB, 8 bits per channel

New in version 1.12.

GBRA_10BE = 66

planar 4:4:4:4 ARGB, 10 bits per channel

New in version 1.12.

GBRA_10LE = 67

planar 4:4:4:4 ARGB, 10 bits per channel

New in version 1.12.

GBR_12BE = 68

planar 4:4:4 RGB, 12 bits per channel

New in version 1.12.

GBR_12LE = 69

planar 4:4:4 RGB, 12 bits per channel

New in version 1.12.

RGBX = 7

sparse rgb packed into 32 bit, space last

GBRA_12BE = 70

planar 4:4:4:4 ARGB, 12 bits per channel

New in version 1.12.

GBRA_12LE = 71

planar 4:4:4:4 ARGB, 12 bits per channel

New in version 1.12.

I420_12BE = 72

planar 4:2:0 YUV, 12 bits per channel

New in version 1.12.

I420_12LE = 73

planar 4:2:0 YUV, 12 bits per channel

New in version 1.12.

I422_12BE = 74

planar 4:2:2 YUV, 12 bits per channel

New in version 1.12.

I422_12LE = 75

planar 4:2:2 YUV, 12 bits per channel

New in version 1.12.

Y444_12BE = 76

planar 4:4:4 YUV, 12 bits per channel

New in version 1.12.

Y444_12LE = 77

planar 4:4:4 YUV, 12 bits per channel

New in version 1.12.

GRAY10_LE32 = 78

10-bit grayscale, packed into 32bit words (2 bits padding)

New in version 1.14.

NV12_10LE32 = 79

10-bit variant of GstVideo.VideoFormat.NV12, packed into 32bit words (MSB 2 bits padding)

New in version 1.14.

BGRX = 8

sparse reverse rgb packed into 32 bit, space last

NV16_10LE32 = 80

10-bit variant of GstVideo.VideoFormat.NV16, packed into 32bit words (MSB 2 bits padding)

New in version 1.14.

NV12_10LE40 = 81

Fully packed variant of NV12_10LE32

New in version 1.16.

Y210 = 82

packed 4:2:2 YUV, 10 bits per channel

New in version 1.16.

Y410 = 83

packed 4:4:4 YUV, 10 bits per channel(A-V-Y-U…)

New in version 1.16.

VUYA = 84

packed 4:4:4 YUV with alpha channel (V0-U0-Y0-A0…)

New in version 1.16.

BGR10A2_LE = 85

packed 4:4:4 RGB with alpha channel(B-G-R-A), 10 bits for R/G/B channel and MSB 2 bits for alpha channel

New in version 1.16.

XRGB = 9

sparse rgb packed into 32 bit, space first

class GstVideo.VideoGLTextureOrientation(value)

Bases: GLib.Enum

The orientation of the GL texture.

NORMAL_Y_NORMAL = 0

Top line first in memory, left row first

NORMAL_Y_FLIP = 1

Bottom line first in memory, left row first

FLIP_Y_NORMAL = 2

Top line first in memory, right row first

FLIP_Y_FLIP = 3

Bottom line first in memory, right row first

class GstVideo.VideoGLTextureType(value)

Bases: GLib.Enum

The GL texture type.

LUMINANCE = 0

Luminance texture, GL_LUMINANCE

LUMINANCE_ALPHA = 1

Luminance-alpha texture, GL_LUMINANCE_ALPHA

RGB16 = 2

RGB 565 texture, GL_RGB

RGB = 3

RGB texture, GL_RGB

RGBA = 4

RGBA texture, GL_RGBA

R = 5

R texture, GL_RED_EXT

RG = 6

RG texture, GL_RG_EXT

class GstVideo.VideoGammaMode(value)

Bases: GObject.GEnum

New in version 1.6.

NONE = 0

disable gamma handling

REMAP = 1

convert between input and output gamma Different gamma conversion modes

class GstVideo.VideoInterlaceMode(value)

Bases: GObject.GEnum

The possible values of the GstVideo.VideoInterlaceMode describing the interlace mode of the stream.

classmethod from_string(mode)[source]
Parameters:mode (str) – a mode
Returns:the GstVideo.VideoInterlaceMode of mode or GstVideo.VideoInterlaceMode.PROGRESSIVE when mode is not a valid string representation for a GstVideo.VideoInterlaceMode.
Return type:GstVideo.VideoInterlaceMode

Convert mode to a GstVideo.VideoInterlaceMode

New in version 1.6.

classmethod to_string(mode)[source]
Parameters:mode (GstVideo.VideoInterlaceMode) – a GstVideo.VideoInterlaceMode
Returns:mode as a string or None if mode in invalid.
Return type:str

Convert mode to its string representation.

New in version 1.6.

PROGRESSIVE = 0

all frames are progressive

INTERLEAVED = 1

2 fields are interleaved in one video frame. Extra buffer flags describe the field order.

MIXED = 2

frames contains both interlaced and progressive video, the buffer flags describe the frame and fields.

FIELDS = 3

2 fields are stored in one buffer, use the frame ID to get access to the required field. For multiview (the ‘views’ property > 1) the fields of view N can be found at frame ID (N * 2) and (N * 2) + 1. Each field has only half the amount of lines as noted in the height property. This mode requires multiple GstVideo.VideoMeta metadata to describe the fields.

ALTERNATE = 4

1 field is stored in one buffer, GST_VIDEO_BUFFER_FLAG_TF or GST_VIDEO_BUFFER_FLAG_BF indicates if the buffer is carrying the top or bottom field, respectively. The top and bottom buffers are expected to alternate in the pipeline, with this mode

New in version 1.16.

class GstVideo.VideoMatrixMode(value)

Bases: GObject.GEnum

Different color matrix conversion modes

New in version 1.6.

FULL = 0

do conversion between color matrices

INPUT_ONLY = 1

use the input color matrix to convert to and from R’G’B

OUTPUT_ONLY = 2

use the output color matrix to convert to and from R’G’B

NONE = 3

disable color matrix conversion.

class GstVideo.VideoMultiviewFramePacking(value)

Bases: GObject.GEnum

GstVideo.VideoMultiviewFramePacking represents the subset of GstVideo.VideoMultiviewMode values that can be applied to any video frame without needing extra metadata. It can be used by elements that provide a property to override the multiview interpretation of a video stream when the video doesn’t contain any markers.

This enum is used (for example) on playbin, to re-interpret a played video stream as a stereoscopic video. The individual enum values are equivalent to and have the same value as the matching GstVideo.VideoMultiviewMode.

NONE = -1

A special value indicating no frame packing info.

MONO = 0

All frames are monoscopic.

LEFT = 1

All frames represent a left-eye view.

RIGHT = 2

All frames represent a right-eye view.

SIDE_BY_SIDE = 3

Left and right eye views are provided in the left and right half of the frame respectively.

SIDE_BY_SIDE_QUINCUNX = 4

Left and right eye views are provided in the left and right half of the frame, but have been sampled using quincunx method, with half-pixel offset between the 2 views.

COLUMN_INTERLEAVED = 5

Alternating vertical columns of pixels represent the left and right eye view respectively.

ROW_INTERLEAVED = 6

Alternating horizontal rows of pixels represent the left and right eye view respectively.

TOP_BOTTOM = 7

The top half of the frame contains the left eye, and the bottom half the right eye.

CHECKERBOARD = 8

Pixels are arranged with alternating pixels representing left and right eye views in a checkerboard fashion.

class GstVideo.VideoMultiviewMode(value)

Bases: GObject.GEnum

All possible stereoscopic 3D and multiview representations. In conjunction with GstVideo.VideoMultiviewFlags, describes how multiview content is being transported in the stream.

classmethod from_caps_string(caps_mview_mode)[source]
Parameters:caps_mview_mode (str) – multiview-mode field string from caps
Returns:The GstVideo.VideoMultiviewMode value

Given a string from a caps multiview-mode field, output the corresponding GstVideo.VideoMultiviewMode or GstVideo.VideoMultiviewMode.NONE

Return type:GstVideo.VideoMultiviewMode

New in version 1.6.

classmethod to_caps_string(mview_mode)[source]
Parameters:mview_mode (GstVideo.VideoMultiviewMode) – A GstVideo.VideoMultiviewMode value
Returns:The caps string representation of the mode, or None if invalid.

Given a GstVideo.VideoMultiviewMode returns the multiview-mode caps string for insertion into a caps structure

Return type:str

New in version 1.6.

NONE = -1

A special value indicating no multiview information. Used in GstVideo.VideoInfo and other places to indicate that no specific multiview handling has been requested or provided. This value is never carried on caps.

MONO = 0

All frames are monoscopic.

LEFT = 1

All frames represent a left-eye view.

RIGHT = 2

All frames represent a right-eye view.

SIDE_BY_SIDE = 3

Left and right eye views are provided in the left and right half of the frame respectively.

FRAME_BY_FRAME = 32

Left and right eye views are provided in separate frames alternately.

MULTIVIEW_FRAME_BY_FRAME = 33

Multiple independent views are provided in separate frames in sequence. This method only applies to raw video buffers at the moment. Specific view identification is via the #GstVideoMultiviewMeta and GstVideo.VideoMeta(s) on raw video buffers.

SEPARATED = 34

Multiple views are provided as separate Gst.Memory framebuffers attached to each Gst.Buffer, described by the #GstVideoMultiviewMeta and GstVideo.VideoMeta(s)

SIDE_BY_SIDE_QUINCUNX = 4

Left and right eye views are provided in the left and right half of the frame, but have been sampled using quincunx method, with half-pixel offset between the 2 views.

COLUMN_INTERLEAVED = 5

Alternating vertical columns of pixels represent the left and right eye view respectively.

ROW_INTERLEAVED = 6

Alternating horizontal rows of pixels represent the left and right eye view respectively.

TOP_BOTTOM = 7

The top half of the frame contains the left eye, and the bottom half the right eye.

CHECKERBOARD = 8

Pixels are arranged with alternating pixels representing left and right eye views in a checkerboard fashion.

class GstVideo.VideoOrientationMethod(value)

Bases: GObject.GEnum

The different video orientation methods.

New in version 1.10.

IDENTITY = 0

Identity (no rotation)

90R = 1
_90R = 1

Rotate clockwise 90 degrees

180 = 2
_180 = 2

Rotate 180 degrees

90L = 3
_90L = 3

Rotate counter-clockwise 90 degrees

HORIZ = 4

Flip horizontally

VERT = 5

Flip vertically

UL_LR = 6

Flip across upper left/lower right diagonal

UR_LL = 7

Flip across upper right/lower left diagonal

AUTO = 8

Select flip method based on image-orientation tag

CUSTOM = 9

Current status depends on plugin internal setup

class GstVideo.VideoPrimariesMode(value)

Bases: GObject.GEnum

Different primaries conversion modes

New in version 1.6.

NONE = 0

disable conversion between primaries

MERGE_ONLY = 1

do conversion between primaries only when it can be merged with color matrix conversion.

FAST = 2

fast conversion between primaries

class GstVideo.VideoResamplerMethod(value)

Bases: GObject.GEnum

Different subsampling and upsampling methods

New in version 1.6.

NEAREST = 0

Duplicates the samples when upsampling and drops when downsampling

LINEAR = 1

Uses linear interpolation to reconstruct missing samples and averaging to downsample

CUBIC = 2

Uses cubic interpolation

SINC = 3

Uses sinc interpolation

LANCZOS = 4

Uses lanczos interpolation

class GstVideo.VideoTileMode(value)

Bases: GObject.GEnum

Enum value describing the available tiling modes.

UNKNOWN = 0

Unknown or unset tile mode

ZFLIPZ_2X2 = 65536

Every four adjacent blocks - two horizontally and two vertically are grouped together and are located in memory in Z or flipped Z order. In case of odd rows, the last row of blocks is arranged in linear order.

class GstVideo.VideoTileType(value)

Bases: GObject.GEnum

Enum value describing the most common tiling types.

INDEXED = 0

Tiles are indexed. Use GstVideo.video_tile_get_index () to retrieve the tile at the requested coordinates.

class GstVideo.VideoTransferFunction(value)

Bases: GObject.GEnum

The video transfer function defines the formula for converting between non-linear RGB (R’G’B’) and linear RGB

UNKNOWN = 0

unknown transfer function

GAMMA10 = 1

linear RGB, gamma 1.0 curve

LOG316 = 10

Logarithmic transfer characteristic 316.22777:1 range

BT2020_12 = 11

Gamma 2.2 curve with a linear segment in the lower range. Used for BT.2020 with 12 bits per component.

New in version 1.6.

ADOBERGB = 12

Gamma 2.19921875.

New in version 1.8.

GAMMA18 = 2

Gamma 1.8 curve

GAMMA20 = 3

Gamma 2.0 curve

GAMMA22 = 4

Gamma 2.2 curve

BT709 = 5

Gamma 2.2 curve with a linear segment in the lower range

SMPTE240M = 6

Gamma 2.2 curve with a linear segment in the lower range

SRGB = 7

Gamma 2.4 curve with a linear segment in the lower range

GAMMA28 = 8

Gamma 2.8 curve

LOG100 = 9

Logarithmic transfer characteristic 100:1 range

class GstVideo.VideoVBIParserResult(value)

Bases: GObject.GEnum

Return values for GstVideo.VideoVBIParser

New in version 1.16.

DONE = 0

No line were provided, or no more Ancillary data was found.

OK = 1

A GstVideo.VideoAncillary was found.

ERROR = 2

An error occured