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 11.0 から使用可能
この異形は以前のバージョンでは非対応です。

指定された設定を用いて二次元またはキューブマップ形式の Canvas を作成します。

概要

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

引数

number width
出力先の Canvas の幅。
number height
出力先の Canvas の高さ。
table settings
テーブルには下記の内容をフィールドとして設定します:
TextureType type ("2d")
作成する Canvas の種類。
PixelFormat format ("normal")
Canvas の形式。
boolean readable
Canvas を読み取り可能にするかどうか (描画、およびシェーダでアクセスできるようにするかどうか)。 True ならばデフォルトで通常形式となり、 false ならば 深度/ステンシル形式となります。
number msaa (0)
出力先の Canvas で描画時に使用するマルチサンプル・アンチエイリアシング (MSAA) のサンプル数。
number dpiscale (love.graphics.getDPIScale())
Canvas の画面描画時だけではなく Canvas の描画にも用いられるCanvas の尺度係数
CanvasMipmapMode mipmaps ("none")
Canvas にミップマップを持たせるかどうか。持たせるならば自動生成するかどうか。

返値

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

注意

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

関数

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

ボリュームまたはアレイテクスチャの形式の Canvas を作成します。

概要

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

引数

number width
出力先の Canvas の幅。
number height
出力先の Canvas の高さ。
number layers
アレイ・レイヤーの番号 (Canvas がアレイ・テクスチャの場合)、またはボリュームの深度 (Canvas がボリューム・テクスチャの場合)。
table settings
テーブルには下記の内容をフィールドとして設定します:
TextureType type ("array")
作成する Canvas の種類。
PixelFormat format ("normal")
Canvas の形式。
boolean readable
Canvas を読み取り可能にするかどうか (描画、およびシェーダでアクセスできるようにするかどうか)。 True ならばデフォルトで通常形式となり、 false ならば 深度/ステンシル形式となります。
number msaa (0)
出力先の Canvas で描画時に使用するマルチサンプル・アンチエイリアシング (MSAA) のサンプル数。
number dpiscale (love.graphics.getDPIScale())
Canvas の画面描画時だけではなく Canvas の描画にも用いられるCanvas の尺度係数
CanvasMipmapMode mipmaps ("none")
Canvas にミップマップを持たせるかどうか。持たせるならば自動生成するかどうか。

返値

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

関数

LÖVE 0.9.0 まで使用可能でしたが LÖVE 11.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 まで使用可能でしたが LÖVE 11.0 で廃止されました
この異形は以降のバージョンでは非対応です。

概要

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 です。

注意

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

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

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

関連



そのほかの言語