mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-30 07:34:12 +08:00
579d76deb1
Having two somewhat similar and largely overlapping APIs is confusing, especially since the older one appears in the docs before the newer and most featureful counterpart. Clarify all of this in several ways: - swap the two sections - give a name to the two APIs in the section names - add a note at the beginning of the CROP API section - update note about VIDIOC_CROPCAP Also remove a note that is incorrect (correct wording is in vidioc-cropcap.rst). Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
47 lines
886 B
ReStructuredText
47 lines
886 B
ReStructuredText
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _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
|
|
control
|
|
extended-controls
|
|
format
|
|
planar-apis
|
|
selection-api
|
|
crop
|
|
streaming-par
|