6.2.2.24. VIDEO_SET_FORMAT¶

6.2.2.24.1. Name¶

VIDEO_SET_FORMAT

Attention

This ioctl is deprecated.

6.2.2.24.2. Synopsis¶

VIDEO_SET_FORMAT¶

int ioctl(fd, VIDEO_SET_FORMAT, video_format_t format)

6.2.2.24.3. Arguments¶

int fd	File descriptor returned by a previous call to `open()`.
int request	Equals VIDEO_SET_FORMAT for this command.
video_format_t format	video format of TV as defined in section ??.

6.2.2.24.4. 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.

video_format_t¶

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;

6.2.2.24.5. 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 Generic Error Codes chapter.

EINVAL format is not a valid video format.