git.sesse.net Git - vlc/blob - modules/access/v4l2/v4l2.c

   1 /*****************************************************************************
   2  * v4l2.c : Video4Linux2 input module for VLC
   3  *****************************************************************************
   4  * Copyright (C) 2002-2009 the VideoLAN team
   5  * Copyright (C) 2011-2012 Rémi Denis-Courmont
   6  *
   7  * Authors: Benjamin Pracht <bigben at videolan dot org>
   8  *          Richard Hosking <richard at hovis dot net>
   9  *          Antoine Cellerier <dionoea at videolan d.t org>
  10  *          Dennis Lou <dlou99 at yahoo dot com>
  11  *
  12  * This program is free software; you can redistribute it and/or modify
  13  * it under the terms of the GNU Lesser General Public License as published by
  14  * the Free Software Foundation; either version 2.1 of the License, or
  15  * (at your option) any later version.
  16  *
  17  * This program is distributed in the hope that it will be useful,
  18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20  * GNU Lesser General Public License for more details.
  21  *
  22  * You should have received a copy of the GNU Lesser General Public License
  23  * along with this program; if not, write to the Free Software Foundation,
  24  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  25  *****************************************************************************/
  26
  27 #ifdef HAVE_CONFIG_H
  28 # include "config.h"
  29 #endif
  30
  31 #include <stdlib.h>
  32 #include <string.h>
  33 #include <assert.h>
  34
  35 #include <vlc_common.h>
  36 #include <vlc_plugin.h>
  37
  38 #include "v4l2.h"
  39
  40 #define DEVICE_TEXT N_( "Device" )
  41 #define DEVICE_LONGTEXT N_("Video device node." )
  42 #define STANDARD_TEXT N_( "Standard" )
  43 #define STANDARD_LONGTEXT N_( \
  44     "Video standard (Default, SECAM, PAL, or NTSC)." )
  45 #define CHROMA_TEXT N_("Video input chroma format")
  46 #define CHROMA_LONGTEXT N_( \
  47     "Force the Video4Linux2 video device to use a specific chroma format " \
  48     "(eg. I420 or I422 for raw images, MJPG for M-JPEG compressed input) " \
  49     "(Complete list: GREY, I240, RV16, RV15, RV24, RV32, YUY2, YUYV, UYVY, " \
  50     "I41N, I422, I420, I411, I410, MJPG)")
  51 #define INPUT_TEXT N_( "Input" )
  52 #define INPUT_LONGTEXT N_( \
  53     "Input of the card to use (see debug)." )
  54 #define AUDIO_INPUT_TEXT N_( "Audio input" )
  55 #define AUDIO_INPUT_LONGTEXT N_( \
  56     "Audio input of the card to use (see debug)." )
  57 #define WIDTH_TEXT N_( "Width" )
  58 #define HEIGHT_TEXT N_( "Height" )
  59 #define SIZE_LONGTEXT N_( \
  60     "The specified pixel resolution is forced " \
  61     "(if both width and height are strictly positive)." )
  62 /*#define FPS_TEXT N_( "Frame rate" )
  63 #define FPS_LONGTEXT N_( "Maximum frame rate to use (0 = no limits)." )*/
  64
  65 #define CTRL_RESET_TEXT N_( "Reset controls" )
  66 #define CTRL_RESET_LONGTEXT N_( "Reset controls to defaults." )
  67 #define BRIGHTNESS_TEXT N_( "Brightness" )
  68 #define BRIGHTNESS_LONGTEXT N_( "Picture brightness or black level." )
  69 #define BRIGHTNESS_AUTO_TEXT N_( "Automatic brightness" )
  70 #define BRIGHTNESS_AUTO_LONGTEXT N_( \
  71     "Automatically adjust the picture brightness." )
  72 #define CONTRAST_TEXT N_( "Contrast" )
  73 #define CONTRAST_LONGTEXT N_( "Picture contrast or luma gain." )
  74 #define SATURATION_TEXT N_( "Saturation" )
  75 #define SATURATION_LONGTEXT N_( "Picture saturation or chroma gain." )
  76 #define HUE_TEXT N_( "Hue" )
  77 #define HUE_LONGTEXT N_( "Hue or color balance." )
  78 #define HUE_AUTO_TEXT N_( "Automatic hue" )
  79 #define HUE_AUTO_LONGTEXT N_( \
  80     "Automatically adjust the picture hue." )
  81 #define WHITE_BALANCE_TEMP_TEXT N_( "White balance temperature (K)" )
  82 #define WHITE_BALANCE_TEMP_LONGTEXT N_( \
  83     "White balance temperature as a color temperation in Kelvin " \
  84     "(2800 is minimum incandescence, 6500 is maximum daylight)." )
  85 #define AUTOWHITEBALANCE_TEXT N_( "Automatic white balance" )
  86 #define AUTOWHITEBALANCE_LONGTEXT N_( \
  87     "Automatically adjust the picture white balance." )
  88 #define REDBALANCE_TEXT N_( "Red balance" )
  89 #define REDBALANCE_LONGTEXT N_( \
  90     "Red chroma balance." )
  91 #define BLUEBALANCE_TEXT N_( "Blue balance" )
  92 #define BLUEBALANCE_LONGTEXT N_( \
  93     "Blue chroma balance." )
  94 #define GAMMA_TEXT N_( "Gamma" )
  95 #define GAMMA_LONGTEXT N_( \
  96     "Gamma adjust." )
  97 #define AUTOGAIN_TEXT N_( "Automatic gain" )
  98 #define AUTOGAIN_LONGTEXT N_( \
  99     "Automatically set the video gain." )
 100 #define GAIN_TEXT N_( "Gain" )
 101 #define GAIN_LONGTEXT N_( \
 102     "Picture gain." )
 103 #define SHARPNESS_TEXT N_( "Sharpness" )
 104 #define SHARPNESS_LONGTEXT N_( "Sharpness filter adjust." )
 105 #define CHROMA_GAIN_TEXT N_( "Chroma gain" )
 106 #define CHROMA_GAIN_LONGTEXT N_( "Chroma gain control." )
 107 #define CHROMA_GAIN_AUTO_TEXT N_( "Automatic chroma gain" )
 108 #define CHROMA_GAIN_AUTO_LONGTEXT N_( \
 109     "Automatically control the chroma gain." )
 110 #define POWER_FREQ_TEXT N_( "Power line frequency" )
 111 #define POWER_FREQ_LONGTEXT N_( \
 112     "Power line frequency anti-flicker filter." )
 113 static const int power_freq_vlc[] = { -1,
 114     V4L2_CID_POWER_LINE_FREQUENCY_DISABLED,
 115     V4L2_CID_POWER_LINE_FREQUENCY_50HZ,
 116     V4L2_CID_POWER_LINE_FREQUENCY_60HZ,
 117     V4L2_CID_POWER_LINE_FREQUENCY_AUTO,
 118 };
 119 static const char *const power_freq_user[] = { N_("Unspecified"),
 120     N_("Off"), N_("50 Hz"), N_("60 Hz"), N_("Automatic"),
 121 };
 122 #define BKLT_COMPENSATE_TEXT N_( "Backlight compensation" )
 123 #define BKLT_COMPENSATE_LONGTEXT N_( "Backlight compensation." )
 124 #define BAND_STOP_FILTER_TEXT N_( "Band-stop filter" )
 125 #define BAND_STOP_FILTER_LONGTEXT N_(  \
 126     "Cut a light band induced by fluorescent lighting (unit undocumented)." )
 127 #define HFLIP_TEXT N_( "Horizontal flip" )
 128 #define HFLIP_LONGTEXT N_( \
 129     "Flip the picture horizontally." )
 130 #define VFLIP_TEXT N_( "Vertical flip" )
 131 #define VFLIP_LONGTEXT N_( \
 132     "Flip the picture vertically." )
 133 #define ROTATE_TEXT N_( "Rotate (degrees)" )
 134 #define ROTATE_LONGTEXT N_( "Picture rotation angle (in degrees)." )
 135 #define COLOR_KILLER_TEXT N_( "Color killer" )
 136 #define COLOR_KILLER_LONGTEXT N_( \
 137     "Enable the color killer, i.e. switch to black & white picture " \
 138     "whenever the signal is weak." )
 139 #define COLOR_EFFECT_TEXT N_( "Color effect" )
 140 #define COLOR_EFFECT_LONGTEXT N_( "Select a color effect." )
 141 static const int colorfx_vlc[] = { -1, V4L2_COLORFX_NONE,
 142     V4L2_COLORFX_BW, V4L2_COLORFX_SEPIA, V4L2_COLORFX_NEGATIVE,
 143     V4L2_COLORFX_EMBOSS, V4L2_COLORFX_SKETCH, V4L2_COLORFX_SKY_BLUE,
 144     V4L2_COLORFX_GRASS_GREEN, V4L2_COLORFX_SKIN_WHITEN, V4L2_COLORFX_VIVID,
 145 };
 146 static const char *const colorfx_user[] = { N_("Unspecified"), N_("None"),
 147     N_("Black & white"), N_("Sepia"), N_("Negative"),
 148     N_("Emboss"), N_("Sketch"), N_("Sky blue"),
 149     N_("Grass green"), N_("Skin whiten"), N_("Vivid"),
 150 };
 151
 152 #define AUDIO_VOLUME_TEXT N_( "Audio volume" )
 153 #define AUDIO_VOLUME_LONGTEXT N_( \
 154     "Volume of the audio input." )
 155 #define AUDIO_BALANCE_TEXT N_( "Audio balance" )
 156 #define AUDIO_BALANCE_LONGTEXT N_( \
 157     "Balance of the audio input." )
 158 #define AUDIO_BASS_TEXT N_( "Bass level" )
 159 #define AUDIO_BASS_LONGTEXT N_( \
 160     "Bass adjustment of the audio input." )
 161 #define AUDIO_TREBLE_TEXT N_( "Treble level" )
 162 #define AUDIO_TREBLE_LONGTEXT N_( \
 163     "Treble adjustment of the audio input." )
 164 #define AUDIO_MUTE_TEXT N_( "Mute" )
 165 #define AUDIO_MUTE_LONGTEXT N_( \
 166     "Mute the audio." )
 167 #define AUDIO_LOUDNESS_TEXT N_( "Loudness mode" )
 168 #define AUDIO_LOUDNESS_LONGTEXT N_( \
 169     "Loudness mode a.k.a. bass boost." )
 170
 171 #define S_CTRLS_TEXT N_("v4l2 driver controls")
 172 #define S_CTRLS_LONGTEXT N_( \
 173     "Set the v4l2 driver controls to the values specified using a comma " \
 174     "separated list optionally encapsulated by curly braces " \
 175     "(e.g.: {video_bitrate=6000000,audio_crc=0,stream_type=3} ). " \
 176     "To list available controls, increase verbosity (-vvv) " \
 177     "or use the v4l2-ctl application." )
 178
 179 #define TUNER_TEXT N_("Tuner id")
 180 #define TUNER_LONGTEXT N_( \
 181     "Tuner id (see debug output)." )
 182 #define FREQUENCY_TEXT N_("Frequency")
 183 #define FREQUENCY_LONGTEXT N_( \
 184     "Tuner frequency in Hz or kHz (see debug output)" )
 185 #define TUNER_AUDIO_MODE_TEXT N_("Audio mode")
 186 #define TUNER_AUDIO_MODE_LONGTEXT N_( \
 187     "Tuner audio mono/stereo and track selection." )
 188
 189 #define ASPECT_TEXT N_("Picture aspect-ratio n:m")
 190 #define ASPECT_LONGTEXT N_("Define input picture aspect-ratio to use. Default is 4:3" )
 191
 192 static const int tristate_vlc[] = { -1, 0, 1 };
 193 static const char *const tristate_user[] = {
 194     N_("Unspecified"), N_("Off"), N_("On") };
 195
 196 static const v4l2_std_id standards_v4l2[] = { V4L2_STD_UNKNOWN, V4L2_STD_ALL,
 197     V4L2_STD_PAL,     V4L2_STD_PAL_BG,   V4L2_STD_PAL_DK,
 198     V4L2_STD_NTSC,
 199     V4L2_STD_SECAM,   V4L2_STD_SECAM_DK,
 200     V4L2_STD_MTS,     V4L2_STD_525_60,  V4L2_STD_625_50,
 201     V4L2_STD_ATSC,
 202
 203     V4L2_STD_B,       V4L2_STD_G,        V4L2_STD_H,        V4L2_STD_L,
 204     V4L2_STD_GH,      V4L2_STD_DK,       V4L2_STD_BG,       V4L2_STD_MN,
 205
 206     V4L2_STD_PAL_B,   V4L2_STD_PAL_B1,   V4L2_STD_PAL_G,    V4L2_STD_PAL_H,
 207     V4L2_STD_PAL_I,   V4L2_STD_PAL_D,    V4L2_STD_PAL_D1,   V4L2_STD_PAL_K,
 208     V4L2_STD_PAL_M,   V4L2_STD_PAL_N,    V4L2_STD_PAL_Nc,   V4L2_STD_PAL_60,
 209     V4L2_STD_NTSC_M,  V4L2_STD_NTSC_M_JP,V4L2_STD_NTSC_443, V4L2_STD_NTSC_M_KR,
 210     V4L2_STD_SECAM_B, V4L2_STD_SECAM_D,  V4L2_STD_SECAM_G,  V4L2_STD_SECAM_H,
 211     V4L2_STD_SECAM_K, V4L2_STD_SECAM_K1, V4L2_STD_SECAM_L,  V4L2_STD_SECAM_LC,
 212     V4L2_STD_ATSC_8_VSB, V4L2_STD_ATSC_16_VSB,
 213 };
 214 static const char *const standards_vlc[] = { "", "ALL",
 215     /* Pseudo standards */
 216     "PAL", "PAL_BG", "PAL_DK",
 217     "NTSC",
 218     "SECAM", "SECAM_DK",
 219     "MTS", "525_60", "625_50",
 220     "ATSC",
 221
 222     /* Chroma-agnostic ITU standards (PAL/NTSC or PAL/SECAM) */
 223     "B",              "G",               "H",               "L",
 224     "GH",             "DK",              "BG",              "MN",
 225
 226     /* Individual standards */
 227     "PAL_B",          "PAL_B1",          "PAL_G",           "PAL_H",
 228     "PAL_I",          "PAL_D",           "PAL_D1",          "PAL_K",
 229     "PAL_M",          "PAL_N",           "PAL_Nc",          "PAL_60",
 230     "NTSC_M",         "NTSC_M_JP",       "NTSC_443",        "NTSC_M_KR",
 231     "SECAM_B",        "SECAM_D",         "SECAM_G",         "SECAM_H",
 232     "SECAM_K",        "SECAM_K1",        "SECAM_L",         "SECAM_LC",
 233     "ATSC_8_VSB",     "ATSC_16_VSB",
 234 };
 235 static const char *const standards_user[] = { N_("Undefined"), N_("All"),
 236     "PAL",            "PAL B/G",         "PAL D/K",
 237     "NTSC",
 238     "SECAM",          "SECAM D/K",
 239     N_("Multichannel television sound (MTS)"),
 240     N_("525 lines / 60 Hz"), N_("625 lines / 50 Hz"),
 241     "ATSC",
 242
 243     "PAL/SECAM B",    "PAL/SECAM G",     "PAL/SECAM H",     "PAL/SECAM L",
 244     "PAL/SECAM G/H",  "PAL/SECAM D/K",   "PAL/SECAM B/G",   "PAL/NTSC M/N",
 245
 246     "PAL B",          "PAL B1",          "PAL G",           "PAL H",
 247     "PAL I",          "PAL D",           "PAL D1",          "PAL K",
 248     "PAL M",          "PAL N",           N_("PAL N Argentina"), "PAL 60",
 249     "NTSC M",        N_("NTSC M Japan"), "NTSC 443",  N_("NTSC M South Korea"),
 250     "SECAM B",        "SECAM D",         "SECAM G",         "SECAM H",
 251     "SECAM K",        "SECAM K1",        "SECAM L",         "SECAM L/C",
 252     "ATSC 8-VSB",     "ATSC 16-VSB",
 253 };
 254
 255 static const int i_tuner_audio_modes_list[] = {
 256       V4L2_TUNER_MODE_MONO, V4L2_TUNER_MODE_STEREO,
 257       V4L2_TUNER_MODE_LANG1, V4L2_TUNER_MODE_LANG2, V4L2_TUNER_MODE_LANG1_LANG2
 258 };
 259 static const char *const psz_tuner_audio_modes_list_text[] = {
 260       N_("Mono"),
 261       N_("Stereo"),
 262       N_("Primary language"),
 263       N_("Secondary language or program"),
 264       N_("Dual mono" )
 265 };
 266
 267 vlc_module_begin ()
 268     set_shortname( N_("Video4Linux2") )
 269     set_description( N_("Video4Linux2 input") )
 270     set_category( CAT_INPUT )
 271     set_subcategory( SUBCAT_INPUT_ACCESS )
 272
 273     set_section( N_( "Video input" ), NULL )
 274     add_loadfile( CFG_PREFIX "dev", "/dev/video0",
 275                   DEVICE_TEXT, DEVICE_LONGTEXT, false )
 276         change_safe()
 277     add_string( CFG_PREFIX "standard", "",
 278                 STANDARD_TEXT, STANDARD_LONGTEXT, false )
 279         change_string_list( standards_vlc, standards_user, NULL )
 280         change_safe()
 281     add_string( CFG_PREFIX "chroma", NULL, CHROMA_TEXT, CHROMA_LONGTEXT,
 282                 true )
 283         change_safe()
 284     add_integer( CFG_PREFIX "input", 0, INPUT_TEXT, INPUT_LONGTEXT,
 285                 true )
 286         change_integer_range( 0, 0xFFFFFFFE )
 287         change_safe()
 288     add_integer( CFG_PREFIX "audio-input", -1, AUDIO_INPUT_TEXT,
 289                  AUDIO_INPUT_LONGTEXT, true )
 290         change_integer_range( -1, 0xFFFFFFFE )
 291         change_safe()
 292     add_obsolete_integer( CFG_PREFIX "io" ) /* since 2.0.0 */
 293     add_integer( CFG_PREFIX "width", 0, WIDTH_TEXT, SIZE_LONGTEXT, false )
 294         change_integer_range( 0, VOUT_MAX_WIDTH )
 295         change_safe()
 296     add_integer( CFG_PREFIX "height", 0, HEIGHT_TEXT, SIZE_LONGTEXT, false )
 297         change_integer_range( 0, VOUT_MAX_WIDTH )
 298         change_safe()
 299     add_string( CFG_PREFIX "aspect-ratio", "4:3", ASPECT_TEXT,
 300               ASPECT_LONGTEXT, true )
 301         change_safe()
 302     /*add_float( CFG_PREFIX "fps", 0, FPS_TEXT, FPS_LONGTEXT, true )*/
 303     add_obsolete_float( CFG_PREFIX "fps" )
 304         change_safe() /* since 2.1.0 */
 305     add_obsolete_bool( CFG_PREFIX "use-libv4l2" ) /* since 2.1.0 */
 306
 307     set_section( N_( "Tuner" ), NULL )
 308     add_obsolete_integer( CFG_PREFIX "tuner" ) /* since 2.1.0 */
 309     add_integer( CFG_PREFIX "tuner-frequency", -1, FREQUENCY_TEXT,
 310                  FREQUENCY_LONGTEXT, true )
 311         change_integer_range( -1, 0xFFFFFFFE )
 312         change_safe()
 313     add_integer( CFG_PREFIX "tuner-audio-mode", V4L2_TUNER_MODE_LANG1,
 314                  TUNER_AUDIO_MODE_TEXT, TUNER_AUDIO_MODE_LONGTEXT, true )
 315         change_integer_list( i_tuner_audio_modes_list,
 316                              psz_tuner_audio_modes_list_text )
 317         change_safe()
 318
 319     set_section( N_( "Controls" ),
 320                  N_( "Video capture controls (if supported by the device)" ) )
 321     add_bool( CFG_PREFIX "controls-reset", false, CTRL_RESET_TEXT,
 322               CTRL_RESET_LONGTEXT, true )
 323         change_safe()
 324     add_integer( CFG_PREFIX "brightness", -1, BRIGHTNESS_TEXT,
 325                  BRIGHTNESS_LONGTEXT, true )
 326     add_integer( CFG_PREFIX "brightness-auto", -1,
 327                  BRIGHTNESS_AUTO_TEXT, BRIGHTNESS_AUTO_LONGTEXT, true )
 328         change_integer_list( tristate_vlc, tristate_user )
 329     add_integer( CFG_PREFIX "contrast", -1, CONTRAST_TEXT,
 330                  CONTRAST_LONGTEXT, true )
 331     add_integer( CFG_PREFIX "saturation", -1, SATURATION_TEXT,
 332                  SATURATION_LONGTEXT, true )
 333     add_integer( CFG_PREFIX "hue", -1, HUE_TEXT,
 334                  HUE_LONGTEXT, true )
 335     add_integer( CFG_PREFIX "hue-auto", -1,
 336                  HUE_AUTO_TEXT, HUE_AUTO_LONGTEXT, true )
 337         change_integer_list( tristate_vlc, tristate_user )
 338     add_obsolete_integer( CFG_PREFIX "black-level" ) /* since Linux 2.6.26 */
 339     add_integer( CFG_PREFIX "white-balance-temperature", -1,
 340                  WHITE_BALANCE_TEMP_TEXT, WHITE_BALANCE_TEMP_LONGTEXT, true )
 341         /* Ideally, the range should be 2800-6500 */
 342         change_integer_range( -1, 6500 )
 343     add_integer( CFG_PREFIX "auto-white-balance", -1,
 344                  AUTOWHITEBALANCE_TEXT, AUTOWHITEBALANCE_LONGTEXT, true )
 345         change_integer_list( tristate_vlc, tristate_user )
 346     add_obsolete_integer( CFG_PREFIX"do-white-balance" ) /* since 2.0.0 */
 347     add_integer( CFG_PREFIX "red-balance", -1, REDBALANCE_TEXT,
 348                  REDBALANCE_LONGTEXT, true )
 349     add_integer( CFG_PREFIX "blue-balance", -1, BLUEBALANCE_TEXT,
 350                  BLUEBALANCE_LONGTEXT, true )
 351     add_integer( CFG_PREFIX "gamma", -1, GAMMA_TEXT,
 352                  GAMMA_LONGTEXT, true )
 353     add_integer( CFG_PREFIX "autogain", -1, AUTOGAIN_TEXT,
 354                  AUTOGAIN_LONGTEXT, true )
 355         change_integer_list( tristate_vlc, tristate_user )
 356     add_integer( CFG_PREFIX "gain", -1, GAIN_TEXT,
 357                  GAIN_LONGTEXT, true )
 358     add_integer( CFG_PREFIX "sharpness", -1,
 359                  SHARPNESS_TEXT, SHARPNESS_LONGTEXT, true )
 360     add_integer( CFG_PREFIX "chroma-gain", -1,
 361                  CHROMA_GAIN_TEXT, CHROMA_GAIN_LONGTEXT, true )
 362     add_integer( CFG_PREFIX "chroma-gain-auto", -1,
 363                  CHROMA_GAIN_AUTO_TEXT, CHROMA_GAIN_AUTO_LONGTEXT, true )
 364     add_integer( CFG_PREFIX"power-line-frequency", -1,
 365                  POWER_FREQ_TEXT, POWER_FREQ_LONGTEXT, true )
 366         change_integer_list( power_freq_vlc, power_freq_user )
 367     add_integer( CFG_PREFIX"backlight-compensation", -1,
 368                  BKLT_COMPENSATE_TEXT, BKLT_COMPENSATE_LONGTEXT, true )
 369     add_integer( CFG_PREFIX "band-stop-filter", -1,
 370                  BAND_STOP_FILTER_TEXT, BAND_STOP_FILTER_LONGTEXT, true )
 371     add_bool( CFG_PREFIX "hflip", false, HFLIP_TEXT, HFLIP_LONGTEXT, true )
 372     add_bool( CFG_PREFIX "vflip", false, VFLIP_TEXT, VFLIP_LONGTEXT, true )
 373     add_integer( CFG_PREFIX "rotate", -1, ROTATE_TEXT, ROTATE_LONGTEXT, true )
 374         change_integer_range( -1, 359 )
 375     add_obsolete_integer( CFG_PREFIX "hcenter" ) /* since Linux 2.6.26 */
 376     add_obsolete_integer( CFG_PREFIX "vcenter" ) /* since Linux 2.6.26 */
 377     add_integer( CFG_PREFIX"color-killer", -1,
 378                  COLOR_KILLER_TEXT, COLOR_KILLER_LONGTEXT, true )
 379         change_integer_list( tristate_vlc, tristate_user )
 380     add_integer( CFG_PREFIX"color-effect", -1,
 381                  COLOR_EFFECT_TEXT, COLOR_EFFECT_LONGTEXT, true )
 382         change_integer_list( colorfx_vlc, colorfx_user )
 383
 384     add_integer( CFG_PREFIX "audio-volume", -1, AUDIO_VOLUME_TEXT,
 385                 AUDIO_VOLUME_LONGTEXT, true )
 386     add_integer( CFG_PREFIX "audio-balance", -1, AUDIO_BALANCE_TEXT,
 387                 AUDIO_BALANCE_LONGTEXT, true )
 388     add_bool( CFG_PREFIX "audio-mute", false, AUDIO_MUTE_TEXT,
 389               AUDIO_MUTE_LONGTEXT, true )
 390     add_integer( CFG_PREFIX "audio-bass", -1, AUDIO_BASS_TEXT,
 391                 AUDIO_BASS_LONGTEXT, true )
 392     add_integer( CFG_PREFIX "audio-treble", -1, AUDIO_TREBLE_TEXT,
 393                 AUDIO_TREBLE_LONGTEXT, true )
 394     add_bool( CFG_PREFIX "audio-loudness", false, AUDIO_LOUDNESS_TEXT,
 395               AUDIO_LOUDNESS_LONGTEXT, true )
 396     add_string( CFG_PREFIX "set-ctrls", NULL, S_CTRLS_TEXT,
 397               S_CTRLS_LONGTEXT, true )
 398         change_safe()
 399
 400     add_obsolete_string( CFG_PREFIX "adev" )
 401     add_obsolete_integer( CFG_PREFIX "audio-method" )
 402     add_obsolete_bool( CFG_PREFIX "stereo" )
 403     add_obsolete_integer( CFG_PREFIX "samplerate" )
 404
 405     add_shortcut( "v4l", "v4l2" )
 406     set_capability( "access_demux", 0 )
 407     set_callbacks( DemuxOpen, DemuxClose )
 408
 409     add_submodule ()
 410     add_shortcut( "v4l", "v4l2", "v4l2c" )
 411     set_description( N_("Video4Linux2 Compressed A/V") )
 412     set_capability( "access", 0 )
 413     /* use these when open as access_demux fails; VLC will use another demux */
 414     set_callbacks( AccessOpen, AccessClose )
 415
 416 vlc_module_end ()
 417
 418 /**
 419  * Parses a V4L2 MRL into VLC object variables.
 420  */
 421 void ParseMRL( vlc_object_t *obj, const char *mrl )
 422 {
 423     const char *p = strchr( mrl, ':' );
 424     char *dev = NULL;
 425
 426     if( p != NULL )
 427     {
 428         var_LocationParse( obj, p + 1, CFG_PREFIX );
 429         if( p > mrl )
 430             dev = strndup( mrl, p - mrl );
 431     }
 432     else
 433     {
 434         if( mrl[0] )
 435             dev = strdup( mrl );
 436     }
 437
 438     if( dev != NULL )
 439     {
 440         var_Create( obj, CFG_PREFIX"dev", VLC_VAR_STRING );
 441         var_SetString( obj, CFG_PREFIX"dev", dev );
 442         free( dev );
 443     }
 444 }
 445
 446 v4l2_std_id var_InheritStandard (vlc_object_t *obj, const char *varname)
 447 {
 448     char *name = var_InheritString (obj, varname);
 449     if (name == NULL)
 450         return V4L2_STD_UNKNOWN;
 451
 452     const size_t n = sizeof (standards_vlc) / sizeof (*standards_vlc);
 453
 454     static_assert (sizeof (standards_vlc) / sizeof (*standards_vlc)
 455                          == sizeof (standards_v4l2) / sizeof (*standards_v4l2),
 456                    "Inconsistent standards tables");
 457     static_assert (sizeof (standards_vlc) / sizeof (*standards_vlc)
 458                          == sizeof (standards_user) / sizeof (*standards_user),
 459                    "Inconsistent standards tables");
 460
 461     for (size_t i = 0; i < n; i++)
 462         if (strcasecmp (name, standards_vlc[i]) == 0)
 463         {
 464             free (name);
 465             return standards_v4l2[i];
 466         }
 467
 468     /* Backward compatibility with old versions using V4L2 magic numbers */
 469     char *end;
 470     v4l2_std_id std = strtoull (name, &end, 0);
 471     if (*end != '\0')
 472     {
 473         msg_Err (obj, "unknown video standard \"%s\"", name);
 474         std = V4L2_STD_UNKNOWN;
 475     }
 476     free (name);
 477     return std;
 478 }