pylabrobot.brooks.precise_flex.PreciseFlexVision.save_image#

async PreciseFlexVision.save_image(camera: Literal['front', 'bottom'] | int = 'front', acquire_prefix: str | None = None, acquire_path: str | None = None) → str#

Acquire and save a frame via the acquire tool’s ACQUIRE_AND_SAVE mode; no arm motion.

The file is written on the vision server host; retrieve it over a separate transport. Returns the Vprocess reply.

Parameters:

  • camera (Literal['front', 'bottom'] | int) – which gripper camera - "front"/1 (front-facing) or "bottom"/2 (downward). Selects the acquire tool (acq<n>) and the process that runs it (Camera<n>); the camera itself is fixed by that tool’s CameraNumber.

  • acquire_prefix (str | None) – optional filename prefix for the saved frame.

  • acquire_path (str | None) – optional directory on the vision server host to write the frame to.

Return type:

str