Difference between revisions of "love.audio.newSource (日本語)"

(Created page with "ファイルパス, File, Decoder または SoundData から Source を新規作...")
 
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 から作成された Source は 常に static になります。
+
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 ("stream")|ストリーミングまたはスタティックソースの指定。}}
+
{{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 ("stream")|ストリーミングまたはスタティックソースの指定。}}
+
{{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 を作成するための Decoder を指定します。}}
+
{{param|Decoder|decoder|Source の作成元となる Decoder を指定します。}}
{{param|SourceType|type ("stream")|ストリーミングまたはスタティックソースの指定。}}
+
{{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 を作成するための SoundData を指定します。}}
+
{{param|SoundData|data|Source の作成元となる SoundData を指定します。}}
== 返値 ==
+
=== 返値 ===
{{param|Source|source|指定された音声は再生可能な新しい Source として返されます。返された音声の [[SourceType]] は "static" です。}}
+
{{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 を作成するための FileData を指定します。}}
+
{{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=ファイル, [[SoundData (日本語)|SoundData]] または  [[Decoder (日本語)|Decoder]] から [[Source (日本語)|Source]] を新規作成します。}}
+
{{#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 になります。

O.png この関数は 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:getTypestream が返されてしまいます。つまり、これはバグです。解決方法として 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")

関連


そのほかの言語