This library contains some helper functions and includes the videosink and videofilter base classes.

GST_VIDEO_BLUE_MASK_15

#define GST_VIDEO_BLUE_MASK_15 "0x001f"

GST_VIDEO_BLUE_MASK_15_INT

#define GST_VIDEO_BLUE_MASK_15_INT 0x001f

GST_VIDEO_BLUE_MASK_16

#define GST_VIDEO_BLUE_MASK_16 "0x001f"

GST_VIDEO_BLUE_MASK_16_INT

#define GST_VIDEO_BLUE_MASK_16_INT 0x001f

GST_VIDEO_BYTE1_MASK_24

#define GST_VIDEO_BYTE1_MASK_24  "0x00FF0000"

GST_VIDEO_BYTE1_MASK_24_INT

#define GST_VIDEO_BYTE1_MASK_24_INT  0x00FF0000

GST_VIDEO_BYTE1_MASK_32

#define GST_VIDEO_BYTE1_MASK_32  "0xFF000000"

GST_VIDEO_BYTE1_MASK_32_INT

#define GST_VIDEO_BYTE1_MASK_32_INT  0xFF000000

GST_VIDEO_BYTE2_MASK_24

#define GST_VIDEO_BYTE2_MASK_24  "0x0000FF00"

GST_VIDEO_BYTE2_MASK_24_INT

#define GST_VIDEO_BYTE2_MASK_24_INT  0x0000FF00

GST_VIDEO_BYTE2_MASK_32

#define GST_VIDEO_BYTE2_MASK_32  "0x00FF0000"

GST_VIDEO_BYTE2_MASK_32_INT

#define GST_VIDEO_BYTE2_MASK_32_INT  0x00FF0000

GST_VIDEO_BYTE3_MASK_24

#define GST_VIDEO_BYTE3_MASK_24  "0x000000FF"

GST_VIDEO_BYTE3_MASK_24_INT

#define GST_VIDEO_BYTE3_MASK_24_INT  0x000000FF

GST_VIDEO_BYTE3_MASK_32

#define GST_VIDEO_BYTE3_MASK_32  "0x0000FF00"

GST_VIDEO_BYTE3_MASK_32_INT

#define GST_VIDEO_BYTE3_MASK_32_INT  0x0000FF00

GST_VIDEO_BYTE4_MASK_32

#define GST_VIDEO_BYTE4_MASK_32  "0x000000FF"

GST_VIDEO_BYTE4_MASK_32_INT

#define GST_VIDEO_BYTE4_MASK_32_INT  0x000000FF

GST_VIDEO_CAPS_ABGR

#define             GST_VIDEO_CAPS_ABGR

GST_VIDEO_CAPS_ARGB

#define             GST_VIDEO_CAPS_ARGB

GST_VIDEO_CAPS_BGR

#define             GST_VIDEO_CAPS_BGR

GST_VIDEO_CAPS_BGRA

#define             GST_VIDEO_CAPS_BGRA

GST_VIDEO_CAPS_BGRx

#define             GST_VIDEO_CAPS_BGRx

GST_VIDEO_CAPS_BGRx_HOST_ENDIAN

#define             GST_VIDEO_CAPS_BGRx_HOST_ENDIAN

GST_VIDEO_CAPS_RGB

#define             GST_VIDEO_CAPS_RGB

GST_VIDEO_CAPS_RGBA

#define             GST_VIDEO_CAPS_RGBA

GST_VIDEO_CAPS_RGB_15

#define             GST_VIDEO_CAPS_RGB_15

GST_VIDEO_CAPS_RGB_16

#define             GST_VIDEO_CAPS_RGB_16

GST_VIDEO_CAPS_RGBx

#define             GST_VIDEO_CAPS_RGBx

GST_VIDEO_CAPS_YUV()

#define             GST_VIDEO_CAPS_YUV(fourcc)

GST_VIDEO_CAPS_xBGR

#define             GST_VIDEO_CAPS_xBGR

GST_VIDEO_CAPS_xRGB

#define             GST_VIDEO_CAPS_xRGB

GST_VIDEO_CAPS_xRGB_HOST_ENDIAN

#define             GST_VIDEO_CAPS_xRGB_HOST_ENDIAN

GST_VIDEO_FPS_RANGE

#define GST_VIDEO_FPS_RANGE "(fraction) [ 0, max ]"

GST_VIDEO_GREEN_MASK_15

#define GST_VIDEO_GREEN_MASK_15 "0x03e0"

GST_VIDEO_GREEN_MASK_15_INT

#define GST_VIDEO_GREEN_MASK_15_INT 0x03e0

GST_VIDEO_GREEN_MASK_16

#define GST_VIDEO_GREEN_MASK_16 "0x07e0"

GST_VIDEO_GREEN_MASK_16_INT

#define GST_VIDEO_GREEN_MASK_16_INT 0x07e0

GST_VIDEO_RED_MASK_15

#define GST_VIDEO_RED_MASK_15 "0x7c00"

GST_VIDEO_RED_MASK_15_INT

#define GST_VIDEO_RED_MASK_15_INT 0x7c00

GST_VIDEO_RED_MASK_16

#define GST_VIDEO_RED_MASK_16 "0xf800"

GST_VIDEO_RED_MASK_16_INT

#define GST_VIDEO_RED_MASK_16_INT 0xf800

GST_VIDEO_SIZE_RANGE

#define GST_VIDEO_SIZE_RANGE "(int) [ 1, max ]"

GST_VIDEO_BUFFER_TFF

#define GST_VIDEO_BUFFER_TFF GST_BUFFER_FLAG_MEDIA1

If the GstBuffer is interlaced, then the first field in the video frame is the top field. If unset, the bottom field is first.

Since 0.10.23

GST_VIDEO_BUFFER_RFF

#define GST_VIDEO_BUFFER_RFF GST_BUFFER_FLAG_MEDIA2

If the GstBuffer is interlaced, then the first field (as defined by the GST_VIDEO_BUFFER_TFF flag setting) is repeated.

Since 0.10.23

GST_VIDEO_BUFFER_ONEFIELD

#define GST_VIDEO_BUFFER_ONEFIELD GST_BUFFER_FLAG_MEDIA3

If the GstBuffer is interlaced, then only the first field (as defined by the GST_VIDEO_BUFFER_TFF flag setting) is to be displayed.

Since 0.10.23

enum GstVideoFormat

typedef enum {
  GST_VIDEO_FORMAT_UNKNOWN,
  GST_VIDEO_FORMAT_I420,
  GST_VIDEO_FORMAT_YV12,
  GST_VIDEO_FORMAT_YUY2,
  GST_VIDEO_FORMAT_UYVY,
  GST_VIDEO_FORMAT_AYUV,
  GST_VIDEO_FORMAT_RGBx,
  GST_VIDEO_FORMAT_BGRx,
  GST_VIDEO_FORMAT_xRGB,
  GST_VIDEO_FORMAT_xBGR,
  GST_VIDEO_FORMAT_RGBA,
  GST_VIDEO_FORMAT_BGRA,
  GST_VIDEO_FORMAT_ARGB,
  GST_VIDEO_FORMAT_ABGR,
  GST_VIDEO_FORMAT_RGB,
  GST_VIDEO_FORMAT_BGR,
  GST_VIDEO_FORMAT_Y41B,
  GST_VIDEO_FORMAT_Y42B,
  GST_VIDEO_FORMAT_YVYU,
  GST_VIDEO_FORMAT_Y444,
  GST_VIDEO_FORMAT_v210,
  GST_VIDEO_FORMAT_v216
} GstVideoFormat;

Enum value describing the most common video formats.

gst_video_calculate_display_ratio ()

gboolean            gst_video_calculate_display_ratio   (guint *dar_n,
                                                         guint *dar_d,
                                                         guint video_width,
                                                         guint video_height,
                                                         guint video_par_n,
                                                         guint video_par_d,
                                                         guint display_par_n,
                                                         guint display_par_d);

Given the Pixel Aspect Ratio and size of an input video frame, and the pixel aspect ratio of the intended display device, calculates the actual display ratio the video will be rendered with.

Since 0.10.7

gst_video_frame_rate ()

const GValue*       gst_video_frame_rate                (GstPad *pad);

A convenience function to retrieve a GValue holding the framerate from the caps on a pad.

The pad needs to have negotiated caps containing a framerate property.

gst_video_get_size ()

gboolean            gst_video_get_size                  (GstPad *pad,
                                                         gint *width,
                                                         gint *height);

Inspect the caps of the provided pad and retrieve the width and height of the video frames it is configured for.

The pad needs to have negotiated caps containing width and height properties.

gst_video_format_convert ()

gboolean            gst_video_format_convert            (GstVideoFormat format,
                                                         int width,
                                                         int height,
                                                         int fps_n,
                                                         int fps_d,
                                                         GstFormat src_format,
                                                         gint64 src_value,
                                                         GstFormat dest_format,
                                                         gint64 *dest_value);

Converts among various GstFormat types. This function handles GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For raw video, GST_FORMAT_DEFAULT corresponds to video frames. This function can be to handle pad queries of the type GST_QUERY_CONVERT.

Since 0.10.16

gst_video_format_new_caps ()

GstCaps*            gst_video_format_new_caps           (GstVideoFormat format,
                                                         int width,
                                                         int height,
                                                         int framerate_n,
                                                         int framerate_d,
                                                         int par_n,
                                                         int par_d);

Creates a new GstCaps object based on the parameters provided.

Since 0.10.16

gst_video_format_new_caps_interlaced ()

GstCaps*            gst_video_format_new_caps_interlaced
                                                        (GstVideoFormat format,
                                                         int width,
                                                         int height,
                                                         int framerate_n,
                                                         int framerate_d,
                                                         int par_n,
                                                         int par_d,
                                                         gboolean interlaced);

Creates a new GstCaps object based on the parameters provided.

Since 0.10.23

gst_video_format_get_component_height ()

int                 gst_video_format_get_component_height
                                                        (GstVideoFormat format,
                                                         int component,
                                                         int height);

Calculates the height of the component. See gst_video_format_get_row_stride for a description of the component index.

Since 0.10.16

gst_video_format_get_component_offset ()

int                 gst_video_format_get_component_offset
                                                        (GstVideoFormat format,
                                                         int component,
                                                         int width,
                                                         int height);

Calculates the offset (in bytes) of the first pixel of the component with index component. For packed formats, this will typically be a small integer (0, 1, 2, 3). For planar formats, this will be a (relatively) large offset to the beginning of the second or third component planes. See gst_video_format_get_row_stride for a description of the component index.

Since 0.10.16

gst_video_format_get_component_width ()

int                 gst_video_format_get_component_width
                                                        (GstVideoFormat format,
                                                         int component,
                                                         int width);

Calculates the width of the component. See gst_video_format_get_row_stride for a description of the component index.

Since 0.10.16

gst_video_format_get_pixel_stride ()

int                 gst_video_format_get_pixel_stride   (GstVideoFormat format,
                                                         int component);

Calculates the pixel stride (number of bytes from one pixel to the pixel to its immediate left) for the video component with an index of component. See gst_video_format_get_row_stride for a description of the component index.

Since 0.10.16

gst_video_format_get_row_stride ()

int                 gst_video_format_get_row_stride     (GstVideoFormat format,
                                                         int component,
                                                         int width);

Calculates the row stride (number of bytes from one row of pixels to the next) for the video component with an index of component. For YUV video, Y, U, and V have component indices of 0, 1, and 2, respectively. For RGB video, R, G, and B have component indicies of 0, 1, and 2, respectively. Alpha channels, if present, have a component index of 3. The width parameter always represents the width of the video, not the component.

Since 0.10.16

gst_video_format_get_size ()

int                 gst_video_format_get_size           (GstVideoFormat format,
                                                         int width,
                                                         int height);

Calculates the total number of bytes in the raw video format. This number should be used when allocating a buffer for raw video.

Since 0.10.16

gst_video_format_has_alpha ()

gboolean            gst_video_format_has_alpha          (GstVideoFormat format);

Returns TRUE or FALSE depending on if the video format provides an alpha channel.

Since 0.10.16

gst_video_format_is_rgb ()

gboolean            gst_video_format_is_rgb             (GstVideoFormat format);

Determine whether the video format is an RGB format.

Since 0.10.16

gst_video_format_is_yuv ()

gboolean            gst_video_format_is_yuv             (GstVideoFormat format);

Determine whether the video format is a YUV format.

Since 0.10.16

gst_video_format_to_fourcc ()

guint32             gst_video_format_to_fourcc          (GstVideoFormat format);

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

Since 0.10.16

gst_video_format_from_fourcc ()

GstVideoFormat      gst_video_format_from_fourcc        (guint32 fourcc);

Converts a FOURCC value into the corresponding GstVideoFormat. If the FOURCC cannot be represented by GstVideoFormat, GST_VIDEO_FORMAT_UNKNOWN is returned.

Since 0.10.16

gst_video_format_parse_caps ()

gboolean            gst_video_format_parse_caps         (GstCaps *caps,
                                                         GstVideoFormat *format,
                                                         int *width,
                                                         int *height);

Determines the GstVideoFormat of caps and places it in the location pointed to by format. Extracts the size of the video and places it in the location pointed to by width and height. If caps does not represent one of the raw video formats listed in GstVideoFormat, the function will fail and return FALSE.

Since 0.10.16

gst_video_format_parse_caps_interlaced ()

gboolean            gst_video_format_parse_caps_interlaced
                                                        (GstCaps *caps,
                                                         gboolean *interlaced);

Extracts whether the caps represents interlaced content or not and places it in interlaced.

Since 0.10.23

gst_video_parse_caps_framerate ()

gboolean            gst_video_parse_caps_framerate      (GstCaps *caps,
                                                         int *fps_n,
                                                         int *fps_d);

Extracts the frame rate from caps and places the values in the locations pointed to by fps_n and fps_d. Returns TRUE if the values could be parsed correctly, FALSE if not.

This function can be used with GstCaps that have any media type; it is not limited to formats handled by GstVideoFormat.

Since 0.10.16

gst_video_parse_caps_pixel_aspect_ratio ()

gboolean            gst_video_parse_caps_pixel_aspect_ratio
                                                        (GstCaps *caps,
                                                         int *par_n,
                                                         int *par_d);

Extracts the pixel aspect ratio from caps and places the values in the locations pointed to by par_n and par_d. Returns TRUE if the values could be parsed correctly, FALSE if not.

This function can be used with GstCaps that have any media type; it is not limited to formats handled by GstVideoFormat.

Since 0.10.16