【qlmanage】サムネイルの生成にかかる時間を測る (-z)

Quick Lookのサムネイルを生成するのにかかる時間を測りたいときは、qlmanage -tに-zを付ける。

$ qlmanage -t -z pic.png sample.txt t.html
...
Thumbnails produced: 3
Duration: 0.223575 seconds (average 0.074525 seconds per file)

生成したサムネイルの数と、全体の所要時間、1ファイルあたりの平均時間が表示される。実行例はmacOS 27.0.1のもの。

表示される内容

-zを付けると、通常のproduced one thumbnailのログは表示されない。代わりに、ファイル1つにつき.が1つ表示され、最後に3行の集計が出る。

行	内容
`Thumbnails produced`	生成できたサムネイルの数
`Duration`	全ファイルの生成にかかった合計時間
`average`	1ファイルあたりの平均時間

複数のファイルを指定すると、平均時間を確認できる。3ファイルの例では、合計0.223575秒を3で割った0.074525秒が平均である。

画像を表示せずに時間だけを測る

-zは、qlmanage -hにdon't display thumbnailsと書かれているとおり、サムネイルのウィンドウを開かない。画面のない環境でも使える。

-oと併用するとファイルも保存される

-zと-oを併用すると、時間を測りながらサムネイルのPNGファイルも保存される。

$ mkdir out
$ qlmanage -t -z -o out pic.png
$ ls out
pic.png.png

サイズを変えて比べる

-sと組み合わせると、サムネイルの大きさによる所要時間の違いを比べられる。

$ for s in 128 512 1024; do
>   echo "-s $s"
>   qlmanage -t -z -s $s pic.png | grep Duration
> done

所要時間は、実行するたびに変わる。Macの負荷が高いときは長くなる。uptimeなどで負荷を確認し、同じ条件で3回ほど繰り返して傾向をつかむ。

$ for i in 1 2 3; do qlmanage -t -z pic.png | grep Duration; done
Duration: 0.170838 seconds (average 0.170838 seconds per file)
Duration: 0.169499 seconds (average 0.169499 seconds per file)
Duration: 0.165417 seconds (average 0.165417 seconds per file)

-pではデータを生成するファイルだけ測れる

-pに-zを付けると、プレビューの生成数と、何も生成しなかったファイルの数が表示される。

$ qlmanage -p -z sample.txt pic.png s.docx
...
Previews produced: 1
	files producing nothing: 2
Duration: 0.066275 seconds (average 0.0220917 seconds per file)

テキストファイルやPNG画像のプレビューは、元のファイルを指すURLを返すだけである。プレビュー用のデータは作られないため、生成数に数えられず、所要時間もほぼ0になる。docxのように、HTMLへ変換してデータを生成するファイルは、生成数に数えられる。

$ qlmanage -p -z s.docx
.
Previews produced: 1
Duration: 0.071056 seconds (average 0.071056 seconds per file)

URLを返すだけのファイルでは、-p -zで所要時間を測れない。サムネイルの所要時間を測りたいときは、-t -zを使う。