LTR (Long Term Reference) frames are the frames that are encoded sometime in
the past
and stored in the DPB buffer list to be used as reference to encode future
frames.
One usage of LTR encoding is to reduce error propagation for video transmission
in packet lossy networks. For example, encoder may want to specify some key
frames as
LTR pictures and use them as reference frames for encoding. With extra
protection
selectively on these LTR frames or synchronization with the receiver of
reception of
the LTR frames during transmission, decoder can receive reference frames more
reliably
than other non-reference frames. As a result, transmission error can be
effectively
restricted within certain frames rather than propagated to future frames.
We are introducing below V4l2 Controls for this feature
1. V4L2_CID_MPEG_VIDEO_LTRCOUNT
a. This is used to query or configure the number of LTR frames.
This is a static control and is controlled by the client.
b. The LTR index varies from 0 to the max LTR-1.
c. If LTR Count is more than max supported LTR count (max LTR) by driver,
it will be rejected.
d. Auto Marking : If LTR count is non zero,
1) first LTR count frames would be mark as LTR automatically after
every IDR frame (inclusive).
2) For multilayer encoding: first LTR count base layer reference frames
starting after
every IDR frame (inclusive) in encoding order would be marked as LTR
frames by the encoder.
3) Auto marking of LTR due to IDR should consider following conditions:
1. The frame is not already set to be marked as LTR.
2. The frame is part of the base layer in the hierarchical layer
case.
3. The number of frames currently marked as LTR is less than the
maximum LTR frame index plus 1.
e. Encoder needs to handle explicit Mark/Use command when encoder is still
doing "auto" marking
2. V4L2_CID_MPEG_VIDEO_MARKLTRFRAME :
a. This signals to mark the current frame as LTR frame. It is a dynamic
control and also provide the LTR index to be used.
b. the LTR index provided by this control should never exceed the max
LTR-1. Else it will be rejected.
3. V4L2_CID_MPEG_VIDEO_USELTRFRAME :
a. This specifies the LTR frame(s) to be used for encoding the current
frame. This is a dynamic control.
b. LTR Use Bitmap : this consists of bits [0, 15]. A total of N LSB bits of
this field are valid,
where N is the maximum number of LTRs supported. All the other bits are
invalid and should be rejected.
The LSB corresponds to the LTR index 0. Bit N-1 from the LSB corresponds
to the LTR index max LTR-1.
Dikshita Agarwal (1):
media: v4l2-ctrls: add control for ltr
drivers/media/v4l2-core/v4l2-ctrls.c | 6 ++++++
include/uapi/linux/v4l2-controls.h | 4 ++++
2 files changed, 10 insertions(+)
--
1.9.1