gdiscreencapsrc

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

Set 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 ]

Presence – always

Direction – src

Object type – GstPad

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