요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
.. c:namespace:: V4L
4
.. _VIDIOC_OVERLAY:
6
********************
7
ioctl VIDIOC_OVERLAY
8
********************
10
Name
11
====
13
VIDIOC_OVERLAY - Start or stop video overlay
15
Synopsis
16
========
18
.. c:macro:: VIDIOC_OVERLAY
20
``int ioctl(int fd, VIDIOC_OVERLAY, const int *argp)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by :c:func:`open()`.
28
``argp``
29
Pointer to an integer.
31
Description
32
===========
34
This ioctl is part of the :ref:`video overlay <overlay>` I/O method.
35
Applications call :ref:`VIDIOC_OVERLAY` to start or stop the overlay. It
36
takes a pointer to an integer which must be set to zero by the
37
application to stop overlay, to one to start.
39
Drivers do not support :ref:`VIDIOC_STREAMON` or
40
:ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` with
41
``V4L2_BUF_TYPE_VIDEO_OVERLAY``.
43
Return Value
44
============
46
On success 0 is returned, on error -1 and the ``errno`` variable is set
47
appropriately. The generic error codes are described at the
48
:ref:`Generic Error Codes <gen-errors>` chapter.
50
EINVAL
51
The overlay parameters have not been set up. See :ref:`overlay`
52
for the necessary steps.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
목적, 호출 형식과 인자
1-28`VIDIOC_OVERLAY`는 video overlay I/O 방식에서 overlay를 시작하거나 중지합니다. `argp`는 애플리케이션이 값을 넣은 정수 포인터입니다.
`*argp`동작
0overlay 중지
1overlay 시작
정수 값 하나로 상태를 전환합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: V4L
.. _VIDIOC_OVERLAY:
********************
ioctl VIDIOC_OVERLAY
********************
Name
====
VIDIOC_OVERLAY - Start or stop video overlay
Synopsis
========
.. c:macro:: VIDIOC_OVERLAY
``int ioctl(int fd, VIDIOC_OVERLAY, const int *argp)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``argp``Overlay 제어 제약
29-41이 명령은 전용 video overlay I/O 방식의 일부입니다. `V4L2_BUF_TYPE_VIDEO_OVERLAY`에는 `VIDIOC_STREAMON`이나 `VIDIOC_STREAMOFF`를 사용하지 않으며, 시작·정지는 이 ioctl로 수행합니다.
Pointer to an integer.
Description
===========
This ioctl is part of the :ref:`video overlay <overlay>` I/O method.
Applications call :ref:`VIDIOC_OVERLAY` to start or stop the overlay. It
takes a pointer to an integer which must be set to zero by the
application to stop overlay, to one to start.
Drivers do not support :ref:`VIDIOC_STREAMON` or
:ref:`VIDIOC_STREAMOFF <VIDIOC_STREAMON>` with
``V4L2_BUF_TYPE_VIDEO_OVERLAY``.반환값과 오류
42-52성공하면 0, 오류이면 -1을 반환하고 `errno`를 설정합니다. 공통 오류는 Generic Error Codes 절을 따릅니다.
errno조건
`EINVAL`필요한 overlay 매개변수를 아직 설정하지 않음
시작 전에 overlay 형식을 구성해야 합니다.
Return Value
============
On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
EINVAL
The overlay parameters have not been set up. See :ref:`overlay`
for the necessary steps.
요약·해설
vidioc-overlay.rst:1-52Overlay는 일반 streaming buffer type과 다른 시작·정지 경로를 사용합니다.