# 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 \n" "Language-Team: FRENCH \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 `_" 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 ```` 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 ""