portrait_image_breakdown

Portrait Image Breakdown est un outil de bureau conçu pour les séances photo de portrait. Il se concentre sur trois problèmes pratiques : analyser la pose, l'orientation, le cadrage et la composition en 2D des personnes sur une photo ; transformer cette analyse en consignes courtes, concrètes et directement énonçables au modèle ; et comparer une image de référence avec l'image actuelle pour proposer des ajustements de pose, de position du sujet et de composition. L'interface principale ne comporte que trois pages : Analyse 2D, Consignes en direct et Comparaison d'images. Le flux de travail privilégie le jugement immédiat pendant la prise de vue plutôt que la dérivation théorique des paramètres photographiques. En haut à droite de la page Analyse 2D se trouve également un outil de reconstruction 3D qui s'ouvre séparément et permet d'explorer les hypothèses de caméra et de scène pouvant correspondre à l'image. Ce module distingue clairement les valeurs observées (Observed), estimées (Estimated) et inconnues (Unknown), afin d'éviter de traiter les inférences issues d'une seule image comme des mesures précises. Le projet utilise Python 3.12+, gère les dépendances avec uv, prend en charge les images .jpg, .jpeg, .png, .bmp et .webp, et permet de cliquer sur le canevas ou de glisser-déposer une photo dans la page 2D. Le code est organisé en plusieurs parties : core (pose 2D, composition et consignes en direct), gui (les trois pages principales et la fenêtre 3D optionnelle), reverse_engineering (module d'inférence 3D optionnel isolé du flux principal), avec des tests pytest et une configuration d'empaquetage Windows PyInstaller.