V4L/DVB (4042): Documentation: whitespace cleanup

Signed-off-by: Michael Krufky <mkrufky@linuxtv.org>
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
This commit is contained in:
Michael Krufky 2006-05-23 17:41:31 -03:00 коммит произвёл Mauro Carvalho Chehab
Родитель 680543c5d2
Коммит 6e20409004
6 изменённых файлов: 247 добавлений и 247 удалений

Просмотреть файл

@ -18,7 +18,7 @@ Ragnar Hojland Espinosa <ragnar@macula.net>
+ many more (please mail me if you are missing in this list and would + many more (please mail me if you are missing in this list and would
like to be mentioned) like to be mentioned)

Просмотреть файл

@ -1,9 +1,9 @@
ET61X[12]51 PC Camera Controllers ET61X[12]51 PC Camera Controllers
Driver for Linux Driver for Linux
================================= =================================
- Documentation - - Documentation -
Index Index
@ -156,46 +156,46 @@ Name: video_nr
Type: short array (min = 0, max = 64) Type: short array (min = 0, max = 64)
Syntax: <-1|n[,...]> Syntax: <-1|n[,...]>
Description: Specify V4L2 minor mode number: Description: Specify V4L2 minor mode number:
-1 = use next available -1 = use next available
n = use minor number n n = use minor number n
You can specify up to 64 cameras this way. You can specify up to 64 cameras this way.
For example: For example:
video_nr=-1,2,-1 would assign minor number 2 to the second video_nr=-1,2,-1 would assign minor number 2 to the second
registered camera and use auto for the first one and for every registered camera and use auto for the first one and for every
other camera. other camera.
Default: -1 Default: -1
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: force_munmap Name: force_munmap
Type: bool array (min = 0, max = 64) Type: bool array (min = 0, max = 64)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Force the application to unmap previously mapped buffer memory Description: Force the application to unmap previously mapped buffer memory
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
all the applications support this feature. This parameter is all the applications support this feature. This parameter is
specific for each detected camera. specific for each detected camera.
0 = do not force memory unmapping 0 = do not force memory unmapping
1 = force memory unmapping (save memory) 1 = force memory unmapping (save memory)
Default: 0 Default: 0
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: frame_timeout Name: frame_timeout
Type: uint array (min = 0, max = 64) Type: uint array (min = 0, max = 64)
Syntax: <n[,...]> Syntax: <n[,...]>
Description: Timeout for a video frame in seconds. This parameter is Description: Timeout for a video frame in seconds. This parameter is
specific for each detected camera. This parameter can be specific for each detected camera. This parameter can be
changed at runtime thanks to the /sys filesystem interface. changed at runtime thanks to the /sys filesystem interface.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: debug Name: debug
Type: ushort Type: ushort
Syntax: <n> Syntax: <n>
Description: Debugging information level, from 0 to 3: Description: Debugging information level, from 0 to 3:
0 = none (use carefully) 0 = none (use carefully)
1 = critical errors 1 = critical errors
2 = significant informations 2 = significant informations
3 = more verbose messages 3 = more verbose messages
Level 3 is useful for testing only, when only one device Level 3 is useful for testing only, when only one device
is used at the same time. It also shows some more informations is used at the same time. It also shows some more informations
about the hardware being detected. This module parameter can be about the hardware being detected. This module parameter can be
changed at runtime thanks to the /sys filesystem interface. changed at runtime thanks to the /sys filesystem interface.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------

Просмотреть файл

@ -21,7 +21,7 @@ Internal interface: Video For Linux (V4L)
Supported controls: Supported controls:
- by V4L: Contrast, Brightness, Color, Hue - by V4L: Contrast, Brightness, Color, Hue
- by driver options: frame rate, lighting conditions, video format, - by driver options: frame rate, lighting conditions, video format,
default picture settings, sharpness. default picture settings, sharpness.
SUPPORTED CAMERAS: SUPPORTED CAMERAS:
@ -191,66 +191,66 @@ init_model2_sat Integer 0..255 [0x34] init_model2_sat=65
init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200 init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200
debug You don't need this option unless you are a developer. debug You don't need this option unless you are a developer.
If you are a developer then you will see in the code If you are a developer then you will see in the code
what values do what. 0=off. what values do what. 0=off.
flags This is a bit mask, and you can combine any number of flags This is a bit mask, and you can combine any number of
bits to produce what you want. Usually you don't want bits to produce what you want. Usually you don't want
any of extra features this option provides: any of extra features this option provides:
FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed
VIDIOCSYNC ioctls without failing. VIDIOCSYNC ioctls without failing.
Will work with xawtv, will not Will work with xawtv, will not
with xrealproducer. Default is with xrealproducer. Default is
not set. not set.
FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode. FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode.
FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have
magic meaning to developers. magic meaning to developers.
FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen, FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen,
useful only for debugging. useful only for debugging.
FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers. FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers.
FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as
it was received from the camera. it was received from the camera.
Default (not set) is to mix the Default (not set) is to mix the
preceding frame in to compensate preceding frame in to compensate
for occasional loss of Isoc data for occasional loss of Isoc data
on high frame rates. on high frame rates.
FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame
prior to use; relevant only if prior to use; relevant only if
FLAGS_SEPARATE_FRAMES is set. FLAGS_SEPARATE_FRAMES is set.
Default is not to clean frames, Default is not to clean frames,
this is a little faster but may this is a little faster but may
produce flicker if frame rate is produce flicker if frame rate is
too high and Isoc data gets lost. too high and Isoc data gets lost.
FLAGS_NO_DECODING 128 This flag turns the video stream FLAGS_NO_DECODING 128 This flag turns the video stream
decoder off, and dumps the raw decoder off, and dumps the raw
Isoc data from the camera into Isoc data from the camera into
the reading process. Useful to the reading process. Useful to
developers, but not to users. developers, but not to users.
framerate This setting controls frame rate of the camera. This is framerate This setting controls frame rate of the camera. This is
an approximate setting (in terms of "worst" ... "best") an approximate setting (in terms of "worst" ... "best")
because camera changes frame rate depending on amount because camera changes frame rate depending on amount
of light available. Setting 0 is slowest, 6 is fastest. of light available. Setting 0 is slowest, 6 is fastest.
Beware - fast settings are very demanding and may not Beware - fast settings are very demanding and may not
work well with all video sizes. Be conservative. work well with all video sizes. Be conservative.
hue_correction This highly optional setting allows to adjust the hue_correction This highly optional setting allows to adjust the
hue of the image in a way slightly different from hue of the image in a way slightly different from
what usual "hue" control does. Both controls affect what usual "hue" control does. Both controls affect
YUV colorspace: regular "hue" control adjusts only YUV colorspace: regular "hue" control adjusts only
U component, and this "hue_correction" option similarly U component, and this "hue_correction" option similarly
adjusts only V component. However usually it is enough adjusts only V component. However usually it is enough
to tweak only U or V to compensate for colored light or to tweak only U or V to compensate for colored light or
color temperature; this option simply allows more color temperature; this option simply allows more
complicated correction when and if it is necessary. complicated correction when and if it is necessary.
init_brightness These settings specify _initial_ values which will be init_brightness These settings specify _initial_ values which will be
init_contrast used to set up the camera. If your V4L application has init_contrast used to set up the camera. If your V4L application has
init_color its own controls to adjust the picture then these init_color its own controls to adjust the picture then these
init_hue controls will be used too. These options allow you to init_hue controls will be used too. These options allow you to
preconfigure the camera when it gets connected, before preconfigure the camera when it gets connected, before
any V4L application connects to it. Good for webcams. any V4L application connects to it. Good for webcams.
init_model2_rg These initial settings alter color balance of the init_model2_rg These initial settings alter color balance of the
init_model2_rg2 camera on hardware level. All four settings may be used init_model2_rg2 camera on hardware level. All four settings may be used
@ -258,47 +258,47 @@ init_model2_sat to tune the camera to specific lighting conditions. These
init_model2_yb settings only apply to Model 2 cameras. init_model2_yb settings only apply to Model 2 cameras.
lighting This option selects one of three hardware-defined lighting This option selects one of three hardware-defined
photosensitivity settings of the camera. 0=bright light, photosensitivity settings of the camera. 0=bright light,
1=Medium (default), 2=Low light. This setting affects 1=Medium (default), 2=Low light. This setting affects
frame rate: the dimmer the lighting the lower the frame frame rate: the dimmer the lighting the lower the frame
rate (because longer exposition time is needed). The rate (because longer exposition time is needed). The
Model 2 cameras allow values more than 2 for this option, Model 2 cameras allow values more than 2 for this option,
thus enabling extremely high sensitivity at cost of frame thus enabling extremely high sensitivity at cost of frame
rate, color saturation and imaging sensor noise. rate, color saturation and imaging sensor noise.
sharpness This option controls smoothing (noise reduction) sharpness This option controls smoothing (noise reduction)
made by camera. Setting 0 is most smooth, setting 6 made by camera. Setting 0 is most smooth, setting 6
is most sharp. Be aware that CMOS sensor used in the is most sharp. Be aware that CMOS sensor used in the
camera is pretty noisy, so if you choose 6 you will camera is pretty noisy, so if you choose 6 you will
be greeted with "snowy" image. Default is 4. Model 2 be greeted with "snowy" image. Default is 4. Model 2
cameras do not support this feature. cameras do not support this feature.
size This setting chooses one of several image sizes that are size This setting chooses one of several image sizes that are
supported by this driver. Cameras may support more, but supported by this driver. Cameras may support more, but
it's difficult to reverse-engineer all formats. it's difficult to reverse-engineer all formats.
Following video sizes are supported: Following video sizes are supported:
size=0 128x96 (Model 1 only) size=0 128x96 (Model 1 only)
size=1 160x120 size=1 160x120
size=2 176x144 size=2 176x144
size=3 320x240 (Model 2 only) size=3 320x240 (Model 2 only)
size=4 352x240 (Model 2 only) size=4 352x240 (Model 2 only)
size=5 352x288 size=5 352x288
size=6 640x480 (Model 3 only) size=6 640x480 (Model 3 only)
The 352x288 is the native size of the Model 1 sensor The 352x288 is the native size of the Model 1 sensor
array, so it's the best resolution the camera can array, so it's the best resolution the camera can
yield. The best resolution of Model 2 is 176x144, and yield. The best resolution of Model 2 is 176x144, and
larger images are produced by stretching the bitmap. larger images are produced by stretching the bitmap.
Model 3 has sensor with 640x480 grid, and it works too, Model 3 has sensor with 640x480 grid, and it works too,
but the frame rate will be exceptionally low (1-2 FPS); but the frame rate will be exceptionally low (1-2 FPS);
it may be still OK for some applications, like security. it may be still OK for some applications, like security.
Choose the image size you need. The smaller image can Choose the image size you need. The smaller image can
support faster frame rate. Default is 352x288. support faster frame rate. Default is 352x288.
For more information and the Troubleshooting FAQ visit this URL: For more information and the Troubleshooting FAQ visit this URL:
http://www.linux-usb.org/ibmcam/ http://www.linux-usb.org/ibmcam/
WHAT NEEDS TO BE DONE: WHAT NEEDS TO BE DONE:

Просмотреть файл

@ -81,7 +81,7 @@ MODULE PARAMETERS:
TYPE: integer (Boolean) TYPE: integer (Boolean)
DEFAULT: 1 DEFAULT: 1
DESC: Brightness is normally under automatic control and can't be set DESC: Brightness is normally under automatic control and can't be set
manually by the video app. Set to 0 for manual control. manually by the video app. Set to 0 for manual control.
NAME: autogain NAME: autogain
TYPE: integer (Boolean) TYPE: integer (Boolean)
@ -97,13 +97,13 @@ MODULE PARAMETERS:
TYPE: integer (0-6) TYPE: integer (0-6)
DEFAULT: 3 DEFAULT: 3
DESC: Sets the threshold for printing debug messages. The higher the value, DESC: Sets the threshold for printing debug messages. The higher the value,
the more is printed. The levels are cumulative, and are as follows: the more is printed. The levels are cumulative, and are as follows:
0=no debug messages 0=no debug messages
1=init/detection/unload and other significant messages 1=init/detection/unload and other significant messages
2=some warning messages 2=some warning messages
3=config/control function calls 3=config/control function calls
4=most function calls and data parsing messages 4=most function calls and data parsing messages
5=highly repetitive mesgs 5=highly repetitive mesgs
NAME: snapshot NAME: snapshot
TYPE: integer (Boolean) TYPE: integer (Boolean)
@ -116,24 +116,24 @@ MODULE PARAMETERS:
TYPE: integer (1-4 for OV511, 1-31 for OV511+) TYPE: integer (1-4 for OV511, 1-31 for OV511+)
DEFAULT: 1 DEFAULT: 1
DESC: Number of cameras allowed to stream simultaneously on a single bus. DESC: Number of cameras allowed to stream simultaneously on a single bus.
Values higher than 1 reduce the data rate of each camera, allowing two Values higher than 1 reduce the data rate of each camera, allowing two
or more to be used at once. If you have a complicated setup involving or more to be used at once. If you have a complicated setup involving
both OV511 and OV511+ cameras, trial-and-error may be necessary for both OV511 and OV511+ cameras, trial-and-error may be necessary for
finding the optimum setting. finding the optimum setting.
NAME: compress NAME: compress
TYPE: integer (Boolean) TYPE: integer (Boolean)
DEFAULT: 0 DEFAULT: 0
DESC: Set this to 1 to turn on the camera's compression engine. This can DESC: Set this to 1 to turn on the camera's compression engine. This can
potentially increase the frame rate at the expense of quality, if you potentially increase the frame rate at the expense of quality, if you
have a fast CPU. You must load the proper compression module for your have a fast CPU. You must load the proper compression module for your
camera before starting your application (ov511_decomp or ov518_decomp). camera before starting your application (ov511_decomp or ov518_decomp).
NAME: testpat NAME: testpat
TYPE: integer (Boolean) TYPE: integer (Boolean)
DEFAULT: 0 DEFAULT: 0
DESC: This configures the camera's sensor to transmit a colored test-pattern DESC: This configures the camera's sensor to transmit a colored test-pattern
instead of an image. This does not work correctly yet. instead of an image. This does not work correctly yet.
NAME: dumppix NAME: dumppix
TYPE: integer (0-2) TYPE: integer (0-2)

Просмотреть файл

@ -1,9 +1,9 @@
SN9C10x PC Camera Controllers SN9C10x PC Camera Controllers
Driver for Linux Driver for Linux
============================= =============================
- Documentation - - Documentation -
Index Index
@ -176,46 +176,46 @@ Name: video_nr
Type: short array (min = 0, max = 64) Type: short array (min = 0, max = 64)
Syntax: <-1|n[,...]> Syntax: <-1|n[,...]>
Description: Specify V4L2 minor mode number: Description: Specify V4L2 minor mode number:
-1 = use next available -1 = use next available
n = use minor number n n = use minor number n
You can specify up to 64 cameras this way. You can specify up to 64 cameras this way.
For example: For example:
video_nr=-1,2,-1 would assign minor number 2 to the second video_nr=-1,2,-1 would assign minor number 2 to the second
recognized camera and use auto for the first one and for every recognized camera and use auto for the first one and for every
other camera. other camera.
Default: -1 Default: -1
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: force_munmap Name: force_munmap
Type: bool array (min = 0, max = 64) Type: bool array (min = 0, max = 64)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Force the application to unmap previously mapped buffer memory Description: Force the application to unmap previously mapped buffer memory
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
all the applications support this feature. This parameter is all the applications support this feature. This parameter is
specific for each detected camera. specific for each detected camera.
0 = do not force memory unmapping 0 = do not force memory unmapping
1 = force memory unmapping (save memory) 1 = force memory unmapping (save memory)
Default: 0 Default: 0
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: frame_timeout Name: frame_timeout
Type: uint array (min = 0, max = 64) Type: uint array (min = 0, max = 64)
Syntax: <n[,...]> Syntax: <n[,...]>
Description: Timeout for a video frame in seconds. This parameter is Description: Timeout for a video frame in seconds. This parameter is
specific for each detected camera. This parameter can be specific for each detected camera. This parameter can be
changed at runtime thanks to the /sys filesystem interface. changed at runtime thanks to the /sys filesystem interface.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: debug Name: debug
Type: ushort Type: ushort
Syntax: <n> Syntax: <n>
Description: Debugging information level, from 0 to 3: Description: Debugging information level, from 0 to 3:
0 = none (use carefully) 0 = none (use carefully)
1 = critical errors 1 = critical errors
2 = significant informations 2 = significant informations
3 = more verbose messages 3 = more verbose messages
Level 3 is useful for testing only, when only one device Level 3 is useful for testing only, when only one device
is used. It also shows some more informations about the is used. It also shows some more informations about the
hardware being detected. This parameter can be changed at hardware being detected. This parameter can be changed at
runtime thanks to the /sys filesystem interface. runtime thanks to the /sys filesystem interface.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
@ -280,24 +280,24 @@ Byte # Value Description
0x04 0xC4 Frame synchronisation pattern. 0x04 0xC4 Frame synchronisation pattern.
0x05 0x96 Frame synchronisation pattern. 0x05 0x96 Frame synchronisation pattern.
0x06 0xXX Unknown meaning. The exact value depends on the chip; 0x06 0xXX Unknown meaning. The exact value depends on the chip;
possible values are 0x00, 0x01 and 0x20. possible values are 0x00, 0x01 and 0x20.
0x07 0xXX Variable value, whose bits are ff00uzzc, where ff is a 0x07 0xXX Variable value, whose bits are ff00uzzc, where ff is a
frame counter, u is unknown, zz is a size indicator frame counter, u is unknown, zz is a size indicator
(00 = VGA, 01 = SIF, 10 = QSIF) and c stands for (00 = VGA, 01 = SIF, 10 = QSIF) and c stands for
"compression enabled" (1 = yes, 0 = no). "compression enabled" (1 = yes, 0 = no).
0x08 0xXX Brightness sum inside Auto-Exposure area (low-byte). 0x08 0xXX Brightness sum inside Auto-Exposure area (low-byte).
0x09 0xXX Brightness sum inside Auto-Exposure area (high-byte). 0x09 0xXX Brightness sum inside Auto-Exposure area (high-byte).
For a pure white image, this number will be equal to 500 For a pure white image, this number will be equal to 500
times the area of the specified AE area. For images times the area of the specified AE area. For images
that are not pure white, the value scales down according that are not pure white, the value scales down according
to relative whiteness. to relative whiteness.
0x0A 0xXX Brightness sum outside Auto-Exposure area (low-byte). 0x0A 0xXX Brightness sum outside Auto-Exposure area (low-byte).
0x0B 0xXX Brightness sum outside Auto-Exposure area (high-byte). 0x0B 0xXX Brightness sum outside Auto-Exposure area (high-byte).
For a pure white image, this number will be equal to 125 For a pure white image, this number will be equal to 125
times the area outside of the specified AE area. For times the area outside of the specified AE area. For
images that are not pure white, the value scales down images that are not pure white, the value scales down
according to relative whiteness. according to relative whiteness.
according to relative whiteness. according to relative whiteness.
The following bytes are used by the SN9C103 bridge only: The following bytes are used by the SN9C103 bridge only:

Просмотреть файл

@ -1,9 +1,9 @@
W996[87]CF JPEG USB Dual Mode Camera Chip W996[87]CF JPEG USB Dual Mode Camera Chip
Driver for Linux 2.6 (basic version) Driver for Linux 2.6 (basic version)
========================================= =========================================
- Documentation - - Documentation -
Index Index
@ -188,57 +188,57 @@ Name: ovmod_load
Type: bool Type: bool
Syntax: <0|1> Syntax: <0|1>
Description: Automatic 'ovcamchip' module loading: 0 disabled, 1 enabled. Description: Automatic 'ovcamchip' module loading: 0 disabled, 1 enabled.
If enabled, 'insmod' searches for the required 'ovcamchip' If enabled, 'insmod' searches for the required 'ovcamchip'
module in the system, according to its configuration, and module in the system, according to its configuration, and
loads that module automatically. This action is performed as loads that module automatically. This action is performed as
once soon as the 'w9968cf' module is loaded into memory. once soon as the 'w9968cf' module is loaded into memory.
Default: 1 Default: 1
Note: The kernel must be compiled with the CONFIG_KMOD option Note: The kernel must be compiled with the CONFIG_KMOD option
enabled for the 'ovcamchip' module to be loaded and for enabled for the 'ovcamchip' module to be loaded and for
this parameter to be present. this parameter to be present.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: simcams Name: simcams
Type: int Type: int
Syntax: <n> Syntax: <n>
Description: Number of cameras allowed to stream simultaneously. Description: Number of cameras allowed to stream simultaneously.
n may vary from 0 to 32. n may vary from 0 to 32.
Default: 32 Default: 32
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: video_nr Name: video_nr
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <-1|n[,...]> Syntax: <-1|n[,...]>
Description: Specify V4L minor mode number. Description: Specify V4L minor mode number.
-1 = use next available -1 = use next available
n = use minor number n n = use minor number n
You can specify up to 32 cameras this way. You can specify up to 32 cameras this way.
For example: For example:
video_nr=-1,2,-1 would assign minor number 2 to the second video_nr=-1,2,-1 would assign minor number 2 to the second
recognized camera and use auto for the first one and for every recognized camera and use auto for the first one and for every
other camera. other camera.
Default: -1 Default: -1
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: packet_size Name: packet_size
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <n[,...]> Syntax: <n[,...]>
Description: Specify the maximum data payload size in bytes for alternate Description: Specify the maximum data payload size in bytes for alternate
settings, for each device. n is scaled between 63 and 1023. settings, for each device. n is scaled between 63 and 1023.
Default: 1023 Default: 1023
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: max_buffers Name: max_buffers
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <n[,...]> Syntax: <n[,...]>
Description: For advanced users. Description: For advanced users.
Specify the maximum number of video frame buffers to allocate Specify the maximum number of video frame buffers to allocate
for each device, from 2 to 32. for each device, from 2 to 32.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: double_buffer Name: double_buffer
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Hardware double buffering: 0 disabled, 1 enabled. Description: Hardware double buffering: 0 disabled, 1 enabled.
It should be enabled if you want smooth video output: if you It should be enabled if you want smooth video output: if you
obtain out of sync. video, disable it, or try to obtain out of sync. video, disable it, or try to
decrease the 'clockdiv' module parameter value. decrease the 'clockdiv' module parameter value.
Default: 1 for every device. Default: 1 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: clamping Name: clamping
@ -251,9 +251,9 @@ Name: filter_type
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <0|1|2[,...]> Syntax: <0|1|2[,...]>
Description: Video filter type. Description: Video filter type.
0 none, 1 (1-2-1) 3-tap filter, 2 (2-3-6-3-2) 5-tap filter. 0 none, 1 (1-2-1) 3-tap filter, 2 (2-3-6-3-2) 5-tap filter.
The filter is used to reduce noise and aliasing artifacts The filter is used to reduce noise and aliasing artifacts
produced by the CCD or CMOS image sensor. produced by the CCD or CMOS image sensor.
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: largeview Name: largeview
@ -266,9 +266,9 @@ Name: upscaling
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Software scaling (for non-compressed video only): Description: Software scaling (for non-compressed video only):
0 disabled, 1 enabled. 0 disabled, 1 enabled.
Disable it if you have a slow CPU or you don't have enough Disable it if you have a slow CPU or you don't have enough
memory. memory.
Default: 0 for every device. Default: 0 for every device.
Note: If 'w9968cf-vpp' is not present, this parameter is set to 0. Note: If 'w9968cf-vpp' is not present, this parameter is set to 0.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
@ -276,36 +276,36 @@ Name: decompression
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <0|1|2[,...]> Syntax: <0|1|2[,...]>
Description: Software video decompression: Description: Software video decompression:
0 = disables decompression 0 = disables decompression
(doesn't allow formats needing decompression). (doesn't allow formats needing decompression).
1 = forces decompression 1 = forces decompression
(allows formats needing decompression only). (allows formats needing decompression only).
2 = allows any permitted formats. 2 = allows any permitted formats.
Formats supporting (de)compressed video are YUV422P and Formats supporting (de)compressed video are YUV422P and
YUV420P/YUV420 in any resolutions where width and height are YUV420P/YUV420 in any resolutions where width and height are
multiples of 16. multiples of 16.
Default: 2 for every device. Default: 2 for every device.
Note: If 'w9968cf-vpp' is not present, forcing decompression is not Note: If 'w9968cf-vpp' is not present, forcing decompression is not
allowed; in this case this parameter is set to 2. allowed; in this case this parameter is set to 2.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: force_palette Name: force_palette
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <0|9|10|13|15|8|7|1|6|3|4|5[,...]> Syntax: <0|9|10|13|15|8|7|1|6|3|4|5[,...]>
Description: Force picture palette. Description: Force picture palette.
In order: In order:
0 = Off - allows any of the following formats: 0 = Off - allows any of the following formats:
9 = UYVY 16 bpp - Original video, compression disabled 9 = UYVY 16 bpp - Original video, compression disabled
10 = YUV420 12 bpp - Original video, compression enabled 10 = YUV420 12 bpp - Original video, compression enabled
13 = YUV422P 16 bpp - Original video, compression enabled 13 = YUV422P 16 bpp - Original video, compression enabled
15 = YUV420P 12 bpp - Original video, compression enabled 15 = YUV420P 12 bpp - Original video, compression enabled
8 = YUVY 16 bpp - Software conversion from UYVY 8 = YUVY 16 bpp - Software conversion from UYVY
7 = YUV422 16 bpp - Software conversion from UYVY 7 = YUV422 16 bpp - Software conversion from UYVY
1 = GREY 8 bpp - Software conversion from UYVY 1 = GREY 8 bpp - Software conversion from UYVY
6 = RGB555 16 bpp - Software conversion from UYVY 6 = RGB555 16 bpp - Software conversion from UYVY
3 = RGB565 16 bpp - Software conversion from UYVY 3 = RGB565 16 bpp - Software conversion from UYVY
4 = RGB24 24 bpp - Software conversion from UYVY 4 = RGB24 24 bpp - Software conversion from UYVY
5 = RGB32 32 bpp - Software conversion from UYVY 5 = RGB32 32 bpp - Software conversion from UYVY
When not 0, this parameter will override 'decompression'. When not 0, this parameter will override 'decompression'.
Default: 0 for every device. Initial palette is 9 (UYVY). Default: 0 for every device. Initial palette is 9 (UYVY).
Note: If 'w9968cf-vpp' is not present, this parameter is set to 9. Note: If 'w9968cf-vpp' is not present, this parameter is set to 9.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
@ -313,77 +313,77 @@ Name: force_rgb
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Read RGB video data instead of BGR: Description: Read RGB video data instead of BGR:
1 = use RGB component ordering. 1 = use RGB component ordering.
0 = use BGR component ordering. 0 = use BGR component ordering.
This parameter has effect when using RGBX palettes only. This parameter has effect when using RGBX palettes only.
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: autobright Name: autobright
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Image sensor automatically changes brightness: Description: Image sensor automatically changes brightness:
0 = no, 1 = yes 0 = no, 1 = yes
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: autoexp Name: autoexp
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Image sensor automatically changes exposure: Description: Image sensor automatically changes exposure:
0 = no, 1 = yes 0 = no, 1 = yes
Default: 1 for every device. Default: 1 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: lightfreq Name: lightfreq
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <50|60[,...]> Syntax: <50|60[,...]>
Description: Light frequency in Hz: Description: Light frequency in Hz:
50 for European and Asian lighting, 60 for American lighting. 50 for European and Asian lighting, 60 for American lighting.
Default: 50 for every device. Default: 50 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: bandingfilter Name: bandingfilter
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Banding filter to reduce effects of fluorescent Description: Banding filter to reduce effects of fluorescent
lighting: lighting:
0 disabled, 1 enabled. 0 disabled, 1 enabled.
This filter tries to reduce the pattern of horizontal This filter tries to reduce the pattern of horizontal
light/dark bands caused by some (usually fluorescent) lighting. light/dark bands caused by some (usually fluorescent) lighting.
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: clockdiv Name: clockdiv
Type: int array (min = 0, max = 32) Type: int array (min = 0, max = 32)
Syntax: <-1|n[,...]> Syntax: <-1|n[,...]>
Description: Force pixel clock divisor to a specific value (for experts): Description: Force pixel clock divisor to a specific value (for experts):
n may vary from 0 to 127. n may vary from 0 to 127.
-1 for automatic value. -1 for automatic value.
See also the 'double_buffer' module parameter. See also the 'double_buffer' module parameter.
Default: -1 for every device. Default: -1 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: backlight Name: backlight
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Objects are lit from behind: Description: Objects are lit from behind:
0 = no, 1 = yes 0 = no, 1 = yes
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: mirror Name: mirror
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: Reverse image horizontally: Description: Reverse image horizontally:
0 = no, 1 = yes 0 = no, 1 = yes
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: monochrome Name: monochrome
Type: bool array (min = 0, max = 32) Type: bool array (min = 0, max = 32)
Syntax: <0|1[,...]> Syntax: <0|1[,...]>
Description: The image sensor is monochrome: Description: The image sensor is monochrome:
0 = no, 1 = yes 0 = no, 1 = yes
Default: 0 for every device. Default: 0 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: brightness Name: brightness
Type: long array (min = 0, max = 32) Type: long array (min = 0, max = 32)
Syntax: <n[,...]> Syntax: <n[,...]>
Description: Set picture brightness (0-65535). Description: Set picture brightness (0-65535).
This parameter has no effect if 'autobright' is enabled. This parameter has no effect if 'autobright' is enabled.
Default: 31000 for every device. Default: 31000 for every device.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: hue Name: hue
@ -414,23 +414,23 @@ Name: debug
Type: int Type: int
Syntax: <n> Syntax: <n>
Description: Debugging information level, from 0 to 6: Description: Debugging information level, from 0 to 6:
0 = none (use carefully) 0 = none (use carefully)
1 = critical errors 1 = critical errors
2 = significant informations 2 = significant informations
3 = configuration or general messages 3 = configuration or general messages
4 = warnings 4 = warnings
5 = called functions 5 = called functions
6 = function internals 6 = function internals
Level 5 and 6 are useful for testing only, when only one Level 5 and 6 are useful for testing only, when only one
device is used. device is used.
Default: 2 Default: 2
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
Name: specific_debug Name: specific_debug
Type: bool Type: bool
Syntax: <0|1> Syntax: <0|1>
Description: Enable or disable specific debugging messages: Description: Enable or disable specific debugging messages:
0 = print messages concerning every level <= 'debug' level. 0 = print messages concerning every level <= 'debug' level.
1 = print messages concerning the level indicated by 'debug'. 1 = print messages concerning the level indicated by 'debug'.
Default: 0 Default: 0
------------------------------------------------------------------------------- -------------------------------------------------------------------------------