diff options
Diffstat (limited to 'Documentation/video4linux/ibmcam.txt')
-rw-r--r-- | Documentation/video4linux/ibmcam.txt | 168 |
1 files changed, 84 insertions, 84 deletions
diff --git a/Documentation/video4linux/ibmcam.txt b/Documentation/video4linux/ibmcam.txt index 4a40a2e99451..397a94eb77b8 100644 --- a/Documentation/video4linux/ibmcam.txt +++ b/Documentation/video4linux/ibmcam.txt | |||
@@ -21,7 +21,7 @@ Internal interface: Video For Linux (V4L) | |||
21 | Supported controls: | 21 | Supported controls: |
22 | - by V4L: Contrast, Brightness, Color, Hue | 22 | - by V4L: Contrast, Brightness, Color, Hue |
23 | - by driver options: frame rate, lighting conditions, video format, | 23 | - by driver options: frame rate, lighting conditions, video format, |
24 | default picture settings, sharpness. | 24 | default picture settings, sharpness. |
25 | 25 | ||
26 | SUPPORTED CAMERAS: | 26 | SUPPORTED CAMERAS: |
27 | 27 | ||
@@ -191,66 +191,66 @@ init_model2_sat Integer 0..255 [0x34] init_model2_sat=65 | |||
191 | init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200 | 191 | init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200 |
192 | 192 | ||
193 | debug You don't need this option unless you are a developer. | 193 | debug You don't need this option unless you are a developer. |
194 | If you are a developer then you will see in the code | 194 | If you are a developer then you will see in the code |
195 | what values do what. 0=off. | 195 | what values do what. 0=off. |
196 | 196 | ||
197 | flags This is a bit mask, and you can combine any number of | 197 | flags This is a bit mask, and you can combine any number of |
198 | bits to produce what you want. Usually you don't want | 198 | bits to produce what you want. Usually you don't want |
199 | any of extra features this option provides: | 199 | any of extra features this option provides: |
200 | 200 | ||
201 | FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed | 201 | FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed |
202 | VIDIOCSYNC ioctls without failing. | 202 | VIDIOCSYNC ioctls without failing. |
203 | Will work with xawtv, will not | 203 | Will work with xawtv, will not |
204 | with xrealproducer. Default is | 204 | with xrealproducer. Default is |
205 | not set. | 205 | not set. |
206 | FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode. | 206 | FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode. |
207 | FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have | 207 | FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have |
208 | magic meaning to developers. | 208 | magic meaning to developers. |
209 | FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen, | 209 | FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen, |
210 | useful only for debugging. | 210 | useful only for debugging. |
211 | FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers. | 211 | FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers. |
212 | FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as | 212 | FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as |
213 | it was received from the camera. | 213 | it was received from the camera. |
214 | Default (not set) is to mix the | 214 | Default (not set) is to mix the |
215 | preceding frame in to compensate | 215 | preceding frame in to compensate |
216 | for occasional loss of Isoc data | 216 | for occasional loss of Isoc data |
217 | on high frame rates. | 217 | on high frame rates. |
218 | FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame | 218 | FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame |
219 | prior to use; relevant only if | 219 | prior to use; relevant only if |
220 | FLAGS_SEPARATE_FRAMES is set. | 220 | FLAGS_SEPARATE_FRAMES is set. |
221 | Default is not to clean frames, | 221 | Default is not to clean frames, |
222 | this is a little faster but may | 222 | this is a little faster but may |
223 | produce flicker if frame rate is | 223 | produce flicker if frame rate is |
224 | too high and Isoc data gets lost. | 224 | too high and Isoc data gets lost. |
225 | FLAGS_NO_DECODING 128 This flag turns the video stream | 225 | FLAGS_NO_DECODING 128 This flag turns the video stream |
226 | decoder off, and dumps the raw | 226 | decoder off, and dumps the raw |
227 | Isoc data from the camera into | 227 | Isoc data from the camera into |
228 | the reading process. Useful to | 228 | the reading process. Useful to |
229 | developers, but not to users. | 229 | developers, but not to users. |
230 | 230 | ||
231 | framerate This setting controls frame rate of the camera. This is | 231 | framerate This setting controls frame rate of the camera. This is |
232 | an approximate setting (in terms of "worst" ... "best") | 232 | an approximate setting (in terms of "worst" ... "best") |
233 | because camera changes frame rate depending on amount | 233 | because camera changes frame rate depending on amount |
234 | of light available. Setting 0 is slowest, 6 is fastest. | 234 | of light available. Setting 0 is slowest, 6 is fastest. |
235 | Beware - fast settings are very demanding and may not | 235 | Beware - fast settings are very demanding and may not |
236 | work well with all video sizes. Be conservative. | 236 | work well with all video sizes. Be conservative. |
237 | 237 | ||
238 | hue_correction This highly optional setting allows to adjust the | 238 | hue_correction This highly optional setting allows to adjust the |
239 | hue of the image in a way slightly different from | 239 | hue of the image in a way slightly different from |
240 | what usual "hue" control does. Both controls affect | 240 | what usual "hue" control does. Both controls affect |
241 | YUV colorspace: regular "hue" control adjusts only | 241 | YUV colorspace: regular "hue" control adjusts only |
242 | U component, and this "hue_correction" option similarly | 242 | U component, and this "hue_correction" option similarly |
243 | adjusts only V component. However usually it is enough | 243 | adjusts only V component. However usually it is enough |
244 | to tweak only U or V to compensate for colored light or | 244 | to tweak only U or V to compensate for colored light or |
245 | color temperature; this option simply allows more | 245 | color temperature; this option simply allows more |
246 | complicated correction when and if it is necessary. | 246 | complicated correction when and if it is necessary. |
247 | 247 | ||
248 | init_brightness These settings specify _initial_ values which will be | 248 | init_brightness These settings specify _initial_ values which will be |
249 | init_contrast used to set up the camera. If your V4L application has | 249 | init_contrast used to set up the camera. If your V4L application has |
250 | init_color its own controls to adjust the picture then these | 250 | init_color its own controls to adjust the picture then these |
251 | init_hue controls will be used too. These options allow you to | 251 | init_hue controls will be used too. These options allow you to |
252 | preconfigure the camera when it gets connected, before | 252 | preconfigure the camera when it gets connected, before |
253 | any V4L application connects to it. Good for webcams. | 253 | any V4L application connects to it. Good for webcams. |
254 | 254 | ||
255 | init_model2_rg These initial settings alter color balance of the | 255 | init_model2_rg These initial settings alter color balance of the |
256 | init_model2_rg2 camera on hardware level. All four settings may be used | 256 | 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 | |||
258 | init_model2_yb settings only apply to Model 2 cameras. | 258 | init_model2_yb settings only apply to Model 2 cameras. |
259 | 259 | ||
260 | lighting This option selects one of three hardware-defined | 260 | lighting This option selects one of three hardware-defined |
261 | photosensitivity settings of the camera. 0=bright light, | 261 | photosensitivity settings of the camera. 0=bright light, |
262 | 1=Medium (default), 2=Low light. This setting affects | 262 | 1=Medium (default), 2=Low light. This setting affects |
263 | frame rate: the dimmer the lighting the lower the frame | 263 | frame rate: the dimmer the lighting the lower the frame |
264 | rate (because longer exposition time is needed). The | 264 | rate (because longer exposition time is needed). The |
265 | Model 2 cameras allow values more than 2 for this option, | 265 | Model 2 cameras allow values more than 2 for this option, |
266 | thus enabling extremely high sensitivity at cost of frame | 266 | thus enabling extremely high sensitivity at cost of frame |
267 | rate, color saturation and imaging sensor noise. | 267 | rate, color saturation and imaging sensor noise. |
268 | 268 | ||
269 | sharpness This option controls smoothing (noise reduction) | 269 | sharpness This option controls smoothing (noise reduction) |
270 | made by camera. Setting 0 is most smooth, setting 6 | 270 | made by camera. Setting 0 is most smooth, setting 6 |
271 | is most sharp. Be aware that CMOS sensor used in the | 271 | is most sharp. Be aware that CMOS sensor used in the |
272 | camera is pretty noisy, so if you choose 6 you will | 272 | camera is pretty noisy, so if you choose 6 you will |
273 | be greeted with "snowy" image. Default is 4. Model 2 | 273 | be greeted with "snowy" image. Default is 4. Model 2 |
274 | cameras do not support this feature. | 274 | cameras do not support this feature. |
275 | 275 | ||
276 | size This setting chooses one of several image sizes that are | 276 | size This setting chooses one of several image sizes that are |
277 | supported by this driver. Cameras may support more, but | 277 | supported by this driver. Cameras may support more, but |
278 | it's difficult to reverse-engineer all formats. | 278 | it's difficult to reverse-engineer all formats. |
279 | Following video sizes are supported: | 279 | Following video sizes are supported: |
280 | 280 | ||
281 | size=0 128x96 (Model 1 only) | 281 | size=0 128x96 (Model 1 only) |
282 | size=1 160x120 | 282 | size=1 160x120 |
283 | size=2 176x144 | 283 | size=2 176x144 |
284 | size=3 320x240 (Model 2 only) | 284 | size=3 320x240 (Model 2 only) |
285 | size=4 352x240 (Model 2 only) | 285 | size=4 352x240 (Model 2 only) |
286 | size=5 352x288 | 286 | size=5 352x288 |
287 | size=6 640x480 (Model 3 only) | 287 | size=6 640x480 (Model 3 only) |
288 | 288 | ||
289 | The 352x288 is the native size of the Model 1 sensor | 289 | The 352x288 is the native size of the Model 1 sensor |
290 | array, so it's the best resolution the camera can | 290 | array, so it's the best resolution the camera can |
291 | yield. The best resolution of Model 2 is 176x144, and | 291 | yield. The best resolution of Model 2 is 176x144, and |
292 | larger images are produced by stretching the bitmap. | 292 | larger images are produced by stretching the bitmap. |
293 | Model 3 has sensor with 640x480 grid, and it works too, | 293 | Model 3 has sensor with 640x480 grid, and it works too, |
294 | but the frame rate will be exceptionally low (1-2 FPS); | 294 | but the frame rate will be exceptionally low (1-2 FPS); |
295 | it may be still OK for some applications, like security. | 295 | it may be still OK for some applications, like security. |
296 | Choose the image size you need. The smaller image can | 296 | Choose the image size you need. The smaller image can |
297 | support faster frame rate. Default is 352x288. | 297 | support faster frame rate. Default is 352x288. |
298 | 298 | ||
299 | For more information and the Troubleshooting FAQ visit this URL: | 299 | For more information and the Troubleshooting FAQ visit this URL: |
300 | 300 | ||
301 | http://www.linux-usb.org/ibmcam/ | 301 | http://www.linux-usb.org/ibmcam/ |
302 | 302 | ||
303 | WHAT NEEDS TO BE DONE: | 303 | WHAT NEEDS TO BE DONE: |
304 | 304 | ||