summaryrefslogtreecommitdiffstats
path: root/src/3rdparty/phonon/phonon/backend.dox
blob: 8a9c5b2529ed7e84d68bf1329fe5170d4eec3268 (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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/**
\page phonon_Backend The Backend Class
\ingroup Backend

\section phonon_Backend_requiredfunctions Required Functions
\li bool \ref phonon_Backend_supportsOSD "supportsOSD()"
\li bool \ref phonon_Backend_supportsFourcc "supportsFourcc( quint32 )"
\li bool \ref phonon_Backend_supportsSubtitles "supportsSubtitles()"
\li bool \ref phonon_Backend_supportsVideo "supportsVideo()"
\li QStringList \ref phonon_Backend_availableMimeTypes "availableMimeTypes()"

\section Member Function Documentation

\subsection phonon_Backend_supportsFourcc bool supportsFourcc( quint32 fourcc )
Tells whether the FOURCC (four character code) is supported for
the \ref phonon_VideoDataOutput "VideoDataOutput" interface. If you return \c true, you have to be
able to return VideoFrame objects accordingly from
\ref phonon_VideoDataOutput "VideoDataOutput".
\param fourcc A four character code defining a video frame format.
\returns \c true if your \ref phonon_VideoDataOutput "VideoDataOutput" can
output video frames in the requested format.
\returns \c false if the video frames can not be converted into the requested
format.

\subsection phonon_Backend_availableMimeTypes QStringList availableMimeTypes()
Lists the MIME types the backend can read and decode.

\subsection phonon_Backend_xIndexes QSet<int> <device/codec/effect/...>Indexes()
	Returns a set of indexes that identify the devices/codecs/effects/... the
	backend supports. This list needs to be compiled from looking at
	available hardware and virtual devices/plugins/... . The implementation
	should use cached information, but you need to invalidate the cache
	whenever the hardware configuration changes or new virtual devices come
	available/new plugins are installed/... .

	\return The indexes of the available devices/codecs/effects/...

	\see \ref phonon_Backend_xName
	\see \ref phonon_Backend_xDescription

\subsection phonon_Backend_xName QString <device/codec/effect/...>Name( int index )
	Returns the name of the given device/codec/effect/...

	\param index The index of one device/codec/effect/... this is one index
	out of \ref phonon_Backend_xIndexes
	
	\returns A translated user visible string to name the device.

	\see \ref phonon_Backend_xIndexes
	\see \ref phonon_Backend_xDescription
\subsection phonon_Backend_xDescription QString <device/codec/effect/...>Description( int index )
	Returns the description of the given device/codec/effect/...

	\param index The index of one device/codec/effect/... this is one index
	out of \ref phonon_Backend_xIndexes
	
	\returns A translated user visible string to describe the device.

	\see \ref phonon_Backend_xIndexes
	\see \ref phonon_Backend_xName

\subsection phonon_Backend_audioCaptureDeviceVideoIndex qint32 audioCaptureDeviceVideoIndex( int index )
	\param index The index of the device. This is one of the indexes the backend
	returned via \ref phonon_Backend_xIndexes
	\returns An index of a video capture device that is associated with the given
	audio capture device. For example a webcam might have both a video and an audio
	capture device, and in order give the user a hint that the audio and video
	capture devices belong together this index is used.
	\returns If there is no associated video capture device return -1.

\subsection phonon_Backend_videoCaptureDeviceAudioIndex qint32 videoCaptureDeviceAudioIndex( int index )
	\param index The index of the device. This is one of the indexes the backend
	returned via \ref phonon_Backend_xIndexes
	\returns An index of a audio capture device that is associated with the given
	video capture device. For example a webcam might have both a audio and an video
	capture device, and in order give the user a hint that the video and audio
	capture devices belong together this index is used.
	\returns If there is no associated audio capture device return -1.

\page phonon_AudioDataOutput The AudioDataOutput Class
\ingroup Backend

\page phonon_AudioOutput The AudioOutput Class
\ingroup Backend

\page phonon_VideoDataOutput The VideoDataOutput Class
\ingroup Backend

\page phonon_VideoWidget The VideoWidget Class
\ingroup Backend

\page phonon_Effect The Effect Class
\ingroup Backend

\page phonon_BrightnessControl The BrightnessControl Class
\ingroup Backend

\page phonon_VideoEffect The VideoEffect Class
\ingroup Backend

\page phonon_Visualization The Visualization Class
\ingroup Backend

\page phonon_VolumeFaderEffect The VolumeFaderEffect Class
\ingroup Backend

*/