Tag GEDCOM standard
TOP
Décalage haut
Top crop width
Nombre de pixels à ignorer depuis le bord supérieur d’une image pour CROP.
Exemple concret
Exemple minimal
2 CROP
3 LEFT 120
3 TOP 80
3 WIDTH 640
3 HEIGHT 900
Exemple réaliste
0 @I3@ INDI
1 NAME Jeanne /Dupont/
1 OBJE @M1@
2 CROP
3 LEFT 120
3 TOP 80
3 WIDTH 640
3 HEIGHT 900
0 @M1@ OBJE
1 FILE media/portrait-jeanne.jpg
2 FORM image/jpeg
2 TITL Portrait de Jeanne Dupont
Traduction en langage humain
TOP indique origine verticale : pixels ignorés depuis le bord supérieur. Le minimal est un fragment CROP ; le réaliste fournit l’image liée.
TOP indique origine verticale : pixels ignorés depuis le bord supérieur. Le minimal est un fragment CROP ; le réaliste fournit l’image liée.
Explication pas à pas
L’objectif n’est pas seulement de reconnaître le tag, mais de comprendre ce qu’il fait à cet endroit précis de la hiérarchie.
1
Exemple minimal — « 2 CROP » : le niveau 2 place CROP sous sa superstructure.
2
Exemple minimal — « 3 LEFT 120 » : le niveau 3 place LEFT sous CROP avec la valeur « 120 ».
3
Exemple minimal — « 3 TOP 80 » : le niveau 3 place TOP sous CROP avec la valeur « 80 ».
4
Exemple minimal — « 3 WIDTH 640 » : le niveau 3 place WIDTH sous CROP avec la valeur « 640 ».
5
Exemple minimal — « 3 HEIGHT 900 » : le niveau 3 place HEIGHT sous CROP avec la valeur « 900 ».
6
Exemple réaliste — « 0 @I3@ INDI » : le niveau 0 crée le record identifié par @I3@.
7
Exemple réaliste — « 1 NAME Jeanne /Dupont/ » : le niveau 1 place NAME sous INDI avec la valeur « Jeanne /Dupont/ ».
8
Exemple réaliste — « 1 OBJE @M1@ » : le niveau 1 place OBJE sous INDI et pointe vers @M1@.
9
Exemple réaliste — « 2 CROP » : le niveau 2 place CROP sous OBJE.
10
Exemple réaliste — « 3 LEFT 120 » : le niveau 3 place LEFT sous CROP avec la valeur « 120 ».
11
Exemple réaliste — « 3 TOP 80 » : le niveau 3 place TOP sous CROP avec la valeur « 80 ».
12
Exemple réaliste — « 3 WIDTH 640 » : le niveau 3 place WIDTH sous CROP avec la valeur « 640 ».
13
Exemple réaliste — « 3 HEIGHT 900 » : le niveau 3 place HEIGHT sous CROP avec la valeur « 900 ».
14
Exemple réaliste — « 0 @M1@ OBJE » : le niveau 0 crée le record identifié par @M1@.
15
Exemple réaliste — « 1 FILE media/portrait-jeanne.jpg » : le niveau 1 place FILE sous OBJE avec la valeur « media/portrait-jeanne.jpg ».
16
Exemple réaliste — « 2 FORM image/jpeg » : le niveau 2 place FORM sous FILE avec la valeur « image/jpeg ».
17
Exemple réaliste — « 2 TITL Portrait de Jeanne Dupont » : le niveau 2 place TITL sous FILE avec la valeur « Portrait de Jeanne Dupont ».
18
TOP est un entier : origine verticale : pixels ignorés depuis le bord supérieur.
19
Visualisation : image → décalage TOP vers le bas → décalage LEFT vers la droite → rectangle conservé de WIDTH × HEIGHT.
20
LEFT et TOP valent 0 par défaut. WIDTH vaut par défaut largeur de l’image moins LEFT ; HEIGHT vaut par défaut hauteur de l’image moins TOP.
21
LEFT ou LEFT + WIDTH ne doivent pas dépasser la largeur ; TOP ou TOP + HEIGHT ne doivent pas dépasser la hauteur.
22
CROP s’applique au premier FILE externe du record pointé auquel il peut s’appliquer ; il est recommandé de l’utiliser avec un OBJE ne contenant qu’un FILE.
23
Le niveau numérique indique à quelle structure ce tag appartient.
24
Le type du payload et les sous-structures autorisées dépendent du contexte défini par la norme.
25
Les exemples de cette fiche sont pédagogiques et n’utilisent aucune donnée utilisateur.
Piège fréquent
À ne pas faire / à ne pas déduire :
Utiliser une valeur négative, confondre les axes, ou définir un rectangle qui sort des limites de l’image.
Utiliser une valeur négative, confondre les axes, ou définir un rectangle qui sort des limites de l’image.
Types de structure identifiés par TOP
Un même tag peut représenter plusieurs types de structures. La combinaison du tag et du type de sa structure parente détermine le type exact.
| Nom officiel | URI de type | Page |
|---|---|---|
| Top crop width | g7:TOP | 90 |
Urig7:TOP
Parentg7:CROP
PayloadInteger, nombre de pixels
Cardinality{0:1}