media/v4l/crop.rst

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
6 Image Cropping, Insertion and Scaling -- the CROP API
12    <selection-api>`. The new API should be preferred in most cases,
13    with the exception of pixel aspect ratio detection, which is
15    equivalent in the SELECTION API. See :ref:`selection-vs-crop` for a
62 .. _crop-scale:
64 .. kernel-figure:: crop.svg
66     :align:  center
81 :ref:`vbi-hsync`). Vertically ITU-R line numbers of the first field
82 (see ITU R-525 line numbering for :ref:`525 lines <vbi-525>` and for
83 :ref:`625 lines <vbi-625>`), multiplied by two if the driver
98 shall align with the center of the active picture area of the video
167 .. code-block:: c
175     if (-1 == ioctl (fd, VIDIOC_CROPCAP, &cropcap)) {
186     if (-1 == ioctl (fd, VIDIOC_S_CROP, &crop)
196 .. code-block:: c
203     /* Scale down to 1/4 size of full picture. */
213     if (-1 == ioctl (fd, VIDIOC_S_FMT, &format)) {
226 .. code-block:: c
234     if (-1 == ioctl (fd, VIDIOC_CROPCAP;, &cropcap)) {
254     if (-1 == ioctl (fd, VIDIOC_S_CROP, &crop)
260 Example: Current scaling factor and pixel aspect
265 .. code-block:: c
277     if (-1 == ioctl (fd, VIDIOC_CROPCAP, &cropcap)) {
285     if (-1 == ioctl (fd, VIDIOC_G_CROP, &crop)) {
298     if (-1 == ioctl (fd, VIDIOC_G_FMT, &format)) {
312     /* Devices following ITU-R BT.601 do not capture