.. _AddClip: AddClip ======= Adds a Clip to a video. A Clip is defined as a contiguous part of the video between its two positions. The two positions can be specified in terms of (i) frame numbers, (ii) time since the beginning of the video, or (iii) fraction of 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_range ` - object with nonnegative integer start/stop, at most 9007199254740992 - Optional. Exactly one range field is required, with both start and stop. Both endpoints are required. When both endpoints are supplied, start must not exceed stop; equal endpoints are accepted. Supplied endpoints are checked against the linked video bounds. * - :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