gvaframeselect#
Selects up to frame-budget evenly spaced frames from each sub-stream-frames block.
The selection restarts when the input buffer has GST_BUFFER_FLAG_DISCONT; gvaeventrecorder
marks the first forwarded frame of each event this way. Selected buffers are cached until the
frame budget is collected, then forwarded in input order with one shared ROI. Input and output
video caps are unchanged.
Property |
Type |
Range |
Default |
Description |
|---|---|---|---|---|
|
Unsigned Integer |
[1, 4294967295] |
900 |
Length $N$, in input frames, of each selection block. The pattern restarts every $N$ frames and on |
|
Unsigned Integer |
[1, 4294967295] |
8 |
Maximum number $k$ of frames forwarded per full block, selected evenly across the block. For $k=1$, the first frame is selected. |
|
String |
— |
|
Comma-separated detection labels included when calculating the shared ROI across the selected frames. |
|
Double |
[0.0, 1.0] |
0.5 |
Minimum confidence of a target detection used in the shared ROI calculation. Set this to the same value as |
|
Unsigned Integer |
[0, 4294967295] |
0 |
Pixels added on each side of the shared ROI, clipped to the frame boundaries. |
|
String |
— |
(empty) |
If set, each forwarded frame is also saved to this directory as |
Element Details (gst-inspect-1.0)#
Pad Templates:
SINK template: 'sink'
Availability: Always
Capabilities:
video/x-raw
format: { (string)BGRx, (string)BGRA, (string)BGR, (string)NV12, (string)I420 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:DMABuf)
format: { (string)DMA_DRM } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:VASurface)
format: { (string)NV12 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:VAMemory)
format: { (string)NV12 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
SRC template: 'src'
Availability: Always
Capabilities:
video/x-raw
format: { (string)BGRx, (string)BGRA, (string)BGR, (string)NV12, (string)I420 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:DMABuf)
format: { (string)DMA_DRM } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:VASurface)
format: { (string)NV12 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
video/x-raw(memory:VAMemory)
format: { (string)NV12 } (GstValueList)
width: [ 1, 2147483647 ] (GstIntRange)
height: [ 1, 2147483647 ] (GstIntRange)
framerate: [ 0/1, 2147483647/1 ] (GstFractionRange)
Element has no clocking capabilities.
Element has no URI handling capabilities.
Pads:
SINK: 'sink'
Pad Template: 'sink'
SRC: 'src'
Pad Template: 'src'
Element Properties:
target-classes : Comma-separated detection labels used when calculating the shared ROI
flags: readable, writable
String. Default: "person,vehicle"
confidence-threshold: Minimum detection confidence used when calculating the shared ROI; set it to the same value as gvaeventrecorder
flags: readable, writable
Double. Range: 0 - 1 Default: 0.5
roi-padding : Pixels added on each side of the shared ROI
flags: readable, writable
Unsigned Integer. Range: 0 - 4294967295 Default: 0
frame-budget : Maximum k frames forwarded per full block; selected positions are evenly spaced, with the first frame used when k is 1
flags: readable, writable
Unsigned Integer. Range: 1 - 4294967295 Default: 8
name : The name of the object
flags: readable, writable
String. Default: "gvaframeselect0"
output-dir : If set, each forwarded frame is also saved to this directory as frame_<stream frame number>.jpg; frame numbers count all input frames from stream start
flags: readable, writable
String. Default: null
parent : The parent of the object
flags: readable, writable
Object of type "GstObject"
qos : Handle Quality-of-Service events
flags: readable, writable
Boolean. Default: false
sub-stream-frames : Length N, in input frames, of each selection block; the pattern restarts every N frames and on DISCONT
flags: readable, writable
Unsigned Integer. Range: 1 - 4294967295 Default: 900