Browse Source

V4L/DVB (4042): Documentation: whitespace cleanup

Signed-off-by: Michael Krufky <mkrufky@linuxtv.org>
Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
Michael Krufky 19 years ago
parent
commit
6e20409004

+ 4 - 4
Documentation/video4linux/bttv/CONTRIBUTORS

@@ -1,4 +1,4 @@
-Contributors to bttv: 
+Contributors to bttv:
 
 
 Michael Chu <mmchu@pobox.com>
 Michael Chu <mmchu@pobox.com>
   AverMedia fix and more flexible card recognition
   AverMedia fix and more flexible card recognition
@@ -8,8 +8,8 @@ Alan Cox <alan@redhat.com>
 
 
 Chris Kleitsch
 Chris Kleitsch
   Hardware I2C
   Hardware I2C
-  
-Gerd Knorr <kraxel@cs.tu-berlin.de> 
+
+Gerd Knorr <kraxel@cs.tu-berlin.de>
   Radio card (ITT sound processor)
   Radio card (ITT sound processor)
 
 
 bigfoot <bigfoot@net-way.net>
 bigfoot <bigfoot@net-way.net>
@@ -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)
 
 
 
 
 
 

+ 26 - 26
Documentation/video4linux/et61x251.txt

@@ -1,9 +1,9 @@
 
 
-                       ET61X[12]51 PC Camera Controllers
-                                Driver for Linux
-                       =================================
+		       ET61X[12]51 PC Camera Controllers
+				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
-                 n = use minor number n
-                You can specify up to 64 cameras this way.
-                For example:
-                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
-                other camera.
+		-1 = use next available
+		 n = use minor number n
+		You can specify up to 64 cameras this way.
+		For example:
+		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
+		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
-                all the applications support this feature. This parameter is
-                specific for each detected camera.
-                0 = do not force memory unmapping
-                1 = force memory unmapping (save memory)
+		before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
+		all the applications support this feature. This parameter is
+		specific for each detected camera.
+		0 = do not force memory unmapping
+		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
-                changed at runtime thanks to the /sys filesystem interface.
+		specific for each detected camera. This parameter can be
+		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)
-                1 = critical errors
-                2 = significant informations
-                3 = more verbose messages
-                Level 3 is useful for testing only, when only one device
-                is used at the same time. It also shows some more informations
-                about the hardware being detected. This module parameter can be
-                changed at runtime thanks to the /sys filesystem interface.
+		0 = none (use carefully)
+		1 = critical errors
+		2 = significant informations
+		3 = more verbose messages
+		Level 3 is useful for testing only, when only one device
+		is used at the same time. It also shows some more informations
+		about the hardware being detected. This module parameter can be
+		changed at runtime thanks to the /sys filesystem interface.
 Default:        2
 Default:        2
 -------------------------------------------------------------------------------
 -------------------------------------------------------------------------------
 
 

+ 84 - 84
Documentation/video4linux/ibmcam.txt

@@ -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
-                what values do what. 0=off.
+		If you are a developer then you will see in the code
+		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
-                any of extra features this option provides:
-
-                FLAGS_RETRY_VIDIOCSYNC  1  This bit allows to retry failed
-                                           VIDIOCSYNC ioctls without failing.
-                                           Will work with xawtv, will not
-                                           with xrealproducer. Default is
-                                           not set.
-                FLAGS_MONOCHROME        2  Activates monochrome (b/w) mode.
-                FLAGS_DISPLAY_HINTS     4  Shows colored pixels which have
-                                           magic meaning to developers.
-                FLAGS_OVERLAY_STATS     8  Shows tiny numbers on screen,
-                                           useful only for debugging.
-                FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers.
-                FLAGS_SEPARATE_FRAMES   32 Shows each frame separately, as
-                                           it was received from the camera.
-                                           Default (not set) is to mix the
-                                           preceding frame in to compensate
-                                           for occasional loss of Isoc data
-                                           on high frame rates.
-                FLAGS_CLEAN_FRAMES      64 Forces "cleanup" of each frame
-                                           prior to use; relevant only if
-                                           FLAGS_SEPARATE_FRAMES is set.
-                                           Default is not to clean frames,
-                                           this is a little faster but may
-                                           produce flicker if frame rate is
-                                           too high and Isoc data gets lost.
-                FLAGS_NO_DECODING      128 This flag turns the video stream
-                                           decoder off, and dumps the raw
-                                           Isoc data from the camera into
-                                           the reading process. Useful to
-                                           developers, but not to users.
+		bits to produce what you want. Usually you don't want
+		any of extra features this option provides:
+
+		FLAGS_RETRY_VIDIOCSYNC  1  This bit allows to retry failed
+					   VIDIOCSYNC ioctls without failing.
+					   Will work with xawtv, will not
+					   with xrealproducer. Default is
+					   not set.
+		FLAGS_MONOCHROME        2  Activates monochrome (b/w) mode.
+		FLAGS_DISPLAY_HINTS     4  Shows colored pixels which have
+					   magic meaning to developers.
+		FLAGS_OVERLAY_STATS     8  Shows tiny numbers on screen,
+					   useful only for debugging.
+		FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers.
+		FLAGS_SEPARATE_FRAMES   32 Shows each frame separately, as
+					   it was received from the camera.
+					   Default (not set) is to mix the
+					   preceding frame in to compensate
+					   for occasional loss of Isoc data
+					   on high frame rates.
+		FLAGS_CLEAN_FRAMES      64 Forces "cleanup" of each frame
+					   prior to use; relevant only if
+					   FLAGS_SEPARATE_FRAMES is set.
+					   Default is not to clean frames,
+					   this is a little faster but may
+					   produce flicker if frame rate is
+					   too high and Isoc data gets lost.
+		FLAGS_NO_DECODING      128 This flag turns the video stream
+					   decoder off, and dumps the raw
+					   Isoc data from the camera into
+					   the reading process. Useful to
+					   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")
-                because camera changes frame rate depending on amount
-                of light available. Setting 0 is slowest, 6 is fastest.
-                Beware - fast settings are very demanding and may not
-                work well with all video sizes. Be conservative.
+		an approximate setting (in terms of "worst" ... "best")
+		because camera changes frame rate depending on amount
+		of light available. Setting 0 is slowest, 6 is fastest.
+		Beware - fast settings are very demanding and may not
+		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
-                what usual "hue" control does. Both controls affect
-                YUV colorspace: regular "hue" control adjusts only
-                U component, and this "hue_correction" option similarly
-                adjusts only V component. However usually it is enough
-                to tweak only U or V to compensate for colored light or
-                color temperature; this option simply allows more
-                complicated correction when and if it is necessary.
+		hue of the image in a way slightly different from
+		what usual "hue" control does. Both controls affect
+		YUV colorspace: regular "hue" control adjusts only
+		U component, and this "hue_correction" option similarly
+		adjusts only V component. However usually it is enough
+		to tweak only U or V to compensate for colored light or
+		color temperature; this option simply allows more
+		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
-                any V4L application connects to it. Good for webcams.
+		preconfigure the camera when it gets connected, before
+		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,
-                1=Medium (default), 2=Low light. This setting affects
-                frame rate: the dimmer the lighting the lower the frame
-                rate (because longer exposition time is needed). The
-                Model 2 cameras allow values more than 2 for this option,
-                thus enabling extremely high sensitivity at cost of frame
-                rate, color saturation and imaging sensor noise.
+		photosensitivity settings of the camera. 0=bright light,
+		1=Medium (default), 2=Low light. This setting affects
+		frame rate: the dimmer the lighting the lower the frame
+		rate (because longer exposition time is needed). The
+		Model 2 cameras allow values more than 2 for this option,
+		thus enabling extremely high sensitivity at cost of frame
+		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
-                is most sharp. Be aware that CMOS sensor used in the
-                camera is pretty noisy, so if you choose 6 you will
-                be greeted with "snowy" image. Default is 4. Model 2
-                cameras do not support this feature.
+		made by camera. Setting 0 is most smooth, setting 6
+		is most sharp. Be aware that CMOS sensor used in the
+		camera is pretty noisy, so if you choose 6 you will
+		be greeted with "snowy" image. Default is 4. Model 2
+		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
-                it's difficult to reverse-engineer all formats.
-                Following video sizes are supported:
-
-                size=0     128x96  (Model 1 only)
-                size=1     160x120
-                size=2     176x144
-                size=3     320x240 (Model 2 only)
-                size=4     352x240 (Model 2 only)
-                size=5     352x288
-                size=6     640x480 (Model 3 only)
-
-                The 352x288 is the native size of the Model 1 sensor
-                array, so it's the best resolution the camera can
-                yield. The best resolution of Model 2 is 176x144, and
-                larger images are produced by stretching the bitmap.
-                Model 3 has sensor with 640x480 grid, and it works too,
-                but the frame rate will be exceptionally low (1-2 FPS);
-                it may be still OK for some applications, like security.
-                Choose the image size you need. The smaller image can
-                support faster frame rate. Default is 352x288.
+		supported by this driver. Cameras may support more, but
+		it's difficult to reverse-engineer all formats.
+		Following video sizes are supported:
+
+		size=0     128x96  (Model 1 only)
+		size=1     160x120
+		size=2     176x144
+		size=3     320x240 (Model 2 only)
+		size=4     352x240 (Model 2 only)
+		size=5     352x288
+		size=6     640x480 (Model 3 only)
+
+		The 352x288 is the native size of the Model 1 sensor
+		array, so it's the best resolution the camera can
+		yield. The best resolution of Model 2 is 176x144, and
+		larger images are produced by stretching the bitmap.
+		Model 3 has sensor with 640x480 grid, and it works too,
+		but the frame rate will be exceptionally low (1-2 FPS);
+		it may be still OK for some applications, like security.
+		Choose the image size you need. The smaller image can
+		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:
 
 

+ 16 - 16
Documentation/video4linux/ov511.txt

@@ -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:
-          0=no debug messages
-          1=init/detection/unload and other significant messages
-          2=some warning messages
-          3=config/control function calls
-          4=most function calls and data parsing messages
-          5=highly repetitive mesgs
+	the more is printed. The levels are cumulative, and are as follows:
+	  0=no debug messages
+	  1=init/detection/unload and other significant messages
+	  2=some warning messages
+	  3=config/control function calls
+	  4=most function calls and data parsing messages
+	  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
-        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
-        finding the optimum setting.
+	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
+	both OV511 and OV511+ cameras, trial-and-error may be necessary for
+	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
-        have a fast CPU. You must load the proper compression module for your
-        camera before starting your application (ov511_decomp or ov518_decomp).
+	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
+	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)

+ 39 - 39
Documentation/video4linux/sn9c102.txt

@@ -1,9 +1,9 @@
 
 
-                         SN9C10x PC Camera Controllers
-                                Driver for Linux
-                         =============================
+			 SN9C10x PC Camera Controllers
+				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
-                 n = use minor number n
-                You can specify up to 64 cameras this way.
-                For example:
-                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
-                other camera.
+		-1 = use next available
+		 n = use minor number n
+		You can specify up to 64 cameras this way.
+		For example:
+		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
+		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
-                all the applications support this feature. This parameter is
-                specific for each detected camera.
-                0 = do not force memory unmapping
-                1 = force memory unmapping (save memory)
+		before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
+		all the applications support this feature. This parameter is
+		specific for each detected camera.
+		0 = do not force memory unmapping
+		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
-                changed at runtime thanks to the /sys filesystem interface.
+		specific for each detected camera. This parameter can be
+		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)
-                1 = critical errors
-                2 = significant informations
-                3 = more verbose messages
-                Level 3 is useful for testing only, when only one device
-                is used. It also shows some more informations about the
-                hardware being detected. This parameter can be changed at
-                runtime thanks to the /sys filesystem interface.
+		0 = none (use carefully)
+		1 = critical errors
+		2 = significant informations
+		3 = more verbose messages
+		Level 3 is useful for testing only, when only one device
+		is used. It also shows some more informations about the
+		hardware being detected. This parameter can be changed at
+		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
-                      (00 = VGA, 01 = SIF, 10 = QSIF) and c stands for
-                      "compression enabled" (1 = yes, 0 = no).
+		      frame counter, u is unknown, zz is a size indicator
+		      (00 = VGA, 01 = SIF, 10 = QSIF) and c stands for
+		      "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
-                      times the area of the specified AE area. For images
-                      that are not pure white, the value scales down according
-                      to relative whiteness.
+		      For a pure white image, this number will be equal to 500
+		      times the area of the specified AE area. For images
+		      that are not pure white, the value scales down according
+		      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
-                      times the area outside of the specified AE area. For
-                      images that are not pure white, the value scales down
-                      according to relative whiteness.
-                      according to relative whiteness.
+		      For a pure white image, this number will be equal to 125
+		      times the area outside of the specified AE area. For
+		      images that are not pure white, the value scales down
+		      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:
 
 

+ 81 - 81
Documentation/video4linux/w9968cf.txt

@@ -1,9 +1,9 @@
 
 
-                   W996[87]CF JPEG USB Dual Mode Camera Chip
-                     Driver for Linux 2.6 (basic version)
-                   =========================================
+		   W996[87]CF JPEG USB Dual Mode Camera Chip
+		     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'
-                 module in the system, according to its configuration, and
-                 loads that module automatically. This action is performed as
-                 once soon as the 'w9968cf' module is loaded into memory.
+		 If enabled, 'insmod' searches for the required 'ovcamchip'
+		 module in the system, according to its configuration, and
+		 loads that module automatically. This action is performed as
+		 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
-                 this parameter to be present.
+		 enabled for the 'ovcamchip' module to be loaded and for
+		 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
-                 n = use minor number n
-                You can specify up to 32 cameras this way.
-                For example:
-                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
-                other camera.
+		-1 = use next available
+		 n = use minor number n
+		You can specify up to 32 cameras this way.
+		For example:
+		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
+		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
-                for each device, from 2 to 32.
+		Specify the maximum number of video frame buffers to allocate
+		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
-                obtain out of sync. video, disable it, or try to
-                decrease the 'clockdiv' module parameter value.
+		It should be enabled if you want smooth video output: if you
+		obtain out of sync. video, disable it, or try to
+		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.
-                The filter is used to reduce noise and aliasing artifacts
-                produced by the CCD or CMOS image sensor.
+		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
+		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.
-                Disable it if you have a slow CPU or you don't have enough
-                memory.
+		0 disabled, 1 enabled.
+		Disable it if you have a slow CPU or you don't have enough
+		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
-                    (doesn't allow formats needing decompression).
-                1 = forces decompression
-                    (allows formats needing decompression only).
-                2 = allows any permitted formats.
-                Formats supporting (de)compressed video are YUV422P and
-                YUV420P/YUV420 in any resolutions where width and height are
-                multiples of 16.
+		0 = disables decompression
+		    (doesn't allow formats needing decompression).
+		1 = forces decompression
+		    (allows formats needing decompression only).
+		2 = allows any permitted formats.
+		Formats supporting (de)compressed video are YUV422P and
+		YUV420P/YUV420 in any resolutions where width and height are
+		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:
-                 0 = Off - allows any of the following formats:
-                 9 = UYVY    16 bpp - Original video, compression disabled
-                10 = YUV420  12 bpp - Original video, compression enabled
-                13 = YUV422P 16 bpp - Original video, compression enabled
-                15 = YUV420P 12 bpp - Original video, compression enabled
-                 8 = YUVY    16 bpp - Software conversion from UYVY
-                 7 = YUV422  16 bpp - Software conversion from UYVY
-                 1 = GREY     8 bpp - Software conversion from UYVY
-                 6 = RGB555  16 bpp - Software conversion from UYVY
-                 3 = RGB565  16 bpp - Software conversion from UYVY
-                 4 = RGB24   24 bpp - Software conversion from UYVY
-                 5 = RGB32   32 bpp - Software conversion from UYVY
-                When not 0, this parameter will override 'decompression'.
+		In order:
+		 0 = Off - allows any of the following formats:
+		 9 = UYVY    16 bpp - Original video, compression disabled
+		10 = YUV420  12 bpp - Original video, compression enabled
+		13 = YUV422P 16 bpp - Original video, compression enabled
+		15 = YUV420P 12 bpp - Original video, compression enabled
+		 8 = YUVY    16 bpp - Software conversion from UYVY
+		 7 = YUV422  16 bpp - Software conversion from UYVY
+		 1 = GREY     8 bpp - Software conversion from UYVY
+		 6 = RGB555  16 bpp - Software conversion from UYVY
+		 3 = RGB565  16 bpp - Software conversion from UYVY
+		 4 = RGB24   24 bpp - Software conversion from UYVY
+		 5 = RGB32   32 bpp - Software conversion from UYVY
+		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.
-                0 = use BGR component ordering.
-                This parameter has effect when using RGBX palettes only.
+		1 = use RGB component ordering.
+		0 = use BGR component ordering.
+		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:
-                0 disabled, 1 enabled.
-                This filter tries to reduce the pattern of horizontal
-                light/dark bands caused by some (usually fluorescent) lighting.
+		lighting:
+		0 disabled, 1 enabled.
+		This filter tries to reduce the pattern of horizontal
+		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.
-                -1 for automatic value.
-                See also the 'double_buffer' module parameter.
+		n may vary from 0 to 127.
+		-1 for automatic value.
+		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)
-                1 = critical errors
-                2 = significant informations
-                3 = configuration or general messages
-                4 = warnings
-                5 = called functions
-                6 = function internals
-                Level 5 and 6 are useful for testing only, when only one
-                device is used.
+		0 = none (use carefully)
+		1 = critical errors
+		2 = significant informations
+		3 = configuration or general messages
+		4 = warnings
+		5 = called functions
+		6 = function internals
+		Level 5 and 6 are useful for testing only, when only one
+		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.
-                1 = print messages concerning the level indicated by 'debug'.
+		0 = print messages concerning every level <= 'debug' level.
+		1 = print messages concerning the level indicated by 'debug'.
 Default:        0
 Default:        0
 -------------------------------------------------------------------------------
 -------------------------------------------------------------------------------