Perspective Transform

Cette fonction permet de définir une région quadrilatérale sur une image et de générer une vue corrigée, en plongée (transformée par perspective), de cette région. L’outil est interactif — sélectionnez quatre points sur l’image, déplacez-les pour affiner, et utilisez des raccourcis clavier pour éditer votre sélection.

📥 Entrées

• Image — Image source affichée dans le bloc pour la sélection des points.

📤 Sorties

• Image — Image recadrée/transformée par perspective de la quadrilatère sélectionnée.

• Transform Matrix — Matrice de transformation perspective (utile pour alimenter d’autres blocs qui requièrent une matrice de perspective ou d’homographie).

🕹️ Contrôles

• Interactive Image Area — Cliquez sur l’image pour ajouter des points. Les points apparaissent en tant que polygone superposé au fur et à mesure.

• Drag Points — Cliquez et faites glisser un point pour ajuster sa position.

• C — Efface tous les points sélectionnés.

• U — Annule le dernier point ajouté.

• Help Text — Petit texte d’aide sur le bloc rappelant comment ajouter, déplacer, effacer et annuler des points.

Remarque : la superposition indique si le polygone est complet et met en surbrillance le sommet sous la souris pour faciliter l’ajustement.

⚙️ Mécanisme d’exécution

• Le bloc affiche l’image connectée afin que vous puissiez sélectionner interactivement quatre points.

• Si moins de quatre points sont définis, le bloc renvoie des sorties vides pour indiquer aux blocs en aval que la transformation n’est pas prête.

• Une fois quatre points fournis, le bloc les ordonne, calcule la taille du rectangle de sortie à partir des points sélectionnés, construit la transformation de perspective et fournit l’image transformée ainsi que la matrice de transformation.

• Le bloc met en cache la dernière transformation calculée pour la même image et le même jeu de points afin d’éviter des recalculs inutiles lors de l’ajustement d’autres parties du scénario.

✨ Fonctionnalités

• Sélection ROI visuelle et interactive avec édition par clic-et-glisser.

• Raccourcis clavier pour une édition rapide.

• Superposition visuelle affichant le polygone, la mise en évidence des sommets et l’état d’achèvement.

• Fournit à la fois l’image corrigée et la matrice de transformation pour réutilisation.

• Le dimensionnement automatique choisit un rectangle de sortie approprié en fonction des points sélectionnés.

📝 Instructions d’utilisation

1. Connectez un bloc producteur d’image à l’entrée Image.

2. Cliquez sur la zone image à l’intérieur du bloc pour placer jusqu’à quatre points d’angle (dans n’importe quel ordre).

3. Faites glisser les points pour affiner leur position.

4. Utilisez U pour annuler le dernier point et C pour effacer tous les points.

5. Lorsque quatre points sont présents, le bloc fournira une image corrigée et la sortie Transform Matrix.

💡 Conseils et astuces

• Utilisez Show Image pour prévisualiser l’image source ou transformée dans une fenêtre plus grande pendant l’ajustement des points.

• Si vous devez d’abord recadrer la zone, ajoutez Image ROI Select ou Image ROI avant ce bloc pour travailler sur une région plus petite.

• Si votre image source est très grande, ajoutez Image Resizer avant ce bloc pour accélérer l’interaction et réduire l’utilisation mémoire.

• La Transform Matrix produite peut être alimentée dans le bloc Social Distance Detector comme entrée Perspective Matrix nécessaire pour mesurer des distances réelles depuis la vue transformée.

• Sauvegardez les résultats transformés avec Image Write si vous souhaitez conserver une copie des images corrigées.

🛠️ Dépannage

• Si aucune sortie n’apparaît, vérifiez que quatre points sont définis — le bloc ne produira pas de transformée tant que le quadrilatère n’est pas complet.

• Si l’image transformée semble déformée, ajustez les points d’angle en les faisant glisser ; l’utilisation de Show Image aide à inspecter les détails lors de l’ajustement.

• Si l’interaction est lente sur de grandes images, insérez Image Resizer avant ce bloc ou travaillez sur une région recadrée avec Image ROI Select.

• Si vous ajoutez accidentellement un point au mauvais endroit, appuyez sur U pour retirer le dernier point ou C pour recommencer.