Manual: Hymne l 1995

NAME

SYNOPSIS

OPTIONS

• -volume audio -volume value will set the current volume to value if value is a float in the range [0.0,1.0]. Without the value parameter, the current volume will be returned.
• -speaker <0|1>
• -headphone <0|1>
• -line_out <0|1> These options can be used to turn available audio output ports on and off. Note that on some devices, the output port selector behaves like a toggle switch: you can select at most one active port at the time, turning a second one on will turn off the previous one. Additionally, on these devices, it is not possible to turn a port off except by explicitly turning on another one. For example: you have to activate the headphones to turn off the speaker. Without the additional parameter, the current value will be returned.
• -pause audio -pause will temporaly stop the output of audio data.
• -resume audio -resume will resume the output of audio data if paused.
• -ispause audio -ispause will return 1 if the output of audio data is paused, 0 otherwise.
• -active audio -active will return 1 if there is data transferred to the audio device in order to be played, 0 otherwise.
• -waiting audio -waiting will return 1 if there is another process waiting for the release of the audio device, 0 otherwise. An application may decide to close(2) the audio device in order to let an other process use it.
• -error audio -error will return 1 if an underflow error has occurred, 0 otherwise. Underflow errors occur when the buffer of the audio device becomes empty and there are no bytes left to be played.
• -reset audio -reset will reset the data underflow-error flag.

EXAMPLES

You will need a Tcl interpreter (like tclsh(1), wish(1) or hush(1)) extendend with the audio command. Of course, hymne(1) has this command.

          shell-prompt> hymne
  
          # How to define a volume scale in two Tcl lines:
          % proc set_vol v {audio -volume [expr \$v/100.0]}
          % pack [scale .vol -command set_vol -orient horizontal -label Volume]
  
          # Some random playing ...
          % audio -volume                 # Get current volume
          0.403922                
          % audio -volume 0.2         # Set current volume to 20 procent
          % audio -volume                 # Note the rounding error ...
          0.196078
          % set s [audio -samples] # How many samples have been played?
          692393
          % puts \$s
          692393 
          % # etc
  .if
  
  
slide: EXAMPLES

  
  
<h4>NOTES</h4>


  

  If you want to exented your personal hush interpreter with 
  the audio command, you might want to read audio(4)
  
  
slide: NOTES

  
  
<h4>LIBRARY</h4>


  

  hymne -- file <hymne/audio.h> 
  
  
slide: LIBRARY

  
  
<h4>KEYWORDS</h4>
  Audio, audio, hush, hymne, Tcl
  
  
  
<h4>SEE ALSO</h4>
  Audio(4), audio(4), audio(7), hush(1), hymne(1), Tcl(1)
  
  
    
    
  
  <hr>
  [.]
  
  Papers
  Tutorials
  Examples
  Manuals
  Interfaces
  Sources
  Packages
  Resources
  ?
  
  <hr>
  
  <table cellpadding=10>
  <tr>
  <td>
  <address>
  Hush Online Technology
  </address>
  hush@cs.vu.nl
  <br>09/24/99
  </td><td>
  <img src=../../../../@share/base/eye.gif width=30 height=30>
  </td>
  <td></td><td></td><td></td><td></td><td></td><td></td><td></td>
  <td>
  <img src=../../../../@share/images/griff.gif>
  </td>
  </tr>
  </table>