View source for Documentation:Modules/image

== Options ==
=== Video output ===
{{Module|name=image|type=Video output|first_version=0.8.2|last_version=0.9.10|description=Outputs the video images to files}}

In VLC 1.0.0 the image video output was rewritten into a video-filter named [[Documentation:Modules/scene|scene]], and the old image video output was removed.

Trivia bit: [https://git.videolan.org/?p=vlc/vlc-0.9.git;a=blob;f=modules/video_output/image.c#l56 the help text] was inaccurate, claiming width and height options were <samp>&hellip; [b]y default (-1) &hellip;</samp>. The variables that inherited the command-line options, <var>p_vout->p_sys->i_width</var> and <var>p_vout->p_sys->i_height</var>, were unsigned integers and the value <code>0</code> was passed as the second argument in [https://git.videolan.org/?p=vlc/vlc-0.9.git;a=blob;f=modules/video_output/image.c#l95 the call] to <code>[https://git.videolan.org/?p=vlc/vlc-0.9.git;a=blob;f=include/vlc_plugin.h;h=364e53c089d709d4a6eebc2756a973145d387d33;hb=HEAD#l354 add_integer]</code>.<br />
Thus, <code>--image-out-width</code> and <code>--image-out-height</code> had defaults of <code>0</code>, not <code>-1</code>.<br />
The help-text probably wasn't updated, since this error was prior to the first public release. It has since been fixed.

{{Option
|name=image-out-format
|value=png, jpeg
|default=png
|description=Format of the output images}}
{{Option
|name=image-out-width
|value=integer
|default=-1
|description=You can enforce the image width. By default ''-1'' VLC will adapt to the video characteristics}}
{{Option
|name=image-out-height
|value=integer
|default=-1
|description=You can enforce the image height. By default ''-1'' VLC will adapt to the video characteristics}}
{{Option
|name=image-out-ratio
|value=integer
|default=3
|description=Ratio of images to record. ''3'' means that one image out of three is recorded}}
{{Option
|name=image-out-prefix
|value=string
|default=img
|description=Prefix of the output images filenames. Output filenames will have the "prefixNUMBER.format" form. Starting with VLC 0.9.0 you can also use [[Documentation:Play HowTo/Format String|format time and meta variables]]}}
{{Option
|name=image-out-replace
|default=disabled
|description=Always write to the same file}}

== Source code ==
* {{VLCSourceFile|modules/demux/image.c}}

{{Documentation footer}}