Phonon Namespace Reference

Detailed Description

The Phonon namespace contains classes and functions for multimedia applications.

This namespace contains classes to access multimedia functions for audio and video playback. Those classes are not dependent on any specific framework, but rather use exchangeable backends to do the work.

See the Phonon Module page for general information about the framework.

Namespaces

namespace Phonon::BackendCapabilities

The BackendCapabilities namespace contains functions to describe the capabilities of the multimedia backend.

This namespace was introduced in Qt 4.4.

Classes

class AudioOutput

The AudioOutput class is used to send data to audio output devices. More...

class Effect

The Effect class is used to transform audio streams. More...

class EffectParameter

The EffectParameter class describes one parameter of an effect. More...

class EffectWidget

The EffectWidget class provides a widget to control the parameters of an Effect. More...

class MediaController

The MediaController class controls optional features of a media file/device. More...

class MediaNode

The MediaNode class is the base class for all nodes in a media graph. More...

class MediaObject

The MediaObject class provides an interface for media playback. More...

class MediaSource

The MediaSource class provides multimedia data for media objects. More...

class ObjectDescription

The ObjectDescription class provides information about Phonon objects. More...

class Path

The Path class describes connections between media nodes. More...

class SeekSlider

The SeekSlider class provides a slider for seeking to positions in media streams. More...

class VideoPlayer

The VideoPlayer widget is used to perform playback of video. More...

class VideoWidget

The VideoWidget class provides a widget that is used to display video. More...

class VolumeSlider

The VolumeSlider widget provides a slider that is used to control the volume of an audio output device. More...

Type Documentation

typedef Phonon::AudioOutputDevice

This typedef of ObjectDescription describes an audio output device, such as soundcards (with different drivers), sound servers, or other virtual outputs like playback on a different computer on the network.

A list of available devices is given by the backend with Backendcapabilities::availableAudioOutputDevices()

     QList<Phonon::AudioOutputDevice> audioOutputDevices =
             Phonon::BackendCapabilities::availableAudioOutputDevices();

typedef Phonon::AudioOutputDeviceModel

provides an item view model containing available audio output devices.

enum Phonon::Category

Sets the category your program should be listed in in the mixer.

A Jukebox will set this to Music, a VoIP program to Communication, a DVD player to video, and so on.

Note: These categories can also become useful for an application that controls the volumes automatically, like turning down the music when a call comes in, or turning down the notifications when the media player knows it's playing classical music.

typedef Phonon::CleanUpFunction

enum Phonon::DiscType

Enum to identify the media discs supported by MediaObject.

See also MediaSource and MediaObject.

typedef Phonon::EffectDescription

EffectDescription gives a description of an audio effect. It is a typedef of the ObjectDescription class. Please see its class description for details.

EffectDescription is used to create audio Effects, which can be inserted into a media graph, altering an audio stream.

See also Phonon::ObjectDescription, Capabilities Example, and Media Player.

typedef Phonon::EffectDescriptionModel

provides a item view model containing available audio effects.

enum Phonon::ErrorType

This enum describes the severity when an error has occurred during playback.

After a media object has entered the ErrorState, one can query the type of error from MediaObject::errorType(). Note that you should query the error when receiving the MediaObject::stateChanged() signal, because the error type will be lost if the media object leaves the error state.

See also MediaObject::errorType().

enum Phonon::MetaData

Provided as keys for Phonon::MediaObject::metaData(). The enum values matches strings defined in the Ogg Vorbis specification

enum Phonon::ObjectDescriptionType

This enum defines the type of information that is contained in a ObjectDescription object.

enum Phonon::State

The state enum describes the different states a media object can take. Several functions of MediaObject are asynchronous, so even if a you have requested a state change through a function call, e.g., through play(), you cannot be sure that the change has taken place before you receive the stateChanged() signal.

A media object can at any time change into any state, regardless of the state it previously had.

This enum was introduced in Qt 4.4.

See also MediaObject.

Function Documentation

QString Phonon::categoryToString ( Category c )

Returns a (translated) string to show to the user identifying the given Category (c).

Path Phonon::createPath ( MediaNode * source, MediaNode * sink )

Creates a new Path connecting the two MediaNodes source and sink.

The implementation will automatically select the right format and media type. E.g. connecting a MediaObject and AudioOutput will create a Path object connecting the audio. This might be represented as PCM or perhaps even AC3 depending on the AudioOutput object.

source The MediaNode to connect an output from sink The MediaNode to connect to.

MediaObject * Phonon::createPlayer ( Phonon::Category category, const MediaSource & source = MediaSource() )

Convenience function to create a MediaObject and AudioOutput connected by a path. The MediaObject return will have source set as its current source and the specified category.

const char * Phonon::phononVersion ()