#include <Phonon/MediaSource>
Note that all constructors of this class are implicit, so that you can simply write.
Definition at line 61 of file mediasource.h.
Public Types | |
enum | Type { Invalid = -1, LocalFile, Url, Disc, Stream, Empty } |
Identifies the type of media described by the MediaSource object. More... | |
Public Member Functions | |
MediaSource () | |
Creates an empty MediaSource. More... | |
MediaSource (const QString &fileName) | |
Creates a MediaSource object for a local file or a Qt resource. More... | |
MediaSource (const QUrl &url) | |
Creates a MediaSource object for a URL. More... | |
MediaSource (Phonon::DiscType discType, const QString &deviceName=QString()) | |
Creates a MediaSource object for discs. More... | |
MediaSource (AbstractMediaStream *stream) | |
Creates a MediaSource object for a data stream. More... | |
MediaSource (QIODevice *ioDevice) | |
Creates a MediaSource object for a QIODevice. More... | |
~MediaSource () | |
Creates a MediaSource object for capture devices. More... | |
MediaSource (const MediaSource &rhs) | |
Constructs a copy of rhs . More... | |
MediaSource & | operator= (const MediaSource &rhs) |
Assigns rhs to this MediaSource and returns a reference to this MediaSource. More... | |
bool | operator== (const MediaSource &rhs) const |
Returns true if this MediaSource is equal to rhs ; otherwise returns false . More... | |
void | setAutoDelete (bool enable) |
Tell the MediaSource to take ownership of the AbstractMediaStream or QIODevice that was passed in the constructor. More... | |
bool | autoDelete () const |
Returns the setting of the auto-delete option. More... | |
Type | type () const |
Returns the type of the MediaSource (depends on the constructor that was used). More... | |
QString | fileName () const |
Returns the file name of the MediaSource if type() == LocalFile; otherwise returns QString(). More... | |
QUrl | url () const |
Returns the url of the MediaSource if type() == URL or type() == LocalFile; otherwise returns QUrl(). More... | |
Phonon::DiscType | discType () const |
Returns the disc type of the MediaSource if type() == Disc; otherwise returns NoDisc. More... | |
QString | deviceName () const |
Returns the device name of the MediaSource if type() == Disc; otherwise returns QString(). More... | |
AbstractMediaStream * | stream () const |
Returns the media stream of the MediaSource if type() == Stream; otherwise returns 0. More... | |
Protected Member Functions | |
MediaSource (MediaSourcePrivate &) | |
Protected Attributes | |
QExplicitlySharedDataPointer< MediaSourcePrivate > | d |
Friends | |
class | StreamInterface |
enum Type |
Identifies the type of media described by the MediaSource object.
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.
|
Empty |
An empty MediaSource. It can be used to unload the current media from a MediaObject.
|
Definition at line 70 of file mediasource.h.
MediaSource | ( | ) |
Creates an empty MediaSource.
An empty MediaSource is considered valid and can be set on a MediaObject to unload its current media.
MediaSource | ( | const QString & | fileName | ) |
Creates a MediaSource object for a local file or a Qt resource.
fileName | file name of a local media file or a Qt resource that was compiled in. |
MediaSource | ( | const QUrl & | url | ) |
Creates a MediaSource object for a URL.
url | URL to a media file or stream. |
MediaSource | ( | Phonon::DiscType | discType, |
const QString & | deviceName = QString() |
||
) |
Creates a MediaSource object for discs.
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. |
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
.
stream | The AbstractMediaStream subclass to provide the media data. |
MediaSource | ( | QIODevice * | ioDevice | ) |
Creates a MediaSource object for a QIODevice.
This constructor can be very handy in the combination of QByteArray and QBuffer.
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. |
~MediaSource | ( | ) |
Creates a MediaSource object for capture devices.
Destroys the MediaSource object.
MediaSource | ( | const MediaSource & | rhs | ) |
Constructs a copy of rhs
.
This constructor is fast thanks to explicit sharing.
|
protected |
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.
bool operator== | ( | const MediaSource & | rhs | ) | const |
Returns true
if this MediaSource is equal to rhs
; otherwise returns false
.
void 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.
bool autoDelete | ( | ) | const |
Returns the type of the MediaSource (depends on the constructor that was used).
QString fileName | ( | ) | const |
Returns the file name of the MediaSource if type() == LocalFile; otherwise returns QString().
QUrl url | ( | ) | const |
Returns the url of the MediaSource if type() == URL or type() == LocalFile; otherwise returns QUrl().
Phonon::DiscType discType | ( | ) | const |
Returns the disc type of the MediaSource if type() == Disc; otherwise returns NoDisc.
QString deviceName | ( | ) | const |
Returns the device name of the MediaSource if type() == Disc; otherwise returns QString().
AbstractMediaStream* stream | ( | ) | const |
Returns the media stream of the MediaSource if type() == Stream; otherwise returns 0.
QIODevices are handled as streams, too.
|
friend |
Definition at line 63 of file mediasource.h.
|
protected |
Definition at line 270 of file mediasource.h.