videoconvert: GStreamer Base Plugins 1.0 Plugins Reference Manual

## videoconvert videoconvert |

## Properties

GstVideoDitherMethod | dither | Read / Write
GstVideoAlphaMode | alpha-mode | Read / Write
gdouble | alpha-value | Read / Write
GstVideoChromaMode | chroma-mode | Read / Write
GstVideoResamplerMethod | chroma-resampler | Read / Write
guint | dither-quantization | Read / Write
GstVideoGammaMode | gamma-mode | Read / Write
GstVideoMatrixMode | matrix-mode | Read / Write
GstVideoPrimariesMode | primaries-mode | Read / Write
guint | n-threads | Read / Write

## Types and Values

struct | GstVideoConvert

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GstObject
                ╰── GstElement
                    ╰── GstBaseTransform
                        ╰── GstVideoFilter
                            ╰── GstVideoConvert

## Description

Convert video frames between a great variety of video formats.

#### Example launch line

    1
    gst-launch-1.0 -v videotestsrc ! video/x-raw,format=YUY2 ! videoconvert ! autovideosink

This will output a test video (generated in YUY2 format) in a video window. If the video sink selected does not support YUY2 videoconvert will automatically convert the video to a format understood by the video sink.

## Synopsis

### Element Information

plugin | videoconvert
author | GStreamer maintainers <gstreamer-devel@lists.freedesktop.org>
class | Filter/Converter/Video

### Element Pads

name | sink
direction | sink
presence | always
details | video/x-raw, format=(string){ I420, YV12, YUY2, UYVY, AYUV, RGBx, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, RGB, BGR, Y41B, Y42B, YVYU, Y444, v210, v216, NV12, NV21, GRAY8, GRAY16_BE, GRAY16_LE, v308, RGB16, BGR16, RGB15, BGR15, UYVP, A420, RGB8P, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10BE, I420_10LE, I422_10BE, I422_10LE, Y444_10BE, Y444_10LE, GBR, GBR_10BE, GBR_10LE, NV16, NV24, NV12_64Z32, A420_10BE, A420_10LE, A422_10BE, A422_10LE, A444_10BE, A444_10LE, NV61, P010_10BE, P010_10LE, IYU2, VYUY, GBRA, GBRA_10BE, GBRA_10LE, GBR_12BE, GBR_12LE, GBRA_12BE, GBRA_12LE, I420_12BE, I420_12LE, I422_12BE, I422_12LE, Y444_12BE, Y444_12LE, GRAY10_LE32, NV12_10LE32, NV16_10LE32 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]
| video/x-raw(ANY), format=(string){ I420, YV12, YUY2, UYVY, AYUV, RGBx, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, RGB, BGR, Y41B, Y42B, YVYU, Y444, v210, v216, NV12, NV21, GRAY8, GRAY16_BE, GRAY16_LE, v308, RGB16, BGR16, RGB15, BGR15, UYVP, A420, RGB8P, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10BE, I420_10LE, I422_10BE, I422_10LE, Y444_10BE, Y444_10LE, GBR, GBR_10BE, GBR_10LE, NV16, NV24, NV12_64Z32, A420_10BE, A420_10LE, A422_10BE, A422_10LE, A444_10BE, A444_10LE, NV61, P010_10BE, P010_10LE, IYU2, VYUY, GBRA, GBRA_10BE, GBRA_10LE, GBR_12BE, GBR_12LE, GBRA_12BE, GBRA_12LE, I420_12BE, I420_12LE, I422_12BE, I422_12LE, Y444_12BE, Y444_12LE, GRAY10_LE32, NV12_10LE32, NV16_10LE32 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

name | src
direction | source
presence | always
details | video/x-raw, format=(string){ I420, YV12, YUY2, UYVY, AYUV, RGBx, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, RGB, BGR, Y41B, Y42B, YVYU, Y444, v210, v216, NV12, NV21, GRAY8, GRAY16_BE, GRAY16_LE, v308, RGB16, BGR16, RGB15, BGR15, UYVP, A420, RGB8P, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10BE, I420_10LE, I422_10BE, I422_10LE, Y444_10BE, Y444_10LE, GBR, GBR_10BE, GBR_10LE, NV16, NV24, NV12_64Z32, A420_10BE, A420_10LE, A422_10BE, A422_10LE, A444_10BE, A444_10LE, NV61, P010_10BE, P010_10LE, IYU2, VYUY, GBRA, GBRA_10BE, GBRA_10LE, GBR_12BE, GBR_12LE, GBRA_12BE, GBRA_12LE, I420_12BE, I420_12LE, I422_12BE, I422_12LE, Y444_12BE, Y444_12LE, GRAY10_LE32, NV12_10LE32, NV16_10LE32 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]
| video/x-raw(ANY), format=(string){ I420, YV12, YUY2, UYVY, AYUV, RGBx, BGRx, xRGB, xBGR, RGBA, BGRA, ARGB, ABGR, RGB, BGR, Y41B, Y42B, YVYU, Y444, v210, v216, NV12, NV21, GRAY8, GRAY16_BE, GRAY16_LE, v308, RGB16, BGR16, RGB15, BGR15, UYVP, A420, RGB8P, YUV9, YVU9, IYU1, ARGB64, AYUV64, r210, I420_10BE, I420_10LE, I422_10BE, I422_10LE, Y444_10BE, Y444_10LE, GBR, GBR_10BE, GBR_10LE, NV16, NV24, NV12_64Z32, A420_10BE, A420_10LE, A422_10BE, A422_10LE, A444_10BE, A444_10LE, NV61, P010_10BE, P010_10LE, IYU2, VYUY, GBRA, GBRA_10BE, GBRA_10LE, GBR_12BE, GBR_12LE, GBRA_12BE, GBRA_12LE, I420_12BE, I420_12LE, I422_12BE, I422_12LE, Y444_12BE, Y444_12LE, GRAY10_LE32, NV12_10LE32, NV16_10LE32 }, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]

## Functions

## Types and Values

### struct GstVideoConvert

    struct GstVideoConvert;

Opaque object data structure.

## Property Details

### The `“dither”` property

      “dither”                   GstVideoDitherMethod

Apply dithering while converting.

Flags: Read / Write

Default value: GST_VIDEO_DITHER_BAYER

### The `“alpha-mode”` property

      “alpha-mode”               GstVideoAlphaMode

Alpha Mode to use.

Flags: Read / Write

Default value: GST_VIDEO_ALPHA_MODE_COPY

### The `“alpha-value”` property

      “alpha-value”              gdouble

Alpha Value to use.

Flags: Read / Write

Allowed values: [0,1]

Default value: 1

### The `“chroma-mode”` property

      “chroma-mode”              GstVideoChromaMode

Chroma Resampling Mode.

Flags: Read / Write

Default value: GST_VIDEO_CHROMA_MODE_FULL

### The `“chroma-resampler”` property

      “chroma-resampler”         GstVideoResamplerMethod

Chroma resampler method.

Flags: Read / Write

Default value: GST_VIDEO_RESAMPLER_METHOD_LINEAR

### The `“dither-quantization”` property

      “dither-quantization”      guint

Quantizer to use.

Flags: Read / Write

Default value: 1

### The `“gamma-mode”` property

      “gamma-mode”               GstVideoGammaMode

Gamma Conversion Mode.

Flags: Read / Write

Default value: GST_VIDEO_GAMMA_MODE_NONE

### The `“matrix-mode”` property

      “matrix-mode”              GstVideoMatrixMode

Matrix Conversion Mode.

Flags: Read / Write

Default value: GST_VIDEO_MATRIX_MODE_FULL

### The `“primaries-mode”` property

      “primaries-mode”           GstVideoPrimariesMode

Primaries Conversion Mode.

Flags: Read / Write

Default value: GST_VIDEO_PRIMARIES_MODE_NONE

### The `“n-threads”` property

      “n-threads”                guint

Maximum number of threads to use.

Flags: Read / Write

Default value: 1