363 lines
6.8 KiB
HTML
363 lines
6.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Introduction</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
|
REL="HOME"
|
|
TITLE="The Webcam HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="The Webcam HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Enabling Support for Your (Webcam) Hardware in Linux"
|
|
HREF="hardware.html"></HEAD
|
|
><BODY
|
|
CLASS="SECT1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>The Webcam HOWTO</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="hardware.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECT1"
|
|
><H1
|
|
CLASS="SECT1"
|
|
><A
|
|
NAME="INTRO"
|
|
></A
|
|
>1. Introduction</H1
|
|
><P
|
|
> This document was written to assist the reader in setting up and
|
|
configuring a webcam, digital camera, or other video device in the Linux
|
|
operating system.
|
|
|
|
It outlines how to enable the necessary kernel and/or software support and
|
|
various frame-grabber applications that can be used to access your device.
|
|
|
|
It does not discuss the differences in graphic and video formats, the
|
|
features and/or capabilities of particular devices, or the encoding or
|
|
conversion of video formats.</P
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="COPYRIGHT"
|
|
></A
|
|
>1.1. Copyright Information</H2
|
|
><P
|
|
> This document is Copyright 2004-2005, by Howard Shane.</P
|
|
><P
|
|
> Permission is granted to copy, distribute, and/or modify this
|
|
document under the terms of the GNU Free Documentation License, Version
|
|
1.2 or any later version published by the Free Software Foundation with
|
|
no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
|
|
|
|
A copy of the license can be found in <A
|
|
HREF="appendix.html"
|
|
>Appendix A</A
|
|
>. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="DISCLAIMER"
|
|
></A
|
|
>1.2. Disclaimer</H2
|
|
><P
|
|
> No liability for the contents of this document can be accepted.
|
|
|
|
Use the concepts, examples and other content entirely at your own risk.
|
|
|
|
As this is a new edition, there may be technical or other inaccuracies
|
|
that may result in the loss of irreplaceable data.
|
|
|
|
In any case, proceed with caution, and realize that although errors
|
|
are highly unlikely, the author can accept no responsibility for them.</P
|
|
><P
|
|
> All copyrights are held by their respective owners, unless
|
|
specifically noted otherwise.
|
|
|
|
Use of a term in this document should not be regarded as affecting the
|
|
validity of any trademark or service mark. </P
|
|
><P
|
|
> Naming of particular products or brands should not be seen as
|
|
endorsements. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="NEWVERSIONS"
|
|
></A
|
|
>1.3. New Versions</H2
|
|
><P
|
|
> This is the fourth release. </P
|
|
><P
|
|
> The latest version number of this document can be found <A
|
|
HREF="http://www.tldp.org/HOWTO/Webcam-HOWTO/"
|
|
TARGET="_top"
|
|
>here</A
|
|
>. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="CREDITS"
|
|
></A
|
|
>1.4. Credits</H2
|
|
><P
|
|
> I would like to thank all of the individuals that have pioneered
|
|
video support for Linux, in particular the v4l and v4l2 teams, Gerd Knorr,
|
|
and the Metzler Brothers among others. </P
|
|
><P
|
|
> Also, I would like to thank Marla, who has the grace to accept my
|
|
imperfections and idiosyncrasies unconditionally, including my obsession
|
|
with projects such as this. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="FEEDBACK"
|
|
></A
|
|
>1.5. Feedback</H2
|
|
><P
|
|
> Please send any
|
|
additions or comments pertaining to this document to the following email
|
|
address: <TT
|
|
CLASS="EMAIL"
|
|
><<A
|
|
HREF="mailto:hshane[AT]austin.rr.com"
|
|
>hshane[AT]austin.rr.com</A
|
|
>></TT
|
|
>.
|
|
|
|
In particular, if you have information about new devices or interfaces
|
|
supported or errata, please contact me so we can keep this document
|
|
up-to-date! </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="CONVENTIONS"
|
|
></A
|
|
>1.6. Conventions Used in this Document</H2
|
|
><P
|
|
> The following conventions are used in this document and are
|
|
outlined here for those who may not yet have a complete understanding
|
|
of how to access and control the underlying operating system in Linux,
|
|
which is usually via the Bash shell. </P
|
|
><P
|
|
> First, filenames are referenced in a paragraph like so:
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>/path/file</TT
|
|
> </P
|
|
><P
|
|
> Commands in Linux are executed (or 'called') at the command prompt,
|
|
otherwise known as the 'command line.'
|
|
|
|
If you are in the non-graphical (text-based) environment, you will usually
|
|
be presented with the Bash shell prompt which is a dollar sign: </P
|
|
><P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> $</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
> ...or the hash mark:</P
|
|
><P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> #</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
> ...if you have logged in as root or have otherwise acquired root, or
|
|
'superuser' privileges.
|
|
|
|
You can also access the Bash shell in the X window
|
|
system, otherwise known as X or X11, with an <A
|
|
HREF="http://invisible-island.net/xterm/"
|
|
TARGET="_top"
|
|
>xterm</A
|
|
> or similar
|
|
X-terminal-emulator.
|
|
|
|
Commands to be performed at the Bash prompt, but referenced in a paragraph
|
|
of this document, usually look like this: <B
|
|
CLASS="COMMAND"
|
|
>do this now</B
|
|
></P
|
|
><P
|
|
> Commands and/or the resulting output of commands may also be
|
|
outlined with screen output in their own paragraph or heading: </P
|
|
><P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
> $ date
|
|
Sun Jul 27 22:37:11 CDT 2003</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
> </P
|
|
><P
|
|
> When a command is written in front of the Bash prompt (e.g.,
|
|
<B
|
|
CLASS="COMMAND"
|
|
>$ date</B
|
|
> above), it is assumed the [Return]
|
|
or [Enter] key has been pressed after the command, possibly
|
|
followed by the output on a new line (e.g., as in the date in
|
|
the above example). </P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="hardware.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>The Webcam HOWTO</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Enabling Support for Your (Webcam) Hardware in Linux</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |