gdiscreencapsrc

This element uses GDI to capture the desktop or a portion of it. The default is capturing the whole desktop, but GstGDIScreenCapSrc:x, GstGDIScreenCapSrc:y, GstGDIScreenCapSrc:width and GstGDIScreenCapSrc:height can be used to select a particular region. Use GstGDIScreenCapSrc:monitor for changing which monitor to capture from.

Set GstGDIScreenCapSrc:cursor to TRUE to include the mouse cursor.

Example pipelines

 gst-launch-1.0 gdiscreencapsrc ! videoconvert ! dshowvideosink

Capture the desktop and display it.

 gst-launch-1.0 gdiscreencapsrc x=100 y=100 width=320 height=240 cursor=TRUE
 ! videoconvert ! dshowvideosink

Capture a portion of the desktop, including the mouse cursor, and display it.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstBaseSrc
                    ╰──GstPushSrc
                        ╰──gdiscreencapsrc

Factory details

Authors: – Haakon Sporsheim

Classification:Source/Video

Rank – none

Plugin – winscreencap

Package – GStreamer Bad Plug-ins

Pad Templates

src

video/x-raw:
         format: BGR
          width: [ 1, 2147483647 ]
         height: [ 1, 2147483647 ]
      framerate: [ 0/1, 2147483647/1 ]

Presencealways

Directionsrc

Object typeGstPad


Properties

cursor

“cursor” gboolean

Whether to show mouse cursor (default off)

Flags : Read / Write

Default value : false


height

“height” gint

Height of screen capture area (0 = maximum)

Flags : Read / Write

Default value : 0


monitor

“monitor” gint

Which monitor to use (0 = 1st monitor and default)

Flags : Read / Write

Default value : 0


width

“width” gint

Width of screen capture area (0 = maximum)

Flags : Read / Write

Default value : 0


x

“x” gint

Horizontal coordinate of top left corner for the screen capture area

Flags : Read / Write

Default value : 0


y

“y” gint

Vertical coordinate of top left corner for the screen capture area

Flags : Read / Write

Default value : 0


The results of the search are