Referenzreplikation
Das Auge ist gut darin, „etwas stimmt nicht“ zu erkennen, aber unzuverlässig bei „um wie viel“. Wenn die Aufgabe lautet „repliziere es exakt, keine Fehler“, dann miss. Jede Stunde, die mit Herumjustieren eines Werts verloren geht, ist eine Stunde, die ein Extraktionsskript beendet hätte.
Vertraue niemals den Rändern des Screenshots
Screenshots kommen mit Letterboxing, Geräterahmen oder abgerundeten Browser-Ecken an. Wenn du anhand der Dateiabmessungen misst, ist jeder Prozentsatz leicht falsch, und der Fehler bleibt unsichtbar, weil fast alles richtig aussieht.
Finde zuerst den tatsächlichen Inhaltsbereich:
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] # eine Spalte, die den Seitenhintergrund darstellt
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()
Drücke jede nachfolgende Messung als Prozentsatz dieses Bereichs aus, niemals als Prozentsatz der Datei.
Extrahiere Positionen, schätze sie nicht
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()
Fenstere jedes Element ein und setze einen Schwellenwert auf sein Luminanzband – dunkle UI auf hellem Hintergrund oder umgekehrt. Zwei Warnungen:
- Ein Ergebnis, das genau auf deiner Fensterkante liegt, ist eine abgeschnittene Messung, kein Fund. Vergrößere das Fenster und miss erneut.
- Dunkler Text und ein dunkles Foto überschreiten beide einen „dunklen“ Schwellenwert. Wähle Fenster, die nur das Element enthalten.
Wandle in Prozentsätze des Inhaltsbereichs um und baue entsprechend. Dann wird aus „die Überschrift ist zu groß“ „die Überschrift ist 22,4 % der Panelbreite in der Referenz und 32 % in meiner".
Überprüfe eine Behauptung, bevor du sie umsetzt
Suche ein Merkmal zweimal, bevor du dich festlegst. Bei einem Build wurden vertikale haarfeine Linien in einer Miniaturansicht „gesehen“ und implementiert; die Referenz hatte keine – es war die eigene Silhouettenkante des Motivs. Eine Überprüfung hätte es verhindert:
band = a[60:330, :].mean(axis=0) # Zeilen ohne andere UI
dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]
Flacher Hintergrund, keine Einbrüche, keine Linien. Eine 1px-Linie zeigt sich als isolierter Einzelspalten-Einbruch; eine Fotokante als allmähliche Rampe. Numerisch sind sie trivial zu unterscheiden, mit dem Auge leicht zu verwechseln.
Löse die Bildrahmung, justiere nicht daran herum
Um zu reproduzieren, wie ein Foto beschnitten ist, leite es her. Miss die Breite des Motivs als Bruchteil des Fotos und erneut als Bruchteil des Panels:
renderScale = subjectWidth_inPanel / subjectWidth_inPhoto # z. B. 1,231
Bei object-fit: cover, das nach Höhe skaliert: scaledW = panelW × renderScale, also panelAspect = 1 / (renderScale / photoAspect). Das ergibt das Panel-Seitenverhältnis, das der Designer verwendet hat. Löse dann object-position aus dem Zentrum des Motivs – die Formel steht in ../landing-page/references/traps.md.
Überprüfe mit einer unabhängigen Größe, die du nicht angepasst hast, etwa der Höhe der Krone des Motivs. Liegt die Vorhersage innerhalb von ein oder zwei Pixeln, ist das Modell richtig.
Erkenne, wann eine Referenz nicht nachgebaut werden kann
Manchmal sagt die Mathematik Nein. Liegt der erforderliche object-position außerhalb von 0–1, kann kein Wert das Motiv dort platzieren – das Panel-Seitenverhältnis oder das Bild muss sich ändern.
Und wenn ein geliefertes Asset eine Neuerstellung des Originals ist und nicht das Original, unterscheiden sich seine Proportionen. Erkenne es: sage eine Messung aus der Quelle voraus und vergleiche sie. Stimmt sie auf vier Stichproben pixelgenau überein, handelt es sich um dasselbe Bild; ein uneinheitlicher Fehler (203 px, wo 282 px vorhergesagt werden, an nur einer Stelle) bedeutet ein anderes Motiv.
Sage es klar, nenne, was übereinstimmt – Layout-Metriken, Rahmung, Platzierung – und höre auf, den Rest zu verfolgen. Weiter zu „korrigieren“ produziert schlechtere Ausgabe und verschwendet die Zeit des Benutzers.
Beide Viewports, immer
Eine Referenz ist ein Desktop-Screenshot und ein mobiler Screenshot. Nur den Desktop zu bauen und das Mobile abzuleiten, dreht den schwierigen Teil um – Mobile ist der Ort, an dem die Korrekturen landen. Wurde nur eine Ansicht geliefert, fordere die andere an, bevor du beginnst.
Arbeitsablauf
- Extrahiere den Inhaltsbereich; miss jedes Element in eine Prozenttabelle.
- Baue Tokens und Layout nach diesen Zahlen.
- Rendere im Seitenverhältnis der Referenz, skaliere die Referenz auf deine Breite, stapele sie vertikal mit einem hellen Trenner. Gestapelt ist besser als nebeneinander – das Auge verfolgt eine vertikale Kante.
- Messe deinen Render erneut mit demselben Skript. Vergleiche Tabellen, nicht Eindrücke.
- Wiederhole pro Abschnitt. Gehe nicht von einem Abschnitt weiter, der sichtbar falsch ist.
Checkliste
- Inhaltsbereich extrahiert; Prozentsätze relativ zu ihm, nicht zur Datei
- Keine Messung an ihrer Suchfensterkante
- Jedes „Merkmal“ numerisch bestätigt, bevor es implementiert wurde
- Bildrahmung gelöst, nicht justiert
- Desktop- und mobile Referenzen vorhanden
- Render mit demselben Skript erneut gemessen und als Zahlen verglichen