diff --git a/library/wave.po b/library/wave.po index f0ec943f6a..d72ac11ac2 100644 --- a/library/wave.po +++ b/library/wave.po @@ -32,22 +32,28 @@ msgid "" "\"WAVE\" (or \"WAV\") file format. Only uncompressed PCM encoded wave files " "are supported." msgstr "" +":mod:`wave` 模組為波形音訊檔案格式「WAVE」(或稱「WAV」)提供了便捷的介面。" +"僅支援未壓縮的 PCM 編碼波形檔。" #: ../../library/wave.rst:20 msgid "" "Support for ``WAVE_FORMAT_EXTENSIBLE`` headers was added, provided that the " "extended format is ``KSDATAFORMAT_SUBTYPE_PCM``." msgstr "" +"增加了標頭 ``WAVE_FORMAT_EXTENSIBLE`` 的支援,要求的擴展格式" +"為 ``KSDATAFORMAT_SUBTYPE_PCM``。" #: ../../library/wave.rst:23 msgid "The :mod:`wave` module defines the following function and exception:" -msgstr "" +msgstr ":mod:`wave` 模組定義了以下的函式和例外:" #: ../../library/wave.rst:28 msgid "" "If *file* is a string, open the file by that name, otherwise treat it as a " "file-like object. *mode* can be:" msgstr "" +"如果 *file* 是一個字串,會打開對應名稱的檔案,否則會以類檔案物件處理。" +"*mode* 可以是:" #: ../../library/wave.rst:32 msgid "``'rb'``" @@ -55,7 +61,7 @@ msgstr "``'rb'``" #: ../../library/wave.rst:32 msgid "Read only mode." -msgstr "" +msgstr "唯讀模式。" #: ../../library/wave.rst:35 msgid "``'wb'``" @@ -63,11 +69,11 @@ msgstr "``'wb'``" #: ../../library/wave.rst:35 msgid "Write only mode." -msgstr "" +msgstr "唯寫模式。" #: ../../library/wave.rst:37 msgid "Note that it does not allow read/write WAV files." -msgstr "" +msgstr "請注意,不支援同時讀寫 WAV 檔案。" #: ../../library/wave.rst:39 msgid "" @@ -76,6 +82,9 @@ msgid "" "file-like object is passed as *file*, ``file.mode`` is used as the default " "value for *mode*." msgstr "" +"*mode* 設定為 ``'rb'`` 時,會回傳一個 :class:`Wave_read` 物件,*mode* 設定為 " +"``'wb'`` 時,則回傳一個 :class:`Wave_write` 物件。如果省略 *mode*,並且將類檔案" +" (file-like) 物件作為 *file* 參數傳遞,則 ``file.mode`` 會是 *mode* 的預設值。" #: ../../library/wave.rst:44 msgid "" @@ -83,6 +92,8 @@ msgid "" "its ``close()`` method is called; it is the caller's responsibility to close " "the file object." msgstr "" +"如果您傳遞一個類檔案物件,當呼叫其 ``close()`` 方法時,wave 物件不會自動關閉" +"該物件;關閉檔案物件的責任會在呼叫者上。" #: ../../library/wave.rst:48 msgid "" @@ -90,16 +101,19 @@ msgid "" "the :keyword:`!with` block completes, the :meth:`Wave_read.close()` or :meth:" "`Wave_write.close()` method is called." msgstr "" +":func:`.open` 函式可以在 :keyword:`with` 陳述式中使用。當 :keyword:`!with` 區" +"塊完成時,會呼叫 :meth:`Wave_read.close()` 或是 :meth:`Wave_write.close()` 方" +"法。" #: ../../library/wave.rst:52 ../../library/wave.rst:176 msgid "Added support for unseekable files." -msgstr "" +msgstr "增加對不可搜尋 (unseekable) 檔案的支援。" #: ../../library/wave.rst:57 msgid "" "An error raised when something is impossible because it violates the WAV " "specification or hits an implementation deficiency." -msgstr "" +msgstr "當不符合 WAV 格式或無法操作時會引發錯誤。" #: ../../library/wave.rst:64 msgid "Wave_read Objects" @@ -107,44 +121,46 @@ msgstr "Wave_read 物件" #: ../../library/wave.rst:68 msgid "Read a WAV file." -msgstr "" +msgstr "讀取一個 WAV 檔案。" #: ../../library/wave.rst:70 msgid "" "Wave_read objects, as returned by :func:`.open`, have the following methods:" -msgstr "" +msgstr "由 :func:`.open` 回傳的 Wave_read 物件具有以下方法:" #: ../../library/wave.rst:75 msgid "" "Close the stream if it was opened by :mod:`wave`, and make the instance " "unusable. This is called automatically on object collection." -msgstr "" +msgstr "關閉 :mod:`wave` 開啟的串流並使該實例無法使用。當物件回收時自動呼叫。" #: ../../library/wave.rst:81 msgid "Returns number of audio channels (``1`` for mono, ``2`` for stereo)." -msgstr "" +msgstr "回傳音訊聲道的數量(單聲道為 ``1``,立體聲為 ``2``)。" #: ../../library/wave.rst:86 msgid "Returns sample width in bytes." -msgstr "" +msgstr "回傳以位元組表示的取樣寬度 (sample width)。" #: ../../library/wave.rst:91 msgid "Returns sampling frequency." -msgstr "" +msgstr "回傳取樣率。" #: ../../library/wave.rst:96 msgid "Returns number of audio frames." -msgstr "" +msgstr "回傳音訊幀數。" #: ../../library/wave.rst:101 msgid "Returns compression type (``'NONE'`` is the only supported type)." -msgstr "" +msgstr "回傳壓縮類型(僅支援 ``'NONE'`` 類型)。" #: ../../library/wave.rst:106 msgid "" "Human-readable version of :meth:`getcomptype`. Usually ``'not compressed'`` " "parallels ``'NONE'``." msgstr "" +":meth:`getcomptype` 的人類可讀的版本。通常使用 ``'not compressed'`` 代替 " +"``'NONE'``。" #: ../../library/wave.rst:112 msgid "" @@ -152,43 +168,47 @@ msgid "" "framerate, nframes, comptype, compname)``, equivalent to output of the " "``get*()`` methods." msgstr "" +"回傳一個 :func:`~collections.namedtuple` ``(nchannels, sampwidth, framerate, " +"nframes, comptype, compname)``,等同於 ``get*()`` 方法的輸出。" #: ../../library/wave.rst:119 msgid "" "Reads and returns at most *n* frames of audio, as a :class:`bytes` object." -msgstr "" +msgstr "讀取並回傳以 :class:`bytes` 物件表示的最多 *n* 個音訊幀。" #: ../../library/wave.rst:124 msgid "Rewind the file pointer to the beginning of the audio stream." -msgstr "" +msgstr "重置檔案指標至音訊流的開頭。" #: ../../library/wave.rst:126 msgid "" "The following two methods are defined for compatibility with the :mod:`aifc` " "module, and don't do anything interesting." -msgstr "" +msgstr "以下兩個方法是為了與 :mod:`aifc` 模組的保持相容性,並不執行任何操作。" #: ../../library/wave.rst:132 msgid "Returns ``None``." -msgstr "" +msgstr "回傳 ``None``。" #: ../../library/wave.rst:137 msgid "Raise an error." -msgstr "" +msgstr "引發錯誤。" #: ../../library/wave.rst:139 msgid "" "The following two methods define a term \"position\" which is compatible " "between them, and is otherwise implementation dependent." msgstr "" +"以下兩個方法所定義的「位置」,在它們之間是相容的,但其他情況下則取決於具體實作" +"方式。" #: ../../library/wave.rst:145 msgid "Set the file pointer to the specified position." -msgstr "" +msgstr "將檔案指標設定為指定的位置。" #: ../../library/wave.rst:150 msgid "Return current file pointer position." -msgstr "" +msgstr "回傳目前的檔案指標位置。" #: ../../library/wave.rst:156 msgid "Wave_write Objects" @@ -196,11 +216,11 @@ msgstr "Wave_write 物件" #: ../../library/wave.rst:160 msgid "Write a WAV file." -msgstr "" +msgstr "寫入一個 WAV 檔案。" #: ../../library/wave.rst:162 msgid "Wave_write objects, as returned by :func:`.open`." -msgstr "" +msgstr "Wave_write 物件,由 :func:`.open` 回傳。" #: ../../library/wave.rst:164 msgid "" @@ -215,10 +235,17 @@ msgid "" "`writeframes` will calculate the number of frames in the data and set " "*nframes* accordingly before writing the frame data." msgstr "" +"對於可搜尋 (seekable) 的輸出串流,``wave`` 標頭將自動更新,以反映實際寫入的幀" +"數。對於不可搜尋的串流,當寫入第一個幀資料時,*nframes* 的值必" +"須是準確的。要取得準確的 *nframes* 值,可以通過呼叫 :meth:`setnframes` 或 :" +"meth:`setparams` 方法,並在呼叫 :meth:`close` 之前設定將寫入的幀數量,然後使" +"用 :meth:`writeframesraw` 方法寫入幀資料;或者通過呼叫 :meth:`writeframes` 方" +"法一次性寫入所有的幀資料。在後一種情況下,:meth:`writeframes` 方法將計算資料" +"中的幀數量,並在寫入幀資料之前相應地設定 *nframes* 的值。" #: ../../library/wave.rst:179 msgid "Wave_write objects have the following methods:" -msgstr "" +msgstr "Wave_write 物件具有以下方法:" #: ../../library/wave.rst:183 msgid "" @@ -227,22 +254,25 @@ msgid "" "exception if the output stream is not seekable and *nframes* does not match " "the number of frames actually written." msgstr "" +"確保 *nframes* 正確,如果該檔案是由 :mod:`wave` 開啟的,則關閉該檔案。此方法" +"在物件回收時被呼叫。如果輸出串流不可搜尋且 *nframes* 不符合實際" +"寫入的幀數,則會引發例外。" #: ../../library/wave.rst:191 msgid "Set the number of channels." -msgstr "" +msgstr "設定音訊的通道數量。" #: ../../library/wave.rst:196 msgid "Set the sample width to *n* bytes." -msgstr "" +msgstr "設定取樣寬度為 *n* 個位元組。" #: ../../library/wave.rst:201 msgid "Set the frame rate to *n*." -msgstr "" +msgstr "設定取樣頻率為 *n*。" #: ../../library/wave.rst:203 msgid "A non-integral input to this method is rounded to the nearest integer." -msgstr "" +msgstr "此方法的非整數輸入會被將四捨五入到最接近的整數。" #: ../../library/wave.rst:210 msgid "" @@ -250,12 +280,14 @@ msgid "" "of frames actually written is different (this update attempt will raise an " "error if the output stream is not seekable)." msgstr "" +"設定幀數為 *n*。如果實際寫入的幀數不同,則稍後將進行更改(如果輸出串流不可搜" +"尋,則此嘗試將引發錯誤)。" #: ../../library/wave.rst:217 msgid "" "Set the compression type and description. At the moment, only compression " "type ``NONE`` is supported, meaning no compression." -msgstr "" +msgstr "設定壓縮類型和描述。目前只支援壓縮類型為 ``NONE``,表示無壓縮。" #: ../../library/wave.rst:223 msgid "" @@ -263,20 +295,24 @@ msgid "" "compname)``, with values valid for the ``set*()`` methods. Sets all " "parameters." msgstr "" +"這個 *tuple* 應該是 ``(nchannels, sampwidth, framerate, nframes, comptype, " +"compname)``,值需要是符合 ``set*()`` 方法的參數。設定所有參數。" #: ../../library/wave.rst:230 msgid "" "Return current position in the file, with the same disclaimer for the :meth:" "`Wave_read.tell` and :meth:`Wave_read.setpos` methods." msgstr "" +"回傳檔案中的指標位置,其指標位置含意與 :meth:`Wave_read.tell` 和 :meth:" +"`Wave_read.setpos` 是一致的。" #: ../../library/wave.rst:236 msgid "Write audio frames, without correcting *nframes*." -msgstr "" +msgstr "寫入音訊幀,不修正 *nframes*。" #: ../../library/wave.rst:238 ../../library/wave.rst:249 msgid "Any :term:`bytes-like object` is now accepted." -msgstr "" +msgstr "現在可接受任何 :term:`bytes-like object`。" #: ../../library/wave.rst:244 msgid "" @@ -285,6 +321,8 @@ msgid "" "that have been written after *data* has been written does not match the " "previously set value for *nframes*." msgstr "" +"寫入音訊幀並確保 *nframes* 正確。如果輸出串流不可搜尋,並且在寫" +"入 *data* 後已寫入的總幀數與先前設定的 *nframes* 值不符,則會引發錯誤。" #: ../../library/wave.rst:252 msgid "" @@ -292,3 +330,5 @@ msgid "" "`writeframes` or :meth:`writeframesraw`, and any attempt to do so will " "raise :exc:`wave.Error`." msgstr "" +"注意在呼叫 :meth:`writeframes` 或 :meth:`writeframesraw` 之後設置任何參數都是" +"無效的,任何嘗試這樣做的操作都會引發 :exc:`wave.Error`。"