2018-08-30 22:15:26 +08:00
|
|
|
.. Permission is granted to copy, distribute and/or modify this
|
|
|
|
|
.. document under the terms of the GNU Free Documentation License,
|
|
|
|
|
.. Version 1.1 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 is included at
|
|
|
|
|
.. Documentation/media/uapi/fdl-appendix.rst.
|
|
|
|
|
..
|
|
|
|
|
.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
|
|
|
|
|
|
2016-06-30 21:18:56 +08:00
|
|
|
.. _common:
|
|
|
|
|
|
|
|
|
|
###################
|
|
|
|
|
Common API Elements
|
|
|
|
|
###################
|
|
|
|
|
Programming a V4L2 device consists of these steps:
|
|
|
|
|
|
|
|
|
|
- Opening the device
|
|
|
|
|
|
|
|
|
|
- Changing device properties, selecting a video and audio input, video
|
|
|
|
|
standard, picture brightness a. o.
|
|
|
|
|
|
|
|
|
|
- Negotiating a data format
|
|
|
|
|
|
|
|
|
|
- Negotiating an input/output method
|
|
|
|
|
|
|
|
|
|
- The actual input/output loop
|
|
|
|
|
|
|
|
|
|
- Closing the device
|
|
|
|
|
|
|
|
|
|
In practice most steps are optional and can be executed out of order. It
|
|
|
|
|
depends on the V4L2 device type, you can read about the details in
|
|
|
|
|
:ref:`devices`. In this chapter we will discuss the basic concepts
|
|
|
|
|
applicable to all devices.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
|
|
open
|
|
|
|
|
querycap
|
|
|
|
|
app-pri
|
|
|
|
|
video
|
|
|
|
|
audio
|
|
|
|
|
tuner
|
|
|
|
|
standard
|
|
|
|
|
dv-timings
|
2016-07-02 19:37:16 +08:00
|
|
|
control
|
|
|
|
|
extended-controls
|
2016-06-30 21:18:56 +08:00
|
|
|
format
|
|
|
|
|
planar-apis
|
|
|
|
|
selection-api
|
2018-05-14 19:27:24 +08:00
|
|
|
crop
|
2016-06-30 21:18:56 +08:00
|
|
|
streaming-par
|
