mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
134 lines
5.7 KiB
Plaintext
134 lines
5.7 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0)
|
|
# This file is distributed under the same license as the Godot Engine package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Godot Engine latest\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:4
|
|
msgid "Custom AudioStreams"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:7
|
|
msgid "Introduction"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:9
|
|
msgid "AudioStream is the base class of all audio emitting objects. AudioStreamPlayer binds onto an AudioStream to emit PCM data into an AudioServer which manages audio drivers."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:13
|
|
msgid "All audio resources require two audio based classes: AudioStream and AudioStreamPlayback. As a data container, AudioStream contains the resource and exposes itself to GDScript. AudioStream references its own internal custom AudioStreamPlayback which translates AudioStream into PCM data."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:19
|
|
msgid "This guide assumes the reader knows how to create C++ modules. If not, refer to this guide :ref:`doc_custom_modules_in_cpp`."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:23
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:115
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:346
|
|
msgid "References:"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:25
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:117
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:348
|
|
msgid "`servers/audio/audio_stream.h <https://github.com/godotengine/godot/blob/master/servers/audio/audio_stream.h>`__"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:26
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:349
|
|
msgid "`scene/audio/audio_stream_player.cpp <https://github.com/godotengine/godot/blob/master/scene/audio/audio_stream_player.cpp>`__"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:29
|
|
msgid "What for?"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:31
|
|
msgid "Binding external libraries (like Wwise, FMOD, etc)."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:32
|
|
msgid "Adding custom audio queues"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:33
|
|
msgid "Adding support for more audio formats"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:36
|
|
msgid "Create an AudioStream"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:38
|
|
msgid "An AudioStream consists of three components: data container, stream name, and an AudioStreamPlayback friend class generator. Audio data can be loaded in a number of ways such as with an internal counter for a tone generator, internal/external buffer, or a file reference."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:43
|
|
msgid "Some AudioStreams need to be stateless such as objects loaded from ResourceLoader. ResourceLoader loads once and references the same object regardless how many times ``load`` is called on a specific resource. Therefore, playback state must be self-contained in AudioStreamPlayback."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:48
|
|
msgid "audiostream_mytone.h"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:78
|
|
msgid "audiostream_mytone.cpp"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:121
|
|
msgid "Create an AudioStreamPlayback"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:123
|
|
msgid "AudioStreamPlayer uses ``mix`` callback to obtain PCM data. The callback must match sample rate and fill the buffer."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:125
|
|
msgid "Since AudioStreamPlayback is controlled by the audio thread, i/o and dynamic memory allocation are forbidden."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:127
|
|
msgid "audiostreamplayer_mytone.h"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:164
|
|
msgid "audiostreamplayer_mytone.cpp"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:228
|
|
msgid "Resampling"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:230
|
|
msgid "Godot's AudioServer currently uses 44100 Hz sample rate. When other sample rates are needed such as 48000, either provide one or use AudioStreamPlaybackResampled. Godot provides cubic interpolation for audio resampling."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:234
|
|
msgid "Instead of overloading ``mix``, AudioStreamPlaybackResampled uses ``_mix_internal`` to query AudioFrames and ``get_stream_sampling_rate`` to query current mix rate."
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:237
|
|
msgid "mytone_audiostream_resampled.h"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:279
|
|
msgid "mytone_audiostream_resampled.cpp"
|
|
msgstr ""
|
|
|
|
#: ../../docs/engine_details/architecture/custom_audiostreams.rst:347
|
|
msgid "`core/math/audio_frame.h <https://github.com/godotengine/godot/blob/master/core/math/audio_frame.h>`__"
|
|
msgstr ""
|