summaryrefslogtreecommitdiff
path: root/Documentation/media/uapi/dvb/video-set-highlight.rst
blob: 90aeafd923b71fd4de4590ffc2f341123c91e34e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
.. -*- coding: utf-8; mode: rst -*-

.. _VIDEO_SET_HIGHLIGHT:

===================
VIDEO_SET_HIGHLIGHT
===================

Name
----

VIDEO_SET_HIGHLIGHT

.. attention:: This ioctl is deprecated.

Synopsis
--------

.. c:function:: int ioctl(fd, VIDEO_SET_HIGHLIGHT, struct video_highlight *vhilite)
    :name: VIDEO_SET_HIGHLIGHT


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_HIGHLIGHT for this command.

    -  .. row 3

       -  video_highlight_t \*vhilite

       -  SPU Highlight information according to section ??.


Description
-----------

This ioctl sets the SPU highlight information for the menu access of a
DVD.

.. c:type:: video_highlight

.. code-block:: c

	typedef
	struct video_highlight {
		int     active;      /*    1=show highlight, 0=hide highlight */
		__u8    contrast1;   /*    7- 4  Pattern pixel contrast */
				/*    3- 0  Background pixel contrast */
		__u8    contrast2;   /*    7- 4  Emphasis pixel-2 contrast */
				/*    3- 0  Emphasis pixel-1 contrast */
		__u8    color1;      /*    7- 4  Pattern pixel color */
				/*    3- 0  Background pixel color */
		__u8    color2;      /*    7- 4  Emphasis pixel-2 color */
				/*    3- 0  Emphasis pixel-1 color */
		__u32    ypos;       /*   23-22  auto action mode */
				/*   21-12  start y */
				/*    9- 0  end y */
		__u32    xpos;       /*   23-22  button color number */
				/*   21-12  start x */
				/*    9- 0  end x */
	} video_highlight_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.