SpriteBatch:addLayer (日本語)

LÖVE 11.0 から使用可能

この関数は以前のバージョンでは非対応です。

アレイ・テクスチャで作成したバッチをスプライトへ追加します。

関数

SpriteBatch のアレイ・テクスチャをレイヤに追加します。

概要

spriteindex = SpriteBatch:addLayer( layerindex, x, y, r, sx, sy, ox, oy, kx, ky )

引数

number layerindex

現在のスプライトで使用するレイヤのインデックス。

number x (0)

x-軸でのスプライト描画位置。

number y (0)

y-軸でのスプライト描画位置。

number r (0)

方向 (弧度)。

number sx (1)

尺度変更係数 (x-軸)。

number sy (sx)

尺度変更係数 (x-軸)。

number ox (0)

原点の支距 (x-軸)。

number oy (0)

原点の支距 (y-軸)。

number kx (0)

剪断係数 (x-軸)。

number ky (0)

剪断係数 (y-軸)。

返値

number spriteindex

SpriteBatch:set あるいは SpriteBatch:setLayer で用いる追加されたスプライトのインデックス。

関数

指定された Quad を用いて SpriteBatch のアレイ・テクスチャをレイヤに追加します。

概要

spriteindex = SpriteBatch:addLayer( layerindex, quad, x, y, r, sx, sy, ox, oy, kx, ky )

引数

number layerindex

現在のスプライトで使用するレイヤのインデックス。

Quad quad

スプライトの描画時に使用するテクスチャのレイヤにおけるサブセクション (小区分)。

number x (0)

x-軸でのスプライト描画位置。

number y (0)

y-軸でのスプライト描画位置。

number r (0)

方向 (弧度)。

number sx (1)

尺度変更係数 (x-軸)。

number sy (sx)

尺度変更係数 (x-軸)。

number ox (0)

原点の支距 (x-軸)。

number oy (0)

原点の支距 (y-軸)。

number kx (0)

剪断係数 (x-軸)。

number ky (0)

剪断係数 (y-軸)。

返値

number spriteindex

SpriteBatch:set あるいは SpriteBatch:setLayer で用いる追加されたスプライトのインデックス。

注釈

指定されたレイヤのインデックスは Quad:setLayer で設定した Quad レイヤのインデックスの設定を上書きします。

関数

指定された Transform を用いて SpriteBatch のアレイ・テクスチャをレイヤに追加します。

概要

spriteindex = SpriteBatch:addLayer( layerindex, transform )

引数

number layerindex

現在のスプライトで使用するレイヤのインデックス。

Transform transform

Transform オブジェクト。

返値

number spriteindex

SpriteBatch:set あるいは SpriteBatch:setLayer で用いる追加されたスプライトのインデックス。

関数

指定された Quad と Transform を用いて SpriteBatch のアレイ・テクスチャをレイヤに追加します。

概要

spriteindex = SpriteBatch:addLayer( layerindex, quad, transform )

引数

number layerindex

現在のスプライトで使用するレイヤのインデックス。

Quad quad

スプライトの描画時に使用するテクスチャのレイヤにおけるサブセクション (小区分)。

Transform transform

Transform オブジェクト。

返値

number spriteindex

SpriteBatch:set あるいは SpriteBatch:setLayer で用いる追加されたスプライトのインデックス。

注釈

指定されたレイヤのインデックスは Quad:setLayer で設定した Quad レイヤのインデックスの設定を上書きします。

注釈

カスタム・シェーダのメインテクスチャとしてアレイ・テクスチャ、またはそれ以外の非二次元テクスチャ形式を用いるには、ピクセル・シェーダーで void effect() の異形を使用します。また、このように ArrayImage または sampler2DArray で MainTex を宣言してください: uniform ArrayImage MainTex;

用例

SpriteBatch におけるアレイ・イメージを多層レイヤーへ描画します

function love.load()
    local sprites = {"sprite1.png", "sprite2.png"}
    image = love.graphics.newArrayImage(sprites)

    batch = love.graphics.newSpriteBatch(image)
    batch:addLayer(1, 50, 50)
    batch:addLayer(2, 250, 50)
end

function love.draw()
    love.graphics.draw(batch)
end

カスタム・シェーダを使用します

shader = love.graphics.newShader[[
uniform ArrayImage MainTex;

void effect() {
    // アレイ・テクスチャが渡されたとき、テクセルはレイヤ・インデックスに対して第三構成要素のテクスチャ座標を使用します。
    // LOVE がアレイ・テクスチャをレンダリングするとき love.graphics.drawLayer で指定された
    // レイヤ・インデックスがあるテクスチャ座標を設定します。
    love_PixelColor = Texel(MainTex, VaryingTexCoord.xyz) * VaryingColor;
}
]]

function love.load()
    local sprites = {"sprite1.png", "sprite2.png"}
    image = love.graphics.newArrayImage(sprites)

    batch = love.graphics.newSpriteBatch(image)
    batch:addLayer(1, 50, 50)
    batch:addLayer(2, 250, 50)
end

function love.draw()
    love.graphics.setShader(shader)
    love.graphics.draw(batch)
end

関連

• SpriteBatch (日本語)
• SpriteBatch:setLayer (日本語)
• love.graphics.newArrayImage (日本語)
• love.graphics.newCanvas (日本語)
• love.graphics.newShader (日本語)
• TextureType (日本語)

そのほかの言語

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
詳細情報