media: docs: selection: rename files to something meaningful
These files have an automatically-generated numbering. Rename them with a name that suggests their meaning. Reported-by: Hans Verkuil <hverkuil@xs4all.nl> 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>
This commit is contained in:

committed by
Mauro Carvalho Chehab

parent
579d76deb1
commit
ff9273f5b8
28
Documentation/media/uapi/v4l/selection-api-intro.rst
Normal file
28
Documentation/media/uapi/v4l/selection-api-intro.rst
Normal file
@@ -0,0 +1,28 @@
|
||||
.. -*- coding: utf-8; mode: rst -*-
|
||||
|
||||
************
|
||||
Introduction
|
||||
************
|
||||
|
||||
Some video capture devices can sample a subsection of a picture and
|
||||
shrink or enlarge it to an image of arbitrary size. Next, the devices
|
||||
can insert the image into larger one. Some video output devices can crop
|
||||
part of an input image, scale it up or down and insert it at an
|
||||
arbitrary scan line and horizontal offset into a video signal. We call
|
||||
these abilities cropping, scaling and composing.
|
||||
|
||||
On a video *capture* device the source is a video signal, and the
|
||||
cropping target determine the area actually sampled. The sink is an
|
||||
image stored in a memory buffer. The composing area specifies which part
|
||||
of the buffer is actually written to by the hardware.
|
||||
|
||||
On a video *output* device the source is an image in a memory buffer,
|
||||
and the cropping target is a part of an image to be shown on a display.
|
||||
The sink is the display or the graphics screen. The application may
|
||||
select the part of display where the image should be displayed. The size
|
||||
and position of such a window is controlled by the compose target.
|
||||
|
||||
Rectangles for all cropping and composing targets are defined even if
|
||||
the device does supports neither cropping nor composing. Their size and
|
||||
position will be fixed in such a case. If the device does not support
|
||||
scaling then the cropping and composing rectangles have the same size.
|
Reference in New Issue
Block a user