1
0
Fork 0
python-docs-fr/library/ossaudiodev.po

573 lines
18 KiB
Plaintext

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-05-22 23:13+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: library/ossaudiodev.rst:2
msgid ":mod:`ossaudiodev` --- Access to OSS-compatible audio devices"
msgstr ""
#: library/ossaudiodev.rst:12
msgid ""
"The :mod:`ossaudiodev` module is deprecated (see :pep:`PEP 594 "
"<594#ossaudiodev>` for details)."
msgstr ""
#: library/ossaudiodev.rst:15
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 ""
#: library/ossaudiodev.rst:47
msgid ""
"Operations in this module now raise :exc:`OSError` where :exc:`IOError` was "
"raised."
msgstr ""
#: library/ossaudiodev.rst:55
msgid ""
"`Open Sound System Programmer's Guide <http://www.opensound.com/pguide/oss."
"pdf>`_"
msgstr ""
#: library/ossaudiodev.rst:55
msgid "the official documentation for the OSS C API"
msgstr ""
#: library/ossaudiodev.rst:57
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 ""
#: library/ossaudiodev.rst:60
msgid ":mod:`ossaudiodev` defines the following variables and functions:"
msgstr ""
#: library/ossaudiodev.rst:65
msgid ""
"This exception is raised on certain errors. The argument is a string "
"describing what went wrong."
msgstr ""
#: library/ossaudiodev.rst:68
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 ""
#: library/ossaudiodev.rst:72
msgid ""
"(For backwards compatibility, the exception class is also available as "
"``ossaudiodev.error``.)"
msgstr ""
#: library/ossaudiodev.rst:79
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 ""
#: library/ossaudiodev.rst:85
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 ""
#: library/ossaudiodev.rst:89
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 ""
#: library/ossaudiodev.rst:96
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 ""
#: library/ossaudiodev.rst:107
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 ""
#: library/ossaudiodev.rst:116
msgid "Audio Device Objects"
msgstr ""
#: library/ossaudiodev.rst:118
msgid ""
"Before you can write to or read from an audio device, you must call three "
"methods in the correct order:"
msgstr ""
#: library/ossaudiodev.rst:121
msgid ":meth:`setfmt` to set the output format"
msgstr ""
#: library/ossaudiodev.rst:123
msgid ":meth:`channels` to set the number of channels"
msgstr ""
#: library/ossaudiodev.rst:125
msgid ":meth:`speed` to set the sample rate"
msgstr ""
#: library/ossaudiodev.rst:127
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 ""
#: library/ossaudiodev.rst:131
msgid ""
"The audio device objects returned by :func:`.open` define the following "
"methods and (read-only) attributes:"
msgstr ""
#: library/ossaudiodev.rst:137
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 ""
#: library/ossaudiodev.rst:144
msgid "Return the file descriptor associated with the device."
msgstr ""
#: library/ossaudiodev.rst:149
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 ""
#: library/ossaudiodev.rst:157
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 "
"data may not be written---see :meth:`writeall`."
msgstr ""
#: library/ossaudiodev.rst:177
msgid "Writable :term:`bytes-like object` is now accepted."
msgstr "N'importe quel :term:`bytes-like object` est maintenant accepté."
#: library/ossaudiodev.rst:169
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 ""
#: library/ossaudiodev.rst:181
msgid ""
"Audio device objects also support the context management protocol, i.e. they "
"can be used in a :keyword:`with` statement."
msgstr ""
#: library/ossaudiodev.rst:186
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 ""
#: library/ossaudiodev.rst:195
msgid ""
"Put the device into non-blocking mode. Once in non-blocking mode, there is "
"no way to return it to blocking mode."
msgstr ""
#: library/ossaudiodev.rst:201
msgid ""
"Return a bitmask of the audio output formats supported by the soundcard. "
"Some of the formats supported by OSS are:"
msgstr ""
#: library/ossaudiodev.rst:205
msgid "Format"
msgstr "Format"
#: library/ossaudiodev.rst:259
msgid "Description"
msgstr "Description"
#: library/ossaudiodev.rst:207
msgid ":const:`AFMT_MU_LAW`"
msgstr ":const:`AFMT_MU_LAW`"
#: library/ossaudiodev.rst:207
msgid ""
"a logarithmic encoding (used by Sun ``.au`` files and :file:`/dev/audio`)"
msgstr ""
#: library/ossaudiodev.rst:210
msgid ":const:`AFMT_A_LAW`"
msgstr ":const:`AFMT_A_LAW`"
#: library/ossaudiodev.rst:210
msgid "a logarithmic encoding"
msgstr ""
#: library/ossaudiodev.rst:212
msgid ":const:`AFMT_IMA_ADPCM`"
msgstr ":const:`AFMT_IMA_ADPCM`"
#: library/ossaudiodev.rst:212
msgid ""
"a 4:1 compressed format defined by the Interactive Multimedia Association"
msgstr ""
#: library/ossaudiodev.rst:215
msgid ":const:`AFMT_U8`"
msgstr ":const:`AFMT_U8`"
#: library/ossaudiodev.rst:215
msgid "Unsigned, 8-bit audio"
msgstr ""
#: library/ossaudiodev.rst:217
msgid ":const:`AFMT_S16_LE`"
msgstr ":const:`AFMT_S16_LE`"
#: library/ossaudiodev.rst:217
msgid ""
"Signed, 16-bit audio, little-endian byte order (as used by Intel processors)"
msgstr ""
#: library/ossaudiodev.rst:220
msgid ":const:`AFMT_S16_BE`"
msgstr ":const:`AFMT_S16_BE`"
#: library/ossaudiodev.rst:220
msgid ""
"Signed, 16-bit audio, big-endian byte order (as used by 68k, PowerPC, Sparc)"
msgstr ""
#: library/ossaudiodev.rst:223
msgid ":const:`AFMT_S8`"
msgstr ":const:`AFMT_S8`"
#: library/ossaudiodev.rst:223
msgid "Signed, 8 bit audio"
msgstr ""
#: library/ossaudiodev.rst:225
msgid ":const:`AFMT_U16_LE`"
msgstr ":const:`AFMT_U16_LE`"
#: library/ossaudiodev.rst:225
msgid "Unsigned, 16-bit little-endian audio"
msgstr ""
#: library/ossaudiodev.rst:227
msgid ":const:`AFMT_U16_BE`"
msgstr ":const:`AFMT_U16_BE`"
#: library/ossaudiodev.rst:227
msgid "Unsigned, 16-bit big-endian audio"
msgstr ""
#: library/ossaudiodev.rst:230
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 ""
#: library/ossaudiodev.rst:238
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 ""
#: library/ossaudiodev.rst:246
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 ""
#: library/ossaudiodev.rst:254
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 ""
#: library/ossaudiodev.rst:259
msgid "Rate"
msgstr ""
#: library/ossaudiodev.rst:261
msgid "8000"
msgstr "8000"
#: library/ossaudiodev.rst:261
msgid "default rate for :file:`/dev/audio`"
msgstr ""
#: library/ossaudiodev.rst:263
msgid "11025"
msgstr "11025"
#: library/ossaudiodev.rst:263
msgid "speech recording"
msgstr ""
#: library/ossaudiodev.rst:265
msgid "22050"
msgstr "22050"
#: library/ossaudiodev.rst:267
msgid "44100"
msgstr "44100"
#: library/ossaudiodev.rst:267
msgid "CD quality audio (at 16 bits/sample and 2 channels)"
msgstr ""
#: library/ossaudiodev.rst:270
msgid "96000"
msgstr "96000"
#: library/ossaudiodev.rst:270
msgid "DVD quality audio (at 24 bits/sample)"
msgstr ""
#: library/ossaudiodev.rst:276
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 ""
#: library/ossaudiodev.rst:283
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 ""
#: library/ossaudiodev.rst:290
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 ""
#: library/ossaudiodev.rst:295
msgid ""
"The following convenience methods combine several ioctls, or one ioctl and "
"some simple calculations."
msgstr ""
#: library/ossaudiodev.rst:301
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 ""
#: library/ossaudiodev.rst:311
#, fuzzy
msgid "For example, ::"
msgstr "Par exemple ::"
#: library/ossaudiodev.rst:315
#, fuzzy
msgid "is equivalent to ::"
msgstr "est équivalente à ::"
#: library/ossaudiodev.rst:324
msgid "Returns the size of the hardware buffer, in samples."
msgstr ""
#: library/ossaudiodev.rst:329
msgid ""
"Returns the number of samples that are in the hardware buffer yet to be "
"played."
msgstr ""
#: library/ossaudiodev.rst:334
msgid ""
"Returns the number of samples that could be queued into the hardware buffer "
"to be played without blocking."
msgstr ""
#: library/ossaudiodev.rst:337
msgid "Audio device objects also support several read-only attributes:"
msgstr ""
#: library/ossaudiodev.rst:342
msgid "Boolean indicating whether the device has been closed."
msgstr ""
#: library/ossaudiodev.rst:347
msgid "String containing the name of the device file."
msgstr ""
#: library/ossaudiodev.rst:352
msgid "The I/O mode for the file, either ``\"r\"``, ``\"rw\"``, or ``\"w\"``."
msgstr ""
#: library/ossaudiodev.rst:358
msgid "Mixer Device Objects"
msgstr ""
#: library/ossaudiodev.rst:360
msgid "The mixer object provides two file-like methods:"
msgstr ""
#: library/ossaudiodev.rst:365
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 ""
#: library/ossaudiodev.rst:371
msgid "Returns the file handle number of the open mixer device file."
msgstr ""
#: library/ossaudiodev.rst:373
msgid "Mixer objects also support the context management protocol."
msgstr ""
#: library/ossaudiodev.rst:377
msgid "The remaining methods are specific to audio mixing:"
msgstr ""
#: library/ossaudiodev.rst:382
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 ""
#: library/ossaudiodev.rst:394
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 ""
#: library/ossaudiodev.rst:402
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 ""
#: library/ossaudiodev.rst:407
msgid ""
"See the code example for the :meth:`controls` function for an example of "
"getting data from a bitmask."
msgstr ""
#: library/ossaudiodev.rst:413
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 ""
#: library/ossaudiodev.rst:419
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 ""
#: library/ossaudiodev.rst:424
msgid ""
"Raises :exc:`OSSAudioError` if an invalid control is specified, or :exc:"
"`OSError` if an unsupported control is specified."
msgstr ""
#: library/ossaudiodev.rst:430
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 ""
#: library/ossaudiodev.rst:436
msgid ""
"Raises :exc:`OSSAudioError` if an invalid mixer control was specified, or if "
"the specified volumes were out-of-range."
msgstr ""
#: library/ossaudiodev.rst:442
msgid ""
"This method returns a bitmask indicating which control(s) are currently "
"being used as a recording source."
msgstr ""
#: library/ossaudiodev.rst:448
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 ""