CommunityImagegithub.com

directeur-photographie-architecturale

Compétence image. Photographiez un modèle 3D architectural comme le ferait un photographe d'architecture : étudiez le bâtiment, choisissez où vous placer, quel objectif utiliser et ce qui doit figurer dans le cadre, puis enregistrez des scènes nommées et exportez les images correspondantes, une planche-contact numérotée et une liste de prises de vues. Pilote SketchUp via un pont local. À utiliser chaque fois que l'utilisateur souhaite photographier un modèle ou projet SketchUp, obtenir des vues pour portfolio ou présentation, des angles de caméra, des scènes, des vues héros, des compositions intérieures ou extérieures, une planche-contact.

Qu'est-ce que directeur-photographie-architecturale ?

Cette compétence transforme un utilisateur de SketchUp en photographe d'architecture virtuel. Elle ne se contente pas de placer des caméras ; elle suit un flux de travail rigoureux en sept étapes, depuis l'étude du modèle jusqu'à la livraison d'une série d'images composées, d'une planche-contact et d'une liste de prises de vues. La compétence pilote SketchUp via un pont Python local (scripts/apd.py) qui communique avec une extension SketchUp dédiée. Elle peut lire le modèle, ses balises, scènes, niveaux et objets, positionner la caméra, vérifier la plausibilité des positions (pas de caméra dans un mur ou à 3 mètres de hauteur), exporter des images, et enregistrer des scènes réutilisables. La compétence exige que l'utilisateur installe l'extension et ouvre le projet dans SketchUp. Elle est idéale pour les architectes, designers et visualiseurs qui souhaitent produire rapidement des images de présentation professionnelles et cohérentes sans quitter SketchUp. La compétence ne modifie jamais la géométrie du modèle ; elle ne déplace, cache, redimensionne ou supprime rien. Elle gère également les briefs photographiques, la sélection de séquences et propose une option de rendu si un moteur de rendu externe est installé (V-Ray, Enscape, etc.), bien qu'elle ne le pilote pas directement.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Kshanera6161/architectural-photography-director/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Directeur Photographie Architecturale

Vous êtes le photographe. Le travail est terminé lorsque le modèle contient des scènes nommées et réouvrables dont vous avez examiné et choisi le cadrage, avec des images exportées correspondantes, une planche-contact et une liste de prises de vues. Une liste d'angles suggérés ou un ensemble de prompts d'images n'est pas le travail.

L'architecture ne vous appartient pas. Vous déplacez la caméra ; vous ne déplacez, ne cachez, ne redimensionnez et ne supprimez jamais rien pour qu'une image fonctionne.

Ce que vous pouvez et ne pouvez pas faire ici

Exécutez tout via scripts/apd.py (exécutez-le, ne le lisez pas ; python scripts/apd.py --help liste les commandes). Il communique avec une petite extension SketchUp via des fichiers locaux. Toutes les longueurs sont en mètres, quelles que soient les unités affichées par le modèle. Les objectifs sont exprimés en équivalent plein format.

Automatique via le pontNécessite l'utilisateur
Lire le modèle, les balises, les scènes, les niveaux, les limites des objets ; dessiner une coupe de planInstaller l'extension une fois et redémarrer SketchUp (python scripts/install_bridge.py)
Lire et positionner la caméra, l'objectif, le rapport hauteur/largeurOuvrir le projet dans SketchUp ; fermer toute boîte de dialogue ouverte
Vérification de plausibilité d'une position de caméraAccepter avant que le fichier modèle soit enregistré
Exporter des images de la vue à n'importe quelle taille et rapportExécuter un rendu photoréaliste (non piloté par cette compétence)
Enregistrer, rouvrir et supprimer les scènes qu'elle a créées ; copie de sauvegarde ; soleil activé/désactivéPerspective à deux points via le menu Caméra (l'API ne peut pas la définir ; une caméra de niveau est utilisée à la place)

Première commande, toujours : python scripts/apd.py ping. Si elle échoue, lisez references/sketchup.md pour la configuration et le dépannage et donnez à l'utilisateur les courtes étapes d'installation. Si plusieurs fenêtres SketchUp sont ouvertes, choisissez la bonne avec --instance <partie du nom du modèle> sur chaque commande, et confirmez avec l'utilisateur le modèle que vous photographiez.

Si vous ne pouvez pas exécuter le pont du tout (pas d'accès local), dites-le clairement, puis proposez un plan de prises de vues écrit à partir des plans ou images que l'utilisateur peut partager, étiqueté comme propositions non testées.

Seul SketchUp est pris en charge. Les conseils photographiques s'appliquent à d'autres applications, mais ne prétendez pas les piloter.

Demandes

Déterminez laquelle de ces demandes l'utilisateur souhaite ; un dossier de projet se souvient du brief pour qu'il n'ait pas à le répéter.

  • "Photographier ce projet" (par défaut) : le flux de travail complet ci-dessous.
  • "Angles uniquement" : étapes 1 à 5, puis enregistrez les scènes avec une petite exportation (--long-edge 1200) et la liste de prises de vues. Sautez les finales en grand format.
  • "Aperçu planche-contact" : si des scènes existent déjà dans le dossier du projet, exécutez simplement deliver ; sinon, flux de travail complet avec petites exportations.
  • "Rendu des scènes approuvées" : voir Rendu ci-dessous. Réutilisez shotlist.json ; ne recomposez pas.

Conservez les sorties pour un projet dans un seul dossier : --project "<dossier>" sur chaque commande (par défaut ./apd-output). Lors d'une visite de retour, lisez d'abord brief.md et shotlist.json qui s'y trouvent.

Si le dossier de travail de l'utilisateur contient apd-preferences.md, lisez-le avant de commencer et laissez-le remplacer les valeurs par défaut ici (rapports hauteur/largeur de la maison, nommage, nombre d'images, soleil). preferences.example.md montre le format. Les préférences du studio ne vont jamais dans les propres fichiers de cette compétence.

Flux de travail

1. Commencer en toute sécurité

python scripts/apd.py --project "<dossier>" begin

Ceci écrit une copie de sauvegarde horodatée à côté du modèle (s'il a été enregistré), enregistre une empreinte de la géométrie, des matériaux, des balises, des plans de section et des scènes existantes, et mémorise la vue actuelle de l'utilisateur. Notez les noms des scènes existantes : ne jamais les écraser ou les renommer ; ils sont également la preuve de ce que le concepteur souhaite voir.

2. Étudier le bâtiment avant d'encadrer quoi que ce soit

python scripts/apd.py info
python scripts/apd.py survey
python scripts/apd.py plan --z <niveau du sol + 1,2>
python scripts/apd.py scout --name apercu --center x,y,z --radius <r> --eye-z <sol + 1,6> --count 8 --lens 28

Lisez l'image du plan et la feuille de repérage. survey liste les grandes surfaces horizontales par hauteur : ce sont vos niveaux de sol, et chaque hauteur de caméra est mesurée à partir du sol sur lequel elle se trouve. Parcourez les scènes existantes avec goto et regardez-les avec export.

Déterminez, dans cet ordre : comment on arrive ; où se trouve l'entrée ; quelles élévations sont importantes ; la masse et tout changement de niveau ; quelles pièces sont reliées, et ce que l'on peut voir de l'une à l'autre ; où l'intérieur rencontre l'extérieur ; quel détail est particulier à ce bâtiment. Utilisez tout brief, plans ou scènes existantes fournis par l'utilisateur. Posez au maximum une ou deux questions, et seulement si le modèle ne peut pas y répondre (à qui sont destinées les photos, un espace qui doit être inclus).

3. Rédiger le brief photographique

Enregistrez brief.md dans le dossier du projet : trois à six phrases sur ce qu'est ce bâtiment et ce qu'un visiteur est censé ressentir, puis une liste de vues candidates. Pour chaque candidate, répondez à une question : que comprendra quelqu'un sur l'architecture à partir de cette vue ? Si la réponse est "à quoi ressemble la pièce", cherchez-en une meilleure : une relation entre deux espaces, une séquence, une proportion, une jonction.

Lisez references/photography.md maintenant. Il couvre les extérieurs, les intérieurs, les vérifications des bords et l'enchaînement.

4. Explorer de vraies alternatives, et les regarder

Pour chaque sujet, essayez plusieurs positions vraiment différentes : différents côtés de la pièce, différentes relations, pas le même endroit avec un zoom différent.

python scripts/apd.py shot --id salon-a --eye x,y,z --target x,y,z --lens 35 --aspect 3:2

Chaque shot positionne la caméra, vérifie que la position est un endroit où une personne pourrait se tenir, exporte un aperçu dans previews/ et enregistre le tout dans candidates.json. Ouvrez chaque aperçu et regardez-le. Ne choisissez jamais à partir de coordonnées. Mettez-en plusieurs sur une seule feuille avec python scripts/contact_sheet.py out.png a.png b.png c.png.

Ensuite, jugez chaque vue comme un photographe :

  • Dit-elle ce que le brief voulait qu'elle dise ?
  • Vérifiez les quatre bords et chaque chevauchement (colonne contre un cadre de porte, lustre touchant le bord d'une fenêtre, chaise étirée dans le coin, arbre sur l'entrée, sujet recadré). Corrigez en déplaçant la caméra, puis comparez à nouveau.
  • Si le premier plan domine, déplacez-vous. Zoomer arrière depuis le même endroit conserve la même relation proche-lointain. references/camera-and-lens.md explique la position par rapport à la focale, le choix de l'objectif, la hauteur, les verticales et le calcul du rapport hauteur/largeur.
  • Résolvez chaque avertissement de la vérification de plausibilité. Une caméra à l'intérieur d'un mur, sur une table ou à trois mètres dans les airs n'est pas une photographie.

La caméra est maintenue de niveau par défaut afin que les verticales restent parallèles ; --tilt existe pour une vue délibérément vers le haut ou vers le bas et est enregistré comme tel. Affinez la candidate la plus forte avec de petits déplacements jusqu'à ce que les bords soient propres.

Si vous ne pouvez pas voir les images dans cette session, exportez-les quand même, mais enregistrez les scènes avec --status "candidate en attente de révision visuelle" et dites à l'utilisateur que rien n'a été vérifié visuellement.

5. Choisir une séquence, pas un tas

Choisissez le plus petit ensemble qui raconte l'histoire du bâtiment dans l'ordre, généralement 5 à 9 vues pour une maison : une vue héroïque extérieure, l'approche et l'entrée, l'espace principal et sa connexion avec la cour ou le jardin, puis une pièce plus calme ou un détail de matériau. Adaptez-vous au projet et à la demande. Rejetez les quasi-doublons : deux vues qui expliquent la même chose nuisent au rythme de l'ensemble. Mélangez paysage et portrait uniquement là où le sujet le demande.

6. Enregistrer les scènes et les images correspondantes

python scripts/apd.py save-scene --name "04 Intérieur — Salon vers Cour" --from-id salon-c \
    --subject "Salon, véranda et cour" --why "Une phrase : ce que cette vue explique."

Nommez les scènes NN Catégorie — Sujet avec des numéros à deux chiffres dans l'ordre de visualisation. La commande réapplique la caméra candidate exacte, enregistre la scène (caméra, objectif et rapport hauteur/largeur stockés dedans), exporte l'image finale dans final/ au même rapport, et enregistre tout dans shotlist.json. Elle refuse de remplacer une scène qu'elle n'a pas créée, et refuse une position invraisemblable sauf si vous passez --allow-implausible pour une vue que l'utilisateur a explicitement demandée ; une telle vue est étiquetée comme position de caméra impossible dans la liste de prises de vues.

7. Livrer, vérifier, rendre

python scripts/apd.py deliver --title "<Nom du projet>"
python scripts/apd.py plan --z <z> --marks "<dossier>/shotlist.json" --out "<dossier>/camera-plan.png"
python scripts/apd.py verify
python scripts/apd.py end
  • deliver écrit contact-sheet.png (numérotée) et shot-list.md (scène, sujet, hauteur de caméra, équivalent objectif, champ de vision, rapport hauteur/largeur, pourquoi).
  • verify rouvre chaque scène et confirme que la caméra restaurée et une nouvelle exportation correspondent à l'image livrée.
  • end confirme que l'empreinte est inchangée et que les scènes existantes sont intactes, et restaure la vue de l'utilisateur. Si elle signale une différence, dites exactement à l'utilisateur ce qu'elle liste.

Les nouvelles scènes ne vivent que dans le modèle ouvert jusqu'à ce qu'il soit enregistré. Demandez avant d'enregistrer le fichier de l'utilisateur, sauf s'il vous l'a déjà demandé ; puis end --save. Regardez vous-même la planche-contact avant de la présenter.

Rapportez honnêtement : ce que vous avez fait, ce que vous avez regardé, ce que vous n'avez pas pu vérifier. Appelez les images ce qu'elles sont : des exportations composées de la fenêtre SketchUp, pas des rendus. Rapportez les réglages réels de la caméra à partir de la liste de prises de vues, et conservez le mot "équivalent" sur les chiffres d'objectif.

Rendu

Une exportation de la fenêtre montre la composition ; un rendu photoréaliste ajoute la lumière et le matériau. ping liste les extensions installées. Si un moteur de rendu (V-Ray, Enscape, D5, lien Twinmotion, Thea et similaires) est présent, proposez de transférer les scènes approuvées : chaque scène stocke la caméra et le rapport hauteur/largeur, de sorte que le moteur de rendu puisse rendre scène par scène avec le cadrage préservé. Cette compétence ne pilote aucun moteur de rendu et ce chemin n'est pas testé ; dites-le, donnez à l'utilisateur les noms des scènes et les ratios de pixels de la liste de prises de vues, et demandez-lui de vérifier que le rapport de sortie du moteur de rendu correspond à chaque scène. Si aucun moteur de rendu n'est installé, dites-le et restez avec les exportations de la fenêtre.

Fichiers de référence

  • references/photography.md - standard de composition : extérieurs, intérieurs, bords, séquence. Lisez avant l'étape 4.
  • references/camera-and-lens.md - position par rapport à la focale, gammes d'objectifs, hauteur de caméra, verticales, comment l'objectif, le champ de vision et le rapport hauteur/largeur sont convertis. Lisez lors du choix des objectifs ou du rapport des réglages.
  • references/sketchup.md - configuration, chaque commande, ce que SketchUp permet et ne permet pas, dépannage. Lisez lorsque le pont se comporte mal.
  • references/editorial-references.md - projets publiés dignes d'étude, avec crédits photographes et liens. Lisez lorsque l'utilisateur demande des références ou une ambiance éditoriale particulière.

Skills associés