参照複製
人間の目は「何かがおかしい」と感じることは得意ですが、「どのくらいずれているか」を正確に判断するのは苦手です。要件が 「完全に複製すること、ミスは許されない」 という場合、数値で測りましょう。値を微調整して失った時間は、たった一つの抽出スクリプトがあれば終わっていた時間です。
スクリーンショットの端を決して信用しない
スクリーンショットは、レターボックス(黒帯)が付いていたり、デバイスフレームに入っていたり、ブラウザの角丸がついていたりして届きます。その状態でファイルの寸法に対してパーセンテージを測ると、すべてのパーセンテージがわずかにずれます。そして、その誤差は目に見えません。なぜなら、すべてが ほぼ 正しいからです。
まず、本当のコンテンツボックスを見つけます:
from PIL import Image
import numpy as np
a = np.array(Image.open(src).convert('RGB')).astype(int).sum(axis=2)/3
rows = np.nonzero(a[:, 5] > 200)[0] # ページ背景である列
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()
以降のすべての計測は、このボックスに対するパーセンテージで表現します。ファイルに対するパーセンテージでは決して表現しません。
位置を推定せず、抽出する
def bbox(x0, x1, y0, y1, lo, hi):
reg = a[y0:y1, x0:x1]
ys, xs = np.nonzero((reg >= lo) & (reg <= hi))
return x0+xs.min(), x0+xs.max(), y0+ys.min(), y0+ys.max()
各要素をウィンドウで囲み、その輝度帯で閾値を設定します — 明るい背景の上の暗いUI、またはその逆です。2つの注意点:
- 結果がちょうどウィンドウの端に来た場合、それは発見ではなく、クリップされた計測値です。 ウィンドウを広げて再計測してください。
- 暗いテキストと暗い写真は、どちらも「暗い」閾値を通過します。要素のみを含むウィンドウを選択してください。
これらをコンテンツボックスのパーセンテージに変換し、その数値に基づいて構築します。すると、「見出しが大きすぎる」という曖昧な表現が、「参照では見出しの幅はパネル幅の22.4%だが、私の実装では32%である」という明確な数値に変わります。
実装する前に主張を検証する
実装に取り掛かる前に、ある特徴が存在するかどうかを2回確認してください。ある構築で、サムネイルに一対の垂直なヘアラインが見えたため実装しましたが、参照には存在しませんでした — それは被写体自身のシルエットのエッジだったのです。一度確認していれば防げたはずです:
band = a[60:330, :].mean(axis=0) # 他のUIのない行
102行目: dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]
平坦な背景、ディップなし、線なし。1pxの罫線は、孤立した1列のディップとして現れます。写真のエッジは、緩やかなランプ(階段状の変化)として現れます。これらは数値的には簡単に見分けられますが、目では簡単に混同されます。
画像のフレーミングを解決し、微調整しない
写真がどのように切り抜かれているかを再現するには、それを導き出します。被写体の幅を、写真全体に対する割合、およびパネルに対する割合として測定します:
renderScale = subjectWidth_inPanel / subjectWidth_inPhoto # 例: 1.231
object-fit: cover は高さでスケーリングするため、scaledW = panelW × renderScale となり、結果として panelAspect = 1 / (renderScale / photoAspect) となります。これにより、デザイナーが使用したパネルの縦横比が得られます。次に、被写体の中心から object-position を解きます — 計算式は ../landing-page/references/traps.md にあります。
適合させなかった独立した量(例:被写体の頭頂部の高さ)で検証します。予測が1〜2ピクセル以内に収まれば、モデルは正しいです。
参照が一致しない場合を知る
時には、数式が「ノー」と言うことがあります。必要な object-position が0〜1の範囲外になる場合、被写体をその位置に配置できる値は存在しません — パネルの縦横比または画像自体を変更する必要があります。
また、提供されたアセットがオリジナルではなく、その再生成である場合、その比率は異なります。それを検出します:ソースからある計測値を予測し、比較します。4つのサンプルでピクセル単位で一致すれば同じ画像です。不均一な不一致(ある1点で282pxと予測されるところが203pxであるなど)は、別の被写体を意味します。
そのことを明確に述べ、何が一致しているか(レイアウトメトリクス、フレーミング、配置)を説明し、残りの追跡をやめます。「修正」を続けると、出力が悪化し、ユーザーの時間を浪費します。
常に両方のビューポート
参照は、デスクトップのスクリーンショットとモバイルのスクリーンショットです。デスクトップのみを構築し、モバイルを推測するのは、最も難しい部分(モバイルでは修正が集中する)を後回しにすることになります。片方だけが提供された場合は、開始する前に他方を依頼してください。
作業ループ
- コンテンツボックスを抽出し、すべての要素をパーセンテージテーブルに計測します。
- それらの数値に基づいてトークンとレイアウトを構築します。
- 参照と同じアスペクト比でレンダリングし、参照を自分の幅にスケーリングし、明るい区切り線を挟んで上下に重ねます。上下に重ねる方が左右に並べるより優れています — 目は一つの垂直エッジを追跡できるからです。
- 同じスクリプトで自分のレンダリングを再計測します。印象ではなく、テーブルを比較します。
- セクションごとに繰り返します。目に見えてずれているセクションから先に進まないでください。
チェックリスト
- コンテンツボックスが抽出されている。パーセンテージはファイルではなく、このボックスに対するもの
- どの計測値も、その探索ウィンドウの端に乗っていない
- すべての「特徴」が実装前に数値的に確認されている
- 画像のフレーミングが解決されており、微調整されていない
- デスクトップ および モバイルの参照が手元にある
- レンダリングが同じスクリプトで再計測され、数値として比較されている