Camera

A perspective camera with orbit, zoom, framing, depth cueing, and EEVEE lens focus.

from proteinmotion.camera import Camera

Constructor

Camera()

Notes

Each scene creates its own camera at scene.camera. Use frame() for initial setup and Focus or scene.focus() for animated camera movement.

Attributes

Name	Description
`target`	Look-at point in world coordinates.
`distance`	Distance from the camera to its target, initially 70 Å.
`theta, phi`	Horizontal and vertical angles in radians.
`fov`	Vertical field of view in radians; initially 38 degrees.
`depth_cue`	Distance fog strength; 0 disables it.
`radius`	Framing radius used to choose clipping planes.
`dof`	Whether EEVEE depth of field is enabled; initially False.
`fstop`	Lens f-number, initially 5.6. Lower values produce more blur.

Example and output

This excerpt runs inside a scene’s construct() method. The full example file includes imports, structure loading, and camera setup. Run it from a repository checkout.

Code Scene excerpt

p = ubiquitin()
frame(self, p)
helix = p.select(chain="A", residues=(23, 34))
marker = helix.highlight(
    style="box",
    color="#f2ba67",
    padding=1.5,
)
self.play(FadeIn(marker), run_time=0.6)
self.focus(helix, margin=1.6, run_time=1.5)
self.play(self.camera.animate.orbit(0.4), run_time=2)
self.play(FadeOut(marker), run_time=0.6)
self.focus(p, run_time=1.5)

Output Preview · 6.2 s · 60 fps

Camera focus

Ubiquitin residues 23–34.

Full source: RegionFocus Download MP4

Methods and properties

Name	Description
set_focus()method	Set lens focus without moving or zooming the camera.
focus_pointproperty	Current lens target in world ångströms, following the selected atoms.
frame()method	Frame the supplied proteins or regions immediately and stop previous tracking.
focus()method	Frame a protein or region immediately and optionally track its center.
update_tracking()method	Update the camera target from the tracked region while keeping zoom fixed.
orbit()method	Change horizontal and vertical camera angles.
zoom()method	Divide camera distance by factor. Values greater than 1 zoom in.
eyeproperty	Current camera position in world coordinates.
matrix()method	Compute the view-projection matrix for the given image aspect ratio.
animateproperty	Create a builder for orbit, zoom, and focus animations.
snapshot()method	Capture the current state for deterministic timeline evaluation.
restore()method	Restore a state produced by snapshot().

set_focus()

View source

Camera.set_focus(
    target,
    *,
    chain=None,
    residues=None,
    atoms=None,
    fstop=5.6,
    follow=True,
)

Set lens focus without moving or zooming the camera.

Parameter	Default	Description
`target`	Required	Protein, Region, world point, or None to disable DOF.
`chain`keyword only	`None`	Author chain ID or a collection of IDs; None selects all chains.
`residues`keyword only	`None`	Author residue number, inclusive (first, last) tuple, or list of individual numbers.
`atoms`keyword only	`None`	Atom name or list of names, such as "CA"; None selects all atom names.
`fstop`keyword only	`5.6`	Lens f-number. Lower values produce a shallower depth of field. Must be positive.
`follow`keyword only	`True`	Track the mean selected position through motion; False fixes the initial world point.

Returns: The camera.

Selectors apply to a Protein target. Ranges use inclusive PDB author numbers. atoms="CA" focuses on the Cα centroid. A region defines one focus plane, rather than making all selected atoms equally sharp.

focus_point

View source

Camera.focus_point

Current lens target in world ångströms, following the selected atoms.

frame()

View source

Camera.frame(*proteins, margin=1.25, aspect=16 / 9)

Frame the supplied proteins or regions immediately and stop previous tracking.

Parameter	Default	Description
`*proteins`	—	Protein or annotation objects to add or render.
`margin`keyword only	`1.25`	Positive framing margin; larger values leave more space around the target.
`aspect`keyword only	`16 / 9`	Image width divided by height.

Returns: The camera.

focus()

View source

Camera.focus(target, *, margin=1.25, aspect=16 / 9, follow=True)

Frame a protein or region immediately and optionally track its center.

Parameter	Default	Description
`target`	Required	Object to animate or use as a destination. The supported object type depends on the operation.
`margin`keyword only	`1.25`	Positive framing margin; larger values leave more space around the target.
`aspect`keyword only	`16 / 9`	Image width divided by height.
`follow`keyword only	`True`	Track the selection’s center after the focus completes.