← FaintTypeガイド一覧

トラブルシューティング

同じ文字でもスクリーンショットのコントラスト測定値が変わる理由

アンチエイリアス、拡大縮小、圧縮、OCRの範囲、複数の背景色が、デザイン上の配色を変えずにコントラストの推定値へ影響する仕組みを説明します。

公開 更新

デザインツールで暗い文字色と明るい背景色を選べば、コントラストの計算は単純です。しかし同じ文字をスクリーンショットから測ると、字形の輪郭に多数の中間色が現れます。一行の文字が影、グラデーション、圧縮された画像のブロックをまたぐこともあります。

そのため、スクリーンショットの検査ツールとデザイントークンを使う計算ツールは、どちらの計算が正しくても結果が一致しないことがあります。難しいのは、描画済みのどのピクセルを前景とし、どれを背景とするかです。

アンチエイリアスはパレットにない色を作る

フォントをピクセルに変換するときは、輪郭のピクセルを背景と混ぜ、曲線や斜線を滑らかに見せます。輪郭のピクセルを文字色として採ると、字形の中心部を採った場合よりコントラストが低くなります。その混ざり方は、画面の表示倍率、フォントの描画方法、画像の拡大縮小によって変わります。

FaintTypeはOCR矩形内のすべてのピクセルを文字として扱うのではなく、前景の中心部分に当たるピクセルを探します。また、前景色の候補を選ぶ際にはOCR枠の端に近い細い帯状領域を除外し、近くのボタンの枠線を文字と誤認する可能性を減らします。

OCR矩形は位置を示すもので、字形のマスクではない

Apple Visionは、認識した文字について、正規化された座標の領域と信頼度を返します。一行を囲む枠には通常、文字間の空白が入り、近くの装飾が含まれる場合もあります。前景色と背景色を比較するには、まずこの大まかな領域を絞り込む必要があります。

FaintTypeは領域内とその周囲の帯から色をサンプリングし、似た色をまとめ、残した字形の構成部分を周囲の背景から分離します。それでも、認識処理が関係のない文字を一つにまとめたり、小さなラベルを見落としたりすると、矩形や色の推定が誤ることがあります。

一行の背後に複数の背景があることも

グラデーション、写真、半透明のパネル、影の上では、一行全体を代表する背景色が一つとは限りません。FaintTypeは、検出後に残した字形の各部分について局所的な背景を推定し、代表値、局所的に低い部分の推定値、基準を満たす領域の割合にまとめます。

これらはそれぞれ異なる情報を示します。代表値は描画された文字の大部分を表し、低い部分の推定値は弱点の発見に役立ちます。領域の割合は、サンプリング範囲のどれだけが選択したWCAGの閾値に達しているかを示します。背景が明らかに変化する場所を文字がまたいでいるなら、最も有利な数値だけを報告しないでください。

予想外の結果を調べるには

元のサイズの画像に戻り、該当する結果を選んで、前景色・背景色のサンプルをハイライトされたピクセルと比較します。画像が拡大縮小、再圧縮されていないか、異なる表示倍率で撮影されていないか確認してください。信頼度が中程度または低い場合は、元のデザインやブラウザの開発者ツールで色を確認します。

同じピクセルに対するスクリーンショットの推定値は再現できるはずですが、ピクセルが変換された後まで、元の指定色による計算と一致するとは限りません。閾値付近のわずかな差で判断が変わる場合は、元の書き出し画像を保管してください。