Typstの重要な目的の一つは「LaTeXのよりよい代替となること」です。そして、皆さんご存知の通り¹、LaTeXといえばゆきだるまです。となると、Typstでもができることが求められるのは当然の帰結でしょう²。

というわけで、本記事では「好きな色のマフラーを付けたゆきだるまを出力する」ことに関して、とりとめなく話したいと思います

TeXのConfの話の話

いきなり“Typst以外”の話で恐縮ですが、先月末（2024年11月30日）に富山において「TeXConf 2024」³が開催されました。その最後を飾ったのが鹿野桂一郎氏による「文字の一部に色を塗る」と題した講演です。

文字の一部に色を塗る（GitHub／k16shikano）

この講演では「単一の文字を複数の色に塗り分けて出力する」というタスクについて種々の文書作成ソフトウェア上での実現方法について述べています。具体的には2種類の実装方針を紹介しています。


グリフパスのクリップを利用する方法（PostScriptでの実装）


TikZ上で実現する方法（LaTeX＋TikZでの実装）

腕に覚えのあるTypstユーザの皆さんは、Typst上で「文字の一部に色を塗る」ことに挑戦してみるのもいいでしょう

それに続いて「ゆきだるまの字形☃のマフラーに色を付ける」という発展的な課題について話していたようです⁴。


のマフラーに色を塗る

具体的には「任意に与えられた☃の字形について、前処理を許容した上で、マフラー部分の領域を自動的に取得して別の色を塗る」という問題を扱っています。前処理を行えるのでグリフパスの取得が可能ですが、☃の字形中でマフラーの部分が他から独立しているわけでなく、そもそもどの部分がマフラーであるのか事前には判らないため、話は簡単ではありません。講演では機械学習を利用したアプローチを紹介しています。

鹿野氏の講演はとても面白い話なのですが、でも本記事の話題はこの講演の話とは直接は関係ありません。ただ「ゆきだるまのマフラーに色を付ける」というところだけが関係しています。

のConfの話の話

Typstの動向を早くから注視していた人であれば、「のマフラーに色を付ける」と聞いてsc1Typstのことを思い出したかもしれません。

昨年（2023年）の11月11日（1が4つ並ぶきりたんぽの日です）に某ツイッタァー（現𝕏）において「ﾅﾝﾄｶConf 2023」⁵が開催されました。その最後⁶を飾ったのが某ZR氏による「アレをもっともっと画期的にする話」と題した講演です。

アレをもっともっと画期的にする話（GitHub／zr-tex8r）

その講演において「」と「1」にちなんで紹介されたのが「1を入力してのマフラーに色を付ける」ための画期的なTypstモジュールであるsc1Typstです。

sc1Typst ― もっともっと画期的なTypst用文書テンプレート（Gist／zr-tex8r）

sc1Typstを利用したTypst文書では多数の「1」を入力すること文書ソースを作成します。

#import "sc1typst.typ":*; #show:_1
1
1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111
11111111111111111111111111111111111

この文書ファイルを通常の手順でTypstでコンパイルすると、マフラーに色がついたが出力されます。実は、このマフラーの色は先ほどのソース中に書いた「1」の数から決まるようになっています。


出力結果

ところで、この出力中のは（鹿野氏のスライドのものと同じ外見であることから判るように）フォントの字形です。つまり、「ゆきだるまの字形☃のマフラーに色を付ける」ネタに関しては、Typstの方がLaTeXよりも1年も先行していたことになります。やっぱり時代はTypstですね_（えっ）

ただし、sc1Typstが使うフォントは固定（原ノ味明朝⁷）なので「予め抽出したグリフパスのデータを実装コードに直書きする」ことができます。なのでこの辺りについて技術的に面白い点はありません

時代の話は措いておきましょう。世の中には「ゆきだるまの字形☃のマフラーに色を付ける」機能はぜひとも欲しいが一方で「『1』を並べて入力する」方式は全く不要という人もいるでしょう。そういう人にとっては「1」を並べる方式のsc1Typstは向いていないでしょう。

とはいってもsc1Typstの実装コードの中には「マフラーに色を付ける」処理が書かれているはずで、そこだけを抽出して新しいモジュールを作ればよさそうです。何といっても、Typstのスクリプト言語はTeX言語と違ってとても読みやすいことで有名です。早速sc1Typstの実装コードを眺めてみましょう


（某ZR氏のスライドより抜粋）

11月11日のネタ用のコードであるためか、チョット読みにくいですね……（ざんねん）

（以上で長い長い長い前フリ終わり）

フツーのTypstモジュールの話

というわけで、「ゆきだるまの字形☃のマフラーに色を付ける」ための読みにくくないTypstモジュールをつくりました

scmuffler ― ゆきだるま☃のマフラーに色を付ける（Gist/zr-tex8r）

一応パッケージ(package)の形にしてあるので、ローカルでインストールすればパッケージとして読み込めます。

// ローカルインストールしてパッケージとして読み込む場合
#import "@local/scmuffler:0.2.0": *

ですが、単純にscmuffler.typのファイルをカレントディレクトリに配置してモジュールとして読み込むのでもいいでしょう。

// カレントに置いてモジュールとして読み込む場合
#import "scmuffler.typ": *

sc1Typstと同様に「原ノ味明朝」フォントをTypstで利用可能な状態にしておく必要があります。（一番手っ取り早い方法はフォントをOSにインストールすることです。）

おやくそく

この節に挙げる例では和文用の最低限のレイアウト設定として次のモジュールを使用します。

layout.typ

// 和文用の最低限のレイアウト設定
#let doc(body) = {
  set page(paper: "a5")
  set text(
    lang: "ja",
    font: "Harano Aji Mincho", // 全面的に"原ノ味明朝"を使う
    top-edge: 0.88em,
  )
  body
}

キホン的な使い方

scmufflerパッケージは次の関数を提供します。

scmuffler(«色»)［content値］：マフラーの部分を«色»（color値）で指定した色に変えて（原ノ味明朝の）“☃”の文字(U+2603)を出力する。

例えば次のような文書ソースを用意します。

example-1.typ

#import "layout.typ": *
#show: doc // おやくそく
// モジュール読込
#import "scmuffler.typ": *

// "scmuffler(olive)"でolive色のマフラーの☃を出力
私は#scmuffler(olive)よりも#scmuffler(red)の方が好きです。

これをコンパイルすると、以下の出力が得られます。


出力結果

素敵

マフラーの色を少しずつ変えていく

これ以降はプログラミングを利用します

Typstのcolor.mapモジュールで提供される“turbo”のカラーマップの配色を利用してマフラーの色をグラデーションにしましょう。

sample-2.typ

#import "layout.typ": *
#show: doc
#import "scmuffler.typ": *

// カラーマップからgradient値を作る
#let turbo = gradient.linear(..color.map.turbo)
// "sample()"で色を抽出できる
#for k in range(21) {
  scmuffler(turbo.sample(k / 20.0 * 100%).darken(25%))
}


出力結果

素敵

箇条書きの番号を色付きマフラーの☃にする

muffler-numbering(«色»,…)［function値］：色付きマフラーの☃を利用したカウンタ書式関数を生成する。マフラーの色は引数に指定したcolor値が順番に使われる。

example-3.typ

#import "layout.typ": *
#show: doc
#import "scmuffler.typ": *

// muffler-numbering(<色>,...)
// 色付きマフラーの☃を利用したカウンタ書式関数を生成する.
// マフラーの色は引数に指定したものが順番に使われる.
#let muffler-numbering(..args) = {
  let colors = args.pos()
  (value) => {
    scmuffler(colors.at(calc.rem-euclid(value - 1, colors.len())))
  }
}

#set enum( // 赤・青・緑のマフラーを反復する
  numbering: muffler-numbering(red, blue, olive),
)
// Universeにあるパッケージの名前🙃
+ 粗体（cuti）
+ 口胡（kouhu）
+ 随機（suiji）
+ 条碼（tiaoma）
+ 投影（touying）


出力結果

素敵

まとめ

TypstでもLaTeXでも何でもいいので、イロイロな色のマフラーを着けたゆきだるまが入った文書をドンドンつくりましょう！

えっ、ご存知でしょ？ ↩
アッ、某“Typst以外”の記事の書き出しの使い回しだ！ ↩
TeXConfはTeX・組版・出版とその周辺に関する知見を共有することを目的とした会議です。 ↩
あるいは、時間切れのため話していないのかもしれません。（TeXConf 2024に参加していない人並感） ↩
ﾅﾝﾄｶConfは・とその周辺に関する知見を共有することを目的とした会議です。 ↩
なお「ﾅﾝﾄｶConf 2023」の講演数は全部で1件でした。 ↩
Typst Appで使用可能な日本語用フォントの一つです。 ↩