# motioncells

Performs motion detection on videos.

## Example launch line

     gst-launch-1.0 videotestsrc pattern=18 ! videorate ! videoscale ! video/x-raw,width=320,height=240,framerate=5/1 ! videoconvert ! motioncells ! videoconvert ! xvimagesink

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBaseTransform
                        ╰──GstVideoFilter
                            ╰──GstOpencvVideoFilter
                                ╰──motioncells

## Factory details

Authors: – Robert Jobbagy , Nicola Murino

Classification: – `Filter/Effect/Video`

Rank – none

Plugin – opencv

Package – GStreamer Bad Plug-ins

## Pad Templates

### `sink`

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

Presence – always

Direction – sink

Object type – GstPad

### `src`

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

Presence – always

Direction – src

Object type – GstPad

## Properties

### calculatemotion

    “calculatemotion” gboolean

Toggles motion calculation. If FALSE, this filter does nothing

Flags : Read / Write

Default value : true

### cellscolor

    “cellscolor” gchararray

Color for motion cells in R,G,B format. Max per channel is 255

Flags : Read / Write

Default value : 255,255,0

### datafile

    “datafile” gchararray

Location of motioncells data file (empty string means no saving)

Flags : Read / Write

Default value : NULL

### datafileextension

    “datafileextension” gchararray

Extension of datafile

Flags : Read / Write

Default value : vamc

### display

    “display” gboolean

Toggle display of motion cells on current frame

Flags : Read / Write

Default value : true

### gap

    “gap” gint

Interval in seconds after which motion is considered finished and a motion finished bus message is posted.

Flags : Read / Write

Default value : 5

### gridx

    “gridx” gint

Number of horizontal grid cells.

Flags : Read / Write

Default value : 10

### gridy

    “gridy” gint

Number of vertical grid cells.

Flags : Read / Write

Default value : 10

### minimummotionframes

    “minimummotionframes” gint

Minimum number of motion frames triggering a motion event

Flags : Read / Write

Default value : 1

### motioncellsidx

    “motioncellsidx” gchararray

Describe a cell with its line and column idx separated with ":". Pass multiple cells as a comma-separated list

Flags : Read / Write

### motioncellthickness

    “motioncellthickness” gint

Motion Cell Border Thickness. Set to -1 to fill motion cell

Flags : Read / Write

Default value : 1

### motionmaskcellspos

    “motionmaskcellspos” gchararray

Describe a cell with its line and column idx separated with ":". Pass multiple cells as a comma-separated list

Flags : Read / Write

### motionmaskcoords

    “motionmaskcoords” gchararray

Describe a region with its upper left and lower right x, y coordinates separated with ":". Pass multiple regions as a comma-separated list

Flags : Read / Write

### postallmotion

    “postallmotion” gboolean

Post bus messages for every motion frame or just motion start and motion stop

Flags : Read / Write

Default value : false

### postnomotion

    “postnomotion” gint

If non 0, post a no_motion event on the bus if no motion is detected for the given number of seconds

Flags : Read / Write

Default value : 0

### sensitivity

    “sensitivity” gdouble

Motion detection sensitivity.

Flags : Read / Write

Default value : 0.5

### threshold

    “threshold” gdouble

Threshold value for motion. Filter detects motion when at least this fraction of the cells have moved

Flags : Read / Write

Default value : 0.01

### usealpha

    “usealpha” gboolean

Toggle usage of alpha blending on frames with motion cells

Flags : Read / Write

Default value : true

The results of the search are