Commit 9f3d1056 authored by Stanimir Varbanov's avatar Stanimir Varbanov Committed by Mauro Carvalho Chehab
Browse files

media: v4l2-ctrl: Make display delay and display enable std controls 



Make display delay and display delay enable MFC controls standard v4l
controls. This will allow reuse of the controls for other decoder
drivers. Also the new proposed controls are now codec agnostic because
they could be used for any codec.

Acked-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: default avatarStanimir Varbanov <stanimir.varbanov@linaro.org>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent 86ee6729

Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst

+15 −0
Original line number Diff line number Diff line
@@ -679,6 +679,21 @@ enum v4l2_mpeg_video_frame_skip_mode - 
    otherwise the decoder expects a single frame in per buffer.

    Applicable to the decoder, all codecs.



``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE (boolean)``

    If the display delay is enabled then the decoder is forced to return

    a CAPTURE buffer (decoded frame) after processing a certain number

    of OUTPUT buffers. The delay can be set through

    ``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY``. This

    feature can be used for example for generating thumbnails of videos.

    Applicable to the decoder.



``V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY (integer)``

    Display delay value for decoder. The decoder is forced to

    return a decoded frame after the set 'display delay' number of

    frames. If this number is low it may result in frames returned out

    of display order, in addition the hardware may still be using the

    returned buffer as a reference picture for subsequent frames.



``V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE (boolean)``

    Enable writing sample aspect ratio in the Video Usability

    Information. Applicable to the H264 encoder.

drivers/media/v4l2-core/v4l2-ctrls.c

+4 −0
Original line number Diff line number Diff line
@@ -874,6 +874,8 @@ const char *v4l2_ctrl_get_name(u32 id) 
	case V4L2_CID_MPEG_VIDEO_HEADER_MODE:			return "Sequence Header Mode";

	case V4L2_CID_MPEG_VIDEO_MAX_REF_PIC:			return "Max Number of Reference Pics";

	case V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE:		return "Frame Skip Mode";

	case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY:		return "Display Delay";

	case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE:	return "Display Delay Enable";

	case V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP:		return "H263 I-Frame QP Value";

	case V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP:		return "H263 P-Frame QP Value";

	case V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP:		return "H263 B-Frame QP Value";
@@ -1241,6 +1243,7 @@ void v4l2_ctrl_fill(u32 id, const char **name, enum v4l2_ctrl_type *type, 
	case V4L2_CID_FLASH_READY:

	case V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER:

	case V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE:

	case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE:

	case V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE:

	case V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE:

	case V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM:
@@ -1276,6 +1279,7 @@ void v4l2_ctrl_fill(u32 id, const char **name, enum v4l2_ctrl_type *type, 
		break;

	case V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE:

	case V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE:

	case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY:

		*type = V4L2_CTRL_TYPE_INTEGER;

		break;

	case V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME:

include/uapi/linux/v4l2-controls.h

+3 −0
Original line number Diff line number Diff line
@@ -797,6 +797,9 @@ enum v4l2_mpeg_video_frame_skip_mode { 
#define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP        (V4L2_CID_CODEC_BASE + 651)

#define V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP        (V4L2_CID_CODEC_BASE + 652)



#define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY		(V4L2_CID_CODEC_BASE + 653)

#define V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE	(V4L2_CID_CODEC_BASE + 654)



/*  MPEG-class control IDs specific to the CX2341x driver as defined by V4L2 */

#define V4L2_CID_CODEC_CX2341X_BASE				(V4L2_CTRL_CLASS_CODEC | 0x1000)

#define V4L2_CID_MPEG_CX2341X_VIDEO_SPATIAL_FILTER_MODE		(V4L2_CID_CODEC_CX2341X_BASE+0)