love.graphics.newCanvas (日本語)

LÖVE 0.8.0 から使用可能
love.graphics.newFramebuffer から名称変更。

画面外表示を行うために Canvas オブジェクトを新規作成します。

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


関数

概要

canvas = love.graphics.newCanvas( )

引数

なし。

返値

Canvas canvas
ウィンドウにあるピクセルの大きさと等価な新規 Canvas の寸法。

関数

概要

canvas = love.graphics.newCanvas( width, height )

引数

number width
出力先の Canvas の幅。
number height
出力先の Canvas の高さ。

返値

Canvas canvas
指定された幅と高さの新規 Canvas です。

関数

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

概要

canvas = love.graphics.newCanvas( width, height, format )

引数

number width (window_width)
出力先の Canvas の幅。
number height (window_height)
出力先の Canvas の高さ。
CanvasFormat format ("normal")
出力先の Canvas で使用するテクスチャ形式。

返値

Canvas canvas
指定された幅と高さの新規 Canvas です。

注意

一部の Canvas 形式はデフォルト形式の Canvas より高いシステム要件を求められます。対応状況の確認には love.graphics.getCanvasFormats を使用してください。

関数

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

概要

canvas = love.graphics.newCanvas( width, height, format, msaa )

引数

number width (window_width)
出力先の Canvas の幅。
number height (window_height)
出力先の Canvas の高さ。
CanvasFormat format ("normal")
出力先の Canvas で使用するテクスチャ形式。
number msaa (0)
出力先の Canvas で描画時に使用するマルチサンプル・アンチエイリアシング (MSAA) のサンプル数。

返値

Canvas canvas
指定された幅と高さの新規 Canvas です。

注意

対応している MSAA サンプルの最大値はシステムに依存のため異なります。対応状況の確認には love.graphics.getSystemLimit を使用してください。

MSAA サンプル数としてシステムが対応している最大値より大きい物が指定された場合は、そのまま Canvas は作成されますが対応している最大量のみ使用します(これは 0 も当てはまります)。

関連



そのほかの言語