비디오 입력과 출력

물리 커넥터와 장치 유형

비디오 입력과 출력은 장치의 물리 커넥터입니다. RF 안테나·케이블, CVBS 또는 컴포지트 비디오, S-Video, RGB 커넥터가 대표적이며 카메라 센서도 비디오 입력으로 취급합니다.

비디오와 VBI 캡처 장치는 입력을 가지고, 비디오와 VBI 출력 장치는 출력을 가지며 각각 최소 하나가 존재합니다. 라디오 장치에는 비디오 입력이나 출력이 없습니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. _video:

************************
Video Inputs and Outputs
************************

Video inputs and outputs are physical connectors of a device. These can
be for example: RF connectors (antenna/cable), CVBS a.k.a. Composite
Video, S-Video and RGB connectors. Camera sensors are also considered to
be a video input. Video and VBI capture devices have inputs. Video and
VBI output devices have outputs, at least one each. Radio devices have
no video inputs or outputs.

To learn about the number and attributes of the available inputs and

입출력 열거, 조회와 선택

응용 프로그램은 `VIDIOC_ENUMINPUT`과 `VIDIOC_ENUMOUTPUT` ioctl로 사용 가능한 입력·출력의 개수와 속성을 각각 열거합니다. 현재 입력을 조회할 때 `VIDIOC_ENUMINPUT`이 반환하는 `struct v4l2_input`에는 해당 입력에 적용되는 신호 상태 정보도 들어 있습니다.

`VIDIOC_G_INPUT`과 `VIDIOC_G_OUTPUT`은 현재 입력 또는 출력의 인덱스를 반환합니다. 다른 경로를 선택하려면 `VIDIOC_S_INPUT` 또는 `VIDIOC_S_OUTPUT`을 호출합니다. 장치에 입력이 하나 이상 있으면 드라이버는 모든 입력 ioctl을, 출력이 하나 이상 있으면 모든 출력 ioctl을 구현해야 합니다.

outputs applications can enumerate them with the
:ref:`VIDIOC_ENUMINPUT` and
:ref:`VIDIOC_ENUMOUTPUT` ioctl, respectively. The
struct :c:type:`v4l2_input` returned by the
:ref:`VIDIOC_ENUMINPUT` ioctl also contains signal
status information applicable when the current video input is queried.

The :ref:`VIDIOC_G_INPUT <VIDIOC_G_INPUT>` and
:ref:`VIDIOC_G_OUTPUT <VIDIOC_G_OUTPUT>` ioctls return the index of
the current video input or output. To select a different input or output
applications call the :ref:`VIDIOC_S_INPUT <VIDIOC_G_INPUT>` and
:ref:`VIDIOC_S_OUTPUT <VIDIOC_G_OUTPUT>` ioctls. Drivers must
implement all the input ioctls when the device has one or more inputs,
all the output ioctls when the device has one or more outputs.

현재 비디오 입력 정보 조회 예제

첫 번째 예제는 `VIDIOC_G_INPUT`으로 현재 입력 인덱스를 얻습니다. `struct v4l2_input`을 0으로 초기화하고 그 인덱스를 `input.index`에 넣은 뒤 `VIDIOC_ENUMINPUT`을 호출해 해당 입력의 전체 설명을 가져옵니다.

두 ioctl 중 하나라도 -1을 반환하면 `perror()`로 실패한 요청 이름을 출력하고 종료합니다. 성공하면 `input.name`을 사용해 현재 입력의 사람이 읽을 수 있는 이름을 출력합니다.

Example: Information about the current video input
==================================================

.. code-block:: c

    struct v4l2_input input;
    int index;

    if (-1 == ioctl(fd, VIDIOC_G_INPUT, &index)) {
	perror("VIDIOC_G_INPUT");
	exit(EXIT_FAILURE);
    }

    memset(&input, 0, sizeof(input));
    input.index = index;

    if (-1 == ioctl(fd, VIDIOC_ENUMINPUT, &input)) {
	perror("VIDIOC_ENUMINPUT");
	exit(EXIT_FAILURE);
    }

    printf("Current input: %s\\n", input.name);


Example: Switching to the first video input
===========================================

첫 번째 비디오 입력으로 전환하는 예제

두 번째 예제는 인덱스를 0으로 설정하고 `VIDIOC_S_INPUT`에 그 주소를 전달해 첫 번째 비디오 입력을 선택합니다. 호출이 -1이면 오류를 보고하고 종료합니다. 인덱스가 유효한지는 앞서 `VIDIOC_ENUMINPUT`으로 열거한 범위 안에서 확인해야 합니다.

.. code-block:: c

    int index;

    index = 0;

    if (-1 == ioctl(fd, VIDIOC_S_INPUT, &index)) {
	perror("VIDIOC_S_INPUT");
	exit(EXIT_FAILURE);
    }