Phonon::MediaSource
#include <phonon/MediaSource>
Inherited by Phonon::Experimental::MediaSource.
Public Types | |
| enum | Type { Invalid = -1 , LocalFile , Url , Disc , Stream , CaptureDevice , Empty , AudioVideoCapture } |
Protected Member Functions | |
| PHONON_DEPRECATED | MediaSource (const DeviceAccess &access) |
| MediaSource (MediaSourcePrivate &) | |
Protected Attributes | |
| QExplicitlySharedDataPointer< MediaSourcePrivate > | d |
Detailed Description
Note that all constructors of this class are implicit, so that you can simply write.
Definition at line 62 of file mediasource.h.
Member Enumeration Documentation
◆ Type
Identifies the type of media described by the MediaSource object.
- See also
- MediaSource::type()
| Enumerator | |
|---|---|
| Invalid | The MediaSource object does not describe any valid source. |
| LocalFile | The MediaSource object describes a local file. |
| Url | The MediaSource object describes a URL, which can be both a local file and a file on the network. |
| Disc | The MediaSource object describes a disc. |
| Stream | The MediaSource object describes a data stream. This is also the type used for QIODevices.
|
| CaptureDevice | The MediaSource object describes a single capture device. This could be either audio or video. |
| Empty | An empty MediaSource. It can be used to unload the current media from a MediaObject.
|
| AudioVideoCapture | The MediaSource object describes one device for video capture and one for audio capture. Facilitates capturing both audio and video at the same time, from different devices. It's essentially like two CaptureDevice media sources (one of video type, one of audio type) merged together. |
Definition at line 72 of file mediasource.h.
Constructor & Destructor Documentation
◆ MediaSource() [1/13]
| Phonon::MediaSource::MediaSource | ( | ) |
Creates an empty MediaSource.
An empty MediaSource is considered valid and can be set on a MediaObject to unload its current media.
- See also
- Empty
Definition at line 40 of file mediasource.cpp.
◆ MediaSource() [2/13]
| Phonon::MediaSource::MediaSource | ( | const QString & | fileName | ) |
Creates a MediaSource object for a local file or a Qt resource.
- Deprecated
- Use MediaSource(QUrl("qrc:///...")) for a Qt resource, MediaSource(QUrl::fromLocalFile("...")) for a local file, or MediaSource(QUrl("...")) for an URL.
- Parameters
-
fileName file name of a local media file or a Qt resource that was compiled in.
Definition at line 45 of file mediasource.cpp.
◆ MediaSource() [3/13]
| Phonon::MediaSource::MediaSource | ( | const QUrl & | url | ) |
Creates a MediaSource object for a URL.
A Qt resource can be specified by using an url with a qrc scheme.
- Parameters
-
url URL to a media file or stream.
Definition at line 85 of file mediasource.cpp.
◆ MediaSource() [4/13]
Creates a MediaSource object for discs.
- Parameters
-
discType See DiscType deviceName A platform dependent device name. This can be useful if the computer has more than one CD drive. It is recommended to use Solid to retrieve the device name in a portable way.
Definition at line 111 of file mediasource.cpp.
◆ MediaSource() [5/13]
| Phonon::MediaSource::MediaSource | ( | const AudioCaptureDevice & | device | ) |
Creates a MediaSource object for audio capture devices.
If the device is valid, this creates a 'CaptureDevice' type MediaSource.
Definition at line 129 of file mediasource.cpp.
◆ MediaSource() [6/13]
| Phonon::MediaSource::MediaSource | ( | const VideoCaptureDevice & | device | ) |
Creates a MediaSource object for video capture devices.
If the device is valid, this creates a 'CaptureDevice' type MediaSource
Definition at line 137 of file mediasource.cpp.
◆ MediaSource() [7/13]
| Phonon::MediaSource::MediaSource | ( | Capture::DeviceType | deviceType, |
| CaptureCategory | category = NoCaptureCategory ) |
Sets the source to the preferred audio capture device for the specified category If a valid device is found, this creates a 'CaptureDevice' type MediaSource.
Definition at line 151 of file mediasource.cpp.
◆ MediaSource() [8/13]
| Phonon::MediaSource::MediaSource | ( | CaptureCategory | category | ) |
Creates a MediaSource object that tries to describe a video capture device and an audio capture device, together.
The devices are appropriate for the specified category.
If valid devices are found for both audio and video, then the resulting MediaSource is of type 'AudioVideoCapture'. If only an audio or a video valid device is found, the resulting type is 'CaptureDevice'. If no valid devices are found, the resulting type is 'Invalid'.
Definition at line 145 of file mediasource.cpp.
◆ MediaSource() [9/13]
| Phonon::MediaSource::MediaSource | ( | AbstractMediaStream * | stream | ) |
Creates a MediaSource object for a data stream.
Your application can provide the media data by subclassing AbstractMediaStream and passing a pointer to that object. Phonon will never delete the stream.
- Parameters
-
stream The AbstractMediaStream subclass to provide the media data.
- See also
- setAutoDelete
Definition at line 159 of file mediasource.cpp.
◆ MediaSource() [10/13]
| Phonon::MediaSource::MediaSource | ( | QIODevice * | ioDevice | ) |
Creates a MediaSource object for a QIODevice.
This constructor can be very handy in the combination of QByteArray and QBuffer.
- Parameters
-
ioDevice An arbitrary readable QIODevice subclass. If the device is not opened MediaSource will open it as QIODevice::ReadOnly. Sequential I/O devices are possible, too. For those MediaObject::isSeekable() will have to return false obviously.
- See also
- setAutoDelete
Definition at line 169 of file mediasource.cpp.
◆ ~MediaSource()
| Phonon::MediaSource::~MediaSource | ( | ) |
Destroys the MediaSource object.
Definition at line 197 of file mediasource.cpp.
◆ MediaSource() [11/13]
| Phonon::MediaSource::MediaSource | ( | const MediaSource & | rhs | ) |
Constructs a copy of rhs.
This constructor is fast thanks to explicit sharing.
Definition at line 215 of file mediasource.cpp.
◆ MediaSource() [12/13]
|
protected |
Definition at line 35 of file mediasource.cpp.
◆ MediaSource() [13/13]
|
protected |
Definition at line 123 of file mediasource.cpp.
Member Function Documentation
◆ audioCaptureDevice()
| AudioCaptureDevice Phonon::MediaSource::audioCaptureDevice | ( | ) | const |
Returns the audio capture device for the media source if applicable.
Definition at line 314 of file mediasource.cpp.
◆ audioDeviceAccessList()
| const DeviceAccessList & Phonon::MediaSource::audioDeviceAccessList | ( | ) | const |
Returns the access list for the audio device used for capture.
Valid for type() == CaptureDevice or type() == AudioVideoCapture. If used with CaptureDevice, the kind of device should be Audio, for a valid result.
Definition at line 286 of file mediasource.cpp.
◆ autoDelete()
| bool Phonon::MediaSource::autoDelete | ( | ) | const |
Returns the setting of the auto-delete option.
The default is false.
- See also
- setAutoDelete
Definition at line 236 of file mediasource.cpp.
◆ deviceAccessList()
| const DeviceAccessList & Phonon::MediaSource::deviceAccessList | ( | ) | const |
Returns the access list for the device of this media source.
Valid for capture devices.
- Warning
- use only with MediaSource with type() == CaptureDevice
Definition at line 271 of file mediasource.cpp.
◆ deviceName()
| QString Phonon::MediaSource::deviceName | ( | ) | const |
Returns the device name of the MediaSource if type() == Disc; otherwise returns QString().
Definition at line 296 of file mediasource.cpp.
◆ discType()
| DiscType Phonon::MediaSource::discType | ( | ) | const |
Returns the disc type of the MediaSource if type() == Disc; otherwise returns NoDisc.
Definition at line 266 of file mediasource.cpp.
◆ fileName()
| QString Phonon::MediaSource::fileName | ( | ) | const |
Returns the file name of the MediaSource if type() == LocalFile; otherwise returns QString().
Definition at line 251 of file mediasource.cpp.
◆ mrl()
| Mrl Phonon::MediaSource::mrl | ( | ) | const |
Returns the MRL of the MediaSource if type() == URL or type() == LocalFile; otherwise returns Mrl().
Phonon::Mrl is based on QUrl and adds some additional functionality that is necessary to ensure proper encoding usage in the Phonon backends.
Usually you will not have to use this in an application.
- Since
- 4.5
Definition at line 256 of file mediasource.cpp.
◆ operator=()
| MediaSource & Phonon::MediaSource::operator= | ( | const MediaSource & | rhs | ) |
Assigns rhs to this MediaSource and returns a reference to this MediaSource.
This operation is fast thanks to explicit sharing.
Definition at line 220 of file mediasource.cpp.
◆ operator==()
| bool Phonon::MediaSource::operator== | ( | const MediaSource & | rhs | ) | const |
Returns true if this MediaSource is equal to rhs; otherwise returns false.
Definition at line 226 of file mediasource.cpp.
◆ setAutoDelete()
| void Phonon::MediaSource::setAutoDelete | ( | bool | enable | ) |
Tell the MediaSource to take ownership of the AbstractMediaStream or QIODevice that was passed in the constructor.
The default setting is false, for safety. If you turn it on, you should only access the AbstractMediaStream/QIODevice object as long as you yourself keep a MediaSource object around. As long as you keep the MediaSource object wrapping the stream/device the object will not get deleted.
- See also
- autoDelete
Definition at line 231 of file mediasource.cpp.
◆ stream()
| AbstractMediaStream * Phonon::MediaSource::stream | ( | ) | const |
Returns the media stream of the MediaSource if type() == Stream; otherwise returns 0.
QIODevices are handled as streams, too.
Definition at line 302 of file mediasource.cpp.
◆ type()
| MediaSource::Type Phonon::MediaSource::type | ( | ) | const |
Returns the type of the MediaSource (depends on the constructor that was used).
- See also
- Type
Definition at line 241 of file mediasource.cpp.
◆ url()
| QUrl Phonon::MediaSource::url | ( | ) | const |
Returns the url of the MediaSource if type() == URL or type() == LocalFile; otherwise returns QUrl().
Definition at line 261 of file mediasource.cpp.
◆ videoCaptureDevice()
| VideoCaptureDevice Phonon::MediaSource::videoCaptureDevice | ( | ) | const |
Returns the video capture device for the media source if applicable.
Definition at line 321 of file mediasource.cpp.
◆ videoDeviceAccessList()
| const DeviceAccessList & Phonon::MediaSource::videoDeviceAccessList | ( | ) | const |
Returns the access list for the video device used for capture.
Valid for type() == CaptureDevice or type() == AudioVideoCapture. If used with CaptureDevice, the kind of device should be Video, for a valid result.
Definition at line 291 of file mediasource.cpp.
Member Data Documentation
◆ d
|
protected |
Definition at line 364 of file mediasource.h.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Tue Mar 26 2024 11:20:24 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.