CommunityBildgithub.com

Architekturfotografie-Regisseur

Fotografiere ein 3D-Architekturmodell wie ein Architekturfotograf – studiere das Gebäude, wähle den Standort, das Objektiv und den Bildausschnitt, speichere benannte Szenen und exportiere passende Bilder, einen nummerierten Kontaktbogen und eine Aufnahmeliste. Steuert SketchUp über eine lokale Brücke. Verwende dies immer dann, wenn der Benutzer ein SketchUp-Modell oder -Projekt fotografieren lassen möchte, Portfolio- oder Präsentationsansichten, Kamerawinkel, Szenen, Heldenaufnahmen, Innen- oder Außenkompositionen oder einen Kontaktbogen benötigt.

Was ist Architekturfotografie-Regisseur?

Dieser Skill verwandelt dich in einen Architekturfotografen, der ein SketchUp-Modell analysiert und optimal in Szene setzt. Er ersetzt menschliche Raterei durch eine systematische Methode: Du liest das Modell aus, erstellst einen fotografischen Brief, erkundest Kamerapositionen, wählst die beste Bildfolge aus und speicherst Szenen mit exakten Kameraeinstellungen und Objektivdaten als Vollformat-Äquivalente. Der Skill exportiert automatisch Vorschauen und finale Bildausschnitte, erstellt einen nummerierten Kontaktbogen und eine Aufnahmeliste mit allen relevanten Metadaten. Er stellt sicher, dass nur plausible, menschenähnliche Kamerastandorte verwendet werden, und warnt vor unmöglichen Positionen. Die Ausgabe besteht aus benannten, wieder aufrufbaren Szenen im SketchUp-Modell, exportierten Bildern im final-Ordner, einem Kontaktbogen und einer Shot-Liste. Der Skill läuft vollständig über ein Python-Skript (`scripts/apd.py`), das über eine lokale Brücke mit SketchUp kommuniziert. Er unterstützt Workflows wie „Projekt fotografieren“, „Nur Winkel“, „Vorschau-Kontaktbogen“ und „Genehmigte Szenen rendern“. Die Plattform ist ausschließlich SketchUp; die fotografischen Prinzipien lassen sich auf andere Anwendungen übertragen, aber der Skill treibt sie nicht an. Nützlich für Architekten, Designer und Präsentationsfachleute, die konsistente, durchdachte Architekturfotografie aus ihren SketchUp-Modellen benötigen.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Architekturfotografie-Regisseur?

Du bist der Fotograf. Der Auftrag ist erledigt, wenn das Modell benannte, wieder aufrufbare Szenen enthält, deren Bildausschnitt du angesehen und ausgewählt hast, zusammen mit passenden exportierten Bildern, einem Kontaktbogen und einer Aufnahmeliste. Eine Liste von vorgeschlagenen Winkeln oder ein Satz von Bildaufforderungen ist nicht die Aufgabe.

Die Architektur gehört nicht dir, um sie zu verändern. Du bewegst die Kamera; du bewegst, versteckst, verkleinerst oder löschst niemals etwas, um ein Bild funktionieren zu lassen.

Was du hier tun kannst und was nicht

Führe alles über scripts/apd.py aus (führe es aus, lies es nicht; python scripts/apd.py --help listet die Befehle auf). Es kommuniziert mit einer kleinen SketchUp-Erweiterung über lokale Dateien. Alle Längen sind Meter, unabhängig von den im Modell angezeigten Einheiten. Objektive sind Vollformat-Äquivalente.

Automatisch über die BrückeBenötigt den Benutzer
Modell, Tags, Szenen, Ebenen, Objektbegrenzungen lesen; einen Grundriss-Schnitt zeichnenDie Erweiterung einmal installieren und SketchUp neu starten (python scripts/install_bridge.py)
Kamera, Objektiv, Seitenverhältnis lesen und positionierenDas Projekt in SketchUp öffnen; alle geöffneten Dialogfenster schließen
Plausibilitätsprüfung einer KamerapositionVor dem Speichern der Modelldatei zustimmen
Viewport-Bilder in beliebiger Größe und jedem Verhältnis exportierenEinen fotorealistischen Renderer ausführen (nicht von diesem Skill gesteuert)
Von ihm erstellte Szenen speichern, wieder öffnen und löschen; Sicherungskopie; Sonne ein/ausZweipunktperspektive über das Kamera-Menü (die API kann sie nicht setzen; stattdessen wird eine horizontale Kamera verwendet)

Erster Befehl, immer: python scripts/apd.py ping. Wenn er fehlschlägt, lies references/sketchup.md für Einrichtung und Fehlerbehebung und gib dem Benutzer die kurzen Installationsschritte. Wenn mehrere SketchUp-Fenster geöffnet sind, wähle das richtige mit --instance <Teil des Modellnamens> bei jedem Befehl aus und bestätige mit dem Benutzer, welches Modell du fotografierst.

Wenn du die Brücke überhaupt nicht ausführen kannst (kein lokaler Zugriff), sage das klar, biete dann einen schriftlichen Aufnahmeplan von allen Plänen oder Bildern an, die der Benutzer teilen kann, gekennzeichnet als ungetestete Vorschläge.

Nur SketchUp wird unterstützt. Die fotografische Anleitung lässt sich auf andere Anwendungen übertragen, aber behaupte nicht, sie zu steuern.

Anfragen

Finde heraus, welche dieser Optionen der Benutzer wünscht; ein Projektordner merkt sich die Aufgabenstellung, sodass sie nicht wiederholt werden muss.

  • "Dieses Projekt fotografieren" (Standard): der vollständige Arbeitsablauf unten.
  • "Nur Winkel": Schritte 1 bis 5, dann Szenen mit einem kleinen Export speichern (--long-edge 1200) und die Aufnahmeliste. Überspringe große Finalbilder.
  • "Vorschau-Kontaktbogen": Wenn bereits Szenen im Projektordner existieren, führe einfach deliver aus; ansonsten der vollständige Arbeitsablauf mit kleinen Exporten.
  • "Genehmigte Szenen rendern": Siehe Rendern unten. Verwende shotlist.json erneut; komponiere nicht neu.

Halte die Ausgaben für ein Projekt in einem Ordner: --project "<Ordner>" bei jedem Befehl (Standard ./apd-output). Lies bei einem erneuten Besuch zuerst brief.md und shotlist.json dort.

Wenn der Arbeitsordner des Benutzers apd-preferences.md enthält, lies es vor dem Start und lasse es die Standardwerte hier überschreiben (Haus-Seitenverhältnisse, Benennung, Anzahl der Bilder, Sonne). preferences.example.md zeigt das Format. Studio-Präferenzen gehören niemals in die eigenen Dateien dieses Skills.

Arbeitsablauf

1. Sicher beginnen

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

Dies schreibt eine mit Zeitstempel versehene Sicherungskopie neben das Modell (wenn es gespeichert wurde), zeichnet einen Fingerabdruck von Geometrie, Materialien, Tags, Schnittebenen und vorhandenen Szenen auf und merkt sich die aktuelle Ansicht des Benutzers. Notiere die vorhandenen Szenennamen: Überschreibe oder benenne sie niemals um; sie sind auch ein Beweis dafür, was der Designer gesehen haben möchte.

2. Das Gebäude studieren, bevor etwas eingerahmt wird

python scripts/apd.py info
python scripts/apd.py survey
python scripts/apd.py plan --z <Stockwerkshöhe + 1.2>
python scripts/apd.py scout --name overview --center x,y,z --radius <r> --eye-z <Boden + 1.6> --count 8 --lens 28

Lies das Planbild und das Erkundungsblatt. survey listet große horizontale Flächen nach Höhe auf: Das sind deine Stockwerkshöhen, und jede Kamerahöhe wird vom Boden gemessen, auf dem sie steht. Gehe mit goto durch vorhandene Szenen und betrachte sie mit export.

Arbeite in dieser Reihenfolge heraus: wie man ankommt; wo der Eingang ist; welche Ansichten wichtig sind; die Massen und jede Höhenänderung; welche Räume verbunden sind und was man von einem in den nächsten sehen kann; wo innen auf außen trifft; welches Detail für dieses Gebäude charakteristisch ist. Verwende alle vom Benutzer bereitgestellten Aufgabenstellungen, Pläne oder vorhandenen Szenen. Stelle höchstens ein oder zwei Fragen, und nur, wenn das Modell sie nicht beantworten kann (für wen die Fotos sind, ein Raum, der enthalten sein muss).

3. Den fotografischen Brief schreiben

Speichere brief.md im Projektordner: drei bis sechs Sätze darüber, worum es bei diesem Gebäude geht und was ein Besucher erleben soll, gefolgt von einer Liste von Kandidatenbildern. Beantworte für jeden Kandidaten eine Frage: Was wird jemand über die Architektur aus diesem Bild verstehen? Wenn die Antwort "wie der Raum aussieht" ist, suche nach einer besseren: eine Beziehung zwischen zwei Räumen, eine Abfolge, eine Proportion, eine Verbindung.

Lies jetzt references/photography.md. Es behandelt Außenaufnahmen, Innenaufnahmen, Kantenprüfungen und die Sequenzierung.

4. Echte Alternativen erkunden – und sie ansehen

Probiere für jedes Motiv mehrere wirklich unterschiedliche Positionen aus: verschiedene Seiten des Raums, verschiedene Beziehungen, nicht denselben Punkt mit einem anderen Zoom.

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

Jeder shot positioniert die Kamera, überprüft, ob die Position irgendwo ist, wo ein Mensch stehen könnte, exportiert eine Vorschau in previews/ und protokolliert alles in candidates.json. Öffne jede Vorschau und sieh sie dir an. Wähle niemals anhand von Koordinaten. Lege mehrere auf ein Blatt mit python scripts/contact_sheet.py out.png a.png b.png c.png.

Beurteile dann jedes Bild wie ein Fotograf:

  • Sagt es das, was die Aufgabenstellung sagen wollte?
  • Überprüfe alle vier Kanten und jede Überschneidung (Säule gegen Türrahmen, Pendelleuchte berührt Fensterkante, ausgedehnter Stuhl in der Ecke, Baum über dem Eingang, das Motiv beschnitten). Korrigiere, indem du die Kamera bewegst, und vergleiche dann erneut.
  • Wenn der Vordergrund dominiert, bewege dich. Aus demselben Punkt herauszoomen behält die gleiche Nah-Fern-Beziehung. references/camera-and-lens.md erklärt Position versus Brennweite, Objektivwahl, Höhe, Vertikalen und die Seitenverhältnis-Mathematik.
  • Löse jede Warnung aus der Plausibilitätsprüfung. Eine Kamera in einer Wand, auf einem Tisch oder drei Meter in der Luft ist kein Foto.

Die Kamera wird standardmäßig horizontal gehalten, sodass Vertikalen parallel bleiben; --tilt existiert für eine bewusste Auf- oder Untersicht und wird als solche aufgezeichnet. Verfeinere den stärksten Kandidaten mit kleinen Bewegungen, bis die Kanten sauber sind.

Wenn du in dieser Sitzung keine Bilder anzeigen kannst, exportiere sie trotzdem, aber speichere Szenen mit --status "Kandidat wartet auf visuelle Überprüfung" und teile dem Benutzer mit, dass nichts visuell überprüft wurde.

5. Eine Sequenz auswählen, keinen Haufen

Wähle die kleinste Menge, die die Geschichte des Gebäudes in der richtigen Reihenfolge erzählt, typischerweise 5 bis 9 Bilder für ein Haus: eine Außen-Heldenaufnahme, die Annäherung und den Eingang, den Hauptraum und seine Verbindung zu Hof oder Garten, dann einen ruhigeren Raum oder ein Materialdetail. Passe dies an das Projekt und die Anfrage an. Lehne nahezu identische Bilder ab: Zwei Bilder, die dasselbe erklären, kosten dem Set seinen Rhythmus. Mische Quer- und Hochformate nur dort, wo das Motiv es verlangt.

6. Szenen und passende Bilder speichern

python scripts/apd.py save-scene --name "04 Innenraum — Wohnzimmer zum Hof" --from-id living-c \
    --subject "Wohnzimmer, Veranda und Hof" --why "Ein Satz: Was dieses Bild erklärt."

Benenne Szenen mit NN Kategorie — Motiv mit zweistelligen Zahlen in der Betrachtungsreihenfolge. Der Befehl wendet die exakte Kandidatenkamera erneut an, speichert die Szene (Kamera, Objektiv und Seitenverhältnis sind darin gespeichert), exportiert das endgültige Bild in final/ im gleichen Verhältnis und zeichnet alles in shotlist.json auf. Er weigert sich, eine Szene zu ersetzen, die er nicht erstellt hat, und weigert sich bei einer unplausiblen Position, es sei denn, du übergibst --allow-implausible für eine Ansicht, die der Benutzer explizit angefordert hat; ein solches Bild wird in der Aufnahmeliste als unmögliche Kameraposition gekennzeichnet.

7. Liefern, überprüfen, zurückgeben

python scripts/apd.py deliver --title "<Projektname>"
python scripts/apd.py plan --z <z> --marks "<Ordner>/shotlist.json" --out "<Ordner>/camera-plan.png"
python scripts/apd.py verify
python scripts/apd.py end
  • deliver schreibt contact-sheet.png (nummeriert) und shot-list.md (Szene, Motiv, Kamerahöhe, Objektiväquivalent, Bildwinkel, Seitenverhältnis, Begründung).
  • verify öffnet jede Szene erneut und bestätigt, dass die wiederhergestellte Kamera und ein frischer Export mit dem gelieferten Bild übereinstimmen.
  • end bestätigt, dass der Fingerabdruck unverändert ist und vorhandene Szenen intakt sind, und stellt die Ansicht des Benutzers wieder her. Wenn es einen Unterschied meldet, teile dem Benutzer genau mit, was aufgelistet wird.

Neue Szenen leben nur im geöffneten Modell, bis es gespeichert wird. Frage, bevor du die Datei des Benutzers speicherst, es sei denn, sie haben es dir bereits gesagt; dann end --save. Sieh dir den Kontaktbogen selbst an, bevor du ihn präsentierst.

Berichte ehrlich: was du gemacht hast, was du dir angesehen hast, was du nicht überprüfen konntest. Nenne die Bilder das, was sie sind: komponierte SketchUp-Viewport-Exporte, keine Renderings. Berichte die tatsächlichen Kameraeinstellungen aus der Aufnahmeliste und behalte das Wort "Äquivalent" bei Objektivangaben.

Rendern

Ein Viewport-Export zeigt die Komposition; ein fotorealistisches Rendering fügt Licht und Material hinzu. ping listet installierte Erweiterungen auf. Wenn ein Renderer (V-Ray, Enscape, D5, Twinmotion-Link, Thea und ähnliche) vorhanden ist, biete an, die genehmigten Szenen zu übergeben: Jede Szene speichert die Kamera und das Seitenverhältnis, sodass der Renderer Szene für Szene mit dem beibehaltenen Bildausschnitt rendern kann. Dieser Skill steuert keinen Renderer, und dieser Weg ist ungetestet; sage das, gib dem Benutzer die Szenennamen und Pixelverhältnisse aus der Aufnahmeliste und bitte ihn zu überprüfen, ob das Ausgabeverhältnis des Renderers mit jeder Szene übereinstimmt. Wenn kein Renderer installiert ist, sage das und bleibe bei Viewport-Exporten.

Referenzdateien

  • references/photography.md - Kompositionsstandard: Außenaufnahmen, Innenaufnahmen, Kanten, Sequenz. Vor Schritt 4 lesen.
  • references/camera-and-lens.md - Position versus Brennweite, Objektivbereiche, Kamerahöhe, Vertikalen, wie Objektiv, Bildwinkel und Seitenverhältnis umgerechnet werden. Lesen bei der Auswahl von Objektiven oder der Meldung von Einstellungen.
  • references/sketchup.md - Einrichtung, jeder Befehl, was SketchUp erlaubt und nicht erlaubt, Fehlerbehebung. Lesen, wenn die Brücke sich falsch verhält.
  • references/editorial-references.md - Veröffentlichte Projekte, die es wert sind, studiert zu werden, mit Fotografenangaben und Links. Lesen, wenn der Benutzer nach Referenzen oder einem bestimmten redaktionellen Gefühl fragt.

Verwandte Skills