Provides useful functions and a base class for video sinks.

GstVideoSink will configure the default base sink to drop frames that arrive later than 20ms as this is considered the default threshold for observing out-of-sync frames.

GstVideoSink

typedef struct _GstVideoSink GstVideoSink;

The video sink instance structure. Derived video sinks should set the height and width members.

GstVideoSinkClass

typedef struct {
  GstBaseSinkClass parent_class;

  GstFlowReturn  (*show_frame) (GstVideoSink *video_sink, GstBuffer *buf);
} GstVideoSinkClass;

The video sink class structure. Derived classes should override the show_frame virtual function.

GstVideoRectangle

typedef struct {
  gint x;
  gint y;
  gint w;
  gint h;
} GstVideoRectangle;

Helper structure representing a rectangular area.

GST_VIDEO_SINK_HEIGHT()

#define GST_VIDEO_SINK_HEIGHT(obj) (GST_VIDEO_SINK_CAST (obj)->height)

GST_VIDEO_SINK_PAD()

#define GST_VIDEO_SINK_PAD(obj) GST_BASE_SINK_PAD(obj)

Get the sink GstPad of obj.

GST_VIDEO_SINK_WIDTH()

#define GST_VIDEO_SINK_WIDTH(obj) (GST_VIDEO_SINK_CAST (obj)->width)

gst_video_sink_center_rect ()

void                gst_video_sink_center_rect          (GstVideoRectangle src,
                                                         GstVideoRectangle dst,
                                                         GstVideoRectangle *result,
                                                         gboolean scaling);

Takes src rectangle and position it at the center of dst rectangle with or without scaling. It handles clipping if the src rectangle is bigger than the dst one and scaling is set to FALSE.

The "show-preroll-frame" property

  "show-preroll-frame"       gboolean              : Read / Write / Construct

Whether to show video frames during preroll. If set to FALSE, video frames will only be rendered in PLAYING state.

Default value: TRUE

Since 0.10.25