viewer.yaml

Named camera views for zeon look and look() in the REPL.

viewer.yaml at the project root holds named camera views for the 3D viewer. zeon look <name> and look("<name>") in the REPL point the viewer at a preset by its name. The file is optional and is re-read on every call, so an edit takes effect on the next zeon look without a reload.

Example

From the starter project (excerpt):

presets:
  stands:                          # both well-plate stands and the plate
    look_at: wellplate_stand_1
    target: [0.40, -0.64, 0.08]
    position: [1.30, -0.64, 0.80]
  shaker_slot:                     # the slot the workflow loads (slot_1)
    look_at: wellplate_shaker.slot_1
    target: [-0.29, -0.20, 0.13]
    position: [-0.90, -0.70, 0.70]
  cell:                            # the whole bench from the front right
    target: [0.0, -0.35, 0.15]
    position: [1.8, -1.6, 1.3]

Fields

presets maps a preset name to:

KeyDescription
look_atA world object (instance id or display name) or <holder>.<anchor>. The view frames it and highlights it.
targetWorld [x, y, z] in metres. Used when look_at is absent or does not resolve in the loaded world.
positionWorld [x, y, z] in metres where the camera stands. Without it, the camera is placed where the arms block the view least.

A preset needs look_at or target. A preset name is looked up before world objects, so a preset called wellplate shadows an object with that name.

A file that is not valid YAML, or whose presets is not a mapping of names to mappings, is an error that names the file.

Using it

zeon look stands
zeon look wellplate_shaker.slot_1   # no preset needed for an object or anchor

zeon look also accepts an object id or <holder>.<anchor> directly. --seconds sets how long the highlight stays (default 6).


Did this page help you?