| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485 |
- .. -*- coding: utf-8; mode: rst -*-
- .. _VIDEO_SET_FORMAT:
- ================
- VIDEO_SET_FORMAT
- ================
- Name
- ----
- VIDEO_SET_FORMAT
- .. attention:: This ioctl is deprecated.
- Synopsis
- --------
- .. c:function:: int ioctl(fd, VIDEO_SET_FORMAT, video_format_t format)
- :name: VIDEO_SET_FORMAT
- Arguments
- ---------
- .. flat-table::
- :header-rows: 0
- :stub-columns: 0
- - .. row 1
- - int fd
- - File descriptor returned by a previous call to open().
- - .. row 2
- - int request
- - Equals VIDEO_SET_FORMAT for this command.
- - .. row 3
- - video_format_t format
- - video format of TV as defined in section ??.
- Description
- -----------
- This ioctl sets the screen format (aspect ratio) of the connected output
- device (TV) so that the output of the decoder can be adjusted
- accordingly.
- .. c:type:: video_format_t
- .. code-block:: c
- typedef enum {
- VIDEO_FORMAT_4_3, /* Select 4:3 format */
- VIDEO_FORMAT_16_9, /* Select 16:9 format. */
- VIDEO_FORMAT_221_1 /* 2.21:1 */
- } video_format_t;
- 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.
- .. flat-table::
- :header-rows: 0
- :stub-columns: 0
- - .. row 1
- - ``EINVAL``
- - format is not a valid video format.
|