Lines Matching +full:no +full:- +full:ref +full:- +full:current +full:- +full:limit

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
6 Image Cropping, Insertion and Scaling -- the CROP API
11    The CROP API is mostly superseded by the newer :ref:`SELECTION API
12    <selection-api>`. The new API should be preferred in most cases,
14    implemented by :ref:`VIDIOC_CROPCAP <VIDIOC_CROPCAP>` and has no
15    equivalent in the SELECTION API. See :ref:`selection-vs-crop` for a
29    Despite their name, the :ref:`VIDIOC_CROPCAP <VIDIOC_CROPCAP>`,
30    :ref:`VIDIOC_G_CROP <VIDIOC_G_CROP>` and :ref:`VIDIOC_S_CROP
37 overlay) is negotiated with the :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>`
38 and :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctls.
42 :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` and :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>`
48 support scaling or the :ref:`VIDIOC_G_CROP <VIDIOC_G_CROP>` and
49 :ref:`VIDIOC_S_CROP <VIDIOC_G_CROP>` ioctls. Their size (and position
55    API will also support the :ref:`VIDIOC_CROPCAP <VIDIOC_CROPCAP>`
62 .. _crop-scale:
64 .. kernel-figure:: crop.svg
77 by the :ref:`VIDIOC_CROPCAP <VIDIOC_CROPCAP>` ioctl. To support a wide
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
90 :ref:`VIDIOC_G_CROP <VIDIOC_G_CROP>` and :ref:`VIDIOC_S_CROP <VIDIOC_G_CROP>`
128 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` ioctl however shall not change
134 which are also the upper limit in this example, of 640 × 400 pixels at
139 is 608 × 224 (224 × 2:1 would exceed the limit 400). The offset 0, 0 is
141 reported by :ref:`VIDIOC_CROPCAP <VIDIOC_CROPCAP>` the application can
146 rectangle of 608 × 456 pixels. The present scaling factors limit
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
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