gvatagger#
Reads only H.264/H.265 NAL unit sizes (no entropy decoding, no pixel access) and tags every access unit with GvaTriggerMeta (motion, keyframe) based on an exponential moving average (EMA) of quiet-frame size. Nothing is dropped or delayed: the whole stream passes through unchanged, and the meta survives GstVideoDecoder-based decoders so a downstream element can skip inference on quiet frames.
Pad Templates:
SINK template: 'sink'
Availability: Always
Capabilities:
video/x-h264
stream-format: { (string)byte-stream, (string)avc } (GstValueList)
alignment: au (gchararray)
video/x-h265
stream-format: { (string)byte-stream, (string)hvc1, (string)hev1 } (GstValueList)
alignment: au (gchararray)
SRC template: 'src'
Availability: Always
Capabilities:
video/x-h264
stream-format: { (string)byte-stream, (string)avc } (GstValueList)
alignment: au (gchararray)
video/x-h265
stream-format: { (string)byte-stream, (string)hvc1, (string)hev1 } (GstValueList)
alignment: au (gchararray)
Element Flags:
Element has no clocking capabilities.
Element has no URI handling capabilities.
Pads:
SINK: 'sink'
Pad Template: 'sink'
SRC: 'src'
Pad Template: 'src'
Element Properties:
alpha : Baseline update rate, applied only to quiet, non-IDR access units.
flags: readable, writable
Double. Range: 0 - 1 Default: 0.03
k : Access unit tagged as motion when size > k * baseline.
flags: readable, writable
Double. Range: 1 - 1.797693e+308 Default: 1.5
margin : Minimum absolute byte margin added on top of k * baseline.
flags: readable, writable
Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 8
min-baseline : Floor for the EMA baseline, in bytes, so it can never collapse to ~0.
flags: readable, writable
Unsigned Integer64. Range: 1 - 18446744073709551615 Default: 10
name : The name of the object.
flags: readable, writable
String. Default: "gvatagger0"
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
GvaTriggerMeta#
gvatagger attaches a GstCustomMeta named GvaTriggerMeta to every access unit, with two boolean fields:
Field |
Type |
Meaning |
|---|---|---|
|
boolean |
access unit’s coded (VCL) size exceeds |
|
boolean |
access unit is an IDR |
During the first 60 non-IDR access units, the EMA baseline has not been established yet, so every access unit (including IDRs) is fail-safe tagged motion=true. In steady state, IDRs are always tagged motion=false (keyframes are large regardless of content) and the baseline is only updated from quiet, non-IDR access units, so motion never “trains” the baseline.
Because the meta is attached as a GstCustomMeta, it survives GstVideoDecoder-based decoders (avdec_h264, openh264dec, vah264dec, vah265dec, decodebin3, …), so it can be read after decoding, for example to skip inference on frames that were not tagged as motion.
Example#
Tag a stream and read GvaTriggerMeta after decoding, for example to skip inference on quiet frames:
gst-launch-1.0 filesrc location=input.264 ! h264parse ! gvatagger k=1.5 ! decodebin3 ! autovideosink
See the
gvatagger_motion
sample for a full walkthrough that prints a motion summary.