http://w.atwiki.jp/aegisub/ aegisub karaoke template @ ウィキ ja 2016-04-15T23:19:50+09:00 1460729990 https://w.atwiki.jp/aegisub/pages/14.html **template クラス テンプレートには３つのクラスがあります lineクラス、sylクラス、furiクラス　（pre-lineはlineクラス、charはsylクラスに属します） テンプレートは現れる順序に関わらす、lineクラス、sylクラス、furiクラスの順で実行されます。 同じクラスのテンプレートは現れた順に実行されます。 テンプレートが適用されるとカラオケ行の\kタグはfx行に出力されません。(keeptagsを使用しても出力されません) sylクラス、furiクラスのテンプレートではカラオケ行が音節や文字単位に分割して出力されるためカラオケ行内の改行\Nタグは機能しません。 lineクラス(lineとpre-line)のテンプレートは名前を付けることができます。同じ名前のテンプレートはそれら全体で１つのfx行を出力します。 **template syl 音節単位でエフェクトをかける場合に適したテンプレートです。 カラオケ行を\kタグで区切られた音節単位に分割してfx行を出力します。 各音節のテキストの前に式を評価したテンプレートのtext欄の内容を追加します。 音節単位に分割して出力されるため、\pos（または\move）タグを使う必要があります。 **template char 文字単位でエフェクトをかける場合に適したテンプレートです カラオケ行を文字単位に分割してfx行を出力します。 各文字の前に式を評価したテンプレートのtext欄の内容を追加します。 文字単位に分割して出力されるため、\pos（または\move）タグを使う必要があります。 **template furi ルビ付きのカラオケ行を\kタグで区切られた音節単位に分割してfx行を出力します。 各音節（ルビ）の前に式を評価したテンプレートのtext欄の内容を追加します。 音節単位に分割して出力されるため、\pos（または\move）タグを使う必要があります。 template syl furiとすると１つのテンプレートでメインテキストとルビを１度に出力することができます。 **template line カラオケ行の分割はされません。 各音節のテキスト前に式を評価したテンプレートのtext欄の内容を追加します。 **template pre-line カラオケ行の分割はされません。 行の先頭に式を評価したテンプレートのtext欄の内容が追加されます。 pre-lineテンプレートではnotextは機能しません。 **名前付きテンプレート lineとpre-lineテンプレートには名前を付けることができます。 2016-04-15T23:19:50+09:00 1460729990 https://w.atwiki.jp/aegisub/pages/15.html **テンプレート実行環境 karaoke templateが実行されるとユーザーコード（あなたが書いたコード）の為のテンプレート実行環境がつくられます。 karaoke template自身はグローバルな実行環境で動いています。 テンプレート実行環境はkaraoke templateの実行を妨げないようにグローバルな実行環境とは切り離されています。 実行環境というと小難しそうですが、簡単に言ってしまうと&big(){&color(red){「どんな変数が使えるのか使えないのか」}}ということです。 テンプレート実行環境にはユーザーが定義した変数を追加することができます。 また、テンプレート実行環境には現在処理中の行や音節に関する幾つかの既定変数があらかじめ含まれています。 これらの既定変数はLuaのテーブルフィールドの形で提供されます ユーザー定義変数や既定変数はコード行とテンプレート行のコードブロックの内部で使用できます。 **既定変数の３つのクラス -&aname(meta,option=nolink){meta情報} >meta.から始まる変数 >ass字幕ファイルのヘッダー部分script Infoの情報です。 >&color(red){meta.res_x} 再生時のＸ解像度 >&color(red){meta.res_y}　再生時のＹ解像度 この他にももうちょっとあるけど、この２つ以外はあんまり使うことない^^; 詳しくは[[ここ>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#karaskelcollecthead]]を参照 -&aname(line,option=nolink){line情報} >line.から始まる変数 >現在処理中の行の位置、時間、textに関する情報 >&color(red){line.duraiton} 行の長さ（時間的） >&color(red){line.start_time}行の開始時刻、 &color(red){line.end_time}行お終了時刻　 >&color(red){line.left}行の左端の位置、 &color(red){line.center}行の中央の位置、 &color(red){line.right}行の右端の位置 >&color(red){line.top}行の上端の位置、&color(red){line.middle}行の垂直の中央の位置、&color(red){line.bottom}行の下端の位置、&color(red){line.vcenter}line.middleの別名、&color(red){line.hcenter}line,centerの別名 >&color(red){line.width}行の幅、&color(red){line.height}行の高さ >&color(red){line.text_stripped}　タグを除いた行のテキスト >&color(red){line.kara}　行に含まれる音節の情報 >&color(red){line.furi}　行に含まれるふりがなの情報 >&color(red){line.styleref}　行のスタイルを表している[[スタイルテーブル>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#style-table]]への参照 >&color(red){line.furistyle} 行のフリガナスタイルを表している[[スタイルテーブル>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#style-table]]への参照 >&color(red){line.descent} アルファベット小文字の下に突き抜けた部分の深さ >&color(red){line.extlead}　行間のすき間 >&color(red){line.margin_v},&color(red){line.margin_t}　各行で個別に指定した垂直マージン、ＶはＴのエイリアス >&color(red){line.eff_margin_l}, &color(red){line.eff_margin_r}, &color(red){line.eff_margin_t}, &color(red){line.eff_margin_b} >&color(red){line.eff_margin_v}　左、右、上、下、垂直の有効マージン（各行で個別指定したマージンが０の場合はスタイルのマージンが有効、その他は個別指定マージンが有効） >&color(red){line.halign}　行の水平方向のアラインメント >&color(red){line.valign}　行の垂直方向のアラインメント >&color(red){line.x}、&color(red){line.y}行のＸとＹの位置。アラインメントがオーバーライドされない場合の\posタグでの使用に適する >&color(red){line.class} == "dialogue" >&color(red){line.raw} 未加工の生テキスト >&color(red){line.section} 通常は "[Events]". >&color(red){line.comment} 論理値, コメント行なら真(true) >&color(red){line.effect} 行のEffect欄 >&color(red){line.userdata} 未使用 >&color(red){line.text}　行のタグを含むテキスト >&color(red){line.style}　行のスタイル名 詳しくは[[ここ>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#dialogue-line-table]]を参照 -&aname(syl,option=nolink){syl情報} >syl.から始まる変数 >現在処理中の音節に関する位置、時間、textに関する情報 >&color(red){syl.duration}　音節の長さ（時間的） >&color(red){syl.start_time}音節の開始、 &color(red){syl_end_time}音節の終了時間　（行の開始時刻からの相対値） >&color(red){syl.left}音節の左端、 &color(red){syl.center}中央、 &color(red){syl.right}右端、 &color(red){syl.width}音節の幅（行の左端からの相対値） >&color(red){syl.text_stripped}　タグを除いた音節のテキスト >&color(red){syl.tag} - 音節で定義されたタグ名. 通常はk、K、kf、koの中の一つ. >&color(red){syl.text} - タグを含む音節のテキスト >&color(red){syl.kdur} - 音節の長さ。単位はセンチ秒。\kでの使用に適する >&color(red){syl.line} - 音節の属する行情報へのバックリファレンス >&color(red){syl.inline_fx} - 音節のinline-fx名 >&color(red){syl.i} - 音節のインデックス >&color(red){syl.prespace}, &color(red){syl.postspace} - 音節の前、後のスペース文字。　フリガナについては常に空白。 syl.text_strippedにはスペースが含まれる。 >&color(red){syl.text_spacestripped} - 音節からタグと前後のスペース文字を除いたテキスト。これに syl.prespaceとsyl.postspaceを加えるとsyl.text_strippedになる。 >&color(red){syl.isfuri} - sylがフリガナテーブルの場合は真(true)、そうでなければ偽(false) １つのテンプレートでメインテキストとフリガナの両方を処理する場合これによって処理を振り分けることができる。 >&color(red){syl.highlights} - 音節のマルチハイライト配列。フリガナについてはハイライトは常に１度だけ。 >&color(red){syl.style} - 行のスタイルを表している[[スタイルテーブル>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#style-table]]への参照。 通常のテキストの場合はメインスタイルを、フリガナの場合はフリガナスタイルを示す。 >&color(red){syl.height} - スペース文字を除いた音節の幅と高さ。 >&color(red){syl.prespacewidth}, >&color(red){syl.postspacewidth} - syl.prespaceの幅、 syl.postspaceの幅。フリガナについては常に0. 詳しくは[[ここ>http://docs.aegisub.org/3.2/Automation/Lua/Modules/karaskel.lua/#karaoke-and-furigana-syllable-tables]]を参照 **テンプレートの実行順序と変数の有効性 変数はユーザー変数も既定変数もテンプレート実行環境に存在しないと参照することはできません。 テンプレート行やコード行はそれらが現れる順序とは関係なくonce、line、sylクラスの順で実行されます。 onceクラスはカラオケ行の処理が始まる以前に実行されます。なのでcode onceのコード行でline情報やsyl情報の変数を参照することができません。 code once実行時にはテンプレート実行環境にline情報やsyl情報の変数が存在しないからです。 カラオケ行の行処理が始まると、まずline情報の変数がテンプレート実行環境にセットされます。その後lineクラスのコード行やテンプレート行が実行されますのでlineクラスのコード行やテンプレート行ではline情報の変数が参照できます。 行処理の後はその行内の音節処理が始まります。音節処理ではsyl情報の変数がテンプレート実行環境にセットされます。その後sylクラスのコード行やテンプレート行が実行されますのでsylクラスのテンプレート行やコード行ではline情報とsyl情報の変数が参照できます。 次のカラオケ行の処理に移るまえに既存のline情報やsyl情報の変数は一旦リセット(nil化)されます。 |処理の流れ|対象クラス|テンプレート実行環境| |onceクラスのテンプレート実行|code once|| |カラオケ行の処理開始||| |行処理開始||| |code 行なら||| |line情報のセット|code line|&aname(line){line情報}| |code lineの実行||&aname(line){line情報}| |template行なら||| |line情報のセット||&aname(line){line情報}| |pre-line行なら|template pre-line|&aname(line){line情報}| |template pre-lineの実行||&aname(line){line情報}| |line行なら||&aname(line){line情報}| |syl情報のセット|template line|&aname(syl){syl情報}、&aname(line){line情報}| |template lineの実行||&aname(syl){syl情報}、&aname(line){line情報}| |音節処理開始||&aname(line){line情報}| |syl情報のセット|code syl,&br()template syl|&aname(syl){syl情報}、&aname(line){line情報}| |sylクラスのテンプレート実行||&aname(syl){syl情報}、&aname(line){line情報}| |line情報,syl情報のリセット||| meta情報はいつでも使えます。 関数については、関数内のコードはその関数が呼ばれたときに初めて実行されるので、どこで関数を定義するかは重要ではありません。 （通常関数定義はcode onceで行います） その関数がどこから呼ばれるかによって関数内で使える変数が決まります。 例えば、template sylから呼ばれる関数はmeta,line,syl情報の全てが使えますが、template pre-lineから呼ばれる関数はsyl情報は使えません。上の表をご覧になればわかるようにtemplate pre-line実行時にはsyl情報がテンプレート実行環境にないからです。 ユーザー定義変数はそれが実行された以降はずっと存在し、処理が次のカラオケ行に移行するときにもリセットされません。 ここまでを超簡単にまとめると&big()&color(red){「code onceではmeta情報以外使えない。template pre-lineではsyl情報は使えない。」} **グローバル実行環境へのアクセス 最初にテンプレートの実行環境とkaraoke template自身の実行環境は分離されていると書きました。 テンプレート実行環境ではmath, string以外のLuaの標準ライブラリーが使えなかったり、その他のAegisubが提供する関数がつかえなかったりと制限があります。 _G.を使うとこれらのライブラリ関数やAegisubのその他の関数にアクセスすることができるようになります。 例えば、Luaの標準ライブラリのtable関数にアクセスする場合_G.table.sortなどのようにします。 -Style情報 karaoke templateではstyle情報に直接アクセスすることはできません。 line.stylerefを通じてアクセスすることができます。 例えば、style.color1にアクセスするにはline.styleref.color1またはsyl.style.color1のようにします。 >&color(red){style.margin_v} は&color(red){style.margin_tの別名。 >&color(red){style.class} == "style" >&color(red){style.raw} - スタイルの未加工の生テキスト。 >&color(red){style.section} == "[V4+ Styles]" >&color(red){style.name} - スタイル名。 >&color(red){style.fontname} - スタイルで定義されたフォント名。 >&color(red){style.fontsize} - スタイルで定義されたフォントのサイズ。 >&color(red){style.color1}、 &color(red){style.color2}、 &color(red){style.color3}、 &color(red){style.color4} -プライマリ、セカンダリ、ボーダー（アウトライン）、シャドウの色。セカンダリ色は\kタグを使用した場合の変化前の色。プライマリ色は変化後の色。\kタグを使用しない場合はプライマリ色が文字の本体色。&HAA&color(blue){BB}&color(green){GG}&color(red){RR}& >&color(red){style.bold} - 論理値。フォントの太字のオン/オフ。オンならば真(true)オフならば偽(false)。数値を指定することもできるがサポートされない場合が多くその場合は無効。 >&color(red){style.italic} - 論理値。フォントの斜体のオン/オフ。オンならば真(true)オフならば偽(false)。 >&color(red){style.underline}、&color(red){style.strikeout} - 論理値。フォントのアンダーラインのオン/オフ。オンならば真(true)オフならば偽(false)。 >&color(red){style.scale_x}、&color(red){style.scale_y} - Ｘ、Ｙ方向のスケール。100がデフォルトで拡大も縮小もない状態。 >&color(red){style.spacing} -テキストの文字間のピクセル単位の追加スペース。 >&color(red){style.angle} - テキストのZ軸回転。 >&color(red){style.borderstyle} - 1 は通常のアウトライン, 3はレターボックスタイプのアウトライン。 >&color(red){style.outline} - テキストのアウトライン（周りの縁）の幅 >&color(red){style.shadow} - テキストのシャドウ（影）のテキストからの距離（影の太さではない） >&color(red){style.align} - スクリーン上のテキストのテンキースタイルの配置。 >&color(red){style.margin_l}、>&color(red){style.margin_r}、>&color(red){style.margin_t}、&color(red){style.margin_b} 左端、右端、上方、下方のスタイルで定義されたマージン。>&color(red){style. style.margin_v}は上方マージンの別名。 >&color(red){style.encoding} - WindowsフォントエンコードID。 **inline変数($変数) テンプレートでは上記の変数とは別に＄変数が使えます。上記の変数はLua言語における変数なので多少プログラミングの知識が必要になりますが、＄変数はプログラミングの経験のない人でも簡単に使えるようにできています。 -＄変数とは ＄で始まる変数です。 $center,$middle,$durなどです。 ＄変数はテンプレート行のみで使うことができます。（コード行では使えませんが、テンプレート行のコードブロック内では使えます。） ＄変数はテンプレート行であればどこにでも置くことができます。 コードブロックのなかや文字列の中に置くこともできます。 ***行変数 >&color(red){$layer} 行のレイヤー >&color(red){$lstart}, &color(red){$lend}, &color(red){$ldur}, &color(red){$lmid} 行の開始時刻, 終了時刻, 長さ、中間時刻, 全て絶対値で単位はミリ秒 >&color(red){$style} 行のスタイル名 >&color(red){$actor} 行のアクター名 >&color(red){$margin_l}, &color(red){$margin_r} 有効な左、右マージン (マージンの設定はスタイルの設定値と各行に個別に設定する値があります。各行で設定する値が０以外の場合は個別行の値が有効、それ以外の場合はスタイルの設定値が有効) >&color(red){$margin_v}, &color(red){$margin_t}, &color(red){$margin_b} 有効な垂直マージン, 上方マージン、下方マージン, 垂直マージンと上方マージンは同じ >&color(red){$syln} 行に含まれる音節の数 >&color(red){$li} 行のインデックス (ファイル上の物理的順序なので最初の字幕行が１とはならない) >&color(red){$lleft}, &color(red){$lcenter}, &color(red){$lright} 行の左端の位置、 水平の中央の位置、右端の位置、整数に丸められる >&color(red){$ltop}, &color(red){$lmiddle}, &color(red){$lbottom} 行の上端の位置, 垂直の中央の位置、 下端の位置、整数に丸められる >&color(red){$lx}, &color(red){$ly} 行のＸとＹの位置。アラインメントがオーバーライドされない場合の\posタグでの使用に適する >&color(red){$lwidth}, &color(red){$lheight} ピクセル単位での行の幅と高さ、丸め誤差を含むためポジション変数とは正確に一致しない場合がある ***音節変数 >&color(red){$sstart}, &color(red){$send}, &color(red){$smid} 音節の開始、終了、中間時間。行の開始時刻との相対値。\tや\moveタグとの使用に適する。 >&color(red){$sdur}, &color(red){$skdur} 音節の長さ。ミリ秒とセンチ秒。 >&color(red){$si} 行の先頭からの音節のインデックス。 >&color(red){$sleft}, &color(red){$scenter}, &color(red){$sright} スクリーンの左端からの音節の左端、水平の中央、右端の絶対値。\posや\moveタグとの使用に適する。 >&color(red){$sbottom}, &color(red){4smiddle}, &color(red){$stop} スクリーンの上端からの音節の下端、垂直の中央、上橋の絶対値。\posや\moveタグとの使用に適する。 >&color(red){$sx}, &color(red){$sy} デフォルトアラインメントにおける音節のＸ，Ｙ絶対位置。\anタグでアラインメントをオーバーライドしない場合の\posや\moveタグとの使用に適する。 >&color(red){$swidth}, &color(red){$sheight} 音節の幅と高さ。最大0.5ピクセルの誤差を含む。 ***自動変数 $変数には行変数と音節変数の両方を表すことのできる自動変数があります。これの自動変数はそれがどのタイプのテンプレートで使用されるかによって音節変数を表したり、行変数を表したりします。pre-line テンプレートでは自動変数は行変数を表し、その他のテンプレートでは音節変数を表します。 >&color(red){$start}, &color(red){$end}, &color(red){$mid} 行/音節の開始、終了、中間時間。行の場合は絶対値、音節の場合は相対値。 >&color(red){$dur}, &color(red){$kdur} 行/音節の長さ（時間的）。\durはミリ秒\kdurはセンチ秒。 >&color(red){$i} 行/音節のインデックス。 >&color(red){$left}, &color(red){$center}, &color(red){$right} 行/音節の左、中央、右のスクリーン上の絶対座標。 >&color(red){$top}, &color(red){$middle}, &color(red){$bottom} 行/音節の上端、下端のスクリーン上の絶対座標。 >&color(red){$x}, &color(red){$y} x and y position of line/syllable when using default alignment >&color(red){$width}, &color(red){$height} width and height of line/syllable in pixels, this is rounded and might not match exactly with the positioning variables 2016-04-15T20:22:17+09:00 1460719337 https://w.atwiki.jp/aegisub/pages/2.html **メニュー -[[トップページ]] -[[メニュー]] ---- -[[karaoke templateの書き方]] -[[templateの種類]] -[[変数について]] ---- **リンク -[[@wiki>>http://atwiki.jp]] -[[@wikiご利用ガイド>>http://atwiki.jp/guide/]] // リンクを張るには "[" 2つで文字列を括ります。 // ">" の左側に文字、右側にURLを記述するとリンクになります //**更新履歴 //#recent(20) &link_editmenu(text=ここを編集) 2016-04-02T16:00:27+09:00 1459580427 https://w.atwiki.jp/aegisub/pages/13.html &ref(template1.png) 図のようにコメントにチェックを入れeffect欄にtemplateと入力する。 (単にtemplateとした場合はtemplate sylとして扱われま) 2016-03-27T23:34:09+09:00 1459089249 https://w.atwiki.jp/aegisub/pages/1.html **@wikiへようこそ -ウィキはみんなで気軽にホームページ編集できるツールです。 -このページは自由に編集することができます。 -メールで送られてきたパスワードを用いてログインすることで、各種変更（サイト名、トップページ、メンバー管理、サイドページ、デザイン、ページ管理、等）することができます **まずはこちらをご覧ください。 -[[@wikiの基本操作>>http://www1.atwiki.jp/guide/pages/11.html]] -[[編集モード・構文一覧表>>http://www1.atwiki.jp/guide/pages/137.html]] -[[@wikiの設定・管理>>http://www1.atwiki.jp/guide/pages/36.html]] **分からないことは？ -[[@wiki ご利用ガイド>>http://atwiki.jp/guide/]] -[[よくある質問>>http://www1.atwiki.jp/guide/pages/21.html]] -[[@wiki更新情報>>http://www1.atwiki.jp/guide/pages/143.html]] -[[@wikiへのお問合せフォーム>>http://atwiki.jp/helpdesk]] 等をご活用ください **[[アットウィキモードでの編集方法>>http://www1.atwiki.jp/guide/pages/226.html#id_6861418f]] -[[文字入力>>http://www1.atwiki.jp/guide/pages/228.html]] -[[画像入力>>http://www1.atwiki.jp/guide/pages/230.html]] -[[表組み>>http://www1.atwiki.jp/guide/pages/914.html]] **[[ワープロモードでの編集方法>>http://www1.atwiki.jp/guide/pages/226.html#id_a14c0938]] -[[文字入力>>http://www1.atwiki.jp/guide/pages/2644.html]] -[[画像入力>>http://www1.atwiki.jp/guide/pages/2645.html]] -[[表組み>>http://www1.atwiki.jp/guide/pages/2646.html]] **その他にもいろいろな機能満載！！ -[[@wikiプラグイン一覧>>http://www1.atwiki.jp/guide/pages/264.html]] -[[@wikiかんたんプラグイン入力サポート>>http://www1.atwiki.jp/guide/pages/648.html]] **バグ・不具合を見つけたら？ 要望がある場合は？ お手数ですが、[[お問合せフォーム>>http://atwiki.jp/helpdesk]]からご連絡ください。 2016-03-27T16:50:29+09:00 1459065029 https://w.atwiki.jp/aegisub/pages/3.html **更新履歴 #recent(20) &link_editmenu2(text=ここを編集) 2016-03-27T16:50:29+09:00 1459065029 https://w.atwiki.jp/aegisub/pages/4.html * ニュース @wikiのwikiモードでは #news(興味のある単語) と入力することで、あるキーワードに関連するニュース一覧を表示することができます 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/266.html#id_542badf7 ----- たとえば、#news(ゲーム)と入力すると以下のように表示されます。 #news(ゲーム) 2016-03-27T16:50:29+09:00 1459065029 https://w.atwiki.jp/aegisub/pages/5.html * 更新履歴 @wikiのwikiモードでは #recent(数字) と入力することで、wikiのページ更新履歴を表示することができます。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/269.html#id_bf9eaeba ----- たとえば、#recent(20)と入力すると以下のように表示されます。 #recent(20) 2016-03-27T16:50:29+09:00 1459065029 https://w.atwiki.jp/aegisub/pages/6.html * アーカイブ @wikiのwikiモードでは #archive_log() と入力することで、特定のウェブページを保存しておくことができます。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/921.html#id_2d967d6e ----- たとえば、#archive_log()と入力すると以下のように表示されます。 保存したいURLとサイト名を入力して"アーカイブログ"をクリックしてみよう #archive_log() 2016-03-27T16:50:29+09:00 1459065029 https://w.atwiki.jp/aegisub/pages/7.html *RSSを取り込んで一覧表示(rss) #rss(ここにＲＳＳのＵＲＬ) もしくは #rss(ここにＲＳＳのＵＲＬを入力) と入力することで指定したＲＳＳを取り込んで一覧表示します。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/269.html#id_a0e79757 ---- たとえば、#rss(http://www1.atwiki.jp/guide/rss10_new.xml) と入力すると以下のように表示されます。 #rss(http://www1.atwiki.jp/guide/rss10_new.xml) 2016-03-27T16:50:29+09:00 1459065029