| 1 |
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later |
| 2 |
.. c:namespace:: V4L |
| 3 |
|
| 4 |
************ |
| 5 |
Introduction |
| 6 |
************ |
| 7 |
|
| 8 |
Some video capture devices can sample a subsection of a picture and |
| 9 |
shrink or enlarge it to an image of arbitrary size. Next, the devices |
| 10 |
can insert the image into larger one. Some video output devices can crop |
| 11 |
part of an input image, scale it up or down and insert it at an |
| 12 |
arbitrary scan line and horizontal offset into a video signal. We call |
| 13 |
these abilities cropping, scaling and composing. |
| 14 |
|
| 15 |
On a video *capture* device the source is a video signal, and the |
| 16 |
cropping target determine the area actually sampled. The sink is an |
| 17 |
image stored in a memory buffer. The composing area specifies which part |
| 18 |
of the buffer is actually written to by the hardware. |
| 19 |
|
| 20 |
On a video *output* device the source is an image in a memory buffer, |
| 21 |
and the cropping target is a part of an image to be shown on a display. |
| 22 |
The sink is the display or the graphics screen. The application may |
| 23 |
select the part of display where the image should be displayed. The size |
| 24 |
and position of such a window is controlled by the compose target. |
| 25 |
|
| 26 |
Rectangles for all cropping and composing targets are defined even if |
| 27 |
the device does supports neither cropping nor composing. Their size and |
| 28 |
position will be fixed in such a case. If the device does not support |
| 29 |
scaling then the cropping and composing rectangles have the same size. |