Elecard Sink Filter

Elecard Sink Filter is a GStreamer plugin intended to save received data on a hard drive. Sink Filter also supports the indexing of MPEG-2 Video Elementary Stream (VES) and MPEG-2 Program Stream (PS).

Features

Elecard Sink Filter has the following features:

  • Supports various file cropping modes.

  • Ensures precise settings adjustment.

Parameter Description

Below is the table describing Elecard Sink Filter parameters and their values.

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

async

Enables or disables asynchronous switching to PAUSED.

Boolean

True, False

True

readable, writable

blocksize

Specifies the size in bytes to pull per buffer.

Unsigned Integer

[0 – 4294967295]

4096

readable, writable

crop-mode

Specifies the file cropping mode. This doesn’t work with the crop-time-template parameter but works with crop-size. Available modes:

  • none — no file cropping;

  • by-size — crop file by size;

  • by-time — crop file by time.

Enum

0 — none
1 — by-size
2 — by-time

0

readable, writable, controllable

crop-size

Specifies the size of created files in kBytes or ms. This doesn’t work with crop-time-template.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable, writable, controllable

crop-time-template

Specifies the time template for chunk creation. The template format is:

h1,h2,h3:m1,m2,...:s1,s2,...

The *:0,15,30,45:0 template means that chunks will be cropped every hour at 0, 15, 30, 45 minutes based on the system time.

* — all values.

String

null

readable, writable

drop-before-i-frame

Enables or disables the operation mode for all data to be ignored until the first I-frame is received (only for H264 TS/PS).

Boolean

True, False

False

readable, writable, controllable

enable-last-sample

Enables or disables the last sample’s properties.

Boolean

True, False

True

readable, writable

files-to-write

Specifies the number of created files. If the value is set to 0, the number is not limited.

Unsigned Integer

[0 – 4294967295]

0

readable, writable, controllable

last-sample

Indicates the last obtained sample. This works along with enable-last-sample. It is a statistical read-only parameter.

Boxed pointer of type GstSample

readable

location

Specifies the path for file creation; includes the file name.

String

null

readable, writable

max-bitrate

Specifies the maximum allowed bitrate. Setting the value to 0 disables the parameter.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable, writable

max-lateness

Specifies the maximum buffer size. If there is buffer overflow, the data is discarded. Setting the value to -1 makes the size unlimited.

Integer64

[-1 – 9223372036854775807]

-1

readable, writable

name

Specifies the name of the object.

String

efilesink0

readable, writable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

processing-deadline

Specifies the maximum buffer processing time in nanoseconds (ns).

Unsigned Integer64

[0 – 18446744073709551615]

20000000

readable, writable

qos

Enables or disables the handling of quality-of-service events.

Boolean

True, False

False

readable, writable

render-delay

Specifies an additional delay in nanoseconds.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable, writable

stats

Shows filter statistics. It is a read-only parameter.

Boxed pointer of type GstStructure

average-rate: 0 dropped: 0 rendered: 0

readable

sync

Enables or disables the clock-based synchronization.

Boolean

True, False

False

readable, writable

throttle-time

Specifies the time that should elapse before rendering another buffer. Disabled if set to 0.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable, writable

ts-offset

The timestamp offset in nanoseconds.

Integer64

[-9223372036854775808 – 9223372036854775807]

0

readable, writable

write-mode

Enables or disables the file writing mode. This doesn’t work with crop-time-template. Available modes:

  • to-null — no file writing;

  • overwrite — create a new file;

  • append — append data to the existing file.

Enum

0 — to-null
1 — overwrite
2 — append

1

readable, writable, controllable