.. highlightlang:: us

.. index:: VideoCreate

.. _videocreate:

VideoCreate
============

.. us.tag  VideoCreate NOTREADYENGLISH New5503 video-create

:ref:`VideoCreate` creates a video object.

.. function::  hVideo = VideoCreate()
               hVideo = VideoCreate(ssFilename)

.. us.return

**Return Value**

*hVideo* is the object handle.

.. us.params

**Parameters**

.. uparam:: ssFilename

   *ssFilename* is the complete file name of a video file.

.. us.comment

**Comment**

The video object uses the Microsoft Media Control Interface (**MCI**). 

This interface supports the following formats: ``WMV``, ``MPG``, ``AVI``. 
On some computers the ``.mp4`` format is supported, if the file extension is
``.mpg``. Unfortunately the **MCI** interface does not provide a detailed
specification of the supported formats.

Other formats can be converted with ``FFmpeg``, see http://www.ffmpeg.org.

Example: Create ``MPG`` file from a ``MP4`` file:

::

   ffmpeg -i test.mp4 -qmax 8 test.mpg

Create a snap shot from the position 4.5 seconds::

   ffmpeg -ss 4.5  -i test.mpg -vframes 1 -f image2 test.jpg

.. us.example

**Example**

See :ref:`VideoCommand`.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - R2013.3
     - New.

.. seealso::
   :ref:`overview-videos`,
   :ref:`VideoCommand`,
   :ref:`VideoDestroy`

:sub:`id-1105160`