Camera and Optics

Camera and Optics

A recipe's camera can be a pinhole (no lens, returns a scene) or a lens model such as omni/realistic (returns an oi, an optical image) — see Recipe Workflow for that distinction. For the full API — piCameraCreate, camera subtypes, attaching a lens file, focus and accommodation, film size and resolution, motion, microlens arrays — see the iset3d-camera-and-optics skill in the ISET3D repository. For the lens ray-tracing internals (paraxial optics, MTF, PSF), see iset3d-lens-toolbox.

Tutorials

Start here:

• t_piIntro_camera.m (.m) — the default perspective camera, field of view, film resolution.
• t_piIntro_lens.m — attach a lens model and render an optical image.

Going deeper:

• t_camera.m — render through a double-Gauss lens; set focal distance, see depth of field.
• t_cameraPosition.m — adjust camera position and rotation with the from/to/up lookat.
• t_cameraParameters.m — object distance, focal distance, and depth of field.
• t_lensBasics.m — create and inspect a lens object directly, without a full scene render.
• t_lensDiffractionBasics.m — a diffraction-enabled lens.
• t_lensAutofocus.m — autofocus a PSF camera.
• t_lensRayTracePSF.m — ray-trace a point spread function.

Manual run (marked % SkipFile — excluded from the automated tutorial smoke test as too slow or interactive for routine runs, but still useful):

• t_cameraMotion.m — camera motion blur, multiple renders.
• t_filmResize.m — how film/camera sampling settings affect field of view and image shape.
• t_lensMTF.m — lens MTF validation; a remote-rendering workflow, run when Docker/PBRT with a remote host is available.