.. highlightlang:: us .. index:: VideoSnapshot .. _videosnapshot: VideoSnapshot ============= .. us.tag VideoSnapshot NOTREADYGERMAN video-commands New5503 :ref:`VideoSnapshot` erzeugt eine Bitmap-Datei einer bestimmten Position in der Video-Datei. .. function:: ret = VideoSnapshot(hVideo) ret = VideoSnapshot(hVideo, ssBitmapFile) ret = VideoSnapshot(hVideo, ssBitmapFile, pos) ret = VideoSnapshot(hVideo, ssBitmapFile, pos, ssVideoFile) .. us.return **Returnwert** *ret* ist 0, wenn die Funktion erfolgreich war. Wenn die Funktion fehl schlug wird ein error-code größer 0 zurück gegeben. .. us.params **Parameter** .. uparam:: hVideo *hVideo* ist der Handle des Videoobjekts. .. uparam:: ssBitmapFile Kompletter Dateiname (mit Pfad) der Bitmapdatei. .. uparam:: pos Position in Millisekunden oder -1 für die aktuelle Position. .. uparam:: ssVideoFile Kompletter Dateiname der Videodatei oder leerer String ``""`` für die aktuelle Datei. .. us.comment **Kommentar** Falls das Programm ``FFmpeg.exe`` auf dem Rechner installiert ist und im Pfad angegeben enthalten ist, wird diese Programm verwendet um den Video-Schnappschuss zu erzeugen (siehe http://www.ffmpeg.org und https://de.wikipedia.org/wiki/FFmpeg). Falls ``FFmpeg.exe`` nicht installiert ist, werden DirectX (DirectShow) Funktionen verwendet. Es gibt Fälle in denen sie fehl schlagen, obwohl das Video problemlos abgespielt werden kann, ``FFmpeg.exe`` ist deshalb vorzuziehen. .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - R2013.3 - Neu. .. seealso:: :ref:`overview-videos`, :ref:`VideoCreate` :sub:`id-515123`