Back to home page

OSCL-LXR
 
 

     

0001 // SPDX-License-Identifier: GPL-2.0-or-later
0002 /*
0003  * V4L2 controls framework control definitions.
0004  *
0005  * Copyright (C) 2010-2021  Hans Verkuil <hverkuil-cisco@xs4all.nl>
0006  */
0007 
0008 #include <linux/export.h>
0009 #include <media/v4l2-ctrls.h>
0010 
0011 /*
0012  * Returns NULL or a character pointer array containing the menu for
0013  * the given control ID. The pointer array ends with a NULL pointer.
0014  * An empty string signifies a menu entry that is invalid. This allows
0015  * drivers to disable certain options if it is not supported.
0016  */
0017 const char * const *v4l2_ctrl_get_menu(u32 id)
0018 {
0019     static const char * const mpeg_audio_sampling_freq[] = {
0020         "44.1 kHz",
0021         "48 kHz",
0022         "32 kHz",
0023         NULL
0024     };
0025     static const char * const mpeg_audio_encoding[] = {
0026         "MPEG-1/2 Layer I",
0027         "MPEG-1/2 Layer II",
0028         "MPEG-1/2 Layer III",
0029         "MPEG-2/4 AAC",
0030         "AC-3",
0031         NULL
0032     };
0033     static const char * const mpeg_audio_l1_bitrate[] = {
0034         "32 kbps",
0035         "64 kbps",
0036         "96 kbps",
0037         "128 kbps",
0038         "160 kbps",
0039         "192 kbps",
0040         "224 kbps",
0041         "256 kbps",
0042         "288 kbps",
0043         "320 kbps",
0044         "352 kbps",
0045         "384 kbps",
0046         "416 kbps",
0047         "448 kbps",
0048         NULL
0049     };
0050     static const char * const mpeg_audio_l2_bitrate[] = {
0051         "32 kbps",
0052         "48 kbps",
0053         "56 kbps",
0054         "64 kbps",
0055         "80 kbps",
0056         "96 kbps",
0057         "112 kbps",
0058         "128 kbps",
0059         "160 kbps",
0060         "192 kbps",
0061         "224 kbps",
0062         "256 kbps",
0063         "320 kbps",
0064         "384 kbps",
0065         NULL
0066     };
0067     static const char * const mpeg_audio_l3_bitrate[] = {
0068         "32 kbps",
0069         "40 kbps",
0070         "48 kbps",
0071         "56 kbps",
0072         "64 kbps",
0073         "80 kbps",
0074         "96 kbps",
0075         "112 kbps",
0076         "128 kbps",
0077         "160 kbps",
0078         "192 kbps",
0079         "224 kbps",
0080         "256 kbps",
0081         "320 kbps",
0082         NULL
0083     };
0084     static const char * const mpeg_audio_ac3_bitrate[] = {
0085         "32 kbps",
0086         "40 kbps",
0087         "48 kbps",
0088         "56 kbps",
0089         "64 kbps",
0090         "80 kbps",
0091         "96 kbps",
0092         "112 kbps",
0093         "128 kbps",
0094         "160 kbps",
0095         "192 kbps",
0096         "224 kbps",
0097         "256 kbps",
0098         "320 kbps",
0099         "384 kbps",
0100         "448 kbps",
0101         "512 kbps",
0102         "576 kbps",
0103         "640 kbps",
0104         NULL
0105     };
0106     static const char * const mpeg_audio_mode[] = {
0107         "Stereo",
0108         "Joint Stereo",
0109         "Dual",
0110         "Mono",
0111         NULL
0112     };
0113     static const char * const mpeg_audio_mode_extension[] = {
0114         "Bound 4",
0115         "Bound 8",
0116         "Bound 12",
0117         "Bound 16",
0118         NULL
0119     };
0120     static const char * const mpeg_audio_emphasis[] = {
0121         "No Emphasis",
0122         "50/15 us",
0123         "CCITT J17",
0124         NULL
0125     };
0126     static const char * const mpeg_audio_crc[] = {
0127         "No CRC",
0128         "16-bit CRC",
0129         NULL
0130     };
0131     static const char * const mpeg_audio_dec_playback[] = {
0132         "Auto",
0133         "Stereo",
0134         "Left",
0135         "Right",
0136         "Mono",
0137         "Swapped Stereo",
0138         NULL
0139     };
0140     static const char * const mpeg_video_encoding[] = {
0141         "MPEG-1",
0142         "MPEG-2",
0143         "MPEG-4 AVC",
0144         NULL
0145     };
0146     static const char * const mpeg_video_aspect[] = {
0147         "1x1",
0148         "4x3",
0149         "16x9",
0150         "2.21x1",
0151         NULL
0152     };
0153     static const char * const mpeg_video_bitrate_mode[] = {
0154         "Variable Bitrate",
0155         "Constant Bitrate",
0156         "Constant Quality",
0157         NULL
0158     };
0159     static const char * const mpeg_stream_type[] = {
0160         "MPEG-2 Program Stream",
0161         "MPEG-2 Transport Stream",
0162         "MPEG-1 System Stream",
0163         "MPEG-2 DVD-compatible Stream",
0164         "MPEG-1 VCD-compatible Stream",
0165         "MPEG-2 SVCD-compatible Stream",
0166         NULL
0167     };
0168     static const char * const mpeg_stream_vbi_fmt[] = {
0169         "No VBI",
0170         "Private Packet, IVTV Format",
0171         NULL
0172     };
0173     static const char * const camera_power_line_frequency[] = {
0174         "Disabled",
0175         "50 Hz",
0176         "60 Hz",
0177         "Auto",
0178         NULL
0179     };
0180     static const char * const camera_exposure_auto[] = {
0181         "Auto Mode",
0182         "Manual Mode",
0183         "Shutter Priority Mode",
0184         "Aperture Priority Mode",
0185         NULL
0186     };
0187     static const char * const camera_exposure_metering[] = {
0188         "Average",
0189         "Center Weighted",
0190         "Spot",
0191         "Matrix",
0192         NULL
0193     };
0194     static const char * const camera_auto_focus_range[] = {
0195         "Auto",
0196         "Normal",
0197         "Macro",
0198         "Infinity",
0199         NULL
0200     };
0201     static const char * const colorfx[] = {
0202         "None",
0203         "Black & White",
0204         "Sepia",
0205         "Negative",
0206         "Emboss",
0207         "Sketch",
0208         "Sky Blue",
0209         "Grass Green",
0210         "Skin Whiten",
0211         "Vivid",
0212         "Aqua",
0213         "Art Freeze",
0214         "Silhouette",
0215         "Solarization",
0216         "Antique",
0217         "Set Cb/Cr",
0218         NULL
0219     };
0220     static const char * const auto_n_preset_white_balance[] = {
0221         "Manual",
0222         "Auto",
0223         "Incandescent",
0224         "Fluorescent",
0225         "Fluorescent H",
0226         "Horizon",
0227         "Daylight",
0228         "Flash",
0229         "Cloudy",
0230         "Shade",
0231         NULL,
0232     };
0233     static const char * const camera_iso_sensitivity_auto[] = {
0234         "Manual",
0235         "Auto",
0236         NULL
0237     };
0238     static const char * const scene_mode[] = {
0239         "None",
0240         "Backlight",
0241         "Beach/Snow",
0242         "Candle Light",
0243         "Dusk/Dawn",
0244         "Fall Colors",
0245         "Fireworks",
0246         "Landscape",
0247         "Night",
0248         "Party/Indoor",
0249         "Portrait",
0250         "Sports",
0251         "Sunset",
0252         "Text",
0253         NULL
0254     };
0255     static const char * const tune_emphasis[] = {
0256         "None",
0257         "50 Microseconds",
0258         "75 Microseconds",
0259         NULL,
0260     };
0261     static const char * const header_mode[] = {
0262         "Separate Buffer",
0263         "Joined With 1st Frame",
0264         NULL,
0265     };
0266     static const char * const multi_slice[] = {
0267         "Single",
0268         "Max Macroblocks",
0269         "Max Bytes",
0270         NULL,
0271     };
0272     static const char * const entropy_mode[] = {
0273         "CAVLC",
0274         "CABAC",
0275         NULL,
0276     };
0277     static const char * const mpeg_h264_level[] = {
0278         "1",
0279         "1b",
0280         "1.1",
0281         "1.2",
0282         "1.3",
0283         "2",
0284         "2.1",
0285         "2.2",
0286         "3",
0287         "3.1",
0288         "3.2",
0289         "4",
0290         "4.1",
0291         "4.2",
0292         "5",
0293         "5.1",
0294         "5.2",
0295         "6.0",
0296         "6.1",
0297         "6.2",
0298         NULL,
0299     };
0300     static const char * const h264_loop_filter[] = {
0301         "Enabled",
0302         "Disabled",
0303         "Disabled at Slice Boundary",
0304         NULL,
0305     };
0306     static const char * const h264_profile[] = {
0307         "Baseline",
0308         "Constrained Baseline",
0309         "Main",
0310         "Extended",
0311         "High",
0312         "High 10",
0313         "High 422",
0314         "High 444 Predictive",
0315         "High 10 Intra",
0316         "High 422 Intra",
0317         "High 444 Intra",
0318         "CAVLC 444 Intra",
0319         "Scalable Baseline",
0320         "Scalable High",
0321         "Scalable High Intra",
0322         "Stereo High",
0323         "Multiview High",
0324         "Constrained High",
0325         NULL,
0326     };
0327     static const char * const vui_sar_idc[] = {
0328         "Unspecified",
0329         "1:1",
0330         "12:11",
0331         "10:11",
0332         "16:11",
0333         "40:33",
0334         "24:11",
0335         "20:11",
0336         "32:11",
0337         "80:33",
0338         "18:11",
0339         "15:11",
0340         "64:33",
0341         "160:99",
0342         "4:3",
0343         "3:2",
0344         "2:1",
0345         "Extended SAR",
0346         NULL,
0347     };
0348     static const char * const h264_fp_arrangement_type[] = {
0349         "Checkerboard",
0350         "Column",
0351         "Row",
0352         "Side by Side",
0353         "Top Bottom",
0354         "Temporal",
0355         NULL,
0356     };
0357     static const char * const h264_fmo_map_type[] = {
0358         "Interleaved Slices",
0359         "Scattered Slices",
0360         "Foreground with Leftover",
0361         "Box Out",
0362         "Raster Scan",
0363         "Wipe Scan",
0364         "Explicit",
0365         NULL,
0366     };
0367     static const char * const h264_decode_mode[] = {
0368         "Slice-Based",
0369         "Frame-Based",
0370         NULL,
0371     };
0372     static const char * const h264_start_code[] = {
0373         "No Start Code",
0374         "Annex B Start Code",
0375         NULL,
0376     };
0377     static const char * const h264_hierarchical_coding_type[] = {
0378         "Hier Coding B",
0379         "Hier Coding P",
0380         NULL,
0381     };
0382     static const char * const mpeg_mpeg2_level[] = {
0383         "Low",
0384         "Main",
0385         "High 1440",
0386         "High",
0387         NULL,
0388     };
0389     static const char * const mpeg2_profile[] = {
0390         "Simple",
0391         "Main",
0392         "SNR Scalable",
0393         "Spatially Scalable",
0394         "High",
0395         NULL,
0396     };
0397     static const char * const mpeg_mpeg4_level[] = {
0398         "0",
0399         "0b",
0400         "1",
0401         "2",
0402         "3",
0403         "3b",
0404         "4",
0405         "5",
0406         NULL,
0407     };
0408     static const char * const mpeg4_profile[] = {
0409         "Simple",
0410         "Advanced Simple",
0411         "Core",
0412         "Simple Scalable",
0413         "Advanced Coding Efficiency",
0414         NULL,
0415     };
0416 
0417     static const char * const vpx_golden_frame_sel[] = {
0418         "Use Previous Frame",
0419         "Use Previous Specific Frame",
0420         NULL,
0421     };
0422     static const char * const vp8_profile[] = {
0423         "0",
0424         "1",
0425         "2",
0426         "3",
0427         NULL,
0428     };
0429     static const char * const vp9_profile[] = {
0430         "0",
0431         "1",
0432         "2",
0433         "3",
0434         NULL,
0435     };
0436     static const char * const vp9_level[] = {
0437         "1",
0438         "1.1",
0439         "2",
0440         "2.1",
0441         "3",
0442         "3.1",
0443         "4",
0444         "4.1",
0445         "5",
0446         "5.1",
0447         "5.2",
0448         "6",
0449         "6.1",
0450         "6.2",
0451         NULL,
0452     };
0453 
0454     static const char * const flash_led_mode[] = {
0455         "Off",
0456         "Flash",
0457         "Torch",
0458         NULL,
0459     };
0460     static const char * const flash_strobe_source[] = {
0461         "Software",
0462         "External",
0463         NULL,
0464     };
0465 
0466     static const char * const jpeg_chroma_subsampling[] = {
0467         "4:4:4",
0468         "4:2:2",
0469         "4:2:0",
0470         "4:1:1",
0471         "4:1:0",
0472         "Gray",
0473         NULL,
0474     };
0475     static const char * const dv_tx_mode[] = {
0476         "DVI-D",
0477         "HDMI",
0478         NULL,
0479     };
0480     static const char * const dv_rgb_range[] = {
0481         "Automatic",
0482         "RGB Limited Range (16-235)",
0483         "RGB Full Range (0-255)",
0484         NULL,
0485     };
0486     static const char * const dv_it_content_type[] = {
0487         "Graphics",
0488         "Photo",
0489         "Cinema",
0490         "Game",
0491         "No IT Content",
0492         NULL,
0493     };
0494     static const char * const detect_md_mode[] = {
0495         "Disabled",
0496         "Global",
0497         "Threshold Grid",
0498         "Region Grid",
0499         NULL,
0500     };
0501 
0502     static const char * const hevc_profile[] = {
0503         "Main",
0504         "Main Still Picture",
0505         "Main 10",
0506         NULL,
0507     };
0508     static const char * const hevc_level[] = {
0509         "1",
0510         "2",
0511         "2.1",
0512         "3",
0513         "3.1",
0514         "4",
0515         "4.1",
0516         "5",
0517         "5.1",
0518         "5.2",
0519         "6",
0520         "6.1",
0521         "6.2",
0522         NULL,
0523     };
0524     static const char * const hevc_hierarchial_coding_type[] = {
0525         "B",
0526         "P",
0527         NULL,
0528     };
0529     static const char * const hevc_refresh_type[] = {
0530         "None",
0531         "CRA",
0532         "IDR",
0533         NULL,
0534     };
0535     static const char * const hevc_size_of_length_field[] = {
0536         "0",
0537         "1",
0538         "2",
0539         "4",
0540         NULL,
0541     };
0542     static const char * const hevc_tier[] = {
0543         "Main",
0544         "High",
0545         NULL,
0546     };
0547     static const char * const hevc_loop_filter_mode[] = {
0548         "Disabled",
0549         "Enabled",
0550         "Disabled at slice boundary",
0551         "NULL",
0552     };
0553     static const char * const hevc_decode_mode[] = {
0554         "Slice-Based",
0555         "Frame-Based",
0556         NULL,
0557     };
0558     static const char * const hevc_start_code[] = {
0559         "No Start Code",
0560         "Annex B Start Code",
0561         NULL,
0562     };
0563     static const char * const camera_orientation[] = {
0564         "Front",
0565         "Back",
0566         "External",
0567         NULL,
0568     };
0569     static const char * const mpeg_video_frame_skip[] = {
0570         "Disabled",
0571         "Level Limit",
0572         "VBV/CPB Limit",
0573         NULL,
0574     };
0575     static const char * const intra_refresh_period_type[] = {
0576         "Random",
0577         "Cyclic",
0578         NULL,
0579     };
0580 
0581     switch (id) {
0582     case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
0583         return mpeg_audio_sampling_freq;
0584     case V4L2_CID_MPEG_AUDIO_ENCODING:
0585         return mpeg_audio_encoding;
0586     case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
0587         return mpeg_audio_l1_bitrate;
0588     case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
0589         return mpeg_audio_l2_bitrate;
0590     case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
0591         return mpeg_audio_l3_bitrate;
0592     case V4L2_CID_MPEG_AUDIO_AC3_BITRATE:
0593         return mpeg_audio_ac3_bitrate;
0594     case V4L2_CID_MPEG_AUDIO_MODE:
0595         return mpeg_audio_mode;
0596     case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
0597         return mpeg_audio_mode_extension;
0598     case V4L2_CID_MPEG_AUDIO_EMPHASIS:
0599         return mpeg_audio_emphasis;
0600     case V4L2_CID_MPEG_AUDIO_CRC:
0601         return mpeg_audio_crc;
0602     case V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK:
0603     case V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK:
0604         return mpeg_audio_dec_playback;
0605     case V4L2_CID_MPEG_VIDEO_ENCODING:
0606         return mpeg_video_encoding;
0607     case V4L2_CID_MPEG_VIDEO_ASPECT:
0608         return mpeg_video_aspect;
0609     case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
0610         return mpeg_video_bitrate_mode;
0611     case V4L2_CID_MPEG_STREAM_TYPE:
0612         return mpeg_stream_type;
0613     case V4L2_CID_MPEG_STREAM_VBI_FMT:
0614         return mpeg_stream_vbi_fmt;
0615     case V4L2_CID_POWER_LINE_FREQUENCY:
0616         return camera_power_line_frequency;
0617     case V4L2_CID_EXPOSURE_AUTO:
0618         return camera_exposure_auto;
0619     case V4L2_CID_EXPOSURE_METERING:
0620         return camera_exposure_metering;
0621     case V4L2_CID_AUTO_FOCUS_RANGE:
0622         return camera_auto_focus_range;
0623     case V4L2_CID_COLORFX:
0624         return colorfx;
0625     case V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE:
0626         return auto_n_preset_white_balance;
0627     case V4L2_CID_ISO_SENSITIVITY_AUTO:
0628         return camera_iso_sensitivity_auto;
0629     case V4L2_CID_SCENE_MODE:
0630         return scene_mode;
0631     case V4L2_CID_TUNE_PREEMPHASIS:
0632         return tune_emphasis;
0633     case V4L2_CID_TUNE_DEEMPHASIS:
0634         return tune_emphasis;
0635     case V4L2_CID_FLASH_LED_MODE:
0636         return flash_led_mode;
0637     case V4L2_CID_FLASH_STROBE_SOURCE:
0638         return flash_strobe_source;
0639     case V4L2_CID_MPEG_VIDEO_HEADER_MODE:
0640         return header_mode;
0641     case V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE:
0642         return mpeg_video_frame_skip;
0643     case V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE:
0644         return multi_slice;
0645     case V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE:
0646         return entropy_mode;
0647     case V4L2_CID_MPEG_VIDEO_H264_LEVEL:
0648         return mpeg_h264_level;
0649     case V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE:
0650         return h264_loop_filter;
0651     case V4L2_CID_MPEG_VIDEO_H264_PROFILE:
0652         return h264_profile;
0653     case V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC:
0654         return vui_sar_idc;
0655     case V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE:
0656         return h264_fp_arrangement_type;
0657     case V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE:
0658         return h264_fmo_map_type;
0659     case V4L2_CID_STATELESS_H264_DECODE_MODE:
0660         return h264_decode_mode;
0661     case V4L2_CID_STATELESS_H264_START_CODE:
0662         return h264_start_code;
0663     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE:
0664         return h264_hierarchical_coding_type;
0665     case V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL:
0666         return mpeg_mpeg2_level;
0667     case V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE:
0668         return mpeg2_profile;
0669     case V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL:
0670         return mpeg_mpeg4_level;
0671     case V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE:
0672         return mpeg4_profile;
0673     case V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL:
0674         return vpx_golden_frame_sel;
0675     case V4L2_CID_MPEG_VIDEO_VP8_PROFILE:
0676         return vp8_profile;
0677     case V4L2_CID_MPEG_VIDEO_VP9_PROFILE:
0678         return vp9_profile;
0679     case V4L2_CID_MPEG_VIDEO_VP9_LEVEL:
0680         return vp9_level;
0681     case V4L2_CID_JPEG_CHROMA_SUBSAMPLING:
0682         return jpeg_chroma_subsampling;
0683     case V4L2_CID_DV_TX_MODE:
0684         return dv_tx_mode;
0685     case V4L2_CID_DV_TX_RGB_RANGE:
0686     case V4L2_CID_DV_RX_RGB_RANGE:
0687         return dv_rgb_range;
0688     case V4L2_CID_DV_TX_IT_CONTENT_TYPE:
0689     case V4L2_CID_DV_RX_IT_CONTENT_TYPE:
0690         return dv_it_content_type;
0691     case V4L2_CID_DETECT_MD_MODE:
0692         return detect_md_mode;
0693     case V4L2_CID_MPEG_VIDEO_HEVC_PROFILE:
0694         return hevc_profile;
0695     case V4L2_CID_MPEG_VIDEO_HEVC_LEVEL:
0696         return hevc_level;
0697     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE:
0698         return hevc_hierarchial_coding_type;
0699     case V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE:
0700         return hevc_refresh_type;
0701     case V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD:
0702         return hevc_size_of_length_field;
0703     case V4L2_CID_MPEG_VIDEO_HEVC_TIER:
0704         return hevc_tier;
0705     case V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE:
0706         return hevc_loop_filter_mode;
0707     case V4L2_CID_STATELESS_HEVC_DECODE_MODE:
0708         return hevc_decode_mode;
0709     case V4L2_CID_STATELESS_HEVC_START_CODE:
0710         return hevc_start_code;
0711     case V4L2_CID_CAMERA_ORIENTATION:
0712         return camera_orientation;
0713     case V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE:
0714         return intra_refresh_period_type;
0715     default:
0716         return NULL;
0717     }
0718 }
0719 EXPORT_SYMBOL(v4l2_ctrl_get_menu);
0720 
0721 #define __v4l2_qmenu_int_len(arr, len) ({ *(len) = ARRAY_SIZE(arr); (arr); })
0722 /*
0723  * Returns NULL or an s64 type array containing the menu for given
0724  * control ID. The total number of the menu items is returned in @len.
0725  */
0726 const s64 *v4l2_ctrl_get_int_menu(u32 id, u32 *len)
0727 {
0728     static const s64 qmenu_int_vpx_num_partitions[] = {
0729         1, 2, 4, 8,
0730     };
0731 
0732     static const s64 qmenu_int_vpx_num_ref_frames[] = {
0733         1, 2, 3,
0734     };
0735 
0736     switch (id) {
0737     case V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS:
0738         return __v4l2_qmenu_int_len(qmenu_int_vpx_num_partitions, len);
0739     case V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES:
0740         return __v4l2_qmenu_int_len(qmenu_int_vpx_num_ref_frames, len);
0741     default:
0742         *len = 0;
0743         return NULL;
0744     }
0745 }
0746 EXPORT_SYMBOL(v4l2_ctrl_get_int_menu);
0747 
0748 /* Return the control name. */
0749 const char *v4l2_ctrl_get_name(u32 id)
0750 {
0751     switch (id) {
0752     /* USER controls */
0753     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
0754     case V4L2_CID_USER_CLASS:       return "User Controls";
0755     case V4L2_CID_BRIGHTNESS:       return "Brightness";
0756     case V4L2_CID_CONTRAST:         return "Contrast";
0757     case V4L2_CID_SATURATION:       return "Saturation";
0758     case V4L2_CID_HUE:          return "Hue";
0759     case V4L2_CID_AUDIO_VOLUME:     return "Volume";
0760     case V4L2_CID_AUDIO_BALANCE:        return "Balance";
0761     case V4L2_CID_AUDIO_BASS:       return "Bass";
0762     case V4L2_CID_AUDIO_TREBLE:     return "Treble";
0763     case V4L2_CID_AUDIO_MUTE:       return "Mute";
0764     case V4L2_CID_AUDIO_LOUDNESS:       return "Loudness";
0765     case V4L2_CID_BLACK_LEVEL:      return "Black Level";
0766     case V4L2_CID_AUTO_WHITE_BALANCE:   return "White Balance, Automatic";
0767     case V4L2_CID_DO_WHITE_BALANCE:     return "Do White Balance";
0768     case V4L2_CID_RED_BALANCE:      return "Red Balance";
0769     case V4L2_CID_BLUE_BALANCE:     return "Blue Balance";
0770     case V4L2_CID_GAMMA:            return "Gamma";
0771     case V4L2_CID_EXPOSURE:         return "Exposure";
0772     case V4L2_CID_AUTOGAIN:         return "Gain, Automatic";
0773     case V4L2_CID_GAIN:         return "Gain";
0774     case V4L2_CID_HFLIP:            return "Horizontal Flip";
0775     case V4L2_CID_VFLIP:            return "Vertical Flip";
0776     case V4L2_CID_POWER_LINE_FREQUENCY: return "Power Line Frequency";
0777     case V4L2_CID_HUE_AUTO:         return "Hue, Automatic";
0778     case V4L2_CID_WHITE_BALANCE_TEMPERATURE: return "White Balance Temperature";
0779     case V4L2_CID_SHARPNESS:        return "Sharpness";
0780     case V4L2_CID_BACKLIGHT_COMPENSATION:   return "Backlight Compensation";
0781     case V4L2_CID_CHROMA_AGC:       return "Chroma AGC";
0782     case V4L2_CID_COLOR_KILLER:     return "Color Killer";
0783     case V4L2_CID_COLORFX:          return "Color Effects";
0784     case V4L2_CID_AUTOBRIGHTNESS:       return "Brightness, Automatic";
0785     case V4L2_CID_BAND_STOP_FILTER:     return "Band-Stop Filter";
0786     case V4L2_CID_ROTATE:           return "Rotate";
0787     case V4L2_CID_BG_COLOR:         return "Background Color";
0788     case V4L2_CID_CHROMA_GAIN:      return "Chroma Gain";
0789     case V4L2_CID_ILLUMINATORS_1:       return "Illuminator 1";
0790     case V4L2_CID_ILLUMINATORS_2:       return "Illuminator 2";
0791     case V4L2_CID_MIN_BUFFERS_FOR_CAPTURE:  return "Min Number of Capture Buffers";
0792     case V4L2_CID_MIN_BUFFERS_FOR_OUTPUT:   return "Min Number of Output Buffers";
0793     case V4L2_CID_ALPHA_COMPONENT:      return "Alpha Component";
0794     case V4L2_CID_COLORFX_CBCR:     return "Color Effects, CbCr";
0795     case V4L2_CID_COLORFX_RGB:              return "Color Effects, RGB";
0796 
0797     /*
0798      * Codec controls
0799      *
0800      * The MPEG controls are applicable to all codec controls
0801      * and the 'MPEG' part of the define is historical.
0802      *
0803      * Keep the order of the 'case's the same as in videodev2.h!
0804      */
0805     case V4L2_CID_CODEC_CLASS:      return "Codec Controls";
0806     case V4L2_CID_MPEG_STREAM_TYPE:     return "Stream Type";
0807     case V4L2_CID_MPEG_STREAM_PID_PMT:  return "Stream PMT Program ID";
0808     case V4L2_CID_MPEG_STREAM_PID_AUDIO:    return "Stream Audio Program ID";
0809     case V4L2_CID_MPEG_STREAM_PID_VIDEO:    return "Stream Video Program ID";
0810     case V4L2_CID_MPEG_STREAM_PID_PCR:  return "Stream PCR Program ID";
0811     case V4L2_CID_MPEG_STREAM_PES_ID_AUDIO: return "Stream PES Audio ID";
0812     case V4L2_CID_MPEG_STREAM_PES_ID_VIDEO: return "Stream PES Video ID";
0813     case V4L2_CID_MPEG_STREAM_VBI_FMT:  return "Stream VBI Format";
0814     case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ: return "Audio Sampling Frequency";
0815     case V4L2_CID_MPEG_AUDIO_ENCODING:  return "Audio Encoding";
0816     case V4L2_CID_MPEG_AUDIO_L1_BITRATE:    return "Audio Layer I Bitrate";
0817     case V4L2_CID_MPEG_AUDIO_L2_BITRATE:    return "Audio Layer II Bitrate";
0818     case V4L2_CID_MPEG_AUDIO_L3_BITRATE:    return "Audio Layer III Bitrate";
0819     case V4L2_CID_MPEG_AUDIO_MODE:      return "Audio Stereo Mode";
0820     case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION: return "Audio Stereo Mode Extension";
0821     case V4L2_CID_MPEG_AUDIO_EMPHASIS:  return "Audio Emphasis";
0822     case V4L2_CID_MPEG_AUDIO_CRC:       return "Audio CRC";
0823     case V4L2_CID_MPEG_AUDIO_MUTE:      return "Audio Mute";
0824     case V4L2_CID_MPEG_AUDIO_AAC_BITRATE:   return "Audio AAC Bitrate";
0825     case V4L2_CID_MPEG_AUDIO_AC3_BITRATE:   return "Audio AC-3 Bitrate";
0826     case V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK:  return "Audio Playback";
0827     case V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK: return "Audio Multilingual Playback";
0828     case V4L2_CID_MPEG_VIDEO_ENCODING:  return "Video Encoding";
0829     case V4L2_CID_MPEG_VIDEO_ASPECT:    return "Video Aspect";
0830     case V4L2_CID_MPEG_VIDEO_B_FRAMES:  return "Video B Frames";
0831     case V4L2_CID_MPEG_VIDEO_GOP_SIZE:  return "Video GOP Size";
0832     case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:   return "Video GOP Closure";
0833     case V4L2_CID_MPEG_VIDEO_PULLDOWN:  return "Video Pulldown";
0834     case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:  return "Video Bitrate Mode";
0835     case V4L2_CID_MPEG_VIDEO_CONSTANT_QUALITY:  return "Constant Quality";
0836     case V4L2_CID_MPEG_VIDEO_BITRATE:   return "Video Bitrate";
0837     case V4L2_CID_MPEG_VIDEO_BITRATE_PEAK:  return "Video Peak Bitrate";
0838     case V4L2_CID_MPEG_VIDEO_TEMPORAL_DECIMATION: return "Video Temporal Decimation";
0839     case V4L2_CID_MPEG_VIDEO_MUTE:      return "Video Mute";
0840     case V4L2_CID_MPEG_VIDEO_MUTE_YUV:  return "Video Mute YUV";
0841     case V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE:   return "Decoder Slice Interface";
0842     case V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER:  return "MPEG4 Loop Filter Enable";
0843     case V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB:   return "Number of Intra Refresh MBs";
0844     case V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE: return "Intra Refresh Period Type";
0845     case V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD:      return "Intra Refresh Period";
0846     case V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE:       return "Frame Level Rate Control Enable";
0847     case V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE:          return "H264 MB Level Rate Control";
0848     case V4L2_CID_MPEG_VIDEO_HEADER_MODE:           return "Sequence Header Mode";
0849     case V4L2_CID_MPEG_VIDEO_MAX_REF_PIC:           return "Max Number of Reference Pics";
0850     case V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE:       return "Frame Skip Mode";
0851     case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY:     return "Display Delay";
0852     case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE:  return "Display Delay Enable";
0853     case V4L2_CID_MPEG_VIDEO_AU_DELIMITER:          return "Generate Access Unit Delimiters";
0854     case V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP:       return "H263 I-Frame QP Value";
0855     case V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP:       return "H263 P-Frame QP Value";
0856     case V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP:       return "H263 B-Frame QP Value";
0857     case V4L2_CID_MPEG_VIDEO_H263_MIN_QP:           return "H263 Minimum QP Value";
0858     case V4L2_CID_MPEG_VIDEO_H263_MAX_QP:           return "H263 Maximum QP Value";
0859     case V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP:       return "H264 I-Frame QP Value";
0860     case V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP:       return "H264 P-Frame QP Value";
0861     case V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP:       return "H264 B-Frame QP Value";
0862     case V4L2_CID_MPEG_VIDEO_H264_MAX_QP:           return "H264 Maximum QP Value";
0863     case V4L2_CID_MPEG_VIDEO_H264_MIN_QP:           return "H264 Minimum QP Value";
0864     case V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM:        return "H264 8x8 Transform Enable";
0865     case V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE:         return "H264 CPB Buffer Size";
0866     case V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE:     return "H264 Entropy Mode";
0867     case V4L2_CID_MPEG_VIDEO_H264_I_PERIOD:         return "H264 I-Frame Period";
0868     case V4L2_CID_MPEG_VIDEO_H264_LEVEL:            return "H264 Level";
0869     case V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA:    return "H264 Loop Filter Alpha Offset";
0870     case V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA:     return "H264 Loop Filter Beta Offset";
0871     case V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE:     return "H264 Loop Filter Mode";
0872     case V4L2_CID_MPEG_VIDEO_H264_PROFILE:          return "H264 Profile";
0873     case V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT:   return "Vertical Size of SAR";
0874     case V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH:    return "Horizontal Size of SAR";
0875     case V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE:       return "Aspect Ratio VUI Enable";
0876     case V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC:      return "VUI Aspect Ratio IDC";
0877     case V4L2_CID_MPEG_VIDEO_H264_SEI_FRAME_PACKING:    return "H264 Enable Frame Packing SEI";
0878     case V4L2_CID_MPEG_VIDEO_H264_SEI_FP_CURRENT_FRAME_0:   return "H264 Set Curr. Frame as Frame0";
0879     case V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE:  return "H264 FP Arrangement Type";
0880     case V4L2_CID_MPEG_VIDEO_H264_FMO:          return "H264 Flexible MB Ordering";
0881     case V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE:     return "H264 Map Type for FMO";
0882     case V4L2_CID_MPEG_VIDEO_H264_FMO_SLICE_GROUP:      return "H264 FMO Number of Slice Groups";
0883     case V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_DIRECTION: return "H264 FMO Direction of Change";
0884     case V4L2_CID_MPEG_VIDEO_H264_FMO_CHANGE_RATE:      return "H264 FMO Size of 1st Slice Grp";
0885     case V4L2_CID_MPEG_VIDEO_H264_FMO_RUN_LENGTH:       return "H264 FMO No. of Consecutive MBs";
0886     case V4L2_CID_MPEG_VIDEO_H264_ASO:          return "H264 Arbitrary Slice Ordering";
0887     case V4L2_CID_MPEG_VIDEO_H264_ASO_SLICE_ORDER:      return "H264 ASO Slice Order";
0888     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING:  return "Enable H264 Hierarchical Coding";
0889     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE: return "H264 Hierarchical Coding Type";
0890     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER:return "H264 Number of HC Layers";
0891     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_LAYER_QP:
0892                                 return "H264 Set QP Value for HC Layers";
0893     case V4L2_CID_MPEG_VIDEO_H264_CONSTRAINED_INTRA_PREDICTION:
0894                                 return "H264 Constrained Intra Pred";
0895     case V4L2_CID_MPEG_VIDEO_H264_CHROMA_QP_INDEX_OFFSET:   return "H264 Chroma QP Index Offset";
0896     case V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MIN_QP:       return "H264 I-Frame Minimum QP Value";
0897     case V4L2_CID_MPEG_VIDEO_H264_I_FRAME_MAX_QP:       return "H264 I-Frame Maximum QP Value";
0898     case V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MIN_QP:       return "H264 P-Frame Minimum QP Value";
0899     case V4L2_CID_MPEG_VIDEO_H264_P_FRAME_MAX_QP:       return "H264 P-Frame Maximum QP Value";
0900     case V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MIN_QP:       return "H264 B-Frame Minimum QP Value";
0901     case V4L2_CID_MPEG_VIDEO_H264_B_FRAME_MAX_QP:       return "H264 B-Frame Maximum QP Value";
0902     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L0_BR:    return "H264 Hierarchical Lay 0 Bitrate";
0903     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L1_BR:    return "H264 Hierarchical Lay 1 Bitrate";
0904     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L2_BR:    return "H264 Hierarchical Lay 2 Bitrate";
0905     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L3_BR:    return "H264 Hierarchical Lay 3 Bitrate";
0906     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L4_BR:    return "H264 Hierarchical Lay 4 Bitrate";
0907     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L5_BR:    return "H264 Hierarchical Lay 5 Bitrate";
0908     case V4L2_CID_MPEG_VIDEO_H264_HIER_CODING_L6_BR:    return "H264 Hierarchical Lay 6 Bitrate";
0909     case V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL:           return "MPEG2 Level";
0910     case V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE:         return "MPEG2 Profile";
0911     case V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP:      return "MPEG4 I-Frame QP Value";
0912     case V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP:      return "MPEG4 P-Frame QP Value";
0913     case V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP:      return "MPEG4 B-Frame QP Value";
0914     case V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP:          return "MPEG4 Minimum QP Value";
0915     case V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP:          return "MPEG4 Maximum QP Value";
0916     case V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL:           return "MPEG4 Level";
0917     case V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE:         return "MPEG4 Profile";
0918     case V4L2_CID_MPEG_VIDEO_MPEG4_QPEL:            return "Quarter Pixel Search Enable";
0919     case V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES:     return "Maximum Bytes in a Slice";
0920     case V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB:        return "Number of MBs in a Slice";
0921     case V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE:      return "Slice Partitioning Method";
0922     case V4L2_CID_MPEG_VIDEO_VBV_SIZE:          return "VBV Buffer Size";
0923     case V4L2_CID_MPEG_VIDEO_DEC_PTS:           return "Video Decoder PTS";
0924     case V4L2_CID_MPEG_VIDEO_DEC_FRAME:         return "Video Decoder Frame Count";
0925     case V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR:     return "Video Decoder Conceal Color";
0926     case V4L2_CID_MPEG_VIDEO_VBV_DELAY:         return "Initial Delay for VBV Control";
0927     case V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE:     return "Horizontal MV Search Range";
0928     case V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE:     return "Vertical MV Search Range";
0929     case V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER:     return "Repeat Sequence Header";
0930     case V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME:       return "Force Key Frame";
0931     case V4L2_CID_MPEG_VIDEO_BASELAYER_PRIORITY_ID:     return "Base Layer Priority ID";
0932     case V4L2_CID_MPEG_VIDEO_LTR_COUNT:         return "LTR Count";
0933     case V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX:       return "Frame LTR Index";
0934     case V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES:        return "Use LTR Frames";
0935     case V4L2_CID_FWHT_I_FRAME_QP:              return "FWHT I-Frame QP Value";
0936     case V4L2_CID_FWHT_P_FRAME_QP:              return "FWHT P-Frame QP Value";
0937 
0938     /* VPX controls */
0939     case V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS:        return "VPX Number of Partitions";
0940     case V4L2_CID_MPEG_VIDEO_VPX_IMD_DISABLE_4X4:       return "VPX Intra Mode Decision Disable";
0941     case V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES:        return "VPX No. of Refs for P Frame";
0942     case V4L2_CID_MPEG_VIDEO_VPX_FILTER_LEVEL:      return "VPX Loop Filter Level Range";
0943     case V4L2_CID_MPEG_VIDEO_VPX_FILTER_SHARPNESS:      return "VPX Deblocking Effect Control";
0944     case V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD:   return "VPX Golden Frame Refresh Period";
0945     case V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL:      return "VPX Golden Frame Indicator";
0946     case V4L2_CID_MPEG_VIDEO_VPX_MIN_QP:            return "VPX Minimum QP Value";
0947     case V4L2_CID_MPEG_VIDEO_VPX_MAX_QP:            return "VPX Maximum QP Value";
0948     case V4L2_CID_MPEG_VIDEO_VPX_I_FRAME_QP:        return "VPX I-Frame QP Value";
0949     case V4L2_CID_MPEG_VIDEO_VPX_P_FRAME_QP:        return "VPX P-Frame QP Value";
0950     case V4L2_CID_MPEG_VIDEO_VP8_PROFILE:           return "VP8 Profile";
0951     case V4L2_CID_MPEG_VIDEO_VP9_PROFILE:           return "VP9 Profile";
0952     case V4L2_CID_MPEG_VIDEO_VP9_LEVEL:         return "VP9 Level";
0953 
0954     /* HEVC controls */
0955     case V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_QP:       return "HEVC I-Frame QP Value";
0956     case V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_QP:       return "HEVC P-Frame QP Value";
0957     case V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_QP:       return "HEVC B-Frame QP Value";
0958     case V4L2_CID_MPEG_VIDEO_HEVC_MIN_QP:           return "HEVC Minimum QP Value";
0959     case V4L2_CID_MPEG_VIDEO_HEVC_MAX_QP:           return "HEVC Maximum QP Value";
0960     case V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MIN_QP:       return "HEVC I-Frame Minimum QP Value";
0961     case V4L2_CID_MPEG_VIDEO_HEVC_I_FRAME_MAX_QP:       return "HEVC I-Frame Maximum QP Value";
0962     case V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MIN_QP:       return "HEVC P-Frame Minimum QP Value";
0963     case V4L2_CID_MPEG_VIDEO_HEVC_P_FRAME_MAX_QP:       return "HEVC P-Frame Maximum QP Value";
0964     case V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MIN_QP:       return "HEVC B-Frame Minimum QP Value";
0965     case V4L2_CID_MPEG_VIDEO_HEVC_B_FRAME_MAX_QP:       return "HEVC B-Frame Maximum QP Value";
0966     case V4L2_CID_MPEG_VIDEO_HEVC_PROFILE:          return "HEVC Profile";
0967     case V4L2_CID_MPEG_VIDEO_HEVC_LEVEL:            return "HEVC Level";
0968     case V4L2_CID_MPEG_VIDEO_HEVC_TIER:         return "HEVC Tier";
0969     case V4L2_CID_MPEG_VIDEO_HEVC_FRAME_RATE_RESOLUTION:    return "HEVC Frame Rate Resolution";
0970     case V4L2_CID_MPEG_VIDEO_HEVC_MAX_PARTITION_DEPTH:  return "HEVC Maximum Coding Unit Depth";
0971     case V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE:     return "HEVC Refresh Type";
0972     case V4L2_CID_MPEG_VIDEO_HEVC_CONST_INTRA_PRED:     return "HEVC Constant Intra Prediction";
0973     case V4L2_CID_MPEG_VIDEO_HEVC_LOSSLESS_CU:      return "HEVC Lossless Encoding";
0974     case V4L2_CID_MPEG_VIDEO_HEVC_WAVEFRONT:        return "HEVC Wavefront";
0975     case V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE:     return "HEVC Loop Filter";
0976     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_QP:          return "HEVC QP Values";
0977     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE:     return "HEVC Hierarchical Coding Type";
0978     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_LAYER:    return "HEVC Hierarchical Coding Layer";
0979     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_QP:    return "HEVC Hierarchical Layer 0 QP";
0980     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_QP:    return "HEVC Hierarchical Layer 1 QP";
0981     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_QP:    return "HEVC Hierarchical Layer 2 QP";
0982     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_QP:    return "HEVC Hierarchical Layer 3 QP";
0983     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_QP:    return "HEVC Hierarchical Layer 4 QP";
0984     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_QP:    return "HEVC Hierarchical Layer 5 QP";
0985     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_QP:    return "HEVC Hierarchical Layer 6 QP";
0986     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L0_BR:    return "HEVC Hierarchical Lay 0 BitRate";
0987     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L1_BR:    return "HEVC Hierarchical Lay 1 BitRate";
0988     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L2_BR:    return "HEVC Hierarchical Lay 2 BitRate";
0989     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L3_BR:    return "HEVC Hierarchical Lay 3 BitRate";
0990     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L4_BR:    return "HEVC Hierarchical Lay 4 BitRate";
0991     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L5_BR:    return "HEVC Hierarchical Lay 5 BitRate";
0992     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_L6_BR:    return "HEVC Hierarchical Lay 6 BitRate";
0993     case V4L2_CID_MPEG_VIDEO_HEVC_GENERAL_PB:       return "HEVC General PB";
0994     case V4L2_CID_MPEG_VIDEO_HEVC_TEMPORAL_ID:      return "HEVC Temporal ID";
0995     case V4L2_CID_MPEG_VIDEO_HEVC_STRONG_SMOOTHING:     return "HEVC Strong Intra Smoothing";
0996     case V4L2_CID_MPEG_VIDEO_HEVC_INTRA_PU_SPLIT:       return "HEVC Intra PU Split";
0997     case V4L2_CID_MPEG_VIDEO_HEVC_TMV_PREDICTION:       return "HEVC TMV Prediction";
0998     case V4L2_CID_MPEG_VIDEO_HEVC_MAX_NUM_MERGE_MV_MINUS1:  return "HEVC Max Num of Candidate MVs";
0999     case V4L2_CID_MPEG_VIDEO_HEVC_WITHOUT_STARTCODE:    return "HEVC ENC Without Startcode";
1000     case V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_PERIOD:       return "HEVC Num of I-Frame b/w 2 IDR";
1001     case V4L2_CID_MPEG_VIDEO_HEVC_LF_BETA_OFFSET_DIV2:  return "HEVC Loop Filter Beta Offset";
1002     case V4L2_CID_MPEG_VIDEO_HEVC_LF_TC_OFFSET_DIV2:    return "HEVC Loop Filter TC Offset";
1003     case V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD: return "HEVC Size of Length Field";
1004     case V4L2_CID_MPEG_VIDEO_REF_NUMBER_FOR_PFRAMES:    return "Reference Frames for a P-Frame";
1005     case V4L2_CID_MPEG_VIDEO_PREPEND_SPSPPS_TO_IDR:     return "Prepend SPS and PPS to IDR";
1006 
1007     /* CAMERA controls */
1008     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1009     case V4L2_CID_CAMERA_CLASS:     return "Camera Controls";
1010     case V4L2_CID_EXPOSURE_AUTO:        return "Auto Exposure";
1011     case V4L2_CID_EXPOSURE_ABSOLUTE:    return "Exposure Time, Absolute";
1012     case V4L2_CID_EXPOSURE_AUTO_PRIORITY:   return "Exposure, Dynamic Framerate";
1013     case V4L2_CID_PAN_RELATIVE:     return "Pan, Relative";
1014     case V4L2_CID_TILT_RELATIVE:        return "Tilt, Relative";
1015     case V4L2_CID_PAN_RESET:        return "Pan, Reset";
1016     case V4L2_CID_TILT_RESET:       return "Tilt, Reset";
1017     case V4L2_CID_PAN_ABSOLUTE:     return "Pan, Absolute";
1018     case V4L2_CID_TILT_ABSOLUTE:        return "Tilt, Absolute";
1019     case V4L2_CID_FOCUS_ABSOLUTE:       return "Focus, Absolute";
1020     case V4L2_CID_FOCUS_RELATIVE:       return "Focus, Relative";
1021     case V4L2_CID_FOCUS_AUTO:       return "Focus, Automatic Continuous";
1022     case V4L2_CID_ZOOM_ABSOLUTE:        return "Zoom, Absolute";
1023     case V4L2_CID_ZOOM_RELATIVE:        return "Zoom, Relative";
1024     case V4L2_CID_ZOOM_CONTINUOUS:      return "Zoom, Continuous";
1025     case V4L2_CID_PRIVACY:          return "Privacy";
1026     case V4L2_CID_IRIS_ABSOLUTE:        return "Iris, Absolute";
1027     case V4L2_CID_IRIS_RELATIVE:        return "Iris, Relative";
1028     case V4L2_CID_AUTO_EXPOSURE_BIAS:   return "Auto Exposure, Bias";
1029     case V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE: return "White Balance, Auto & Preset";
1030     case V4L2_CID_WIDE_DYNAMIC_RANGE:   return "Wide Dynamic Range";
1031     case V4L2_CID_IMAGE_STABILIZATION:  return "Image Stabilization";
1032     case V4L2_CID_ISO_SENSITIVITY:      return "ISO Sensitivity";
1033     case V4L2_CID_ISO_SENSITIVITY_AUTO: return "ISO Sensitivity, Auto";
1034     case V4L2_CID_EXPOSURE_METERING:    return "Exposure, Metering Mode";
1035     case V4L2_CID_SCENE_MODE:       return "Scene Mode";
1036     case V4L2_CID_3A_LOCK:          return "3A Lock";
1037     case V4L2_CID_AUTO_FOCUS_START:     return "Auto Focus, Start";
1038     case V4L2_CID_AUTO_FOCUS_STOP:      return "Auto Focus, Stop";
1039     case V4L2_CID_AUTO_FOCUS_STATUS:    return "Auto Focus, Status";
1040     case V4L2_CID_AUTO_FOCUS_RANGE:     return "Auto Focus, Range";
1041     case V4L2_CID_PAN_SPEED:        return "Pan, Speed";
1042     case V4L2_CID_TILT_SPEED:       return "Tilt, Speed";
1043     case V4L2_CID_UNIT_CELL_SIZE:       return "Unit Cell Size";
1044     case V4L2_CID_CAMERA_ORIENTATION:   return "Camera Orientation";
1045     case V4L2_CID_CAMERA_SENSOR_ROTATION:   return "Camera Sensor Rotation";
1046 
1047     /* FM Radio Modulator controls */
1048     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1049     case V4L2_CID_FM_TX_CLASS:      return "FM Radio Modulator Controls";
1050     case V4L2_CID_RDS_TX_DEVIATION:     return "RDS Signal Deviation";
1051     case V4L2_CID_RDS_TX_PI:        return "RDS Program ID";
1052     case V4L2_CID_RDS_TX_PTY:       return "RDS Program Type";
1053     case V4L2_CID_RDS_TX_PS_NAME:       return "RDS PS Name";
1054     case V4L2_CID_RDS_TX_RADIO_TEXT:    return "RDS Radio Text";
1055     case V4L2_CID_RDS_TX_MONO_STEREO:   return "RDS Stereo";
1056     case V4L2_CID_RDS_TX_ARTIFICIAL_HEAD:   return "RDS Artificial Head";
1057     case V4L2_CID_RDS_TX_COMPRESSED:    return "RDS Compressed";
1058     case V4L2_CID_RDS_TX_DYNAMIC_PTY:   return "RDS Dynamic PTY";
1059     case V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT: return "RDS Traffic Announcement";
1060     case V4L2_CID_RDS_TX_TRAFFIC_PROGRAM:   return "RDS Traffic Program";
1061     case V4L2_CID_RDS_TX_MUSIC_SPEECH:  return "RDS Music";
1062     case V4L2_CID_RDS_TX_ALT_FREQS_ENABLE:  return "RDS Enable Alt Frequencies";
1063     case V4L2_CID_RDS_TX_ALT_FREQS:     return "RDS Alternate Frequencies";
1064     case V4L2_CID_AUDIO_LIMITER_ENABLED:    return "Audio Limiter Feature Enabled";
1065     case V4L2_CID_AUDIO_LIMITER_RELEASE_TIME: return "Audio Limiter Release Time";
1066     case V4L2_CID_AUDIO_LIMITER_DEVIATION:  return "Audio Limiter Deviation";
1067     case V4L2_CID_AUDIO_COMPRESSION_ENABLED: return "Audio Compression Enabled";
1068     case V4L2_CID_AUDIO_COMPRESSION_GAIN:   return "Audio Compression Gain";
1069     case V4L2_CID_AUDIO_COMPRESSION_THRESHOLD: return "Audio Compression Threshold";
1070     case V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME: return "Audio Compression Attack Time";
1071     case V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME: return "Audio Compression Release Time";
1072     case V4L2_CID_PILOT_TONE_ENABLED:   return "Pilot Tone Feature Enabled";
1073     case V4L2_CID_PILOT_TONE_DEVIATION: return "Pilot Tone Deviation";
1074     case V4L2_CID_PILOT_TONE_FREQUENCY: return "Pilot Tone Frequency";
1075     case V4L2_CID_TUNE_PREEMPHASIS:     return "Pre-Emphasis";
1076     case V4L2_CID_TUNE_POWER_LEVEL:     return "Tune Power Level";
1077     case V4L2_CID_TUNE_ANTENNA_CAPACITOR:   return "Tune Antenna Capacitor";
1078 
1079     /* Flash controls */
1080     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1081     case V4L2_CID_FLASH_CLASS:      return "Flash Controls";
1082     case V4L2_CID_FLASH_LED_MODE:       return "LED Mode";
1083     case V4L2_CID_FLASH_STROBE_SOURCE:  return "Strobe Source";
1084     case V4L2_CID_FLASH_STROBE:     return "Strobe";
1085     case V4L2_CID_FLASH_STROBE_STOP:    return "Stop Strobe";
1086     case V4L2_CID_FLASH_STROBE_STATUS:  return "Strobe Status";
1087     case V4L2_CID_FLASH_TIMEOUT:        return "Strobe Timeout";
1088     case V4L2_CID_FLASH_INTENSITY:      return "Intensity, Flash Mode";
1089     case V4L2_CID_FLASH_TORCH_INTENSITY:    return "Intensity, Torch Mode";
1090     case V4L2_CID_FLASH_INDICATOR_INTENSITY: return "Intensity, Indicator";
1091     case V4L2_CID_FLASH_FAULT:      return "Faults";
1092     case V4L2_CID_FLASH_CHARGE:     return "Charge";
1093     case V4L2_CID_FLASH_READY:      return "Ready to Strobe";
1094 
1095     /* JPEG encoder controls */
1096     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1097     case V4L2_CID_JPEG_CLASS:       return "JPEG Compression Controls";
1098     case V4L2_CID_JPEG_CHROMA_SUBSAMPLING:  return "Chroma Subsampling";
1099     case V4L2_CID_JPEG_RESTART_INTERVAL:    return "Restart Interval";
1100     case V4L2_CID_JPEG_COMPRESSION_QUALITY: return "Compression Quality";
1101     case V4L2_CID_JPEG_ACTIVE_MARKER:   return "Active Markers";
1102 
1103     /* Image source controls */
1104     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1105     case V4L2_CID_IMAGE_SOURCE_CLASS:   return "Image Source Controls";
1106     case V4L2_CID_VBLANK:           return "Vertical Blanking";
1107     case V4L2_CID_HBLANK:           return "Horizontal Blanking";
1108     case V4L2_CID_ANALOGUE_GAIN:        return "Analogue Gain";
1109     case V4L2_CID_TEST_PATTERN_RED:     return "Red Pixel Value";
1110     case V4L2_CID_TEST_PATTERN_GREENR:  return "Green (Red) Pixel Value";
1111     case V4L2_CID_TEST_PATTERN_BLUE:    return "Blue Pixel Value";
1112     case V4L2_CID_TEST_PATTERN_GREENB:  return "Green (Blue) Pixel Value";
1113     case V4L2_CID_NOTIFY_GAINS:     return "Notify Gains";
1114 
1115     /* Image processing controls */
1116     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1117     case V4L2_CID_IMAGE_PROC_CLASS:     return "Image Processing Controls";
1118     case V4L2_CID_LINK_FREQ:        return "Link Frequency";
1119     case V4L2_CID_PIXEL_RATE:       return "Pixel Rate";
1120     case V4L2_CID_TEST_PATTERN:     return "Test Pattern";
1121     case V4L2_CID_DEINTERLACING_MODE:   return "Deinterlacing Mode";
1122     case V4L2_CID_DIGITAL_GAIN:     return "Digital Gain";
1123 
1124     /* DV controls */
1125     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1126     case V4L2_CID_DV_CLASS:         return "Digital Video Controls";
1127     case V4L2_CID_DV_TX_HOTPLUG:        return "Hotplug Present";
1128     case V4L2_CID_DV_TX_RXSENSE:        return "RxSense Present";
1129     case V4L2_CID_DV_TX_EDID_PRESENT:   return "EDID Present";
1130     case V4L2_CID_DV_TX_MODE:       return "Transmit Mode";
1131     case V4L2_CID_DV_TX_RGB_RANGE:      return "Tx RGB Quantization Range";
1132     case V4L2_CID_DV_TX_IT_CONTENT_TYPE:    return "Tx IT Content Type";
1133     case V4L2_CID_DV_RX_POWER_PRESENT:  return "Power Present";
1134     case V4L2_CID_DV_RX_RGB_RANGE:      return "Rx RGB Quantization Range";
1135     case V4L2_CID_DV_RX_IT_CONTENT_TYPE:    return "Rx IT Content Type";
1136 
1137     case V4L2_CID_FM_RX_CLASS:      return "FM Radio Receiver Controls";
1138     case V4L2_CID_TUNE_DEEMPHASIS:      return "De-Emphasis";
1139     case V4L2_CID_RDS_RECEPTION:        return "RDS Reception";
1140     case V4L2_CID_RF_TUNER_CLASS:       return "RF Tuner Controls";
1141     case V4L2_CID_RF_TUNER_RF_GAIN:     return "RF Gain";
1142     case V4L2_CID_RF_TUNER_LNA_GAIN_AUTO:   return "LNA Gain, Auto";
1143     case V4L2_CID_RF_TUNER_LNA_GAIN:    return "LNA Gain";
1144     case V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO: return "Mixer Gain, Auto";
1145     case V4L2_CID_RF_TUNER_MIXER_GAIN:  return "Mixer Gain";
1146     case V4L2_CID_RF_TUNER_IF_GAIN_AUTO:    return "IF Gain, Auto";
1147     case V4L2_CID_RF_TUNER_IF_GAIN:     return "IF Gain";
1148     case V4L2_CID_RF_TUNER_BANDWIDTH_AUTO:  return "Bandwidth, Auto";
1149     case V4L2_CID_RF_TUNER_BANDWIDTH:   return "Bandwidth";
1150     case V4L2_CID_RF_TUNER_PLL_LOCK:    return "PLL Lock";
1151     case V4L2_CID_RDS_RX_PTY:       return "RDS Program Type";
1152     case V4L2_CID_RDS_RX_PS_NAME:       return "RDS PS Name";
1153     case V4L2_CID_RDS_RX_RADIO_TEXT:    return "RDS Radio Text";
1154     case V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT: return "RDS Traffic Announcement";
1155     case V4L2_CID_RDS_RX_TRAFFIC_PROGRAM:   return "RDS Traffic Program";
1156     case V4L2_CID_RDS_RX_MUSIC_SPEECH:  return "RDS Music";
1157 
1158     /* Detection controls */
1159     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1160     case V4L2_CID_DETECT_CLASS:     return "Detection Controls";
1161     case V4L2_CID_DETECT_MD_MODE:       return "Motion Detection Mode";
1162     case V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD: return "MD Global Threshold";
1163     case V4L2_CID_DETECT_MD_THRESHOLD_GRID: return "MD Threshold Grid";
1164     case V4L2_CID_DETECT_MD_REGION_GRID:    return "MD Region Grid";
1165 
1166     /* Stateless Codec controls */
1167     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1168     case V4L2_CID_CODEC_STATELESS_CLASS:    return "Stateless Codec Controls";
1169     case V4L2_CID_STATELESS_H264_DECODE_MODE:       return "H264 Decode Mode";
1170     case V4L2_CID_STATELESS_H264_START_CODE:        return "H264 Start Code";
1171     case V4L2_CID_STATELESS_H264_SPS:           return "H264 Sequence Parameter Set";
1172     case V4L2_CID_STATELESS_H264_PPS:           return "H264 Picture Parameter Set";
1173     case V4L2_CID_STATELESS_H264_SCALING_MATRIX:        return "H264 Scaling Matrix";
1174     case V4L2_CID_STATELESS_H264_PRED_WEIGHTS:      return "H264 Prediction Weight Table";
1175     case V4L2_CID_STATELESS_H264_SLICE_PARAMS:      return "H264 Slice Parameters";
1176     case V4L2_CID_STATELESS_H264_DECODE_PARAMS:     return "H264 Decode Parameters";
1177     case V4L2_CID_STATELESS_FWHT_PARAMS:            return "FWHT Stateless Parameters";
1178     case V4L2_CID_STATELESS_VP8_FRAME:          return "VP8 Frame Parameters";
1179     case V4L2_CID_STATELESS_MPEG2_SEQUENCE:         return "MPEG-2 Sequence Header";
1180     case V4L2_CID_STATELESS_MPEG2_PICTURE:          return "MPEG-2 Picture Header";
1181     case V4L2_CID_STATELESS_MPEG2_QUANTISATION:     return "MPEG-2 Quantisation Matrices";
1182     case V4L2_CID_STATELESS_VP9_COMPRESSED_HDR: return "VP9 Probabilities Updates";
1183     case V4L2_CID_STATELESS_VP9_FRAME:          return "VP9 Frame Decode Parameters";
1184     case V4L2_CID_STATELESS_HEVC_SPS:           return "HEVC Sequence Parameter Set";
1185     case V4L2_CID_STATELESS_HEVC_PPS:           return "HEVC Picture Parameter Set";
1186     case V4L2_CID_STATELESS_HEVC_SLICE_PARAMS:      return "HEVC Slice Parameters";
1187     case V4L2_CID_STATELESS_HEVC_SCALING_MATRIX:        return "HEVC Scaling Matrix";
1188     case V4L2_CID_STATELESS_HEVC_DECODE_PARAMS:     return "HEVC Decode Parameters";
1189     case V4L2_CID_STATELESS_HEVC_DECODE_MODE:       return "HEVC Decode Mode";
1190     case V4L2_CID_STATELESS_HEVC_START_CODE:        return "HEVC Start Code";
1191     case V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS:   return "HEVC Entry Point Offsets";
1192 
1193     /* Colorimetry controls */
1194     /* Keep the order of the 'case's the same as in v4l2-controls.h! */
1195     case V4L2_CID_COLORIMETRY_CLASS:    return "Colorimetry Controls";
1196     case V4L2_CID_COLORIMETRY_HDR10_CLL_INFO:       return "HDR10 Content Light Info";
1197     case V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY:  return "HDR10 Mastering Display";
1198     default:
1199         return NULL;
1200     }
1201 }
1202 EXPORT_SYMBOL(v4l2_ctrl_get_name);
1203 
1204 void v4l2_ctrl_fill(u32 id, const char **name, enum v4l2_ctrl_type *type,
1205             s64 *min, s64 *max, u64 *step, s64 *def, u32 *flags)
1206 {
1207     *name = v4l2_ctrl_get_name(id);
1208     *flags = 0;
1209 
1210     switch (id) {
1211     case V4L2_CID_AUDIO_MUTE:
1212     case V4L2_CID_AUDIO_LOUDNESS:
1213     case V4L2_CID_AUTO_WHITE_BALANCE:
1214     case V4L2_CID_AUTOGAIN:
1215     case V4L2_CID_HFLIP:
1216     case V4L2_CID_VFLIP:
1217     case V4L2_CID_HUE_AUTO:
1218     case V4L2_CID_CHROMA_AGC:
1219     case V4L2_CID_COLOR_KILLER:
1220     case V4L2_CID_AUTOBRIGHTNESS:
1221     case V4L2_CID_MPEG_AUDIO_MUTE:
1222     case V4L2_CID_MPEG_VIDEO_MUTE:
1223     case V4L2_CID_MPEG_VIDEO_GOP_CLOSURE:
1224     case V4L2_CID_MPEG_VIDEO_PULLDOWN:
1225     case V4L2_CID_EXPOSURE_AUTO_PRIORITY:
1226     case V4L2_CID_FOCUS_AUTO:
1227     case V4L2_CID_PRIVACY:
1228     case V4L2_CID_AUDIO_LIMITER_ENABLED:
1229     case V4L2_CID_AUDIO_COMPRESSION_ENABLED:
1230     case V4L2_CID_PILOT_TONE_ENABLED:
1231     case V4L2_CID_ILLUMINATORS_1:
1232     case V4L2_CID_ILLUMINATORS_2:
1233     case V4L2_CID_FLASH_STROBE_STATUS:
1234     case V4L2_CID_FLASH_CHARGE:
1235     case V4L2_CID_FLASH_READY:
1236     case V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER:
1237     case V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE:
1238     case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY_ENABLE:
1239     case V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE:
1240     case V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE:
1241     case V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM:
1242     case V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE:
1243     case V4L2_CID_MPEG_VIDEO_MPEG4_QPEL:
1244     case V4L2_CID_MPEG_VIDEO_REPEAT_SEQ_HEADER:
1245     case V4L2_CID_MPEG_VIDEO_AU_DELIMITER:
1246     case V4L2_CID_WIDE_DYNAMIC_RANGE:
1247     case V4L2_CID_IMAGE_STABILIZATION:
1248     case V4L2_CID_RDS_RECEPTION:
1249     case V4L2_CID_RF_TUNER_LNA_GAIN_AUTO:
1250     case V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO:
1251     case V4L2_CID_RF_TUNER_IF_GAIN_AUTO:
1252     case V4L2_CID_RF_TUNER_BANDWIDTH_AUTO:
1253     case V4L2_CID_RF_TUNER_PLL_LOCK:
1254     case V4L2_CID_RDS_TX_MONO_STEREO:
1255     case V4L2_CID_RDS_TX_ARTIFICIAL_HEAD:
1256     case V4L2_CID_RDS_TX_COMPRESSED:
1257     case V4L2_CID_RDS_TX_DYNAMIC_PTY:
1258     case V4L2_CID_RDS_TX_TRAFFIC_ANNOUNCEMENT:
1259     case V4L2_CID_RDS_TX_TRAFFIC_PROGRAM:
1260     case V4L2_CID_RDS_TX_MUSIC_SPEECH:
1261     case V4L2_CID_RDS_TX_ALT_FREQS_ENABLE:
1262     case V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT:
1263     case V4L2_CID_RDS_RX_TRAFFIC_PROGRAM:
1264     case V4L2_CID_RDS_RX_MUSIC_SPEECH:
1265         *type = V4L2_CTRL_TYPE_BOOLEAN;
1266         *min = 0;
1267         *max = *step = 1;
1268         break;
1269     case V4L2_CID_ROTATE:
1270         *type = V4L2_CTRL_TYPE_INTEGER;
1271         *flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
1272         break;
1273     case V4L2_CID_MPEG_VIDEO_MV_H_SEARCH_RANGE:
1274     case V4L2_CID_MPEG_VIDEO_MV_V_SEARCH_RANGE:
1275     case V4L2_CID_MPEG_VIDEO_DEC_DISPLAY_DELAY:
1276     case V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD:
1277         *type = V4L2_CTRL_TYPE_INTEGER;
1278         break;
1279     case V4L2_CID_MPEG_VIDEO_LTR_COUNT:
1280         *type = V4L2_CTRL_TYPE_INTEGER;
1281         break;
1282     case V4L2_CID_MPEG_VIDEO_FRAME_LTR_INDEX:
1283         *type = V4L2_CTRL_TYPE_INTEGER;
1284         *flags |= V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
1285         break;
1286     case V4L2_CID_MPEG_VIDEO_USE_LTR_FRAMES:
1287         *type = V4L2_CTRL_TYPE_BITMASK;
1288         *flags |= V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
1289         break;
1290     case V4L2_CID_MPEG_VIDEO_FORCE_KEY_FRAME:
1291     case V4L2_CID_PAN_RESET:
1292     case V4L2_CID_TILT_RESET:
1293     case V4L2_CID_FLASH_STROBE:
1294     case V4L2_CID_FLASH_STROBE_STOP:
1295     case V4L2_CID_AUTO_FOCUS_START:
1296     case V4L2_CID_AUTO_FOCUS_STOP:
1297     case V4L2_CID_DO_WHITE_BALANCE:
1298         *type = V4L2_CTRL_TYPE_BUTTON;
1299         *flags |= V4L2_CTRL_FLAG_WRITE_ONLY |
1300               V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
1301         *min = *max = *step = *def = 0;
1302         break;
1303     case V4L2_CID_POWER_LINE_FREQUENCY:
1304     case V4L2_CID_MPEG_AUDIO_SAMPLING_FREQ:
1305     case V4L2_CID_MPEG_AUDIO_ENCODING:
1306     case V4L2_CID_MPEG_AUDIO_L1_BITRATE:
1307     case V4L2_CID_MPEG_AUDIO_L2_BITRATE:
1308     case V4L2_CID_MPEG_AUDIO_L3_BITRATE:
1309     case V4L2_CID_MPEG_AUDIO_AC3_BITRATE:
1310     case V4L2_CID_MPEG_AUDIO_MODE:
1311     case V4L2_CID_MPEG_AUDIO_MODE_EXTENSION:
1312     case V4L2_CID_MPEG_AUDIO_EMPHASIS:
1313     case V4L2_CID_MPEG_AUDIO_CRC:
1314     case V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK:
1315     case V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK:
1316     case V4L2_CID_MPEG_VIDEO_ENCODING:
1317     case V4L2_CID_MPEG_VIDEO_ASPECT:
1318     case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
1319     case V4L2_CID_MPEG_STREAM_TYPE:
1320     case V4L2_CID_MPEG_STREAM_VBI_FMT:
1321     case V4L2_CID_EXPOSURE_AUTO:
1322     case V4L2_CID_AUTO_FOCUS_RANGE:
1323     case V4L2_CID_COLORFX:
1324     case V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE:
1325     case V4L2_CID_TUNE_PREEMPHASIS:
1326     case V4L2_CID_FLASH_LED_MODE:
1327     case V4L2_CID_FLASH_STROBE_SOURCE:
1328     case V4L2_CID_MPEG_VIDEO_HEADER_MODE:
1329     case V4L2_CID_MPEG_VIDEO_FRAME_SKIP_MODE:
1330     case V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE:
1331     case V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE:
1332     case V4L2_CID_MPEG_VIDEO_H264_LEVEL:
1333     case V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE:
1334     case V4L2_CID_MPEG_VIDEO_H264_PROFILE:
1335     case V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC:
1336     case V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE:
1337     case V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE:
1338     case V4L2_CID_MPEG_VIDEO_H264_HIERARCHICAL_CODING_TYPE:
1339     case V4L2_CID_MPEG_VIDEO_MPEG2_LEVEL:
1340     case V4L2_CID_MPEG_VIDEO_MPEG2_PROFILE:
1341     case V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL:
1342     case V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE:
1343     case V4L2_CID_JPEG_CHROMA_SUBSAMPLING:
1344     case V4L2_CID_ISO_SENSITIVITY_AUTO:
1345     case V4L2_CID_EXPOSURE_METERING:
1346     case V4L2_CID_SCENE_MODE:
1347     case V4L2_CID_DV_TX_MODE:
1348     case V4L2_CID_DV_TX_RGB_RANGE:
1349     case V4L2_CID_DV_TX_IT_CONTENT_TYPE:
1350     case V4L2_CID_DV_RX_RGB_RANGE:
1351     case V4L2_CID_DV_RX_IT_CONTENT_TYPE:
1352     case V4L2_CID_TEST_PATTERN:
1353     case V4L2_CID_DEINTERLACING_MODE:
1354     case V4L2_CID_TUNE_DEEMPHASIS:
1355     case V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL:
1356     case V4L2_CID_MPEG_VIDEO_VP8_PROFILE:
1357     case V4L2_CID_MPEG_VIDEO_VP9_PROFILE:
1358     case V4L2_CID_MPEG_VIDEO_VP9_LEVEL:
1359     case V4L2_CID_DETECT_MD_MODE:
1360     case V4L2_CID_MPEG_VIDEO_HEVC_PROFILE:
1361     case V4L2_CID_MPEG_VIDEO_HEVC_LEVEL:
1362     case V4L2_CID_MPEG_VIDEO_HEVC_HIER_CODING_TYPE:
1363     case V4L2_CID_MPEG_VIDEO_HEVC_REFRESH_TYPE:
1364     case V4L2_CID_MPEG_VIDEO_HEVC_SIZE_OF_LENGTH_FIELD:
1365     case V4L2_CID_MPEG_VIDEO_HEVC_TIER:
1366     case V4L2_CID_MPEG_VIDEO_HEVC_LOOP_FILTER_MODE:
1367     case V4L2_CID_STATELESS_HEVC_DECODE_MODE:
1368     case V4L2_CID_STATELESS_HEVC_START_CODE:
1369     case V4L2_CID_STATELESS_H264_DECODE_MODE:
1370     case V4L2_CID_STATELESS_H264_START_CODE:
1371     case V4L2_CID_CAMERA_ORIENTATION:
1372     case V4L2_CID_MPEG_VIDEO_INTRA_REFRESH_PERIOD_TYPE:
1373         *type = V4L2_CTRL_TYPE_MENU;
1374         break;
1375     case V4L2_CID_LINK_FREQ:
1376         *type = V4L2_CTRL_TYPE_INTEGER_MENU;
1377         break;
1378     case V4L2_CID_RDS_TX_PS_NAME:
1379     case V4L2_CID_RDS_TX_RADIO_TEXT:
1380     case V4L2_CID_RDS_RX_PS_NAME:
1381     case V4L2_CID_RDS_RX_RADIO_TEXT:
1382         *type = V4L2_CTRL_TYPE_STRING;
1383         break;
1384     case V4L2_CID_ISO_SENSITIVITY:
1385     case V4L2_CID_AUTO_EXPOSURE_BIAS:
1386     case V4L2_CID_MPEG_VIDEO_VPX_NUM_PARTITIONS:
1387     case V4L2_CID_MPEG_VIDEO_VPX_NUM_REF_FRAMES:
1388         *type = V4L2_CTRL_TYPE_INTEGER_MENU;
1389         break;
1390     case V4L2_CID_USER_CLASS:
1391     case V4L2_CID_CAMERA_CLASS:
1392     case V4L2_CID_CODEC_CLASS:
1393     case V4L2_CID_FM_TX_CLASS:
1394     case V4L2_CID_FLASH_CLASS:
1395     case V4L2_CID_JPEG_CLASS:
1396     case V4L2_CID_IMAGE_SOURCE_CLASS:
1397     case V4L2_CID_IMAGE_PROC_CLASS:
1398     case V4L2_CID_DV_CLASS:
1399     case V4L2_CID_FM_RX_CLASS:
1400     case V4L2_CID_RF_TUNER_CLASS:
1401     case V4L2_CID_DETECT_CLASS:
1402     case V4L2_CID_CODEC_STATELESS_CLASS:
1403     case V4L2_CID_COLORIMETRY_CLASS:
1404         *type = V4L2_CTRL_TYPE_CTRL_CLASS;
1405         /* You can neither read nor write these */
1406         *flags |= V4L2_CTRL_FLAG_READ_ONLY | V4L2_CTRL_FLAG_WRITE_ONLY;
1407         *min = *max = *step = *def = 0;
1408         break;
1409     case V4L2_CID_BG_COLOR:
1410     case V4L2_CID_COLORFX_RGB:
1411         *type = V4L2_CTRL_TYPE_INTEGER;
1412         *step = 1;
1413         *min = 0;
1414         /* Max is calculated as RGB888 that is 2^24 - 1 */
1415         *max = 0xffffff;
1416         break;
1417     case V4L2_CID_COLORFX_CBCR:
1418         *type = V4L2_CTRL_TYPE_INTEGER;
1419         *step = 1;
1420         *min = 0;
1421         *max = 0xffff;
1422         break;
1423     case V4L2_CID_FLASH_FAULT:
1424     case V4L2_CID_JPEG_ACTIVE_MARKER:
1425     case V4L2_CID_3A_LOCK:
1426     case V4L2_CID_AUTO_FOCUS_STATUS:
1427     case V4L2_CID_DV_TX_HOTPLUG:
1428     case V4L2_CID_DV_TX_RXSENSE:
1429     case V4L2_CID_DV_TX_EDID_PRESENT:
1430     case V4L2_CID_DV_RX_POWER_PRESENT:
1431         *type = V4L2_CTRL_TYPE_BITMASK;
1432         break;
1433     case V4L2_CID_MIN_BUFFERS_FOR_CAPTURE:
1434     case V4L2_CID_MIN_BUFFERS_FOR_OUTPUT:
1435         *type = V4L2_CTRL_TYPE_INTEGER;
1436         *flags |= V4L2_CTRL_FLAG_READ_ONLY;
1437         break;
1438     case V4L2_CID_MPEG_VIDEO_DEC_PTS:
1439         *type = V4L2_CTRL_TYPE_INTEGER64;
1440         *flags |= V4L2_CTRL_FLAG_VOLATILE | V4L2_CTRL_FLAG_READ_ONLY;
1441         *min = *def = 0;
1442         *max = 0x1ffffffffLL;
1443         *step = 1;
1444         break;
1445     case V4L2_CID_MPEG_VIDEO_DEC_FRAME:
1446         *type = V4L2_CTRL_TYPE_INTEGER64;
1447         *flags |= V4L2_CTRL_FLAG_VOLATILE | V4L2_CTRL_FLAG_READ_ONLY;
1448         *min = *def = 0;
1449         *max = 0x7fffffffffffffffLL;
1450         *step = 1;
1451         break;
1452     case V4L2_CID_MPEG_VIDEO_DEC_CONCEAL_COLOR:
1453         *type = V4L2_CTRL_TYPE_INTEGER64;
1454         *min = 0;
1455         /* default for 8 bit black, luma is 16, chroma is 128 */
1456         *def = 0x8000800010LL;
1457         *max = 0xffffffffffffLL;
1458         *step = 1;
1459         break;
1460     case V4L2_CID_PIXEL_RATE:
1461         *type = V4L2_CTRL_TYPE_INTEGER64;
1462         *flags |= V4L2_CTRL_FLAG_READ_ONLY;
1463         break;
1464     case V4L2_CID_DETECT_MD_REGION_GRID:
1465         *type = V4L2_CTRL_TYPE_U8;
1466         break;
1467     case V4L2_CID_DETECT_MD_THRESHOLD_GRID:
1468         *type = V4L2_CTRL_TYPE_U16;
1469         break;
1470     case V4L2_CID_RDS_TX_ALT_FREQS:
1471         *type = V4L2_CTRL_TYPE_U32;
1472         break;
1473     case V4L2_CID_STATELESS_MPEG2_SEQUENCE:
1474         *type = V4L2_CTRL_TYPE_MPEG2_SEQUENCE;
1475         break;
1476     case V4L2_CID_STATELESS_MPEG2_PICTURE:
1477         *type = V4L2_CTRL_TYPE_MPEG2_PICTURE;
1478         break;
1479     case V4L2_CID_STATELESS_MPEG2_QUANTISATION:
1480         *type = V4L2_CTRL_TYPE_MPEG2_QUANTISATION;
1481         break;
1482     case V4L2_CID_STATELESS_FWHT_PARAMS:
1483         *type = V4L2_CTRL_TYPE_FWHT_PARAMS;
1484         break;
1485     case V4L2_CID_STATELESS_H264_SPS:
1486         *type = V4L2_CTRL_TYPE_H264_SPS;
1487         break;
1488     case V4L2_CID_STATELESS_H264_PPS:
1489         *type = V4L2_CTRL_TYPE_H264_PPS;
1490         break;
1491     case V4L2_CID_STATELESS_H264_SCALING_MATRIX:
1492         *type = V4L2_CTRL_TYPE_H264_SCALING_MATRIX;
1493         break;
1494     case V4L2_CID_STATELESS_H264_SLICE_PARAMS:
1495         *type = V4L2_CTRL_TYPE_H264_SLICE_PARAMS;
1496         break;
1497     case V4L2_CID_STATELESS_H264_DECODE_PARAMS:
1498         *type = V4L2_CTRL_TYPE_H264_DECODE_PARAMS;
1499         break;
1500     case V4L2_CID_STATELESS_H264_PRED_WEIGHTS:
1501         *type = V4L2_CTRL_TYPE_H264_PRED_WEIGHTS;
1502         break;
1503     case V4L2_CID_STATELESS_VP8_FRAME:
1504         *type = V4L2_CTRL_TYPE_VP8_FRAME;
1505         break;
1506     case V4L2_CID_STATELESS_HEVC_SPS:
1507         *type = V4L2_CTRL_TYPE_HEVC_SPS;
1508         break;
1509     case V4L2_CID_STATELESS_HEVC_PPS:
1510         *type = V4L2_CTRL_TYPE_HEVC_PPS;
1511         break;
1512     case V4L2_CID_STATELESS_HEVC_SLICE_PARAMS:
1513         *type = V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS;
1514         *flags |= V4L2_CTRL_FLAG_DYNAMIC_ARRAY;
1515         break;
1516     case V4L2_CID_STATELESS_HEVC_SCALING_MATRIX:
1517         *type = V4L2_CTRL_TYPE_HEVC_SCALING_MATRIX;
1518         break;
1519     case V4L2_CID_STATELESS_HEVC_DECODE_PARAMS:
1520         *type = V4L2_CTRL_TYPE_HEVC_DECODE_PARAMS;
1521         break;
1522     case V4L2_CID_STATELESS_HEVC_ENTRY_POINT_OFFSETS:
1523         *type = V4L2_CTRL_TYPE_U32;
1524         *flags |= V4L2_CTRL_FLAG_DYNAMIC_ARRAY;
1525         break;
1526     case V4L2_CID_STATELESS_VP9_COMPRESSED_HDR:
1527         *type = V4L2_CTRL_TYPE_VP9_COMPRESSED_HDR;
1528         break;
1529     case V4L2_CID_STATELESS_VP9_FRAME:
1530         *type = V4L2_CTRL_TYPE_VP9_FRAME;
1531         break;
1532     case V4L2_CID_UNIT_CELL_SIZE:
1533         *type = V4L2_CTRL_TYPE_AREA;
1534         *flags |= V4L2_CTRL_FLAG_READ_ONLY;
1535         break;
1536     case V4L2_CID_COLORIMETRY_HDR10_CLL_INFO:
1537         *type = V4L2_CTRL_TYPE_HDR10_CLL_INFO;
1538         break;
1539     case V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY:
1540         *type = V4L2_CTRL_TYPE_HDR10_MASTERING_DISPLAY;
1541         break;
1542     default:
1543         *type = V4L2_CTRL_TYPE_INTEGER;
1544         break;
1545     }
1546     switch (id) {
1547     case V4L2_CID_MPEG_AUDIO_ENCODING:
1548     case V4L2_CID_MPEG_AUDIO_MODE:
1549     case V4L2_CID_MPEG_VIDEO_BITRATE_MODE:
1550     case V4L2_CID_MPEG_VIDEO_B_FRAMES:
1551     case V4L2_CID_MPEG_STREAM_TYPE:
1552         *flags |= V4L2_CTRL_FLAG_UPDATE;
1553         break;
1554     case V4L2_CID_AUDIO_VOLUME:
1555     case V4L2_CID_AUDIO_BALANCE:
1556     case V4L2_CID_AUDIO_BASS:
1557     case V4L2_CID_AUDIO_TREBLE:
1558     case V4L2_CID_BRIGHTNESS:
1559     case V4L2_CID_CONTRAST:
1560     case V4L2_CID_SATURATION:
1561     case V4L2_CID_HUE:
1562     case V4L2_CID_RED_BALANCE:
1563     case V4L2_CID_BLUE_BALANCE:
1564     case V4L2_CID_GAMMA:
1565     case V4L2_CID_SHARPNESS:
1566     case V4L2_CID_CHROMA_GAIN:
1567     case V4L2_CID_RDS_TX_DEVIATION:
1568     case V4L2_CID_AUDIO_LIMITER_RELEASE_TIME:
1569     case V4L2_CID_AUDIO_LIMITER_DEVIATION:
1570     case V4L2_CID_AUDIO_COMPRESSION_GAIN:
1571     case V4L2_CID_AUDIO_COMPRESSION_THRESHOLD:
1572     case V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME:
1573     case V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME:
1574     case V4L2_CID_PILOT_TONE_DEVIATION:
1575     case V4L2_CID_PILOT_TONE_FREQUENCY:
1576     case V4L2_CID_TUNE_POWER_LEVEL:
1577     case V4L2_CID_TUNE_ANTENNA_CAPACITOR:
1578     case V4L2_CID_RF_TUNER_RF_GAIN:
1579     case V4L2_CID_RF_TUNER_LNA_GAIN:
1580     case V4L2_CID_RF_TUNER_MIXER_GAIN:
1581     case V4L2_CID_RF_TUNER_IF_GAIN:
1582     case V4L2_CID_RF_TUNER_BANDWIDTH:
1583     case V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD:
1584         *flags |= V4L2_CTRL_FLAG_SLIDER;
1585         break;
1586     case V4L2_CID_PAN_RELATIVE:
1587     case V4L2_CID_TILT_RELATIVE:
1588     case V4L2_CID_FOCUS_RELATIVE:
1589     case V4L2_CID_IRIS_RELATIVE:
1590     case V4L2_CID_ZOOM_RELATIVE:
1591         *flags |= V4L2_CTRL_FLAG_WRITE_ONLY |
1592               V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
1593         break;
1594     case V4L2_CID_FLASH_STROBE_STATUS:
1595     case V4L2_CID_AUTO_FOCUS_STATUS:
1596     case V4L2_CID_FLASH_READY:
1597     case V4L2_CID_DV_TX_HOTPLUG:
1598     case V4L2_CID_DV_TX_RXSENSE:
1599     case V4L2_CID_DV_TX_EDID_PRESENT:
1600     case V4L2_CID_DV_RX_POWER_PRESENT:
1601     case V4L2_CID_DV_RX_IT_CONTENT_TYPE:
1602     case V4L2_CID_RDS_RX_PTY:
1603     case V4L2_CID_RDS_RX_PS_NAME:
1604     case V4L2_CID_RDS_RX_RADIO_TEXT:
1605     case V4L2_CID_RDS_RX_TRAFFIC_ANNOUNCEMENT:
1606     case V4L2_CID_RDS_RX_TRAFFIC_PROGRAM:
1607     case V4L2_CID_RDS_RX_MUSIC_SPEECH:
1608     case V4L2_CID_CAMERA_ORIENTATION:
1609     case V4L2_CID_CAMERA_SENSOR_ROTATION:
1610         *flags |= V4L2_CTRL_FLAG_READ_ONLY;
1611         break;
1612     case V4L2_CID_RF_TUNER_PLL_LOCK:
1613         *flags |= V4L2_CTRL_FLAG_VOLATILE;
1614         break;
1615     }
1616 }
1617 EXPORT_SYMBOL(v4l2_ctrl_fill);
[ Source navigation ] [ Diff markup ] [ Identifier search ] [ general search ]

This page was automatically generated by the 2.1.0 LXR engine.

The LXR team
Valid CSS 2.1! Valid HTML 4.01!