[unity]TextMeshPro でルビを表示する

TextMeshPro は多彩な表現を可能にしてくれるテキスト UI ですが、ルビ！　日本のおもてなし！　にはさすがに対応してくれません。

でも、なんとかしたいのでなんとかすることにしましょう。

自動的に読み仮名を振ってくれるわけではありません。

入力フォーマット

入力時のフォーマットを決めます。タグとかぶらないよう、{} を使うことにしました。
ルビは１文字に対してとは限らず、漢字３文字にたいしてルビ文字５つ……といった場合も考慮できるフォーマットにします。

この<color=red>{数:かず}</color>は、{一般的:いっぱんてき}に「{ナ:na}{ノ:no}」という{単位:たんい}{接頭辞:せっとうじ}を{使用:しよう}して{表:あらわ}されます。

さりげなく文字にカラータグ入れてるのは、当然ルビも同じ色になるんだよなぁ？？　という状況にも対応するため入れておきました。

コードの書き方については Sample.cs をご覧ください。

理屈は単純で、「テキスト文字の表示された座標の上に、ルビのテキストフィールドを配置する」だけです。
が、表示サイズ変更したり、１文字ずつ表示するならどのタイミングでルビの表示を行うかなど、そこそこ考える必要のある案件です。

詳しくはコード（Sample.cs, RubyText.cs）に譲るとして、ここではいくつか特徴や苦労話を語ります。

文章にルビやタグが入っているので、単純に文字数をカウントするだけでは上手くいきません。
当初適当に実装してたら、思ったより面倒の種になったので、見直しました。

TextMeshPro のいいところの１つに「指定された枠に収まるよう、自動的にフォントサイズを調整する（AutoSize）」というものがあります。

ただこれ、１フレーム描画した後でないとフォントサイズが確定しないようなので、ルビのサイズも当然１フレーム待った後のサイズで算出する必要があります。

また GetTextInfo().characterInfo で取得できる情報は「現在表示している文字のみ」です。
１文字ずつ表示しよう……という場合、AutoSize オンだと１文字表示するごとに文字が小さくなるなど動きとして不自然になってしまいます。そのため、

という少しまだるっこしい処理をこっそり行っています。
このため、絶えず 1/60 で文章を切り替えたい、亜高速スキップ可能ゲームには向いていないと思います（ないと思いますが）。

ゲームの場合、大抵はフォント固定サイズにし、収まらない文章は削るなどテキスト側で調整することが多いので、正直ここまで対応する必要はないかもしれません。

ルビの字幅、間隔は品質に関わってくる部分なので、なるべく自然に見えるようにしました。

とはいえ、ルビワード（漢字）が行をまたいで表示されるなど、どうしようもないケースもあります。

例えばこのようなケースです。（たんい）が（たん）と（い）に分かれることをプログラムでは把握できないので、最初の文字に（たんい）と表示しています。
どうしても自然に見せる必要があれば {単位:たんい} を {単:たん}{位:い} にするなどコンテンツ側で調整してください。

IsDrawAtOnce に✓を入れると一度に全体表示、✓を外すと１文字ずつ表示されます。速度は AutoForwardSpeed で調整します。
いずれの場合も StartAutoForward() が呼ばれてから描画を開始します。

一応 RectSize(W, H) と Wrapping は監視しているので動的に値が変わっても動作しますが、私が軽くチェックしただけですので、自信はありません☺

文章ごとにルビ用の TextMeshPro を作成すると地味に速度ロスとなりそうなので、使われたルビバッファはキャッシュし、次以降の文章にも使われるようになっています。

バッファは足りなくなった時だけ拡張します。拡張した分は次以降にも残すので、１文章だけビックリするくらいルビ数が……といったケースではメモリロスとなります。ご留意ください。

現実的に考えて、ルビなんていいとこ１文章に 20 もないと思う！