Changeset 769 for trunk/src/multimedia/audio/qaudiooutput.cpp

Timestamp:

Aug 2, 2010, 9:27:30 PM (15 years ago)

Author:

Dmitry A. Kuminov

Message:

trunk: Merged in qt 4.6.3 sources from branches/vendor/nokia/qt.

Location:

trunk

Files:

• . (modified) (1 prop)
• src/multimedia/audio/qaudiooutput.cpp (modified) (10 diffs)

trunk/src/multimedia/audio/qaudiooutput.cpp

@@ -203 +203 @@
     All that is required is to open the QIODevice.
 
+
+
+
+
+
+
+
+
+
+
+
     \sa QIODevice
 */
@@ -208 +219 @@
 void QAudioOutput::start(QIODevice* device)
 {
-    /*
-    -If currently not StoppedState, stop.
-    -If previous start was push mode, delete internal QIODevice.
-    -open audio output.
-    -If ok, NoError and ActiveState, else OpenError and StoppedState
-    -emit stateChanged()
-    */
     d->start(device);
 }
@@ -222 +226 @@
     transfer. This QIODevice can be used to write() audio data directly.
 
+
+
+
+
+
+
+
+
+
+
+
     \sa QIODevice
 */
@@ -227 +242 @@
 QIODevice* QAudioOutput::start()
 {
-    /*
-    -If currently not StoppedState, stop.
-    -If no internal QIODevice, create one.
-    -open audio output.
-    -If ok, NoError and IdleState, else OpenError and StoppedState
-    -emit stateChanged()
-    -return internal QIODevice
-    */
     return d->start(0);
 }
 
 /*!
-    Stops the audio output.
+    Stops the audio output, detaching from the system resource.
+
+    Sets error() to QAudio::NoError, state() to QAudio::StoppedState and
+    emit stateChanged() signal.
 */
 
 void QAudioOutput::stop()
 {
-    /*
-    -If StoppedState, return
-    -set to StoppedState
-    -detach from audio device
-    -emit stateChanged()
-    */
     d->stop();
 }
@@ -259 +263 @@
 void QAudioOutput::reset()
 {
-    /*
-    -drop all buffered audio, set buffers to zero.
-    -call stop()
-    */
     d->reset();
 }
@@ -268 +268 @@
 /*!
     Stops processing audio data, preserving buffered audio data.
+
+
+
 */
 
 void QAudioOutput::suspend()
 {
-    /*
-    -If not ActiveState|IdleState, return
-    -stop processing audio, saving all buffered audio data
-    -set NoError and SuspendedState
-    -emit stateChanged()
-    */
     d->suspend();
 }
@@ -283 +280 @@
 /*!
     Resumes processing audio data after a suspend().
+
+
+
+
+
+
+
 */
 
 void QAudioOutput::resume()
 {
-    /*
-    -If SuspendedState, return
-    -resume audio
-    -(PULL MODE): set ActiveState, NoError
-    -(PUSH MODE): set IdleState, NoError
-    -kick start audio if needed
-    -emit stateChanged()
-    */
      d->resume();
 }
@@ -300 +296 @@
 /*!
     Returns the free space available in bytes in the audio buffer.
+
+
+
 */
 
 int QAudioOutput::bytesFree() const
 {
-    /*
-    -If not ActiveState|IdleState, return 0
-    -return space available in audio buffer in bytes
-    */
     return d->bytesFree();
 }
@@ -354 +349 @@
     Sets the interval for notify() signal to be emitted.
     This is based on the \a ms of audio data processed
-    not on actual real-time. The resolution of the timer is platform specific.
+    not on actual real-time.
+    The minimum resolution of the timer is platform specific and values
+    should be checked with notifyInterval() to confirm actual value
+    being used.
 */
 
@@ -372 +370 @@
 
 /*!
-    Returns the amount of audio data processed since start()
+    Returns the amount of audio data processed since start()
     was called in microseconds.
+
+
+
+
+
+
+
+
+
 */