# identity

Dummy element that passes incoming data through unmodified. It has some useful diagnostic functions, such as offset and timestamp checking.

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBaseTransform
                        ╰──identity

## Factory details

Authors: – Erik Walthinsen

Classification: – `Generic`

Rank – none

Plugin – coreelements

Package – GStreamer

## Pad Templates

### `sink`

    ANY

Presence – always

Direction – sink

Object type – GstPad

### `src`

    ANY

Presence – always

Direction – src

Object type – GstPad

## Signals

### handoff

    handoff_callback (GstElement * identity,
                      GstBuffer * buffer,
                      gpointer udata)

    def handoff_callback (identity, buffer, udata):
        #python callback for the 'handoff' signal

    function handoff_callback(identity: GstElement * identity, buffer: GstBuffer * buffer, udata: gpointer udata): {
        // javascript callback for the 'handoff' signal
    }

This signal gets emitted before passing the buffer downstream.

Parameters:

`identity` –

the identity instance

`buffer` –

the buffer that just has been received

`udata` –
No description available

Flags: Run Last

## Properties

### check-imperfect-offset

    “check-imperfect-offset” gboolean

Send element messages if offset and offset_end do not match up

Flags : Read / Write

Default value : false

### check-imperfect-timestamp

    “check-imperfect-timestamp” gboolean

Send element messages if timestamps and durations do not match up

Flags : Read / Write

Default value : false

### datarate

    “datarate” gint

(Re)timestamps buffers with number of bytes per second (0 = inactive)

Flags : Read / Write

Default value : 0

### drop-allocation

    “drop-allocation” gboolean

Don't forward allocation queries

Flags : Read / Write

Default value : false

### drop-buffer-flags

    “drop-buffer-flags” GstBufferFlags *

Drop buffers with the given flags.

Flags : Read / Write

Default value : (none)

Since : 1.8

### drop-probability

    “drop-probability” gfloat

The Probability a buffer is dropped

Flags : Read / Write

Default value : 0

### dump

    “dump” gboolean

Dump buffer contents to stdout

Flags : Read / Write

Default value : false

### eos-after

    “eos-after” gint

EOS after N buffers.

Flags : Read / Write

Default value : -1

Since : 1.16

### error-after

    “error-after” gint

Error after N buffers

Flags : Read / Write

Default value : -1

### last-message

    “last-message” gchararray

last-message

Flags : Read

Default value : NULL

### signal-handoffs

    “signal-handoffs” gboolean

If set to TRUE, the identity will emit a handoff signal when handling a buffer. When set to FALSE, no signal will be emitted, which might improve performance.

Flags : Read / Write

Default value : true

### silent

    “silent” gboolean

silent

Flags : Read / Write

Default value : true

### single-segment

    “single-segment” gboolean

Timestamp buffers and eat segments so as to appear as one segment

Flags : Read / Write

Default value : false

### sleep-time

    “sleep-time” guint

Microseconds to sleep between processing

Flags : Read / Write

Default value : 0

### stats

    “stats” GstStructure *

Various statistics. This property returns a GstStructure with name application/x-identity-stats with the following fields:

#guint64 "num-buffers": the number of buffers that passed through. #guint64 "num-bytes": the number of bytes that passed through.

Flags : Read

Default value :

    application/x-identity-stats, num-bytes=(guint64)0, num-buffers=(guint64)0;

Since : 1.20

### sync

    “sync” gboolean

Synchronize to pipeline clock

Flags : Read / Write

Default value : false

### ts-offset

    “ts-offset” gint64

Timestamp offset in nanoseconds for synchronisation, negative for earlier sync

Flags : Read / Write

Default value : 0

The results of the search are