mirror of
https://github.com/python/cpython.git
synced 2024-12-01 03:01:36 +01:00
103 lines
3.5 KiB
Plaintext
103 lines
3.5 KiB
Plaintext
audiopy - a program to control the Solaris audio device.
|
||
|
||
Contact: Barry Warsaw
|
||
Email: bwarsaw@python.org
|
||
Version: 0.1
|
||
|
||
Introduction
|
||
|
||
Audiopy is a program to control the Solaris audio device, allowing
|
||
you to set both the input and output devices. It can be run
|
||
either as a standalone command-line script, or as a Tkinter based
|
||
GUI application.
|
||
|
||
Note that your version of Python must have been built with the
|
||
sunaudiodev module enabled. It is not enabled by default however!
|
||
You will need to edit your Modules/Setup file, uncomment the
|
||
sunaudiodev module spec line and rebuild Python.
|
||
|
||
Using audiopy, you can select one of three possible input devices:
|
||
the microphone, the line-in jack, or the CD in. These choices are
|
||
mutually exclusive; you can only have one active input device at
|
||
any one time (this is enforced by the underlying device). Some
|
||
input devices may not be supported on all Solaris machines.
|
||
|
||
You can also choose to enable any of the three possible output
|
||
devices: the headphone jack, the speakers, or the line-out jack.
|
||
You can enable any combination of these three devices.
|
||
|
||
Running as a GUI
|
||
|
||
Simply start audiopy with no arguments to start it as a Tkinter
|
||
based GUI application. It will pop up a window with two sections:
|
||
the top portion contains three radio buttons indicating your
|
||
selected input device; the bottom portion contains three
|
||
checkboxes indicating your selected output devices.
|
||
|
||
Note the underlined characters in the button labels. These
|
||
indicate keyboard accelerators so that pressing Alt+character you
|
||
can select that device. For example, Alt-s toggles the Speaker
|
||
device. The Alt accelerators are the same as those you'd use in
|
||
as the short-form command line switches (see below).
|
||
|
||
Alt-q is also an accelerator for selecting Quit from the File
|
||
menu.
|
||
|
||
No unsupported devices will appear in the GUI. When run as a GUI,
|
||
audiopy monitors the audio device and automatically updates its
|
||
display if the state of the device is changed by some other
|
||
means. In pre-Python 1.5.2 this is done by occasionally polling
|
||
the device, but in Python 1.5.2 no polling is necessary (you don't
|
||
really need to know this, but I thought I'd plug 1.5.2 :-).
|
||
|
||
Running as a Command Line Program
|
||
|
||
You can run audiopy from the command line to select any
|
||
combination of input or output device, by using the command line
|
||
options. Actually, any option forces audiopy to run as a command
|
||
line program and not display its GUI.
|
||
|
||
Options have the general form
|
||
|
||
--device[={0,1}]
|
||
-d[-{0,1}]
|
||
|
||
meaning there is both a long-form and short-form of the switch,
|
||
where `device' or `d' is one of the following:
|
||
|
||
(input)
|
||
microphone -- m
|
||
linein -- i
|
||
cd -- c
|
||
|
||
(output)
|
||
headphones -- p
|
||
speaker -- s
|
||
lineout -- o
|
||
|
||
When no value is given, the switch just toggles the specified
|
||
device. With a value, 0 turns the device off and 1 turns the
|
||
device on. Any other value is an error.
|
||
|
||
For example, to turn the speakers off, turn the headphones on, and
|
||
toggle the cd input device, run audiopy from the command line like
|
||
so:
|
||
|
||
% ./audiopy -s=0 -p=1 -c
|
||
|
||
Audiopy understands two other command line options:
|
||
|
||
--version
|
||
-v
|
||
Print the version number and exit
|
||
|
||
--help
|
||
-h
|
||
Print a help message and exit
|
||
|
||
|
||
|
||
Local Variables:
|
||
indent-tabs-mode: nil
|
||
End:
|