2018-07-04 09:06:45 +00:00
|
|
|
# Copyright (C) 2001-2018, Python Software Foundation
|
2018-07-04 09:08:42 +00:00
|
|
|
# For licence information, see README file.
|
2016-10-30 09:46:26 +00:00
|
|
|
#
|
|
|
|
msgid ""
|
|
|
|
msgstr ""
|
|
|
|
"Project-Id-Version: Python 3.6\n"
|
|
|
|
"Report-Msgid-Bugs-To: \n"
|
2018-11-29 15:13:39 +00:00
|
|
|
"POT-Creation-Date: 2018-11-29 16:06+0100\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
2018-07-04 09:14:25 +00:00
|
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
2017-05-23 22:40:56 +00:00
|
|
|
"Language: fr\n"
|
2016-10-30 09:46:26 +00:00
|
|
|
"MIME-Version: 1.0\n"
|
|
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:2
|
|
|
|
msgid ":mod:`ossaudiodev` --- Access to OSS-compatible audio devices"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:10
|
|
|
|
msgid ""
|
|
|
|
"This module allows you to access the OSS (Open Sound System) audio "
|
|
|
|
"interface. OSS is available for a wide range of open-source and commercial "
|
|
|
|
"Unices, and is the standard audio interface for Linux and recent versions of "
|
|
|
|
"FreeBSD."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:42
|
|
|
|
msgid ""
|
|
|
|
"Operations in this module now raise :exc:`OSError` where :exc:`IOError` was "
|
|
|
|
"raised."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:50
|
|
|
|
msgid ""
|
|
|
|
"`Open Sound System Programmer's Guide <http://www.opensound.com/pguide/oss."
|
|
|
|
"pdf>`_"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:50
|
|
|
|
msgid "the official documentation for the OSS C API"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:52
|
|
|
|
msgid ""
|
|
|
|
"The module defines a large number of constants supplied by the OSS device "
|
|
|
|
"driver; see ``<sys/soundcard.h>`` on either Linux or FreeBSD for a listing."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:55
|
|
|
|
msgid ":mod:`ossaudiodev` defines the following variables and functions:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:60
|
|
|
|
msgid ""
|
|
|
|
"This exception is raised on certain errors. The argument is a string "
|
|
|
|
"describing what went wrong."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:63
|
|
|
|
msgid ""
|
|
|
|
"(If :mod:`ossaudiodev` receives an error from a system call such as :c:func:"
|
|
|
|
"`open`, :c:func:`write`, or :c:func:`ioctl`, it raises :exc:`OSError`. "
|
|
|
|
"Errors detected directly by :mod:`ossaudiodev` result in :exc:"
|
|
|
|
"`OSSAudioError`.)"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:67
|
|
|
|
msgid ""
|
|
|
|
"(For backwards compatibility, the exception class is also available as "
|
|
|
|
"``ossaudiodev.error``.)"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:74
|
|
|
|
msgid ""
|
|
|
|
"Open an audio device and return an OSS audio device object. This object "
|
|
|
|
"supports many file-like methods, such as :meth:`read`, :meth:`write`, and :"
|
|
|
|
"meth:`fileno` (although there are subtle differences between conventional "
|
|
|
|
"Unix read/write semantics and those of OSS audio devices). It also supports "
|
|
|
|
"a number of audio-specific methods; see below for the complete list of "
|
|
|
|
"methods."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:80
|
|
|
|
msgid ""
|
|
|
|
"*device* is the audio device filename to use. If it is not specified, this "
|
|
|
|
"module first looks in the environment variable :envvar:`AUDIODEV` for a "
|
|
|
|
"device to use. If not found, it falls back to :file:`/dev/dsp`."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:84
|
|
|
|
msgid ""
|
|
|
|
"*mode* is one of ``'r'`` for read-only (record) access, ``'w'`` for write-"
|
|
|
|
"only (playback) access and ``'rw'`` for both. Since many sound cards only "
|
|
|
|
"allow one process to have the recorder or player open at a time, it is a "
|
|
|
|
"good idea to open the device only for the activity needed. Further, some "
|
|
|
|
"sound cards are half-duplex: they can be opened for reading or writing, but "
|
|
|
|
"not both at once."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:91
|
|
|
|
msgid ""
|
|
|
|
"Note the unusual calling syntax: the *first* argument is optional, and the "
|
|
|
|
"second is required. This is a historical artifact for compatibility with "
|
|
|
|
"the older :mod:`linuxaudiodev` module which :mod:`ossaudiodev` supersedes."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:102
|
|
|
|
msgid ""
|
|
|
|
"Open a mixer device and return an OSS mixer device object. *device* is the "
|
|
|
|
"mixer device filename to use. If it is not specified, this module first "
|
|
|
|
"looks in the environment variable :envvar:`MIXERDEV` for a device to use. "
|
|
|
|
"If not found, it falls back to :file:`/dev/mixer`."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:111
|
|
|
|
msgid "Audio Device Objects"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:113
|
|
|
|
msgid ""
|
|
|
|
"Before you can write to or read from an audio device, you must call three "
|
|
|
|
"methods in the correct order:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:116
|
|
|
|
msgid ":meth:`setfmt` to set the output format"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:118
|
|
|
|
msgid ":meth:`channels` to set the number of channels"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:120
|
|
|
|
msgid ":meth:`speed` to set the sample rate"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:122
|
|
|
|
msgid ""
|
|
|
|
"Alternately, you can use the :meth:`setparameters` method to set all three "
|
|
|
|
"audio parameters at once. This is more convenient, but may not be as "
|
|
|
|
"flexible in all cases."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:126
|
|
|
|
msgid ""
|
|
|
|
"The audio device objects returned by :func:`.open` define the following "
|
|
|
|
"methods and (read-only) attributes:"
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:132
|
|
|
|
msgid ""
|
|
|
|
"Explicitly close the audio device. When you are done writing to or reading "
|
|
|
|
"from an audio device, you should explicitly close it. A closed device "
|
|
|
|
"cannot be used again."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:139
|
|
|
|
msgid "Return the file descriptor associated with the device."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:144
|
|
|
|
msgid ""
|
|
|
|
"Read *size* bytes from the audio input and return them as a Python string. "
|
|
|
|
"Unlike most Unix device drivers, OSS audio devices in blocking mode (the "
|
|
|
|
"default) will block :func:`read` until the entire requested amount of data "
|
|
|
|
"is available."
|
|
|
|
msgstr ""
|
|
|
|
|
|
|
|
#: ../Doc/library/ossaudiodev.rst:152
|
|
|
|
msgid ""
|
|
|
|
"Write a :term:`bytes-like object` *data* to the audio device and return the "
|
|
|
|
"number of bytes written. If the audio device is in blocking mode (the "
|
|
|
|
"default), the entire data is always written (again, this is different from "
|
|
|
|
"usual Unix device semantics). If the device is in non-blocking mode, some "
|
2018-11-29 15:13:39 +00:00
|
|
|
"data may not be written---see :meth:`writeall`."
|
2016-10-30 09:46:26 +00:00
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:158 ../Doc/library/ossaudiodev.rst:172
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Writable :term:`bytes-like object` is now accepted."
|
|
|
|
msgstr "N'importe quel :term:`bytes-like object` est maintenant accepté."
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:164
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Write a :term:`bytes-like object` *data* to the audio device: waits until "
|
|
|
|
"the audio device is able to accept data, writes as much data as it will "
|
|
|
|
"accept, and repeats until *data* has been completely written. If the device "
|
|
|
|
"is in blocking mode (the default), this has the same effect as :meth:"
|
|
|
|
"`write`; :meth:`writeall` is only useful in non-blocking mode. Has no "
|
|
|
|
"return value, since the amount of data written is always equal to the amount "
|
|
|
|
"of data supplied."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:176
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Audio device objects also support the context management protocol, i.e. they "
|
|
|
|
"can be used in a :keyword:`with` statement."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:181
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The following methods each map to exactly one :c:func:`ioctl` system call. "
|
|
|
|
"The correspondence is obvious: for example, :meth:`setfmt` corresponds to "
|
|
|
|
"the ``SNDCTL_DSP_SETFMT`` ioctl, and :meth:`sync` to ``SNDCTL_DSP_SYNC`` "
|
|
|
|
"(this can be useful when consulting the OSS documentation). If the "
|
|
|
|
"underlying :c:func:`ioctl` fails, they all raise :exc:`OSError`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:190
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Put the device into non-blocking mode. Once in non-blocking mode, there is "
|
|
|
|
"no way to return it to blocking mode."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:196
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Return a bitmask of the audio output formats supported by the soundcard. "
|
|
|
|
"Some of the formats supported by OSS are:"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:200
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Format"
|
|
|
|
msgstr "Format"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:200 ../Doc/library/ossaudiodev.rst:254
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Description"
|
|
|
|
msgstr "Description"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:202
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_MU_LAW`"
|
|
|
|
msgstr ":const:`AFMT_MU_LAW`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:202
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"a logarithmic encoding (used by Sun ``.au`` files and :file:`/dev/audio`)"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:205
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_A_LAW`"
|
|
|
|
msgstr ":const:`AFMT_A_LAW`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:205
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "a logarithmic encoding"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:207
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_IMA_ADPCM`"
|
|
|
|
msgstr ":const:`AFMT_IMA_ADPCM`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:207
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"a 4:1 compressed format defined by the Interactive Multimedia Association"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:210
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_U8`"
|
|
|
|
msgstr ":const:`AFMT_U8`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:210
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Unsigned, 8-bit audio"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:212
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_S16_LE`"
|
|
|
|
msgstr ":const:`AFMT_S16_LE`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:212
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Signed, 16-bit audio, little-endian byte order (as used by Intel processors)"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:215
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_S16_BE`"
|
|
|
|
msgstr ":const:`AFMT_S16_BE`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:215
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Signed, 16-bit audio, big-endian byte order (as used by 68k, PowerPC, Sparc)"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:218
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_S8`"
|
|
|
|
msgstr ":const:`AFMT_S8`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:218
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Signed, 8 bit audio"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:220
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_U16_LE`"
|
|
|
|
msgstr ":const:`AFMT_U16_LE`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:220
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Unsigned, 16-bit little-endian audio"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:222
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ":const:`AFMT_U16_BE`"
|
|
|
|
msgstr ":const:`AFMT_U16_BE`"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:222
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Unsigned, 16-bit big-endian audio"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:225
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Consult the OSS documentation for a full list of audio formats, and note "
|
|
|
|
"that most devices support only a subset of these formats. Some older "
|
|
|
|
"devices only support :const:`AFMT_U8`; the most common format used today is :"
|
|
|
|
"const:`AFMT_S16_LE`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:233
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Try to set the current audio format to *format*---see :meth:`getfmts` for a "
|
|
|
|
"list. Returns the audio format that the device was set to, which may not be "
|
|
|
|
"the requested format. May also be used to return the current audio format---"
|
|
|
|
"do this by passing an \"audio format\" of :const:`AFMT_QUERY`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:241
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Set the number of output channels to *nchannels*. A value of 1 indicates "
|
|
|
|
"monophonic sound, 2 stereophonic. Some devices may have more than 2 "
|
|
|
|
"channels, and some high-end devices may not support mono. Returns the number "
|
|
|
|
"of channels the device was set to."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:249
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Try to set the audio sampling rate to *samplerate* samples per second. "
|
|
|
|
"Returns the rate actually set. Most sound devices don't support arbitrary "
|
|
|
|
"sampling rates. Common rates are:"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:254
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Rate"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:256
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "8000"
|
|
|
|
msgstr "8000"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:256
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "default rate for :file:`/dev/audio`"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:258
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "11025"
|
|
|
|
msgstr "11025"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:258
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "speech recording"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:260
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "22050"
|
|
|
|
msgstr "22050"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:262
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "44100"
|
|
|
|
msgstr "44100"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:262
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "CD quality audio (at 16 bits/sample and 2 channels)"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:265
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "96000"
|
|
|
|
msgstr "96000"
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:265
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "DVD quality audio (at 24 bits/sample)"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:271
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Wait until the sound device has played every byte in its buffer. (This "
|
|
|
|
"happens implicitly when the device is closed.) The OSS documentation "
|
|
|
|
"recommends closing and re-opening the device rather than using :meth:`sync`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:278
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Immediately stop playing or recording and return the device to a state where "
|
|
|
|
"it can accept commands. The OSS documentation recommends closing and re-"
|
|
|
|
"opening the device after calling :meth:`reset`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:285
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Tell the driver that there is likely to be a pause in the output, making it "
|
|
|
|
"possible for the device to handle the pause more intelligently. You might "
|
|
|
|
"use this after playing a spot sound effect, before waiting for user input, "
|
|
|
|
"or before doing disk I/O."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:290
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"The following convenience methods combine several ioctls, or one ioctl and "
|
|
|
|
"some simple calculations."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:296
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Set the key audio sampling parameters---sample format, number of channels, "
|
|
|
|
"and sampling rate---in one method call. *format*, *nchannels*, and "
|
|
|
|
"*samplerate* should be as specified in the :meth:`setfmt`, :meth:`channels`, "
|
|
|
|
"and :meth:`speed` methods. If *strict* is true, :meth:`setparameters` "
|
|
|
|
"checks to see if each parameter was actually set to the requested value, and "
|
|
|
|
"raises :exc:`OSSAudioError` if not. Returns a tuple (*format*, *nchannels*, "
|
|
|
|
"*samplerate*) indicating the parameter values that were actually set by the "
|
|
|
|
"device driver (i.e., the same as the return values of :meth:`setfmt`, :meth:"
|
|
|
|
"`channels`, and :meth:`speed`)."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:306
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "For example, ::"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:310
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "is equivalent to ::"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:319
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Returns the size of the hardware buffer, in samples."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:324
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Returns the number of samples that are in the hardware buffer yet to be "
|
|
|
|
"played."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:329
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Returns the number of samples that could be queued into the hardware buffer "
|
|
|
|
"to be played without blocking."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:332
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Audio device objects also support several read-only attributes:"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:337
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Boolean indicating whether the device has been closed."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:342
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "String containing the name of the device file."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:347
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The I/O mode for the file, either ``\"r\"``, ``\"rw\"``, or ``\"w\"``."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:353
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Mixer Device Objects"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:355
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The mixer object provides two file-like methods:"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:360
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This method closes the open mixer device file. Any further attempts to use "
|
|
|
|
"the mixer after this file is closed will raise an :exc:`OSError`."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:366
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Returns the file handle number of the open mixer device file."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:368
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "Mixer objects also support the context management protocol."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:372
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid "The remaining methods are specific to audio mixing:"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:377
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This method returns a bitmask specifying the available mixer controls "
|
|
|
|
"(\"Control\" being a specific mixable \"channel\", such as :const:"
|
|
|
|
"`SOUND_MIXER_PCM` or :const:`SOUND_MIXER_SYNTH`). This bitmask indicates a "
|
|
|
|
"subset of all available mixer controls---the :const:`SOUND_MIXER_\\*` "
|
|
|
|
"constants defined at module level. To determine if, for example, the current "
|
|
|
|
"mixer object supports a PCM mixer, use the following Python code::"
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:389
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"For most purposes, the :const:`SOUND_MIXER_VOLUME` (master volume) and :"
|
|
|
|
"const:`SOUND_MIXER_PCM` controls should suffice---but code that uses the "
|
|
|
|
"mixer should be flexible when it comes to choosing mixer controls. On the "
|
|
|
|
"Gravis Ultrasound, for example, :const:`SOUND_MIXER_VOLUME` does not exist."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:397
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Returns a bitmask indicating stereo mixer controls. If a bit is set, the "
|
|
|
|
"corresponding control is stereo; if it is unset, the control is either "
|
|
|
|
"monophonic or not supported by the mixer (use in combination with :meth:"
|
|
|
|
"`controls` to determine which)."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:402
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"See the code example for the :meth:`controls` function for an example of "
|
|
|
|
"getting data from a bitmask."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:408
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Returns a bitmask specifying the mixer controls that may be used to record. "
|
|
|
|
"See the code example for :meth:`controls` for an example of reading from a "
|
|
|
|
"bitmask."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:414
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Returns the volume of a given mixer control. The returned volume is a 2-"
|
|
|
|
"tuple ``(left_volume,right_volume)``. Volumes are specified as numbers from "
|
|
|
|
"0 (silent) to 100 (full volume). If the control is monophonic, a 2-tuple is "
|
|
|
|
"still returned, but both volumes are the same."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:419
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Raises :exc:`OSSAudioError` if an invalid control is specified, or :exc:"
|
|
|
|
"`OSError` if an unsupported control is specified."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:425
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Sets the volume for a given mixer control to ``(left,right)``. ``left`` and "
|
|
|
|
"``right`` must be ints and between 0 (silent) and 100 (full volume). On "
|
|
|
|
"success, the new volume is returned as a 2-tuple. Note that this may not be "
|
|
|
|
"exactly the same as the volume specified, because of the limited resolution "
|
|
|
|
"of some soundcard's mixers."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:431
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Raises :exc:`OSSAudioError` if an invalid mixer control was specified, or if "
|
|
|
|
"the specified volumes were out-of-range."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:437
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"This method returns a bitmask indicating which control(s) are currently "
|
|
|
|
"being used as a recording source."
|
|
|
|
msgstr ""
|
|
|
|
|
2018-11-29 15:13:39 +00:00
|
|
|
#: ../Doc/library/ossaudiodev.rst:443
|
2016-10-30 09:46:26 +00:00
|
|
|
msgid ""
|
|
|
|
"Call this function to specify a recording source. Returns a bitmask "
|
|
|
|
"indicating the new recording source (or sources) if successful; raises :exc:"
|
|
|
|
"`OSError` if an invalid source was specified. To set the current recording "
|
|
|
|
"source to the microphone input::"
|
|
|
|
msgstr ""
|