.. _AddFrame: AddFrame ======== Adds a frame to a referenced video. Frame is defined as a position in the video. The position can be specified in terms of (i) frame number, (ii) time offset of the frame since the beginning of the video, or (iii) fractional offset of the frame in the video, with zero being the start and one being the end of the video. Parameters ---------- ``class`` is required; it names this object's application class within its type. .. list-table:: :header-rows: 1 :widths: 15 25 60 * - Parameter - JSON type - Behavior * - :ref:`_ref ` - integer, 1 through 100000 - Optional. Declares a unique reference for later commands in this transaction. When omitted, no reference is available to later commands. If conditional insertion finds existing objects, the reference names those matches. * - :ref:`connect ` - connection object or array of connection objects - Optional. When omitted, no additional user connections are created. Each object requires an earlier node ref. A customer class is required; direction is in or out (default out); properties sets connection properties. Connections are created only for a newly inserted object. * - :ref:`frame_number ` - integer, 0 through 9007199254740992 - Optional. Exactly one position field is required. Zero-based frame position. Do not combine position fields. Storage does not check video boundaries; retrieving an out-of-range frame can fail. * - :ref:`if_not_found ` - array expression - Optional. Checks existing objects of this exact type/class before insertion. When omitted, no duplicate lookup is performed. A match skips creation, properties, and new connections; status is 2 and _ref names all matches. An empty expression array is invalid. * - :ref:`label