Tool / Free · v0.5.1

Landscape Camera Setup.

A Blender add-on that turns a Field Method photo package into cameras, one for each site photograph.

Blender add-on, written for Blender 4.5 · Free download · Not yet tested inside Blender

Look at the model from where each photograph was taken

A site photograph and a 3D model of the same site are easiest to compare from the same viewpoint. Setting up a Blender camera for each photograph by hand, with its position, direction, lens and background, is slow and easy to get wrong.

Landscape Camera Setup reads a photo and camera package from the Photo tools or Site Lens and makes one camera for each photograph, with the photograph as that camera’s background. Each camera keeps its source values and review notes. A value the package does not have uses a labelled manual setting.

It is for landscape architects, architects and designers who model a site in Blender and want to check it against site photographs. It updates Landscape Camera Setup 0.2, the add-on Field Method’s owner wrote before these packages existed.

Install and import

Install

  1. Save your Blender project. If an earlier version of Landscape Camera Setup is installed, disable it first.
  2. Install the ZIP. In Blender’s Preferences, install landscape-camera-setup-v0.5.1.zip from disk and enable Landscape Camera Setup. Install the ZIP as it is: its landscape_camera_setup folder holds both Python files the add-on needs.
  3. Restart Blender.

Import a package

  1. Download a package. In the Photo tools, download the Blender cameras or the photo and camera package; in Site Lens, the site package with cameras reviewed in the Photo tools. Unzip it to a folder and keep camera-records.json, the photos folder and any model file together.
  2. Import. In the 3D Viewport sidebar, open Landscape › Landscape Cameras › Import Field Method Photo Package and choose camera-records.json.
  3. Choose the model. Tick Import Included Site Model when the scene does not have the model yet; untick it when the matching model is already there. Blender’s own glTF importer brings the model in with the right axes and units, so do not rotate it again.
  4. Look through a camera. Select a camera and choose Use Selected Camera View. It becomes the scene camera, its photograph shows as the background, and the render size changes to the photograph’s proportions.
  5. Review. Read Landscape Camera Setup · Import Review in Blender’s Text Editor. Each camera also keeps its source values and review notes as custom properties. Adjust lens, position and rotation until edges in the photograph meet the model.

The README in the ZIP gives the full steps and every setting.

What it does

One camera for each photograph
Up to 200 photographs in a package. Each camera is placed in the package’s California State Plane coordinates, moved to the same origin as the package’s model, and keeps its raw coordinates and source values.
Direction
A direction recorded against true north is turned to grid north for the zone. A magnetic direction needs an offset you have checked, and a direction with no known north is not treated as true north. A missing heading, pitch or roll uses a labelled manual setting, not a guess.
Height
In a package with the terrain underlay, each camera stands on the ground under its photograph plus an eye height. That height is computed, not measured. Otherwise the height is a setting you choose, zero to start: phone GPS altitude is not height above ground and is used only if you turn on a vertical offset you have checked.
Lens
From the package’s lens record when it has one; otherwise an approximation from the photograph’s 35 mm equivalent focal length, labelled as such; otherwise a labelled 50 mm lens on a 36 mm sensor. Panoramic photographs get panoramic cameras; fisheye photographs get provisional fisheye cameras with a warning.
Photograph as background
Each photograph is its camera’s background at 50% opacity: in front of the package’s model when it has one, behind otherwise. Backgrounds show in the viewport only. They are not rendered and not projected onto the model.
Terrain and aerial
A Photo tools package with the underlay brings the ground around the photographs, from USGS 3DEP with the USDA NAIP aerial draped on it, as a GLB that Blender’s glTF importer opens.
Imports again
Importing a package again keeps camera identities and your manual edits, and does not import its model twice.
Single photographs
The tools of the 0.2 add-on are kept: Create Camera from Image makes a review camera from one image file, using its metadata through ExifTool when you have set it up and labelled manual settings otherwise; Use Active Image from Plane takes that image from a selected image plane; and Batch Cameras from Selected Planes puts a camera at each selected plane, labelled as copied from the plane rather than surveyed.

Supported software

  • Blender: written for Blender 4.5. The add-on lists Blender 4.5.0 as its minimum version. It has not yet been run in any version of Blender; see Not yet tested.
  • Nothing else to install: it uses Blender’s own Python modules and the Python standard library. The ZIP holds two Python files, a README and a provenance note.
  • Packages: the Blender cameras from the Photo tools, with or without the terrain and aerial underlay; the photo and camera package from the Photo tools with a site; and the Site Lens site package with reviewed cameras.
  • Coordinates: California State Plane zones I to VI, NAD83, US survey feet (EPSG:2225 to EPSG:2230), from version 0.5.0. Earlier versions read Zone VI only.
  • Models: GLB files, opened with the glTF importer that comes with Blender.
  • ExifTool (optional): to read the metadata of original phone and DJI drone photographs, install ExifTool yourself and set its path in the add-on’s preferences. It is not included. Field Method packages do not need it.

Downloads

  • Landscape Camera Setup 0.5.1 (ZIP, 22 KB, November 13, 2026). Current. Reads Photo tools packages with the terrain and aerial underlay as well as earlier packages. Draws each photograph in front of the package’s model at half opacity, so the two can be compared.

Earlier versions

These stay available so that links in packages downloaded earlier keep working. Use 0.5.1 unless you have a reason not to.

  • Landscape Camera Setup 0.5.0 (ZIP, 21 KB, November 12, 2026). Reads packages in any California State Plane zone, I to VI. Refuses packages with the terrain underlay, with a message, rather than misplacing their cameras. Linked from the READMEs of Photo tools packages downloaded before November 13, 2026.
  • Landscape Camera Setup 0.4.0 (ZIP, 20 KB, October 10, 2026). Adds lens records for undistorted pinhole cameras, checks of the original image files and camera identities that stay the same when a package is imported again. California Zone VI only. The camera records of the photo and camera package and of the Site Lens site package name this version; 0.5.1 reads those packages too.
  • Landscape Camera Setup 0.3.0 (ZIP, 17 KB, October 9, 2026). The first update of Landscape Camera Setup 0.2: corrected camera axes and the first import of Field Method photo packages. California Zone VI only.

Limitations

  • Cameras stand where the phone said it was, not at survey positions. Phone GPS is approximate, and the shift between the GPS datum (WGS84) and NAD83 is not applied.
  • It is not a photogrammetry system. It does no feature matching, bundle adjustment, mesh reconstruction or lens undistortion. Lens distortion values are kept but not applied.
  • Every camera needs review in Blender. Line photographs up on fixed edges such as curbs, paving and road paint.
  • The terrain underlay is bare ground: buildings and trees are not modelled, so roofs and tree crowns in the aerial lie flat on the ground.
  • A panoramic or fisheye photograph does not line up as an ordinary background; check its projection before matching.
  • A package holds at most 200 cameras and 4 MB of camera records. Its files must stay inside the package folder.
  • It makes no network requests. Everything it uses comes from the package folder.

Not yet tested

  • Field Method has not installed or run Landscape Camera Setup inside Blender. Blender is not installed on the computer where it was built. A first check inside Blender is planned; this page will say what it found.
  • Not yet checked in Blender: installing and enabling it, reading the photographs, the camera backgrounds, the conversion of units, switching between cameras, and two projects’ cameras in one scene.
  • What has been checked: the repository’s automated tests run the add-on’s camera mathematics and package checks in plain Python against packages made by Field Method’s own exporters, and compile the Blender part of the add-on without Blender.
  • The same holds for versions 0.3.0 to 0.5.0: none has been run inside Blender.

Questions

Is it free?

Yes, it is a free download. No licence has been chosen for the add-on yet, so redistribution and modification terms are not set.

Does it work in other versions of Blender?

It is written for Blender 4.5 and has not yet been run in any version. Other versions are untested.

Do I need the Photo tools or Site Lens?

To import a package, yes: the packages come from them. The single-photograph and image-plane tools work without a package.

Are the cameras accurate?

They are a starting point. Most positions come from phone GPS, and directions from the phone’s compass where it recorded one; a camera reviewed with Photo Match in the Photo tools was lined up by eye. Expect to adjust each camera. The add-on does not solve the camera from the photograph.

Does it send anything anywhere?

No. It reads files from the package folder on your computer and makes no network requests.

Sources

Related: Photo tools · Site Lens