.. _UpdateFrame: UpdateFrame =========== Updates existing Frame objects that satisfy the specified constraints. Parameters ---------- Exactly one of ``ref`` or ``constraints`` is required. Supplying both is rejected. Use a preceding FindFrame to combine property and relationship filters, then pass its reference. .. list-table:: :header-rows: 1 :widths: 15 25 60 * - Parameter - JSON type - Behavior * - :ref:`constraints ` - array expression - Optional. No property filter; the command-specific selector requirement still applies. Selects existing frames by expression. Cannot be combined with ref. * - :ref:`frame_number ` - integer, 0 through 9007199254740992 - Optional. Existing position is retained unless another position field replaces it. Zero-based frame position. At most one position field may be supplied; it removes the previous position representation. Storage does not check video boundaries; retrieving an out-of-range frame can fail. * - :ref:`label