# 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 <hakon.sporsheim@tandberg.com></hakon.sporsheim@tandberg.com>

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