1*793e52d4SMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 2*793e52d4SMauro Carvalho Chehab.. c:namespace:: DTV.video 3*793e52d4SMauro Carvalho Chehab 4*793e52d4SMauro Carvalho Chehab.. _VIDEO_SET_FORMAT: 5*793e52d4SMauro Carvalho Chehab 6*793e52d4SMauro Carvalho Chehab================ 7*793e52d4SMauro Carvalho ChehabVIDEO_SET_FORMAT 8*793e52d4SMauro Carvalho Chehab================ 9*793e52d4SMauro Carvalho Chehab 10*793e52d4SMauro Carvalho ChehabName 11*793e52d4SMauro Carvalho Chehab---- 12*793e52d4SMauro Carvalho Chehab 13*793e52d4SMauro Carvalho ChehabVIDEO_SET_FORMAT 14*793e52d4SMauro Carvalho Chehab 15*793e52d4SMauro Carvalho Chehab.. attention:: This ioctl is deprecated. 16*793e52d4SMauro Carvalho Chehab 17*793e52d4SMauro Carvalho ChehabSynopsis 18*793e52d4SMauro Carvalho Chehab-------- 19*793e52d4SMauro Carvalho Chehab 20*793e52d4SMauro Carvalho Chehab.. c:macro:: VIDEO_SET_FORMAT 21*793e52d4SMauro Carvalho Chehab 22*793e52d4SMauro Carvalho Chehab``int ioctl(fd, VIDEO_SET_FORMAT, video_format_t format)`` 23*793e52d4SMauro Carvalho Chehab 24*793e52d4SMauro Carvalho ChehabArguments 25*793e52d4SMauro Carvalho Chehab--------- 26*793e52d4SMauro Carvalho Chehab 27*793e52d4SMauro Carvalho Chehab.. flat-table:: 28*793e52d4SMauro Carvalho Chehab :header-rows: 0 29*793e52d4SMauro Carvalho Chehab :stub-columns: 0 30*793e52d4SMauro Carvalho Chehab 31*793e52d4SMauro Carvalho Chehab - .. row 1 32*793e52d4SMauro Carvalho Chehab 33*793e52d4SMauro Carvalho Chehab - int fd 34*793e52d4SMauro Carvalho Chehab 35*793e52d4SMauro Carvalho Chehab - File descriptor returned by a previous call to open(). 36*793e52d4SMauro Carvalho Chehab 37*793e52d4SMauro Carvalho Chehab - .. row 2 38*793e52d4SMauro Carvalho Chehab 39*793e52d4SMauro Carvalho Chehab - int request 40*793e52d4SMauro Carvalho Chehab 41*793e52d4SMauro Carvalho Chehab - Equals VIDEO_SET_FORMAT for this command. 42*793e52d4SMauro Carvalho Chehab 43*793e52d4SMauro Carvalho Chehab - .. row 3 44*793e52d4SMauro Carvalho Chehab 45*793e52d4SMauro Carvalho Chehab - video_format_t format 46*793e52d4SMauro Carvalho Chehab 47*793e52d4SMauro Carvalho Chehab - video format of TV as defined in section ??. 48*793e52d4SMauro Carvalho Chehab 49*793e52d4SMauro Carvalho ChehabDescription 50*793e52d4SMauro Carvalho Chehab----------- 51*793e52d4SMauro Carvalho Chehab 52*793e52d4SMauro Carvalho ChehabThis ioctl sets the screen format (aspect ratio) of the connected output 53*793e52d4SMauro Carvalho Chehabdevice (TV) so that the output of the decoder can be adjusted 54*793e52d4SMauro Carvalho Chehabaccordingly. 55*793e52d4SMauro Carvalho Chehab 56*793e52d4SMauro Carvalho Chehab.. c:type:: video_format_t 57*793e52d4SMauro Carvalho Chehab 58*793e52d4SMauro Carvalho Chehab.. code-block:: c 59*793e52d4SMauro Carvalho Chehab 60*793e52d4SMauro Carvalho Chehab typedef enum { 61*793e52d4SMauro Carvalho Chehab VIDEO_FORMAT_4_3, /* Select 4:3 format */ 62*793e52d4SMauro Carvalho Chehab VIDEO_FORMAT_16_9, /* Select 16:9 format. */ 63*793e52d4SMauro Carvalho Chehab VIDEO_FORMAT_221_1 /* 2.21:1 */ 64*793e52d4SMauro Carvalho Chehab } video_format_t; 65*793e52d4SMauro Carvalho Chehab 66*793e52d4SMauro Carvalho ChehabReturn Value 67*793e52d4SMauro Carvalho Chehab------------ 68*793e52d4SMauro Carvalho Chehab 69*793e52d4SMauro Carvalho ChehabOn success 0 is returned, on error -1 and the ``errno`` variable is set 70*793e52d4SMauro Carvalho Chehabappropriately. The generic error codes are described at the 71*793e52d4SMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 72*793e52d4SMauro Carvalho Chehab 73*793e52d4SMauro Carvalho Chehab 74*793e52d4SMauro Carvalho Chehab.. flat-table:: 75*793e52d4SMauro Carvalho Chehab :header-rows: 0 76*793e52d4SMauro Carvalho Chehab :stub-columns: 0 77*793e52d4SMauro Carvalho Chehab 78*793e52d4SMauro Carvalho Chehab - .. row 1 79*793e52d4SMauro Carvalho Chehab 80*793e52d4SMauro Carvalho Chehab - ``EINVAL`` 81*793e52d4SMauro Carvalho Chehab 82*793e52d4SMauro Carvalho Chehab - format is not a valid video format. 83