# 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: 2020-08-24 09:01+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: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 ""

#: library/ossaudiodev.rst:42
msgid ""
"Operations in this module now raise :exc:`OSError` where :exc:`IOError` was "
"raised."
msgstr ""

#: library/ossaudiodev.rst:50
msgid ""
"`Open Sound System Programmer's Guide <http://www.opensound.com/pguide/oss."
"pdf>`_"
msgstr ""

#: library/ossaudiodev.rst:50
msgid "the official documentation for the OSS C API"
msgstr ""

#: 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 ""

#: library/ossaudiodev.rst:55
msgid ":mod:`ossaudiodev` defines the following variables and functions:"
msgstr ""

#: library/ossaudiodev.rst:60
msgid ""
"This exception is raised on certain errors.  The argument is a string "
"describing what went wrong."
msgstr ""

#: 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 ""

#: library/ossaudiodev.rst:67
msgid ""
"(For backwards compatibility, the exception class is also available as "
"``ossaudiodev.error``.)"
msgstr ""

#: 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 ""

#: 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 ""

#: 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 ""

#: 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 ""

#: 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 ""

#: library/ossaudiodev.rst:111
msgid "Audio Device Objects"
msgstr ""

#: 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 ""

#: library/ossaudiodev.rst:116
msgid ":meth:`setfmt` to set the output format"
msgstr ""

#: library/ossaudiodev.rst:118
msgid ":meth:`channels` to set the number of channels"
msgstr ""

#: library/ossaudiodev.rst:120
msgid ":meth:`speed` to set the sample rate"
msgstr ""

#: 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 ""

#: library/ossaudiodev.rst:126
msgid ""
"The audio device objects returned by :func:`.open` define the following "
"methods and (read-only) attributes:"
msgstr ""

#: 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 ""

#: library/ossaudiodev.rst:139
msgid "Return the file descriptor associated with the device."
msgstr ""

#: 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 ""

#: 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 "
"data may not be written---see :meth:`writeall`."
msgstr ""

#: library/ossaudiodev.rst:158 library/ossaudiodev.rst:172
msgid "Writable :term:`bytes-like object` is now accepted."
msgstr "N'importe quel :term:`bytes-like object` est maintenant accepté."

#: library/ossaudiodev.rst:164
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:176
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:181
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:190
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:196
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:200
msgid "Format"
msgstr "Format"

#: library/ossaudiodev.rst:200 library/ossaudiodev.rst:254
msgid "Description"
msgstr "Description"

#: library/ossaudiodev.rst:202
msgid ":const:`AFMT_MU_LAW`"
msgstr ":const:`AFMT_MU_LAW`"

#: library/ossaudiodev.rst:202
msgid ""
"a logarithmic encoding (used by Sun ``.au`` files and :file:`/dev/audio`)"
msgstr ""

#: library/ossaudiodev.rst:205
msgid ":const:`AFMT_A_LAW`"
msgstr ":const:`AFMT_A_LAW`"

#: library/ossaudiodev.rst:205
msgid "a logarithmic encoding"
msgstr ""

#: library/ossaudiodev.rst:207
msgid ":const:`AFMT_IMA_ADPCM`"
msgstr ":const:`AFMT_IMA_ADPCM`"

#: library/ossaudiodev.rst:207
msgid ""
"a 4:1 compressed format defined by the Interactive Multimedia Association"
msgstr ""

#: library/ossaudiodev.rst:210
msgid ":const:`AFMT_U8`"
msgstr ":const:`AFMT_U8`"

#: library/ossaudiodev.rst:210
msgid "Unsigned, 8-bit audio"
msgstr ""

#: library/ossaudiodev.rst:212
msgid ":const:`AFMT_S16_LE`"
msgstr ":const:`AFMT_S16_LE`"

#: library/ossaudiodev.rst:212
msgid ""
"Signed, 16-bit audio, little-endian byte order (as used by Intel processors)"
msgstr ""

#: library/ossaudiodev.rst:215
msgid ":const:`AFMT_S16_BE`"
msgstr ":const:`AFMT_S16_BE`"

#: library/ossaudiodev.rst:215
msgid ""
"Signed, 16-bit audio, big-endian byte order (as used by 68k, PowerPC, Sparc)"
msgstr ""

#: library/ossaudiodev.rst:218
msgid ":const:`AFMT_S8`"
msgstr ":const:`AFMT_S8`"

#: library/ossaudiodev.rst:218
msgid "Signed, 8 bit audio"
msgstr ""

#: library/ossaudiodev.rst:220
msgid ":const:`AFMT_U16_LE`"
msgstr ":const:`AFMT_U16_LE`"

#: library/ossaudiodev.rst:220
msgid "Unsigned, 16-bit little-endian audio"
msgstr ""

#: library/ossaudiodev.rst:222
msgid ":const:`AFMT_U16_BE`"
msgstr ":const:`AFMT_U16_BE`"

#: library/ossaudiodev.rst:222
msgid "Unsigned, 16-bit big-endian audio"
msgstr ""

#: library/ossaudiodev.rst:225
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:233
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:241
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:249
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:254
msgid "Rate"
msgstr ""

#: library/ossaudiodev.rst:256
msgid "8000"
msgstr "8000"

#: library/ossaudiodev.rst:256
msgid "default rate for :file:`/dev/audio`"
msgstr ""

#: library/ossaudiodev.rst:258
msgid "11025"
msgstr "11025"

#: library/ossaudiodev.rst:258
msgid "speech recording"
msgstr ""

#: library/ossaudiodev.rst:260
msgid "22050"
msgstr "22050"

#: library/ossaudiodev.rst:262
msgid "44100"
msgstr "44100"

#: library/ossaudiodev.rst:262
msgid "CD quality audio (at 16 bits/sample and 2 channels)"
msgstr ""

#: library/ossaudiodev.rst:265
msgid "96000"
msgstr "96000"

#: library/ossaudiodev.rst:265
msgid "DVD quality audio (at 24 bits/sample)"
msgstr ""

#: library/ossaudiodev.rst:271
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:278
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:285
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:290
msgid ""
"The following convenience methods combine several ioctls, or one ioctl and "
"some simple calculations."
msgstr ""

#: library/ossaudiodev.rst:296
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:306
#, fuzzy
msgid "For example,  ::"
msgstr "Par exemple ::"

#: library/ossaudiodev.rst:310
#, fuzzy
msgid "is equivalent to  ::"
msgstr "est équivalente à ::"

#: library/ossaudiodev.rst:319
msgid "Returns the size of the hardware buffer, in samples."
msgstr ""

#: library/ossaudiodev.rst:324
msgid ""
"Returns the number of samples that are in the hardware buffer yet to be "
"played."
msgstr ""

#: library/ossaudiodev.rst:329
msgid ""
"Returns the number of samples that could be queued into the hardware buffer "
"to be played without blocking."
msgstr ""

#: library/ossaudiodev.rst:332
msgid "Audio device objects also support several read-only attributes:"
msgstr ""

#: library/ossaudiodev.rst:337
msgid "Boolean indicating whether the device has been closed."
msgstr ""

#: library/ossaudiodev.rst:342
msgid "String containing the name of the device file."
msgstr ""

#: library/ossaudiodev.rst:347
msgid "The I/O mode for the file, either ``\"r\"``, ``\"rw\"``, or ``\"w\"``."
msgstr ""

#: library/ossaudiodev.rst:353
msgid "Mixer Device Objects"
msgstr ""

#: library/ossaudiodev.rst:355
msgid "The mixer object provides two file-like methods:"
msgstr ""

#: library/ossaudiodev.rst:360
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:366
msgid "Returns the file handle number of the open mixer device file."
msgstr ""

#: library/ossaudiodev.rst:368
msgid "Mixer objects also support the context management protocol."
msgstr ""

#: library/ossaudiodev.rst:372
msgid "The remaining methods are specific to audio mixing:"
msgstr ""

#: library/ossaudiodev.rst:377
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:389
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:397
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:402
msgid ""
"See the code example for the :meth:`controls` function for an example of "
"getting data from a bitmask."
msgstr ""

#: library/ossaudiodev.rst:408
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:414
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:419
msgid ""
"Raises :exc:`OSSAudioError` if an invalid control is specified, or :exc:"
"`OSError` if an unsupported control is specified."
msgstr ""

#: library/ossaudiodev.rst:425
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:431
msgid ""
"Raises :exc:`OSSAudioError` if an invalid mixer control was specified, or if "
"the specified volumes were out-of-range."
msgstr ""

#: library/ossaudiodev.rst:437
msgid ""
"This method returns a bitmask indicating which control(s) are currently "
"being used as a recording source."
msgstr ""

#: library/ossaudiodev.rst:443
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 ""
