Difference between revisions of "love.audio.newSource (日本語)"
m (→注釈) |
|||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
ファイルパス, [[File (日本語)|File]], [[Decoder (日本語)|Decoder]] または [[SoundData (日本語)|SoundData]] から [[Source (日本語)|Source]] を新規作成します。 | ファイルパス, [[File (日本語)|File]], [[Decoder (日本語)|Decoder]] または [[SoundData (日本語)|SoundData]] から [[Source (日本語)|Source]] を新規作成します。 | ||
− | SoundData | + | SoundData から作成した Source の再生方式は static になります。 |
{{newobjectnotice (日本語)}} | {{newobjectnotice (日本語)}} | ||
== 関数 == | == 関数 == | ||
− | == 概要 == | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} |
+ | === 概要 === | ||
<source lang="lua"> | <source lang="lua"> | ||
source = love.audio.newSource( filename, type ) | source = love.audio.newSource( filename, type ) | ||
</source> | </source> | ||
− | == 引数 == | + | === 引数 === |
{{param|string|filename|音声ファイルのファイルパス。 }} | {{param|string|filename|音声ファイルのファイルパス。 }} | ||
− | {{param|SourceType|type ( | + | {{param|SourceType|type|Source における再生方式の指定 (stream または static)}} |
− | == 返値 == | + | === 返値 === |
{{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
== 関数 == | == 関数 == | ||
− | == 概要 == | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} |
+ | === 概要 === | ||
<source lang="lua"> | <source lang="lua"> | ||
source = love.audio.newSource( file, type ) | source = love.audio.newSource( file, type ) | ||
</source> | </source> | ||
− | == 引数 == | + | === 引数 === |
{{param|File|file|File には音声ファイルを指定します。}} | {{param|File|file|File には音声ファイルを指定します。}} | ||
− | {{param|SourceType|type ( | + | {{param|SourceType|type|Source における再生方式の指定 (stream または static)}} |
− | == 返値 == | + | === 返値 === |
{{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
== 関数 == | == 関数 == | ||
− | == 概要 == | + | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} |
+ | === 概要 === | ||
<source lang="lua"> | <source lang="lua"> | ||
source = love.audio.newSource( decoder, type ) | source = love.audio.newSource( decoder, type ) | ||
</source> | </source> | ||
− | == 引数 == | + | === 引数 === |
− | {{param|Decoder|decoder|Source | + | {{param|Decoder|decoder|Source の作成元となる Decoder を指定します。}} |
− | {{param|SourceType|type (" | + | {{param|SourceType|type|Source における再生方式の指定 (stream または static)}} |
− | == 返値 == | + | === 返値 === |
+ | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
+ | == 関数 == | ||
+ | {{newin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} | ||
+ | === 概要 === | ||
+ | <source lang="lua"> | ||
+ | source = love.audio.newSource( data, type ) | ||
+ | </source> | ||
+ | === 引数 === | ||
+ | {{param|FileData|data|Source の作成元となる FileData を指定します。}} | ||
+ | {{param|SourceType|type|Source における再生方式の指定 (stream または static)}} | ||
+ | === 返値 === | ||
{{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
== 関数 == | == 関数 == | ||
− | == 概要 == | + | === 概要 === |
<source lang="lua"> | <source lang="lua"> | ||
source = love.audio.newSource( data ) | source = love.audio.newSource( data ) | ||
</source> | </source> | ||
− | == 引数 == | + | === 引数 === |
− | {{param|SoundData|data|Source | + | {{param|SoundData|data|Source の作成元となる SoundData を指定します。}} |
− | == 返値 == | + | === 返値 === |
− | {{param|Source|source|指定された音声は再生可能な新しい Source | + | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。 音声の再生方式 ([[SourceType (日本語)|SourceType]]) は "static" が返されます。}} |
+ | |||
+ | == 関数 == | ||
+ | {{oldin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} | ||
+ | === 概要 === | ||
+ | <source lang="lua"> | ||
+ | source = love.audio.newSource( filename, type ) | ||
+ | </source> | ||
+ | === 引数 === | ||
+ | {{param|string|filename|音声ファイルのファイルパス。 }} | ||
+ | {{param|SourceType|type ("stream")|Source における再生方式の指定 (stream または static)}} | ||
+ | === 返値 === | ||
+ | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
+ | == 関数 == | ||
+ | {{oldin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} | ||
+ | === 概要 === | ||
+ | <source lang="lua"> | ||
+ | source = love.audio.newSource( file, type ) | ||
+ | </source> | ||
+ | === 引数 === | ||
+ | {{param|File|file|File には音声ファイルを指定します。}} | ||
+ | {{param|SourceType|type ("stream")|Source における再生方式の指定 (stream または static)}} | ||
+ | === 返値 === | ||
+ | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
+ | == 関数 == | ||
+ | {{oldin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} | ||
+ | === 概要 === | ||
+ | <source lang="lua"> | ||
+ | source = love.audio.newSource( decoder, type ) | ||
+ | </source> | ||
+ | === 引数 === | ||
+ | {{param|Decoder|decoder|Source の作成元となる Decoder を指定します。}} | ||
+ | {{param|SourceType|type ("stream")|Source における再生方式の指定 (stream または static)}} | ||
+ | === 返値 === | ||
+ | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
== 関数 == | == 関数 == | ||
− | == 概要 == | + | {{oldin (日本語)|[[11.0 (日本語)|11.0]]|110|type=異形}} |
+ | === 概要 === | ||
<source lang="lua"> | <source lang="lua"> | ||
− | source = love.audio.newSource( data ) | + | source = love.audio.newSource( data, type ) |
</source> | </source> | ||
− | == 引数 == | + | === 引数 === |
− | {{param|FileData|data|Source | + | {{param|FileData|data|Source の作成元となる FileData を指定します。}} |
− | == 返値 == | + | {{param|SourceType|type ("stream")|Source における再生方式の指定 (stream または static)}} |
+ | === 返値 === | ||
{{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | {{param|Source|source|指定された音声は再生可能な新しい Source として返されます。}} | ||
+ | |||
+ | == 注釈 == | ||
+ | [[11.0 (日本語)|11.0]] 以前では、このコンストラクタへ [[SourceType (日本語)|SourceType]] として '''queue''' を指定してしまうと、エラーにならず、 [[Source:getType (日本語)|Source:getType]] で '''stream''' が返されてしまいます。つまり、これはバグです。解決方法として Source の種別指定には [[love.audio.newQueueableSource (日本語)|love.audio.newQueueableSource]] をお使いください。 | ||
== 用例 == | == 用例 == | ||
− | === | + | === 音楽を読み込んで再生します === |
<source lang="lua"> | <source lang="lua"> | ||
bgm = love.audio.newSource("bgm.ogg", "stream") | bgm = love.audio.newSource("bgm.ogg", "stream") | ||
love.audio.play(bgm) | love.audio.play(bgm) | ||
</source> | </source> | ||
− | === | + | === 効果音を読み込んで再生します === |
<source lang="lua"> | <source lang="lua"> | ||
sfx = love.audio.newSource("sfx.wav", "static") | sfx = love.audio.newSource("sfx.wav", "static") | ||
love.audio.play(sfx) | love.audio.play(sfx) | ||
</source> | </source> | ||
− | === SoundData を読み込んで Source | + | === SoundData を読み込んで Source を作成します === |
<source lang="lua"> | <source lang="lua"> | ||
data = love.sound.newSoundData("sfx.wav") | data = love.sound.newSoundData("sfx.wav") | ||
sfx = love.audio.newSource(data) | sfx = love.audio.newSource(data) | ||
</source> | </source> | ||
− | === Decoder を読み込んで Source | + | === Decoder を読み込んで Source を作成します === |
<source lang="lua"> | <source lang="lua"> | ||
decoder = love.sound.newDecoder("bgm.ogg") | decoder = love.sound.newDecoder("bgm.ogg") | ||
− | bgm = love.audio.newSource(decoder) | + | bgm = love.audio.newSource(decoder, "stream") |
</source> | </source> | ||
== 関連 == | == 関連 == | ||
Line 77: | Line 137: | ||
* [[Constructs::Source (日本語)]] | * [[Constructs::Source (日本語)]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
− | {{#set:Description= | + | {{#set:Description=ファイルパス, [[File (日本語)|File]], [[Decoder (日本語)|Decoder]] または [[SoundData (日本語)|SoundData]] から [[Source (日本語)|Source]] を新規作成します。}} |
{{#set:Since=000}} | {{#set:Since=000}} | ||
− | |||
== そのほかの言語 == | == そのほかの言語 == | ||
− | {{i18n|love.audio.newSource}} | + | {{i18n (日本語)|love.audio.newSource}} |
Latest revision as of 09:39, 3 December 2019
ファイルパス, File, Decoder または SoundData から Source を新規作成します。 SoundData から作成した Source の再生方式は static になります。
この関数は love.update または love.draw などから繰り返し呼び出すと動作が重くなることがあります。もし、特定の資源を何度も使う必要がある場合は、一括で作成と格納を行うことで効率的に再利用できます! |
関数
LÖVE 11.0 から使用可能 |
この異形は以前のバージョンでは非対応です。 |
概要
source = love.audio.newSource( filename, type )
引数
string filename
- 音声ファイルのファイルパス。
SourceType type
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から使用可能 |
この異形は以前のバージョンでは非対応です。 |
概要
source = love.audio.newSource( file, type )
引数
File file
- File には音声ファイルを指定します。
SourceType type
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から使用可能 |
この異形は以前のバージョンでは非対応です。 |
概要
source = love.audio.newSource( decoder, type )
引数
Decoder decoder
- Source の作成元となる Decoder を指定します。
SourceType type
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から使用可能 |
この異形は以前のバージョンでは非対応です。 |
概要
source = love.audio.newSource( data, type )
引数
FileData data
- Source の作成元となる FileData を指定します。
SourceType type
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
概要
source = love.audio.newSource( data )
引数
SoundData data
- Source の作成元となる SoundData を指定します。
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。 音声の再生方式 (SourceType) は "static" が返されます。
関数
LÖVE 11.0 から廃止 |
この異形は以降のバージョンでは非対応です。 |
概要
source = love.audio.newSource( filename, type )
引数
string filename
- 音声ファイルのファイルパス。
SourceType type ("stream")
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から廃止 |
この異形は以降のバージョンでは非対応です。 |
概要
source = love.audio.newSource( file, type )
引数
File file
- File には音声ファイルを指定します。
SourceType type ("stream")
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から廃止 |
この異形は以降のバージョンでは非対応です。 |
概要
source = love.audio.newSource( decoder, type )
引数
Decoder decoder
- Source の作成元となる Decoder を指定します。
SourceType type ("stream")
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
関数
LÖVE 11.0 から廃止 |
この異形は以降のバージョンでは非対応です。 |
概要
source = love.audio.newSource( data, type )
引数
FileData data
- Source の作成元となる FileData を指定します。
SourceType type ("stream")
- Source における再生方式の指定 (stream または static)
返値
Source source
- 指定された音声は再生可能な新しい Source として返されます。
注釈
11.0 以前では、このコンストラクタへ SourceType として queue を指定してしまうと、エラーにならず、 Source:getType で stream が返されてしまいます。つまり、これはバグです。解決方法として Source の種別指定には love.audio.newQueueableSource をお使いください。
用例
音楽を読み込んで再生します
bgm = love.audio.newSource("bgm.ogg", "stream")
love.audio.play(bgm)
効果音を読み込んで再生します
sfx = love.audio.newSource("sfx.wav", "static")
love.audio.play(sfx)
SoundData を読み込んで Source を作成します
data = love.sound.newSoundData("sfx.wav")
sfx = love.audio.newSource(data)
Decoder を読み込んで Source を作成します
decoder = love.sound.newDecoder("bgm.ogg")
bgm = love.audio.newSource(decoder, "stream")
関連