GstVideoSizeFilter

GstVideoSizeFilter — A filter to modify a video's resolution

Synopsis

#include <gst/filters/gst-videosize-filter.h>

                    GstVideoSizeFilter;
GstVideoSizeFilter * gst_videosize_filter_new           (guint width,
                                                         guint height);
GstVideoSizeFilter * gst_videosize_filter_new_range     (guint min_width,
                                                         guint min_height,
                                                         guint max_width,
                                                         guint max_height);

Object Hierarchy

  GObject
   +----GstFilter
         +----GstVideoSizeFilter

Properties

  "max-height"               guint                 : Read / Write / Construct Only
  "max-width"                guint                 : Read / Write / Construct Only
  "min-height"               guint                 : Read / Write / Construct Only
  "min-width"                guint                 : Read / Write / Construct Only

Description

This filter will force the video resolution of the pipeline to a specific size.

Details

GstVideoSizeFilter

typedef struct _GstVideoSizeFilter GstVideoSizeFilter;

A filter to force the size of a video stream (resolution)


gst_videosize_filter_new ()

GstVideoSizeFilter * gst_videosize_filter_new           (guint width,
                                                         guint height);

Creates a new videosize filter. This filter will force the video output to have a specific size (resolution). It will add a videoscale element to the pipeline as well as a capsfilter. If the source can use the new size, it will do it, otherwise, the videoscale will scale the video to make sure it has the right size.

width :

The requested width of the video

height :

The requested height of the video

Returns :

A new GstVideoSizeFilter See also: gst_videosize_filter_new_range()

gst_videosize_filter_new_range ()

GstVideoSizeFilter * gst_videosize_filter_new_range     (guint min_width,
                                                         guint min_height,
                                                         guint max_width,
                                                         guint max_height);

Creates a new videosize filter. This filter will force the video output to have a resolution in a specific range. It will allow you to set a 'reasonable resolution' rather than a 'specific resolution'. It will add a videoscale element to the pipeline as well as a capsfilter. If the source can use a size in that range, it will do it, otherwise, the videoscale will scale the video to make sure it has the right size.

min_width :

The minimum width of the video

min_height :

The minimum height of the video

max_width :

The maximum width of the video

max_height :

The maximum height of the video

Returns :

A new GstVideoSizeFilter See also: gst_videosize_filter_new()

Property Details

The "max-height" property

  "max-height"               guint                 : Read / Write / Construct Only

The maximum height of the video

Allowed values: <= G_MAXLONG

Default value: 240


The "max-width" property

  "max-width"                guint                 : Read / Write / Construct Only

The maximum width of the video

Allowed values: <= G_MAXLONG

Default value: 320


The "min-height" property

  "min-height"               guint                 : Read / Write / Construct Only

The minimum height of the video

Allowed values: <= G_MAXLONG

Default value: 240


The "min-width" property

  "min-width"                guint                 : Read / Write / Construct Only

The minimum width of the video

Allowed values: <= G_MAXLONG

Default value: 320