GLESAdaptor¶

OpenGL ES の描画コンテキストを保持できるアダプター (EGLベース)

描画に使うオブジェクトは egl を使ってコンテキスト処理する前提になります

メンバー一覧¶

GLESAdaptor¶

コンストラクタ

引数

引数	既定値	説明
`window`	` `	対象ウインドウ

解説

コンストラクタ

screenWidth¶

プロパティ \ アクセス: r/w

解説

スクリーン横幅

screenHeight¶

プロパティ \ アクセス: r/w

解説

スクリーン縦幅

blendMode¶

プロパティ \ アクセス: r/w

解説

ブレンドモード (tTVPBlendMode 相当: 0=Disable,1=Opaque,2=Alpha,3=Add,...)

setScreenSize¶

メソッド

引数

引数	既定値	説明
`width`	` `
`height`	` `

解説

スクリーンサイズの設定

makeCurrent¶

メソッド

解説

OpenGL コンテキスト設定

capture¶

メソッド

引数

引数	既定値	説明
`layer`	` `	結果格納先レイヤ
`callback`	` `	処理関数 function(width, height, param) このオブジェクトのコンテキストで実行されます
`param`	` `	追加パラメータ
`color`	` `	塗りつぶし色

解説

OpenGL描画処理実行

copyLayer¶

メソッド

引数

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`left`	` `	左位置
`top`	` `	上位置

解説

レイヤのコピー

drawLayer¶

メソッド

引数

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`a`	` `	アフィン変換行列 (2x2) の a 成分
`b`	` `	アフィン変換行列 (2x2) の b 成分
`c`	` `	アフィン変換行列 (2x2) の c 成分
`d`	` `	アフィン変換行列 (2x2) の d 成分
`tx`	` `	平行移動 X
`ty`	` `	平行移動 Y
`opacity`	` `	不透明度 0～255 (省略時 255)

解説

レイヤの描画

beginEffect¶

メソッド

解説

エフェクト捕捉の開始

以降の描画は中間フレームバッファ(透明クリア済み)へ行われる。対応する endEffect() を必ず呼ぶこと。

beginEffect() ～ endEffect() で囲んだ描画を中間バッファに捕捉し、画像加工コマンド列を GPU 上で適用してから直前の描画先へ合成する。 capture() のコールバック内で、モジュール(Live2D / drawLayer 等) の描画ごとに個別のエフェクトを掛けられる。ネスト可。

endEffect¶

メソッド

引数

引数	既定値	説明
`commands`	` `	加工コマンドの配列。各要素は辞書で cmd メンバに種別、残りのメンバにパラメータを持つ。下記「コマンド一覧」参照。
`opacity`	`255`	合成時の不透明度(0～255、省略時 255)。α に乗算される。 Live2D のように自前描画で opacity を解釈しないモジュールのレイヤ不透明度を反映するのに使う。加工不要なら commands に空配列を渡せば「捕捉して opacity 付きで合成するだけ」になる。

解説

エフェクト適用と合成

直前の beginEffect() 以降に描画された内容へ commands を順に適用し、現在の blendMode で直前の描画先へ合成する。

例) [ %[ cmd:"grayscale" ], %[ cmd:"gamma", value:1.2 ] ]

コマンド一覧

点処理 (連続すると 1 パスに融合される):

%[ cmd:"grayscale" ] — グレースケール化 Y=(19B+183G+54*R)>>8
%[ cmd:"gamma", value:r ] (全チャンネル一括) / %[ cmd:"gamma", rgamma:.., rfloor:.., rceil:.., ggamma:.., gfloor:.., gceil:.., bgamma:.., bfloor:.., bceil:.. ] (チャンネル別) — ガンマ補正 out = pow(in/255, 1/gamma)*(ceil-floor)+floor (本体 Layer.adjustGamma と同じ。floor 既定 0 / ceil 既定 255)
%[ cmd:"light", brightness:b, contrast:c ] — 明度 b(-255～255) / コントラスト c(-100～100)
%[ cmd:"lut", table:[ ...256要素... ] ] — 全チャンネル共通の 256 段ルックアップテーブル
%[ cmd:"colorize", hue:h, sat:s, blend:b ] — 色相 h(0～255) / 彩度 s(0～255) / 合成率 b(0～1)
%[ cmd:"modulate", hue:h, saturation:s, luminance:l ] — 色相 h(-180～180) / 彩度 s(-100～100) / 輝度 l(-100～100)
%[ cmd:"noise", level:n ] — ノイズ付加 n(0～255)
%[ cmd:"generateWhiteNoise" ] — グレースケールのホワイトノイズ生成 (α は保持)
%[ cmd:"overcolor", color:0xAARRGGBB, type:mode, opacity:o ] — 指定色での全体塗りつぶし合成 (吉里吉里 fillOperateRect 準拠)。 color の上位8bit(AA) と opacity(0～255,既定255) が合成αになる。 type は吉里吉里の合成モード値 (tTVPBlendOperationMode): 1=Opaque 2=Alpha(既定) 3=Additive 4=Subtractive 5=Multiplicative 8=Dodge 9=Darken 10=Lighten 11=Screen 12=AddAlpha 13=PsNormal 14=PsAdditive 15=PsSubtractive 16=PsMultiplicative 17=PsScreen 18=PsOverlay 19=PsHardLight 20=PsSoftLight 21=PsColorDodge 22=PsColorDodge5 23=PsColorBurn 24=PsLighten 25=PsDarken 26=PsDifference 27=PsDifference5 28=PsExclusion

近傍処理 (中間バッファを介して H/V 2 パス):

%[ cmd:"boxBlur", area:r, iter:n ] — 半径 r の一様ぼかしを n 回 (iter 既定 1)
%[ cmd:"gaussianBlur", radius:r ] — 半径 r のガウスぼかし

※ noise / blur の最外周 / colorize は CPU 版と完全一致ではなく視覚的同等。

setClipRect¶

メソッド

引数

引数	既定値	説明
`left`	` `	クリップ矩形の左端 (レイヤ座標、左上原点)
`top`	` `	クリップ矩形の上端 (レイヤ座標、左上原点)
`width`	` `	クリップ矩形の幅
`height`	` `	クリップ矩形の高さ

解説

矩形クリップの設定

以降の drawLayer / endEffect / endMaskClip の合成が矩形内に制限される。描画モジュールが scissor 状態を尊重する場合は直接描画にも効くが、確実にクリップしたい場合は beginMaskClip/endMaskClip で囲むこと。

クリッピングの方式 (AffineLayer の clip / clipImage 相当)

矩形クリップ: setClipRect / clearClipRect。scissor で実現。
画像クリップ (mask 方式): beginMaskClip() ～ endMaskClip() で囲んだ描画を中間バッファに捕捉し、マスク画像の α を乗算しながら直前の描画先へ合成する。マスク矩形の外側は α=0 (CPU 版 Layer.clipAlphaRect の第8引数 0 相当)。描画モジュール (Live2D 等) にも安全に使える。
画像クリップ (stencil 方式): beginStencilClip() ～ endStencilClip()。マスク α をステンシルに書き込み描画を切り抜く。α は閾値で2値化される。描画モジュールが自前でステンシルを使う場合は競合するため、 drawLayer による単純テクスチャ描画専用。

// 矩形クリップ (単純テクスチャ描画)
setClipRect(100, 100, 200, 150);
drawLayer(src, 1, 0, 0, 1, 0, 0);
clearClipRect();

// 画像クリップ mask 方式 (モジュール描画にも安全)
beginMaskClip();
drawLayer(src, 1, 0, 0, 1, 0, 0);   // または player.render() 等
endMaskClip(maskTexture, 100, 100);

// 画像クリップ stencil 方式 (drawLayer 専用)
beginStencilClip(maskTexture, 100, 100, 1);
drawLayer(src, 1, 0, 0, 1, 0, 0);
endStencilClip();

clearClipRect¶

メソッド

解説

矩形クリップの解除

beginMaskClip¶

メソッド

解説

マスククリップ捕捉の開始

以降の描画は中間フレームバッファ(透明クリア済み)へ行われる。対応する endMaskClip() を必ず呼ぶこと。beginEffect() とネスト可。

endMaskClip¶

メソッド

引数

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)。void なら素通し合成 (矩形クリップだけを合成時に確実に適用したい場合に使う)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)

解説

マスク適用合成

直前の beginMaskClip() 以降に描画された内容へマスク画像の α を乗算し、現在の blendMode で直前の描画先へ合成する。マスク矩形の外側は α=0 (完全クリップ)。

beginStencilClip¶

メソッド

引数

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)
`threshold`	` `	クリップを有効とする α 閾値 (1～255、省略不可)

解説

ステンシルクリップの開始

マスク画像の α が閾値以上の領域をステンシルへ書き込み、以降の drawLayer をその領域内に切り抜く。

endStencilClip¶

メソッド

解説

ステンシルクリップの終了

引数	既定値	説明
`layer`	` `	結果格納先レイヤ
`callback`	` `	処理関数 function(width, height, param) このオブジェクトのコンテキストで実行されます
`param`	` `	追加パラメータ
`color`	` `	塗りつぶし色

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`left`	` `	左位置
`top`	` `	上位置

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`a`	` `	アフィン変換行列 (2x2) の a 成分
`b`	` `	アフィン変換行列 (2x2) の b 成分
`c`	` `	アフィン変換行列 (2x2) の c 成分
`d`	` `	アフィン変換行列 (2x2) の d 成分
`tx`	` `	平行移動 X
`ty`	` `	平行移動 Y
`opacity`	` `	不透明度 0～255 (省略時 255)

引数	既定値	説明
`commands`	` `	加工コマンドの配列。各要素は辞書で cmd メンバに種別、残りのメンバにパラメータを持つ。下記「コマンド一覧」参照。
`opacity`	`255`	合成時の不透明度(0～255、省略時 255)。α に乗算される。 Live2D のように自前描画で opacity を解釈しないモジュールのレイヤ不透明度を反映するのに使う。加工不要なら commands に空配列を渡せば「捕捉して opacity 付きで合成するだけ」になる。

引数	既定値	説明
`left`	` `	クリップ矩形の左端 (レイヤ座標、左上原点)
`top`	` `	クリップ矩形の上端 (レイヤ座標、左上原点)
`width`	` `	クリップ矩形の幅
`height`	` `	クリップ矩形の高さ

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)。void なら素通し合成 (矩形クリップだけを合成時に確実に適用したい場合に使う)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)
`threshold`	` `	クリップを有効とする α 閾値 (1～255、省略不可)

引数	既定値	説明
`layer`	` `	結果格納先レイヤ
`callback`	` `	処理関数 function(width, height, param) このオブジェクトのコンテキストで実行されます
`param`	` `	追加パラメータ
`color`	` `	塗りつぶし色

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`left`	` `	左位置
`top`	` `	上位置

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`a`	` `	アフィン変換行列 (2x2) の a 成分
`b`	` `	アフィン変換行列 (2x2) の b 成分
`c`	` `	アフィン変換行列 (2x2) の c 成分
`d`	` `	アフィン変換行列 (2x2) の d 成分
`tx`	` `	平行移動 X
`ty`	` `	平行移動 Y
`opacity`	` `	不透明度 0～255 (省略時 255)

引数	既定値	説明
`commands`	` `	加工コマンドの配列。各要素は辞書で cmd メンバに種別、残りのメンバにパラメータを持つ。下記「コマンド一覧」参照。
`opacity`	`255`	合成時の不透明度(0～255、省略時 255)。α に乗算される。 Live2D のように自前描画で opacity を解釈しないモジュールのレイヤ不透明度を反映するのに使う。加工不要なら commands に空配列を渡せば「捕捉して opacity 付きで合成するだけ」になる。

引数	既定値	説明
`left`	` `	クリップ矩形の左端 (レイヤ座標、左上原点)
`top`	` `	クリップ矩形の上端 (レイヤ座標、左上原点)
`width`	` `	クリップ矩形の幅
`height`	` `	クリップ矩形の高さ

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)。void なら素通し合成 (矩形クリップだけを合成時に確実に適用したい場合に使う)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)
`threshold`	` `	クリップを有効とする α 閾値 (1～255、省略不可)

GLESAdaptor¶

メンバー一覧¶

コンストラクタ¶

プロパティ¶

メソッド¶

GLESAdaptor¶

screenWidth¶

screenHeight¶

blendMode¶

setScreenSize¶

makeCurrent¶

capture¶

copyLayer¶

drawLayer¶

beginEffect¶

endEffect¶

setClipRect¶

clearClipRect¶

beginMaskClip¶

endMaskClip¶

beginStencilClip¶

endStencilClip¶

引数	既定値	説明
`layer`	` `	結果格納先レイヤ
`callback`	` `	処理関数 function(width, height, param) このオブジェクトのコンテキストで実行されます
`param`	` `	追加パラメータ
`color`	` `	塗りつぶし色

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`left`	` `	左位置
`top`	` `	上位置

引数	既定値	説明
`layer`	` `	レイヤまたは GLESTexture
`a`	` `	アフィン変換行列 (2x2) の a 成分
`b`	` `	アフィン変換行列 (2x2) の b 成分
`c`	` `	アフィン変換行列 (2x2) の c 成分
`d`	` `	アフィン変換行列 (2x2) の d 成分
`tx`	` `	平行移動 X
`ty`	` `	平行移動 Y
`opacity`	` `	不透明度 0～255 (省略時 255)

引数	既定値	説明
`commands`	` `	加工コマンドの配列。各要素は辞書で cmd メンバに種別、残りのメンバにパラメータを持つ。下記「コマンド一覧」参照。
`opacity`	`255`	合成時の不透明度(0～255、省略時 255)。α に乗算される。 Live2D のように自前描画で opacity を解釈しないモジュールのレイヤ不透明度を反映するのに使う。加工不要なら commands に空配列を渡せば「捕捉して opacity 付きで合成するだけ」になる。

引数	既定値	説明
`left`	` `	クリップ矩形の左端 (レイヤ座標、左上原点)
`top`	` `	クリップ矩形の上端 (レイヤ座標、左上原点)
`width`	` `	クリップ矩形の幅
`height`	` `	クリップ矩形の高さ

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)。void なら素通し合成 (矩形クリップだけを合成時に確実に適用したい場合に使う)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)

引数	既定値	説明
`mask`	` `	マスク画像 (GLESTexture または Layer)
`x`	` `	マスク配置位置 X (レイヤ座標)
`y`	` `	マスク配置位置 Y (レイヤ座標)
`threshold`	` `	クリップを有効とする α 閾値 (1～255、省略不可)