summaryrefslogtreecommitdiffstats
path: root/doc/src/phonon-api.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/phonon-api.qdoc')
-rw-r--r--doc/src/phonon-api.qdoc40
1 files changed, 21 insertions, 19 deletions
diff --git a/doc/src/phonon-api.qdoc b/doc/src/phonon-api.qdoc
index 5deb64e..09274bf 100644
--- a/doc/src/phonon-api.qdoc
+++ b/doc/src/phonon-api.qdoc
@@ -2,7 +2,7 @@
This file is part of the KDE project
Copyright (C) 2005-2007 Matthias Kretz <kretz@kde.org>
Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
- Contact: Qt Software Information (qt-info@nokia.com)
+ Contact: Nokia Corporation (qt-info@nokia.com)
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
@@ -60,7 +60,7 @@
through a function call, e.g., through
\l{Phonon::MediaObject::}{play()}, you cannot be sure that the
change has taken place before you receive the
- \l{Phonon::MediaObject::}{stateChanged()} signal.
+ \l{Phonon::MediaObject::}{stateChanged()} signal.
A media object can at any time change into any state, regardless
of the state it previously had. \omit In the
@@ -192,14 +192,14 @@
computer on the network.
\value EffectType An audio effect (\l{Phonon::}{EffectDescription}).
- \omitvalue SubtitleType
- \omitvalue AudioCaptureDeviceType
- \omitvalue AudioChannelType
+ \omitvalue SubtitleType
+ \omitvalue AudioCaptureDeviceType
+ \omitvalue AudioChannelType
*/
/*!
\typedef Phonon::AudioOutputDevice
- \relates Phonon::ObjectDescription
+ \relates Phonon::ObjectDescription
This typedef of \l{Phonon::}{ObjectDescription} describes an audio output
device, such as soundcards (with different drivers), sound servers, or other
@@ -223,7 +223,7 @@
\fn Phonon::phononVersion()
\inmodule Phonon
\since 4.5
-
+
Returns the Phonon version.
*/
@@ -362,7 +362,7 @@
property() is called.
Currently, Qt backends do not use properties for their object
- descriptions.
+ descriptions.
\sa property()
*/
@@ -370,7 +370,7 @@
/*!
\fn inline bool Phonon::ObjectDescription::isValid() const
- Returns true if the device or effect described exists.
+ Returns true if the device or effect described exists.
An ObjectDescription that is invalid, will also have an
index() of -1.
@@ -1115,6 +1115,11 @@
\note Sequential devices can also be used, but MediaObject::isSeekable() will
return false as a result.
+ \warning On Windows, we only support \l{QIODevice}s containing the
+ \c avi, \c mp3, or \c mpg formats. Use the constructor that takes
+ a file name to open files (the Qt backend does not use a QFile
+ internally).
+
\sa setAutoDelete()
*/
@@ -1864,7 +1869,7 @@
\snippet doc/src/snippets/code/doc_src_phonon-api.qdoc 14
- \sa currentSource()
+ \sa currentSource(), MediaSource
*/
/*!
@@ -1932,7 +1937,7 @@
\fn void Phonon::MediaObject::clearQueue()
Clears the queue of media sources.
-
+
\sa queue(), enqueue()
*/
@@ -2096,7 +2101,7 @@
/*!
\fn void Phonon::MediaObject::hasVideoChanged(bool hasVideo)
- Emitted whenever the return value of hasVideo() changes, i.e.,
+ Emitted whenever the return value of hasVideo() changes, i.e.,
the media source being played back contains video.
Normally you'll check hasVideo() first and then let this signal
@@ -4110,15 +4115,13 @@
/*!
\enum Phonon::VideoWidget::ScaleMode
-
+
The ScaleMode enum describes how to treat aspect ratio during
- resizing of video.
+ resizing of video.
\value FitInView The video will be fitted to fill the view
keeping aspect ratio.
- \value ScaleAndCrop The video is scaled
-
-
+ \value ScaleAndCrop The video is scaled
*/
/*!
@@ -4136,7 +4139,6 @@
top-level window. Key event forwarding is handled by VideoWidget,
but if you need to handle other events, e.g., mouse events, you
should handle fullscreen mode yourself.
-
*/
/*!
@@ -4583,7 +4585,7 @@
\class Phonon::AddonInterface
\inmodule Phonon
\since 4.4
- \internal
+ \internal
\brief Interface for Menu, Chapter, Angle and Title/Track control.
*/