Difference between revisions of "love.graphics.newImage (日本語)"

(Created page with "ファイルパス、 FileData, ImageData または CompressedImageData から新規 I...")
 
m (関数)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
ファイルパス、 [[FileData (日本語)|FileData]], [[ImageData (日本語)|ImageData]] または [[CompressedImageData (日本語)|CompressedImageData]] から新規 [[Image (日本語)|Image]]の作成を行い、さらに画像に対して任意で mipmap を作成または指定します。
+
ファイルパス、 [[FileData (日本語)|FileData]], [[ImageData (日本語)|ImageData]] または [[CompressedImageData (日本語)|CompressedImageData]] から新規 [[Image (日本語)|Image]]の作成を行い、さらに画像に対して任意で mipmap を作成または指定します。
 
{{newobjectnotice (日本語)}}
 
{{newobjectnotice (日本語)}}
 
== 関数 ==
 
== 関数 ==
Line 7: Line 7:
 
</source>
 
</source>
 
=== 引数 ===
 
=== 引数 ===
{{param|string|filename|画像ファイルのファイルパス。}}
+
{{param (日本語)|string|filename|画像ファイルのファイルパス。}}
 
=== 返値 ===
 
=== 返値 ===
{{param|Image|image|画面上で描画できる Image オブジェクト。}}
+
{{param (日本語)|Image|image|画面上で描画できる Image オブジェクト。}}
  
 
== 関数 ==
 
== 関数 ==
Line 17: Line 17:
 
</source>
 
</source>
 
=== 引数 ===
 
=== 引数 ===
{{param|ImageData|imageData|ImageData オブジェクト。この ImageData は [[love.window.setMode (日本語)|love.window.setMode]] が呼び出されたときに Image を ImageData へ再読み込みするために使用されます。}}
+
{{param (日本語)|ImageData|imageData|ImageData オブジェクト。この ImageData は [[love.window.setMode (日本語)|love.window.setMode]] が呼び出されたときに Image を ImageData へ再読み込みするために使用されます。}}
 
=== 返値 ===
 
=== 返値 ===
{{param|Image|image|画面上で描画できる Image オブジェクト。}}
+
{{param (日本語)|Image|image|画面上で描画できる Image オブジェクト。}}
  
 
== 関数 ==
 
== 関数 ==
{{newin (日本語)|[[0.9.0]]|090|type=異形}}
+
{{newin (日本語)|[[0.9.0 (日本語)|0.9.0]]|090|type=異形}}
 
=== 概要 ===
 
=== 概要 ===
 
<source lang="lua">
 
<source lang="lua">
Line 28: Line 28:
 
</source>
 
</source>
 
=== 引数 ===
 
=== 引数 ===
{{param|CompressedImageData|compressedImageData|CompressedImageData オブジェクト。この CompressedImageData は [[love.window.setMode (日本語)|love.window.setMode]] が呼び出されたときに Image を CompressedImageData へ再読み込みするために使用されます。
+
{{param (日本語)|CompressedImageData|compressedImageData|CompressedImageData オブジェクト。この CompressedImageData は [[love.window.setMode (日本語)|love.window.setMode]] が呼び出されたときに Image を CompressedImageData へ再読み込みするために使用されます。
 
}}
 
}}
 
=== 返値 ===
 
=== 返値 ===
{{param|Image|image|画面上で描画できる Image オブジェクト。}}
+
{{param (日本語)|Image|image|画面上で描画できる Image オブジェクト。}}
  
 
== 関数 ==
 
== 関数 ==
{{newin (日本語)|[[0.10.0]]|100|type=異形}}
+
{{newin (日本語)|[[0.10.0 (日本語)|0.10.0]]|100|type=異形}}
 
=== 概要 ===
 
=== 概要 ===
 
<source lang="lua">
 
<source lang="lua">
Line 40: Line 40:
 
</source>
 
</source>
 
=== 引数 ===
 
=== 引数 ===
{{param|string|filename|画像ファイルのファイルパス(または [[FileData (日本語)|FileData]] または  [[ImageData (日本語)|ImageData]] あるいは  [[CompressedData (日本語)|CompressedData]] オブジェクト)。}}
+
{{param (日本語)|string|filename|画像ファイルのファイルパス(または [[FileData (日本語)|FileData]] または  [[ImageData (日本語)|ImageData]] あるいは  [[CompressedData (日本語)|CompressedData]] オブジェクト)。}}
{{param|table|flags|下記のフィールドを有するテーブル:}}
+
{{param (日本語)|table|flags|下記のフィールドを有するテーブル:}}
 
{{subparam|boolean|linear (false)|true の場合に[[love.graphics.isGammaCorrect (日本語)|ガンマ補正表示]]が有効ならば、画像のピクセルは sRGB ではなく 線形 RGB で符号化されているものと解釈されます。それ以外において影響はありません。}}
 
{{subparam|boolean|linear (false)|true の場合に[[love.graphics.isGammaCorrect (日本語)|ガンマ補正表示]]が有効ならば、画像のピクセルは sRGB ではなく 線形 RGB で符号化されているものと解釈されます。それ以外において影響はありません。}}
 
{{subparam|boolean or table|mipmaps (false)|true の場合は、画像に対して mipmap を自動生成します([[CompressedImageData (日本語)|CompressedImageData]]) を起源とする画像である場合は、画像ファイルから取得します)。この値がテーブルの場合は、 1x1 から、半分の大きさまで段階的に縮小される寸法がある同一形式による画像ファイル名以外のリストを有しています。それらの画像は、この Image の mipmap レベルとして使用されます。}}
 
{{subparam|boolean or table|mipmaps (false)|true の場合は、画像に対して mipmap を自動生成します([[CompressedImageData (日本語)|CompressedImageData]]) を起源とする画像である場合は、画像ファイルから取得します)。この値がテーブルの場合は、 1x1 から、半分の大きさまで段階的に縮小される寸法がある同一形式による画像ファイル名以外のリストを有しています。それらの画像は、この Image の mipmap レベルとして使用されます。}}
  
 
=== 返値 ===
 
=== 返値 ===
{{param|Image|image|画面上で描画できる新規 Image オブジェクト。}}
+
{{param (日本語)|Image|image|画面上で描画できる新規 Image オブジェクト。}}
  
 
== 関数 ==
 
== 関数 ==
{{newinoldin (日本語)|[[0.9.1]]|091|[[0.10.0]]|100|type=異形}}
+
{{newinoldin (日本語)|[[0.9.1 (日本語)|0.9.1]]|091|[[0.10.0 (日本語)|0.10.0]]|100|type=異形}}
 
=== 概要 ===
 
=== 概要 ===
 
<source lang="lua">
 
<source lang="lua">
Line 55: Line 55:
 
</source>
 
</source>
 
=== 引数 ===
 
=== 引数 ===
{{param|string|filename|画像ファイルのファイルパス(または [[FileData (日本語)|FileData]] または  [[ImageData (日本語)|ImageData]] あるいは  [[CompressedData (日本語)|CompressedData]] オブジェクト)。}}
+
{{param (日本語)|string|filename|画像ファイルのファイルパス(または [[FileData (日本語)|FileData]] または  [[ImageData (日本語)|ImageData]] あるいは  [[CompressedData (日本語)|CompressedData]] オブジェクト)。}}
{{param|TextureFormat|format|画像データとして解釈を行う形式。}}
+
{{param (日本語)|TextureFormat|format|画像データとして解釈を行う形式。}}
 
=== 返値 ===
 
=== 返値 ===
{{param|Image|image|画面上で描画できる Image オブジェクト。}}
+
{{param (日本語)|Image|image|画面上で描画できる Image オブジェクト。}}
  
 
== 関連 ==
 
== 関連 ==
Line 68: Line 68:
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 
== そのほかの言語 ==
 
== そのほかの言語 ==
{{i18n|love.graphics.newImage}}
+
{{i18n (日本語)|love.graphics.newImage}}

Latest revision as of 08:18, 1 July 2019

ファイルパス、 FileData, ImageData または CompressedImageData から新規 Imageの作成を行い、さらに画像に対して任意で mipmap を作成または指定します。

O.png この関数は love.update または love.draw などから繰り返し呼び出すと動作が重くなることがあります。もし、特定の資源を何度も使う必要がある場合は、一括で作成と格納を行うことで効率的に再利用できます!  



関数

概要

image = love.graphics.newImage( filename )

引数

string filename
画像ファイルのファイルパス。

返値

Image image
画面上で描画できる Image オブジェクト。

関数

概要

image = love.graphics.newImage( imageData )

引数

ImageData imageData
ImageData オブジェクト。この ImageData は love.window.setMode が呼び出されたときに Image を ImageData へ再読み込みするために使用されます。

返値

Image image
画面上で描画できる Image オブジェクト。

関数

LÖVE 0.9.0 から使用可能
この異形は以前のバージョンでは非対応です。

概要

image = love.graphics.newImage( compressedImageData )

引数

CompressedImageData compressedImageData
CompressedImageData オブジェクト。この CompressedImageData は love.window.setMode が呼び出されたときに Image を CompressedImageData へ再読み込みするために使用されます。

返値

Image image
画面上で描画できる Image オブジェクト。

関数

LÖVE 0.10.0 から使用可能
この異形は以前のバージョンでは非対応です。

概要

image = love.graphics.newImage( filename, flags )

引数

string filename
画像ファイルのファイルパス(または FileData または ImageData あるいは CompressedData オブジェクト)。
table flags
下記のフィールドを有するテーブル:
boolean linear (false)
true の場合にガンマ補正表示が有効ならば、画像のピクセルは sRGB ではなく 線形 RGB で符号化されているものと解釈されます。それ以外において影響はありません。
boolean or table mipmaps (false)
true の場合は、画像に対して mipmap を自動生成します(CompressedImageData) を起源とする画像である場合は、画像ファイルから取得します)。この値がテーブルの場合は、 1x1 から、半分の大きさまで段階的に縮小される寸法がある同一形式による画像ファイル名以外のリストを有しています。それらの画像は、この Image の mipmap レベルとして使用されます。

返値

Image image
画面上で描画できる新規 Image オブジェクト。

関数

LÖVE 0.9.1 まで使用可能でしたが LÖVE 0.10.0 で廃止されました
この異形は以降のバージョンでは非対応です。

概要

image = love.graphics.newImage( filename, format )

引数

string filename
画像ファイルのファイルパス(または FileData または ImageData あるいは CompressedData オブジェクト)。
TextureFormat format
画像データとして解釈を行う形式。

返値

Image image
画面上で描画できる Image オブジェクト。

関連


そのほかの言語