## 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