Lines Matching +full:video +full:- +full:encoder
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
13 VIDIOC_ENCODER_CMD - VIDIOC_TRY_ENCODER_CMD - Execute an encoder command
38 These ioctls control an audio/video (usually MPEG-) encoder.
39 ``VIDIOC_ENCODER_CMD`` sends a command to the encoder,
54 call will restart the encoder.
57 call sends an implicit START command to the encoder if it has not been
62 the encoder, and all buffered data is discarded. Applies to both queues of
67 encoders (as further documented in :ref:`encoder`).
73 .. flat-table:: struct v4l2_encoder_cmd
74 :header-rows: 0
75 :stub-columns: 0
78 * - __u32
79 - ``cmd``
80 - The encoder command, see :ref:`encoder-cmds`.
81 * - __u32
82 - ``flags``
83 - Flags to go with the command, see :ref:`encoder-flags`. If no
86 * - __u32
87 - ``data``\ [8]
88 - Reserved for future extensions. Drivers and applications must set
94 .. _encoder-cmds:
96 .. flat-table:: Encoder Commands
97 :header-rows: 0
98 :stub-columns: 0
101 * - ``V4L2_ENC_CMD_START``
102 - 0
103 - Start the encoder. When the encoder is already running or paused,
106 For a device implementing the :ref:`encoder`, once the drain sequence
110 an ``EBUSY`` error code. See :ref:`encoder` for more details.
111 * - ``V4L2_ENC_CMD_STOP``
112 - 1
113 - Stop the encoder. When the ``V4L2_ENC_CMD_STOP_AT_GOP_END`` flag
116 encoder is already stopped, this command does nothing.
118 For a device implementing the :ref:`encoder`, the command will initiate
119 the drain sequence as documented in :ref:`encoder`. No flags or other
123 * - ``V4L2_ENC_CMD_PAUSE``
124 - 2
125 - Pause the encoder. When the encoder has not been started yet, the
126 driver will return an ``EPERM`` error code. When the encoder is
129 * - ``V4L2_ENC_CMD_RESUME``
130 - 3
131 - Resume encoding after a PAUSE command. When the encoder has not
133 the encoder is already running, this command does nothing. No
138 .. _encoder-flags:
140 .. flat-table:: Encoder Command Flags
141 :header-rows: 0
142 :stub-columns: 0
145 * - ``V4L2_ENC_CMD_STOP_AT_GOP_END``
146 - 0x0001
147 - Stop encoding at the end of the current *Group Of Pictures*,
150 Does not apply to :ref:`encoder`.
155 On success 0 is returned, on error -1 and the ``errno`` variable is set
157 :ref:`Generic Error Codes <gen-errors>` chapter.
160 A drain sequence of a device implementing the :ref:`encoder` is still in
161 progress. It is not allowed to issue another encoder command until it
168 The application sent a PAUSE or RESUME command when the encoder was